按课程名/老师定位有个人笔记的得到课程，不需要知识库。query仅课程名exact/prefix，author精确，二者AND且至少一个；用返回course_type+course_id筛选list_notes。核对reference.resources.v1与applied_filters，空页has_more=true仍沿next_cursor继续。保留每页partial/warnings及候选metadata_state；course_directory_no_lessons表示目录缺课节，末页has_more=false仍不能宣称找全老师的全部课程。total未知，不冒充全站课程列表或课程内语义搜索。

单次后端批量读取最多20个去重个人笔记ID，保持顺序。默认content/ref_content/reference，original需显式选择；引用原文ref_content，content是评论。默认32000/最多64000Unicode码点及1MiB。逐条保留ok/unavailable/failed/deferred_budget、content_state、pending_ids和partial，成功调用不代表每条读完；整条超预算按需改用旧get_note，不自动并发20次。不批量开放知识库共享权限。需note.batch_detail.v1。

按来源、引用资源或知识库查找笔记。列表只返回定位信息；少量个人笔记正文按需用get_notes，知识库共享笔记保持get_note原权限路径。新查询核对meta.capabilities、applied_filters并按pagination.next_cursor翻页；partial/warnings未解决时末页也不代表来源完整。书库无匹配可按note_type=ref列定位信息，在真实reference中核对书籍作者/书名/book_id；保留时间、平台和知识库范围，平台未知不自加dedao，一次发现最多5页，未遍历完说明未查完。book_info.author与reference.author冲突须分别标注，候选不直接认定作者身份。total_count=null表示未知。

获取指定笔记的详细内容，包括正文、标签、附件、音频转录、网页链接等。

字段语义说明（AI Agent 重要参考）： content 通常是 AI 总结，不一定是原文。不同类型笔记的原文字段如下：

• 引用笔记（ref）：原文 = note.ref_content，note.content 是个人评论

• 普通文字笔记（plain_text）：原文 = note.content

• 链接/网页笔记（link）：原文 = note.web_page.content，AI 总结 = note.content

• 录音笔记（audio/local_audio）：转写原文 = note.audio.original，AI 总结 = note.content

用户要求'读原文'时，先看 note.note_type，再按上述对应关系取字段。

直接读取笔记原文。引用笔记返回 ref_content，链接笔记返回网页原文，录音笔记返回转写原文，文字笔记返回正文；无原文或不支持的类型会报错。

直接读取录音台、录音卡及录音、会议或课堂笔记的转写原文；设备来源先用list_notes.source定位。没有转写时明确返回不可用，不用AI总结代替。

直接列出笔记中的图片、音频和文件附件，不需要从完整详情中猜字段。

直接读取录音或会议笔记的结构化时间线和原文资源；没有时间线时明确返回不可用。

读取总结中的独立章节时间线 chapter_timeline；start_ms 为毫秒，保留 source。与录音 moments 和标记分别读取，不能相互替代。

直接读取录音笔记的快捷笔记；没有快捷笔记时明确返回不可用。

读取从会议总结中明确的待办章节按规则解析出的条目。返回 source 和 items；空列表表示未识别到明确待办章节，不应让模型自由补写。

新建笔记（⚠️ 仅支持新建，不支持编辑已有笔记）。支持纯文本笔记（plain_text）、链接笔记（link）和图片笔记（img_text）。

🔗 笔记内链：Get笔记正文支持链接到其他笔记，格式为 https://biji.com/note/{note_id}。如需在笔记正文中引用其他笔记，按此格式填写 content 中的链接。若当前笔记后续会被分享出去，则应优先调用 share_note 工具获取被引用笔记的分享链接，并以分享链接替代内链写入正文。

图片笔记流程：先用 upload_image 上传图片获取 image_url，再调用此接口传入 image_urls。

返回值说明：

• plain_text：同步返回 id、title、created_at、updated_at。

