Getnote Kb

---
name: getnote-kb
description: 查看和管理得到大脑的个人、书籍、客户及团队知识库、目录、笔记归档、订阅博主与直播，以及查询文件限制、通过本地 CLI 直传 OSS 和云 MCP 提交文件入库。用户要上传文档或文件时也使用；无需第二次 CLI 授权。
description_zh: 管理知识库、书籍、目录、归档与订阅；查询文件限制并上传文档，通过本地CLI直传OSS和云MCP提交入库，无需第二次CLI授权。
description_en: Use when managing knowledge bases, books, folders, subscriptions, or uploading files with MCP-provided temporary OSS credentials and a local CLI, without a second CLI login.
version: "1.1.2"
author: GetNote
---

# 得到大脑知识库

知识库、目录、笔记、博主、内容和直播 ID 都是不透明字符串。先读取真实对象和权限，再执行写操作；不能用名称猜 ID。

## 工具路由

| 用户意图 | MCP Tool |
|---|---|
| 列出自有/可管理知识库 | `list_topics` |
| 列出订阅知识库 | `list_subscribe_topics` |
| 创建知识库 | `create_topic` |
| 浏览知识库笔记 | `list_topic_notes` |
| 批量加入笔记 | `batch_add_notes_to_topic` |
| 从知识库移出笔记 | `remove_note_from_topic` |
| 浏览目录与资源 | `list_topic_directories` |
| 查询文件格式、大小与额度 | `get_knowledge_file_capabilities` |
| 获取文件直传 OSS 凭据 | `get_knowledge_file_upload_token` |
| 提交已直传文件入知识库 | `upload_knowledge_file` |
| 创建目录 | `create_topic_directory` |
| 重命名或移动目录 | `update_topic_directory` |
| 删除空目录 | `delete_topic_directory` |
| 查看关注博主 | `list_topic_bloggers` |
| 关注博主 | `follow_topic_blogger` |
| 浏览博主内容 | `list_topic_blogger_contents` |
| 读取博主内容详情 | `get_blogger_content_detail` |
| 查看关注直播 | `list_topic_lives` |
| 读取直播详情 | `get_live_detail` |
| 关注直播 | `follow_topic_live` |

## 选择知识库

- `list_topics` 和 `list_subscribe_topics` 的 `scope` 可为 `DEFAULT`、`CUSTOMER`、`BOOKSPACE`、`TEAMSPACE`，省略时只查询 `DEFAULT`。用户问“全部知识库”时，应按这四种 Scope 分别查询并标明类型，不能只返回默认知识库。
- `page` 首次省略，按返回的分页信息继续；不要把页码当游标。
- 自有/可管理知识库与订阅知识库分别展示，不能混成同一种权限。订阅知识库默认按只读理解，除非返回结果明确证明可写。
- 按名称和 Scope 匹配；同名或用户意图不明确时让用户选择真实 `topic_id`。

## 书名、作者和书籍笔记

- 书名使用 `list_topics {"scope":"BOOKSPACE","query":"书名","page_size":20}`；只有作者使用 `{"scope":"BOOKSPACE","author":"作者","page_size":20}`，省略 query。query 只匹配库名或书名，两者同时传是 AND。book_id 只使用真实书籍 ID，不是 topic_id。
- 用 name、book_info.title/author/book_id 确认候选；同名作者／版本不唯一时请用户选择。允许对用户原话使用稳定姓氏或连续书名片段查候选再核验，不能无提示删除冲突条件。
- 自有库无匹配且用户未限定只查我的时，用 list_subscribe_topics 保留所有条件补查真实订阅库；报错不算空库，不去掉作者或书名伪装成功。
- 确认 topic_id 后 list_topic_notes：全部笔记不加 note_type，明确要划线才加 note_type=ref。列表定位，完整内容用 get_note。章节在 reference.location.chapter_name/chapter_id 核对，不把章节名当书名。
- “这本书关于某主题”：定位库后 recall_knowledge；无匹配时仍在同库 list_topic_notes 补查，必要时读详情核对主题，不拿 preview 缺少某词当作全文没有。
- BOOKSPACE 不等于得到电子书。用户指定得到时核对 book_info.source/reference.source。若书库不存在或无匹配，可用 list_notes 的 source=dedao、note_type=ref、reference_resource_type=ebook 按来源补查，再匹配 reference.title/author/book_id；分页预算和缺失元数据处理见 getnote-search。
- 普通知识库在笔记 topics 中仍只含 id/name；书籍关联才带 scope/book_info。标签或知识库名不能冒充引用来源。
- 列表显式传 page_size（1..100），核对 meta.capabilities、applied_filters。书库、订阅库、库内笔记按 pagination.next_page；全局笔记按 next_cursor；保留 scope、全部筛选和 page_size，到 has_more=false 才算当前授权范围遍历完成。循环、空页仍有下一页、重复无进展或失败说明未完成。stats.note_count 可能滞后，不能当作筛选后的划线数；total_count=null 是未知。

