笔记工具最大的浪费,是存进去就再也没被翻出来。得到大脑(Get笔记)是得到官方开放的笔记 Skill:文本、链接、图片都能存,搜索走语义召回而不是关键词匹配,知识库支持分类订阅。它把「采集—整理—召回」这条链路接到了 Agent 上,104.1k 安装、28.7k 下载,效率榜第 9,版本 v1.9.1。
整包不大,SKILL.md 13.3 kB 是主文档,另有 7 份 reference 拆开讲 API 细节、OAuth、保存、搜索、标签、知识库,配两个 Python 脚本处理 OAuth 轮询和图片上传。它的形态是「官方 API 的规范化封装」,不是自己造一套存储。
百度网盘下载:https://pan.baidu.com/s/1yAhjty-Hvpk-R1oH4dz6dg?pwd=cei0(提取码:cei0)
通过网盘分享的文件:iswalle-getnote-1.9.1.zip
链接: https://pan.baidu.com/s/1yAhjty-Hvpk-R1oH4dz6dg?pwd=cei0 提取码: cei0 复制这段内容后打开百度网盘手机App,操作更方便哦
一、基本信息
| 项目 | 内容 |
|---|---|
| 技能名称 | 得到大脑(Get笔记)(getnote) |
| 维护方 | 得到官方开放平台(biji.com) |
| 定位 | 个人笔记与知识库的采集、检索、管理 Skill |
| 版本 | v1.9.1 |
| 社区数据 | 安装 104.1k · 下载 28.7k · 效率榜 #9 |
| 安全认证 | CLS 扫描中(截至整理时未出结论) |
| 运行环境 | curl + python3;GETNOTE_API_KEY、GETNOTE_CLIENT_ID |
| API 域名 | https://openapi.biji.com(强制,不接受替代地址) |
| 权限范围 | note.content.read / write、note.recall.read |
| 包体大小 | 主文档 13.3 kB,另有 7 份 reference 与 2 个脚本 |
| 下载安装 | iswalle-getnote-1.9.1.zip(网盘,提取码 cei0) |
| 标签 | productivity、docs、content-media、api、知识管理 |
二、它解决什么问题
先说清楚它不是什么:它不是本地笔记软件,数据存在得到云端;也不是通用剪藏工具,它的入口是你的 Agent。
它解决的是三个具体场景。第一,读到一半的网页、聊到一半的想法,需要一个地方随手存,而且要能在以后被搜出来。第二,存进去的东西如果只能靠关键词找,等于没存——「上次看到的那个讲注意力机制的文章」这种模糊描述,关键词搜索无能为力,语义搜索可以。第三,围绕某个主题积累的素材,需要按主题归拢,而不是散在一堆标签里。
对已经在用得到 App 的人来说,还有一层价值:数据不用迁移。同一套账号体系,同一批笔记,Agent 和你手机上的操作看到的是同一份内容。
它的定位可以概括为:把「第二大脑」这件事,从一个 App 扩展成一个可被 Agent 调用的接口。
三、核心功能
3.1 四种指令覆盖主流程
| 指令 | 作用 | 处理方式 |
|---|---|---|
/note save |
保存文本、链接、图片 | 文本同步返回;链接抓取与图片走异步任务 |
/note search |
全局或定向知识库语义搜索 | 同步返回 |
/note list / tag |
浏览与管理笔记、标签 | 同步返回 |
/note kb |
知识库创建、订阅、分类 | 同步返回 |
异步那部分要注意:链接抓取和图片上传需要轮询任务状态,通常 10-30 秒。文档内置了一次自动重试,二次失败就要人工介入。批量导入时,这个延迟会累积。
3.2 语义搜索:理解意图而非匹配字面
这是它和普通笔记工具的分水岭。搜「关于注意力机制的文章」,关键词匹配只能命中标题里带这几个字的笔记;语义搜索能召回内容相关但标题完全不同的记录。
代价是不可解释。你很难解释「为什么这条被搜出来了」,也没法像关键词搜索那样精确控制。做严肃检索时,这一点要有心理准备——它更适合「找回印象」,不适合「穷举证据」。
3.3 知识库:把散落素材收成主题
知识库不是文件夹,它支持订阅博主内容、追踪直播。这意味着它带一点「内容源管理」的味道:不只是存你写的,还能订阅别人产出的。对做主题研究的人来说,这个能力省掉了手动搬运。
3.4 工程细节:三个必须知道的约束
文档里埋了三条容易踩的坑,值得单独拎出来:
- 接口域名写死:所有请求只能发往
https://openapi.biji.com,不接受任何替代地址。这是防钓鱼设计,也意味着你不能自建代理。 - ID 是 64 位整数:超出 JavaScript 的
Number.MAX_SAFE_INTEGER,直接JSON.parse会静默丢精度。必须先把id、note_id、parent_id这些字段正则替换成字符串再解析。 - 创建频率限制:建议间隔 1 分钟以上,否则触发 10202 限流。
第二条尤其阴险——它不报错,只是把 ID 悄悄改掉,然后你拿着错误的 ID 去删笔记,删了个寂寞。
四、真正有价值的地方
官方接口,数据同源。不是第三方爬虫抓的,是官方开放的 API。你在 Agent 里存的笔记,手机 App 上立刻能看到,反过来也一样。这种一致性是第三方工具做不到的。
多模态采集。文本、链接、图片三条路都通。链接会自动抓正文,图片会做 OCR。日常收集素材时,不用先想「这个格式能不能存」。
隐私设计有具体动作。不是喊口号:GETNOTE_OWNER_ID 用来在群聊里拦截越权操作,删除和分享要求二次确认,凭证禁止外泄。这些是能落地的规则。
文档拆得细。7 份 reference 分别管 API 细节、OAuth、保存、搜索、标签、知识库、列表。想查什么直接翻对应那份,不用在 13 kB 主文档里翻半天。
错误码有对照。10201 是会员限制,10202 是限流,都写清了怎么处理。这种颗粒度能省掉大量猜测。
五、绕不开的问题
会员墙。高级搜索和大容量存储依赖得到大脑会员,非会员会拿到 10201。也就是说,免费用户能用的功能是打折的,评估时要先确认自己的账号状态。
异步延迟。链接和图片保存要 10-30 秒轮询。做「存完立刻用」的流程时,这个延迟会打断节奏,需要设计成先存后取。
频率限制偏紧。创建笔记间隔建议 1 分钟以上,批量导入基本不可行。想搬 500 条旧笔记进去,按这个节奏要跑八个多小时。
数据在别人服务器上。导出自由度受平台政策约束。重度使用前要想清楚:如果哪天服务调整,你的知识库怎么办。
语义搜索不可控。召回质量好,但不可解释、不可精确控制。做需要穷举的检索时,得配合标签和知识库做二次筛选。
认证状态未出结论。CLS 显示「扫描中」,对一个要读你全部笔记的工具来说,这是个需要留意的空白。
这几条问题放在一起,指向同一个判断:它是一个「生态内很好用、生态外有门槛」的工具。得到用户几乎没有迁移成本,非得到用户则要先解决会员、数据托管、批量导入三件事。评估时先问自己一句「我的笔记愿不愿意放在这儿」,答案决定后面所有取舍。补一句实用建议:先用一百条笔记试两周,摸清搜索召回的脾气,再决定要不要把全部资料搬进来。
六、官方风险表与解读
| 风险项 | 级别 | 说明 | 缓解措施 |
|---|---|---|---|
| 会员门槛 | 中 | 高级搜索、大容量依赖会员,否则报 10201 | 先确认账号权益,再设计功能边界 |
| 异步失败 | 中 | 链接抓取受反爬影响,二次失败需人工 | 重要链接保留原始出处备份 |
| 限流 | 中 | 创建间隔不足触发 10202 | 批量导入加 60 秒以上间隔 |
| 隐私 | 中 | 笔记内容、搜索词、链接、图片上传云端 | 敏感信息本地加密,不入库 |
| 平台绑定 | 中 | 数据存于得到云端,导出受政策约束 | 定期导出备份,避免单点依赖 |
| 群聊越权 | 低 | 未配 GETNOTE_OWNER_ID 时他人可误触 |
群聊场景务必配置 owner 校验 |
风险集中在「平台依赖」这一类,技术层面没有硬伤。最需要认真对待的是隐私和平台绑定:把全部笔记托管在第三方,本质上是用便利换控制权。这个交换是否划算,取决于你的内容有多重要。
一条实用纪律:群聊里用,一定先配 GETNOTE_OWNER_ID;否则群友一句话就能把内容写进你的私人笔记,或者把私人笔记读出来。
3.5 知识库与标签怎么配合
两个功能容易混着用,实际分工很清楚:标签管「是什么」,知识库管「放哪儿」。
标签是横向切片。一条笔记可以打多个标签,用来标记主题、来源、状态。比如「待读」「已整理」「引用过」这种工作流状态,用标签最合适。标签的弱点是没有层级,堆到三十个以上就失去意义,所以建议控制在一层、二十个以内。
知识库是纵向容器。一条笔记通常只属于一个库,库与库之间边界清晰。适合「长期跟踪的主题」,比如某个行业、某个项目、某门课程。它还支持订阅博主和直播,等于把「内容源」也纳进库的范畴。
配合方式。先按知识库分大类,再用标签标状态。搜索时两步走:先在目标库里做语义搜索,缩到几十条;再用标签过滤掉「已归档」「草稿」这类不该出现的。单用语义搜索容易召回太多,单用标签又找不回「忘了打标签」的笔记。
这个组合看起来简单,实际能解决大部分「存了找不到」的问题。真正难的是一开始就定好库和标签的划分,中途改起来成本很高——笔记一多,重新归类就是个大工程。
七、适合谁,不适合谁
| 类型 | 是否适合 | 理由 |
|---|---|---|
| 知识工作者 / 终身学习者 | 适合 | 阅读笔记、课程要点、灵感碎片需要一个可检索的容器 |
| 得到 App 深度用户 | 适合 | 数据同源,不用迁移,边际成本最低 |
| 内容创作者 / 研究者 | 适合 | 网页剪藏 + 图片归档 + 语义召回,素材链路完整 |
| 批量迁移历史笔记 | 不适合 | 1 分钟一条的频率限制,大批量不现实 |
| 要求数据完全自主可控 | 不适合 | 数据在云端,导出受平台政策约束 |
| 非会员且需要高级搜索 | 不适合 | 会直接撞上 10201 |
八、落地路径
- 先授权。
/note config走 OAuth,拿到GETNOTE_API_KEY与GETNOTE_CLIENT_ID。 - 验通。存一条纯文本笔记,确认同步返回成功。
- 测异步。存一个网页链接,观察轮询多久出结果,确认自动重试是否生效。
- 建知识库。按你常做的主题建两三个,把后续素材直接归进去,别都堆在默认库。
- 定标签规范。标签乱建等于没建,建议控制在一层、数量不超过二十个。
- 配群聊防护。如果在群里用,务必设
GETNOTE_OWNER_ID。
九、文件构成与安装
| 文件 | 大小 | 作用 |
|---|---|---|
SKILL.md |
13.3 kB | 主文档:约束、认证、指令、ID 精度处理 |
references/api-details.md |
9.4 kB | 接口清单与 scope 权限说明 |
references/save.md |
6.9 kB | 保存流程:文本 / 链接 / 图片三条路径 |
references/search.md |
3.1 kB | 语义搜索参数与结果结构 |
references/knowledge.md |
7.7 kB | 知识库创建与订阅 |
references/oauth.md |
5.4 kB | 授权流程与凭证刷新 |
scripts/oauth_poll.py |
3.0 kB | OAuth 轮询辅助 |
scripts/upload_image.py |
5.7 kB | 图片上传与状态查询 |
安装需要在得到开放平台注册应用拿到 CLIENT_ID,再走一次 OAuth 授权。两个脚本用 python3 跑,依赖标准库加 curl,不需要额外安装包。
十、常见问题
非会员能用吗?
能存能搜,但高级搜索和大容量存储会报 10201。日常轻量使用够,重度使用建议先确认会员权益。
为什么保存链接要等半分钟?
它在后台抓取网页正文并解析,走的是异步任务。10-30 秒是正常范围,失败会自动重试一次。
笔记 ID 为什么会变?
64 位整数超出 JS 安全范围,直接 JSON.parse 会截断精度。必须先把 ID 字段替换成字符串再解析,文档给了正则写法。
能批量导入吗?
技术上可以,实际很慢。创建间隔建议 60 秒以上,否则触发 10202。几百条的量级建议分几天跑。
群聊里会不会串号?
配了 GETNOTE_OWNER_ID 就不会。没配的话,群里任何人都可能触发写入或读取,务必先配置。
搜索为什么有时召回不相关的内容?
语义搜索按相似度召回,不保证精确。要缩范围就指定知识库,或者先用标签过滤再做语义搜索。
数据能导出吗?
通过 API 可以逐条读取,但没有一键全量导出。重度使用者建议定期用 /note list 拉一遍做本地备份。
能保存音频或会议录音吗?
文档主要覆盖文本、链接、图片三类。音频转写能力取决于得到端是否开放对应接口,当前版本没有明确的录入流程。要处理录音,建议先在本地转写成文本,再以文本形式存入。
标签能分层吗?
不能,只有一层。想模拟层级,用「父级-子级」的命名约定,比如「项目-A项目」,检索时按前缀搜。这是权宜之计,标签多了仍然会乱。
授权过期了怎么重新配?
再走一次 /note config 的 OAuth 流程,覆盖旧的 GETNOTE_API_KEY 即可。长期不用的账号容易过期,建议每月调用一次接口保活。
能删除笔记吗?
可以,但属于敏感操作,要求二次确认。删除前建议先用 /note list 确认 ID —— 注意 ID 必须以字符串处理,精度丢了会删错或删不掉。
一条笔记能属于多个知识库吗?
不能,一条笔记通常只归属一个库。要跨库引用,用标签或多建一条副本。这个限制在小规模下没什么感觉,笔记上千条之后会成为整理上的主要障碍。
搜索能限定时间范围吗?
当前接口以相关性为主,没有明确的时间过滤参数。要找「最近存的」,用 /note list 按时间排序比语义搜索更直接。
结语
得到大脑 Skill 的价值在于「连接」:它把得到已经积累的笔记体系和 Agent 的能力接起来,让你在对话里就能完成采集、检索、整理。对已在得到生态里的用户,这是零迁移成本的增强;对生态外的人,它更像一个功能完整的云端笔记 API。
用之前想清楚两件事:你愿不愿意把知识库交给云端,以及你的账号权益够不够用。这两条没问题,剩下的就是养成「随手存、定期搜」的习惯——工具再好,不搜等于没存。
补充一个习惯建议:定期把重要笔记导出到本地或自己的存储里。云端知识库的便利建立在「服务持续可用」的前提上,而服务条款、账号状态、接口策略都可能变化。导出不需要多复杂,一个季度一次 Markdown 备份,就够你在意外发生时把损失控制在可接受范围。
通过网盘分享的文件:iswalle-getnote-1.9.1.zip
链接: https://pan.baidu.com/s/1yAhjty-Hvpk-R1oH4dz6dg?pwd=cei0 提取码: cei0 复制这段内容后打开百度网盘手机App,操作更方便哦
得到大脑 笔记管理 语义搜索 知识库 第二大脑
百度网盘下载:https://pan.baidu.com/s/1yAhjty-Hvpk-R1oH4dz6dg?pwd=cei0(提取码:cei0)















暂无评论内容