• link（分享链接：biji.com/note/share_note/* 或 d.biji.com/* 短链）：同步返回 id、title、created_at、updated_at，无需轮询。

• link（普通链接）：返回 tasks 数组（每项含 task_id 和 url），需用 get_note_task_progress 轮询进度。

查询创建笔记任务的处理进度。用于链接笔记（note_type=link）创建后，通过 save_note 返回的 task_id 轮询任务状态，直到 status 变为 success（可获取 note_id）或 failed（可获取 error_msg）。建议每 10~30 秒轮询一次，约 3 分钟内完成。需要 note.content.read scope。

删除笔记（移入回收站）。需要 note.content.trash scope。

更新已有笔记的标题、内容或标签。⚠️ 仅支持 plain_text 类型笔记，链接笔记、图片笔记等暂不支持更新。至少需要传 title、content、tags 中的一个。tags 是替换操作，会覆盖原有标签。

为指定笔记添加标签。

删除笔记的指定标签（系统标签不可删除）。

获取用户创建、拥有或加入的知识库列表，默认DEFAULT；查书名/书籍作者显式scope=BOOKSPACE，query只匹配书名、author匹配书籍作者，二者AND，只有作者线索就只传author。返回topics[]、has_more、total，完整分页并核对book_info。无匹配且用户未限定只查自有时，用list_subscribe_topics保留全部条件补查；仍无匹配再按list_notes的引用来源路线补查，不能把空书库当账号没有划线。用户限定具体知识库时保留原范围；来源作者冲突保留为待核验候选。

创建新的知识库。⚠️ 限制：每天最多创建 50 个知识库，北京时间自然日 00:00 重置。

列出知识库内可访问的笔记，支持来源、引用资源、时间筛选。列表只返回定位信息；需要正文和完整元数据时调用 get_note。按 pagination.next_page 翻页；去重 ID，重复游标/页码、无进展或中途失败不能声称全量完成。

批量将笔记添加到知识库（每批最多 20 个）。

浏览知识库文件夹结构及当前目录下的笔记等资源。支持个人、书籍、客户档案和团队知识库。

在知识库中创建文件夹。

重命名或移动知识库文件夹。未提供的字段保持不变。

删除空的知识库文件夹。属于破坏性操作，调用前必须取得用户确认。

将笔记从知识库中移除。

读取笔记标记（包含文字标记、照片等），与 Timeline 独立，不用时间线替代标记。

按月份读取当前用户发芽报告；发芽不是标记数据。

读取已授权用户发芽报告原文，id 来自 list_sprouts。

上传前查询当前配置允许的文件扩展名、MIME、大小、页数和独立日限额；不缓存为固定格式列表。

仅查询原知识库文件上传凭据操作。保留已上传对象和同一笔记 client_request_id；保存遇限流不要重新上传。凭据敏感，不得放进聊天、日志或命令参数。任务 pending/processing 不等于完成。恢复仅查询原 operation_id，不能自动申请新 key。

仅查询原图片上传凭据操作。保留已上传对象和同一笔记 client_request_id；保存遇限流不要重新上传。凭据敏感，不得放进聊天、日志或命令参数。任务 pending/processing 不等于完成。恢复仅查询原 operation_id，不能自动申请新 key。

保留已上传对象和同一笔记 client_request_id；保存遇限流不要重新上传。凭据敏感，不得放进聊天、日志或命令参数。任务 pending/processing 不等于完成。恢复仅查询原 operation_id，不能自动申请新 key。获取一次 OSS 文件上传临时凭据。通过本地 getnote upload --token-file --max-size-bytes <能力上限> 直接 PUT 到 OSS，无需再次 CLI 登录。凭据通过受控文件或 stdin 传入，不写命令参数或聊天；不要把文件字节传给云 MCP。

保留已上传对象和同一笔记 client_request_id；保存遇限流不要重新上传。凭据敏感，不得放进聊天、日志或命令参数。任务 pending/processing 不等于完成。恢复仅查询原 operation_id，不能自动申请新 key。OSS 直传成功后将原文件加入知识库，只接收元数据，不接收本地路径或 base64。返回处理中的资源不等于入库成功；用 list_topic_directories 查询同一 ID，直到 SUCCESS 或 FAIL。

获取图片上传配置，包括支持的文件类型、大小限制等。上传图片前先调用此接口了解约束。

保留已上传对象和同一笔记 client_request_id；保存遇限流不要重新上传。凭据敏感，不得放进聊天、日志或命令参数。任务 pending/processing 不等于完成。恢复仅查询原 operation_id，不能自动申请新 key。获取 OSS 图片上传凭证。返回 accessid/host/policy/signature 等字段，用于 multipart/form-data POST 上传图片到阿里云 OSS。上传成功后获取 image_id，再用 save_note 创建图片笔记。⚠️ mime_type 必须与实际文件格式一致，否则 OSS 签名失败。

保留已上传对象和同一笔记 client_request_id；保存遇限流不要重新上传。凭据敏感，不得放进聊天、日志或命令参数。任务 pending/processing 不等于完成。恢复仅查询原 operation_id，不能自动申请新 key。上传图片到 OSS。返回 image_url（用于创建图片笔记的 image_urls 参数）。

获取知识库订阅的博主列表。需要 topic.blogger.read scope。

把抖音博主订阅到指定知识库，后续可读取该博主内容。

获取知识库中某个博主发布的内容列表（摘要，不含原文）。需要 topic.blogger.read scope。

获取博主内容详情，包含完整原文（post_media_text）。需要 topic.blogger.read scope。

获取知识库中已完成且 AI 已处理的直播列表。需要 topic.live.read scope。

获取直播详情，包含 AI 摘要（post_summary）和完整原文转写（post_media_text）。需要 topic.live.read scope。

订阅一个得到 App 直播到知识库。直播结束后经 AI 处理即可通过 list_topic_lives 查看。目前仅支持得到 App 直播链接。需要 topic.live.write scope。

生成笔记的公开分享链接。幂等接口，多次调用返回同一个 share_url。需要 note.sharing.write scope。

获取当前用户真实订阅的他人知识库，不含自己创建的库。默认DEFAULT；书籍显式BOOKSPACE，保留query/author/book_id及分页。自有书库无匹配时可补查这里；仍无匹配且用户未限定只查订阅库时，按list_notes的个人引用来源路线核对候选，保留已知平台/时间，不能把空库当没有笔记。返回topics[]、has_more、total。

查询当前 API Key 的调用配额，包括 read/write/write_note 三类的日/月剩余次数。

全局语义搜索：在所有笔记中进行语义召回。适用场景：「搜一下」「找找我哪些笔记提到了 XX」。返回结果按相关度从高到低排序。需要 note.recall.read scope。

知识库语义搜索：在指定知识库范围内进行语义召回。适用场景：「在我的 XX 知识库搜一下 XX」。返回结果按相关度从高到低排序。需要 note.topic.recall.read scope。