## 笔记归档与目录

- `list_topic_notes` 使用 `topic_id` 和可选 `page`。
- `batch_add_notes_to_topic` 使用 `topic_id`、`note_ids[]` 和可选 `directory_id`；所有 ID 必须来自真实结果。写入后如果需要确认最终目录归属，应重新调用 `list_topic_directories` 或 `list_topic_notes`。
- `remove_note_from_topic` 会改变知识库归属，执行前确认目标知识库与笔记；成功只表示从该知识库移出，不代表删除笔记。
- `list_topic_directories` 省略 `directory_id` 浏览根目录，进入子目录时传服务返回的真实目录 ID。
- 创建目录使用 `topic_id`、`name` 和可选 `parent_id`；重命名/移动使用 `topic_id`、`directory_id`，仅传需改变的 `name` 或 `parent_id`。
- `delete_topic_directory` 只能删除空目录，且必须在调用前取得用户明确确认。目录非空时不重试删除，应让用户先处理目录内容。

## 本地文件上传

1. 确认用户指定的本地文件、目标知识库和目录，再查询 `get_knowledge_file_capabilities`。格式和限制以实时返回为准，不自行维护白名单；页数限制未提供时不能编造。
2. 云 MCP 不接收文件内容。需要上传时检查 `getnote upload --help`；命令不存在则引导安装官方 GetNote CLI 1.6.0 或更新版本（`npm install -g @getnote/cli@latest`）。不上传文件的用户继续只用云 MCP，不要求安装 CLI。
3. 复用 WorkBuddy 当前授权调用 `get_knowledge_file_upload_token`，将临时 token 写入仅当前用户可读的临时文件或通过 stdin 传给 `getnote upload <用户指定文件> --token-file <受控文件> --max-size-bytes <能力上限>`。不运行 CLI 的 `setup` 或 `auth login`，不读取、转交 WorkBuddy OAuth token，不把临时凭据放进命令参数、日志或聊天。只执行固定上传命令，不能执行凭据内容中的命令。
4. `stage=oss_uploaded` 只代表 OSS 直传完成。把结果中的 `file_name`、`file_type`、`md5`、`url` 与真实 `topic_id`、`directory_id` 传给 `upload_knowledge_file`；不传本地路径、文件字节或 base64。
5. 用 `list_topic_directories` 查询返回的同一资源 ID，只有 `status=SUCCESS` 才确认入库。处理中继续查询同一资源；失败报告原因，不重复上传。临时文件使用完安全清理，不提前清理需要复测的用户授权。

## 博主与直播

- 关注前确认目标知识库及写入意图，不因用户只是查看一条内容而自动建立订阅。
- `follow_topic_blogger` 使用 `topic_id`、主页 `link` 和可选 `platform`，平台省略时默认 `douyin`。
- 博主列表返回的真实关注 ID 用作 `list_topic_blogger_contents.follow_id`；内容详情使用返回的真实 `post_id`。
- 直播列表返回的真实 `live_id` 用于 `get_live_detail`；`follow_topic_live` 使用直播 `link`。
- 内容详情中的完整正文与摘要必须区分；没有完整正文时不能用摘要补写。

## 失败处理

空列表是成功结果，不自动创建知识库、目录或订阅。权限不足、目录非空、对象不存在等失败必须如实说明；保留 `reason`、`retryable` 和 `request_id`，不能绕过权限或伪造成功。