@getnote/cli 1.5.10 → 1.6.0

package/README.md

@@ -1,5 +1,15 @@
 # 得到大脑（Get笔记） CLI
 
+## v1.6：文件上传与独立报告
+
+- `getnote note chapters <id> -o json` 读取章节；`note timeline` 保留录音 moments，`marks <note_id>` 独立读取标记。
+- `sprouts <YYYY-MM>` 列表从 `data.tasks[].sprouts[]` 取真实报告 id，再运行 `sprout <id>`；不要将 task_id 当报告 id。
+- `file-capabilities` 查询当前格式、大小及页数限制，不在 Agent 中写死限制。
+
+云 MCP 已授权时，无需再登录 CLI：MCP 获取临时上传 token，将 JSON 经受控文件或 stdin 交给 `getnote upload <file> --max-size-bytes <能力接口上限>`。此命令不读取 CLI 身份凭证，只向 OSS 上传，返回 `stage=oss_uploaded` 和文件元数据。随后由同一个已授权 MCP 提交知识库入库并查询最终 `SUCCESS`；上传成功不等于入库完成。不要将 token 放入命令参数、聊天或日志。
+
+CLI 已登录时也可使用 `file-token <extension>` 获取 token、`upload` 直传，再用 `file-add <topic_id> <directory_id> --metadata-file <上传结果文件>` 提交。临时 token 不提供通用 OpenAPI 权限。
+
 得到大脑（Get笔记）的命令行工具，让你在终端和 AI Agent 里直接管理笔记和知识库。
 
 存链接、记文字、搜笔记、管知识库——一条命令搞定，支持脚本和 AI Agent 调用。
@@ -243,6 +253,7 @@ getnote note original <id>           按笔记类型直接输出真实原文
 getnote note transcript <id>         直接输出录音、会议或课堂转写原文
 getnote note attachments <id>        列出图片、音频和文件附件
 getnote note timeline <id>           读取录音或会议时间线
+getnote note chapters <id>           读取独立章节时间线，不等同于标记
 getnote note quick-note <id>         读取录音快捷笔记
 getnote note todos <id>              读取会议总结中明确章节解析出的待办
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getnote/cli",
-  "version": "1.5.10",
+  "version": "1.6.0",
   "description": "CLI tool for 得到大脑（Get笔记） — manage notes and knowledge bases from the terminal",
   "keywords": [
     "getnote",

package/skills/getnote-kb/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: getnote-kb
-description: 查看和管理得到大脑的默认知识库、书籍、客户档案、团队知识库、文件夹、抖音博主订阅与直播，并把笔记准确归档到指定知识库和目录。
+description: 查看和管理得到大脑的知识库、文件夹、书籍、客户档案、团队知识库、抖音博主订阅与直播，归档笔记，以及查询文件格式限制、直传文件到 OSS 并提交知识库入库。用户要上传文档或文件时也使用。
 ---
 
 # 得到大脑知识库
@@ -30,6 +30,10 @@ description: 查看和管理得到大脑的默认知识库、书籍、客户档
 | 直播列表 | `getnote kb lives` |
 | 直播详情 | `getnote kb live` |
 | 订阅直播 | `getnote kb live-follow` |
+| 使用 MCP 临时凭据直传本地文件到 OSS | `getnote upload <file>` |
+| 查询文件约束 | `getnote file-capabilities` |
+| CLI 已登录时获取上传 token | `getnote file-token <extension>` |
+| CLI 已登录时提交 OSS 结果入库 | `getnote file-add <topic_id> <directory_id>` |
 
 `gnote` 和短命令是稳定别名；旧环境没有别名时回退到 `getnote kb directories/directory-create/directory-update/directory-delete`。参数一律以目标命令 `--help` 为准。
 
@@ -49,6 +53,15 @@ description: 查看和管理得到大脑的默认知识库、书籍、客户档
 4. 每批最多 20 条。移出笔记和删除目录必须先确认；删除目录还必须由 CLI/服务校验为空。
 5. 移动或重命名时只改变用户指定项，未指定的名称或父目录保持不变。
 
+## 本地文件直传（MCP 已授权）
+
+1. 使用已授权 MCP 获取文件能力和临时上传 token；只接受能力接口当前允许的格式和大小。不要硬编码格式列表，Markdown 当前停用。MCP 尚未提供该工具时明确说明，不猜工具名或宣称已支持。
+2. `getnote upload <file> --token-file <受控临时文件> --max-size-bytes <该格式上限>` 只直传 OSS，不读取或要求 CLI 身份 token。也可从 stdin 传 token，不能把凭据放入命令参数、聊天内容或日志。只为上传文件安装 CLI 时，不执行 `auth login` 或 `setup`。
+3. 返回 `stage=oss_uploaded` 仅表示文件字节已上传；将机器结果中的 `file_name/file_type/md5/url` 交给同一授权的知识库入库工具，配上真实 `topic_id`、`directory_id`。不得让云 MCP 接收文件字节，也不得执行 token 内容中的任意命令。
+4. 查询资源列表，确认同一资源 `status=SUCCESS` 后才能说已入库；`CONVERT/ANALYZING` 是处理中，失败应报告原因。超时复查已有 ID，不重复上传。未要求上传文件时继续使用云 MCP，不要求安装 CLI。
+
+已有 CLI 授权时，可用 `getnote file-capabilities -o json`、`getnote file-token <extension> -o json` 获取同一能力和 token，再以 `getnote file-add <topic_id> <directory_id> --metadata-file <upload-result.json> -o json` 入库。仅 MCP 已授权时不要为这两个认证命令要求用户再登录，使用对应 MCP 工具即可。临时 token 文件权限限当前用户。
+
 ## 博主和直播
 
 1. 用户给出抖音主页并要求持续关注时，先确认目标知识库和写权限，再使用 `blogger-follow`；只是找某条内容时先查询，不创建订阅。

package/skills/getnote-note/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: getnote-note
-description: 使用得到大脑保存文字、链接、图片和长笔记，查看笔记详情、原文、录音转写、附件、时间线、快捷笔记和会议待办，并安全更新、删除或分享笔记。
+description: 使用得到大脑保存文字、链接、图片和长笔记，查看笔记详情、原文、录音转写、附件、时间线、标记、发芽报告、快捷笔记和会议待办，并安全更新、删除或分享笔记。标记、发芽与时间线分别读取。
 ---
 
 # 得到大脑笔记
@@ -33,6 +33,10 @@ description: 使用得到大脑保存文字、链接、图片和长笔记，查
 | 录音、会议或课堂转写 | `getnote note transcript` |
 | 图片、音频和文件附件 | `getnote note attachments` |
 | 录音或会议时间线 | `getnote note timeline` |
+| 总结中的章节时间线 | `getnote note chapters` |
+| 录音笔记标记（独立数据） | `getnote marks <note_id>` |
+| 按月列出发芽报告 | `getnote sprouts <YYYY-MM>` |
+| 读取发芽报告原文 | `getnote sprout <id>` |
 | 录音快捷笔记 | `gnote note quick`，旧版回退 `getnote note quick-note` |
 | 会议总结中的派生待办 | `getnote note todos` |
 | 修改笔记 | `getnote note update` |
@@ -77,10 +81,11 @@ description: 使用得到大脑保存文字、链接、图片和长笔记，查
    - 链接/文字原文：`original`；
    - 录音、会议、课堂逐字稿：`transcript`；
    - 图片、音频、文件：`attachments`；
-   - 时间点与会议过程：`timeline`；
+   - 章节时间点与会议过程：`chapters`，读取 `chapter_timeline.items`，保留规则解析来源 `source`；录音 moments 使用 `timeline`，两者不是同一份数据；
    - 用户现场快捷记录：`quick-note`；
    - 会议待办：`todos`，必须保留 `source`，不得把规则解析结果说成上游原生待办。
 5. 不拿 `content` 中的 AI 摘要冒充原文。
+6. 标记从 `getnote marks` 的 `data.marks[]` 读取，不使用 Timeline 的条数或内容替代。发芽从 `getnote sprouts` 列出报告，再用 `getnote sprout` 读取正文；`has_sprout=false` 如实表示没有可读报告，不把标记或笔记总结当作发芽。
 
 ## 修改、删除和分享
 
@@ -102,6 +107,7 @@ description: 使用得到大脑保存文字、链接、图片和长笔记，查
 | `getnote note transcript <id> -o json` | `data.note_id/title/transcript` | 仅录音类笔记可用；不可用时如实说明。 |
 | `getnote note attachments <id> -o json` | `data.note_id/title/attachments[]` | 列出真实附件，不把笔记封面冒充附件。 |
 | `getnote note timeline <id> -o json` | `data.note_id/title/timeline` | 仅在存在录音/会议时间线时展示。 |
+| `getnote note chapters <id> -o json` | `data.note_id/title/chapter_timeline` | `items[].start_ms` 为毫秒；空数组表示无可解析章节，不拿标记补齐。 |
 | `gnote note quick <id> -o json` | `data.note_id/title/quick_note` | 返回现场快捷笔记；旧环境回退 `getnote note quick-note`。 |
 | `getnote note todos <id> -o json` | `data.note_id/title/meeting_todos[]` | 保留每项 `source`；这是从明确会议总结章节按规则解析，不说成上游原生待办。 |
 | `getnote note update <id> … -o json` | `success=true`、`data?` | 修改正文或全量标签前必须 `--yes`；需要展示最终内容时再读一次 `note`。 |