getnote-note

得到大脑笔记

通过官方 getnote CLI 完成真实操作。不要自己拼 OpenAPI 请求、ID 或笔记链接；机器调用优先使用 -o json，以退出码和下述结果契约判断结果。

统一结果判定

所有 API 命令的 JSON 结果先看下面这层结构，再读取每条命令规定的 data 字段：

{
  "success": true,
  "data": {},
  "request_id": "可选"
}

失败结果为 success=false 或命令退出码非 0，读取 error.code、error.message、error.reason、error.retryable 和可选 request_id。HTTP 成功、上传完成、出现任务 ID 或拿到空笔记链接，都不能替代最终成功结果。

意图路由

意图	命令入口
保存文字、链接或本地图片	getnote save
查询异步保存任务	getnote task
查看最近笔记	getnote notes
查看详情或字段	getnote note
链接/文字原文	getnote note original
录音、会议或课堂转写	getnote note transcript
图片、音频和文件附件	getnote note attachments
录音或会议时间线	getnote note timeline
录音快捷笔记	gnote note quick，旧版回退 getnote note quick-note
会议总结中的派生待办	getnote note todos
修改笔记	getnote note update
删除笔记	getnote note delete
公开分享	getnote note share

不确定参数时先运行目标命令 --help。

保存流程

文字与长文

1. 保留用户原意，不擅自扩写；未指定时不添加知识库、父笔记、标签或公开分享。
2. 短文本可作为参数传入。长文本、Markdown、含复杂引号或换行的内容必须使用 --content-file 或 --stdin，避免截断和转义损坏。
3. 重试同一次创建时复用同一个 --idempotency-key。
4. 只有命令退出码为 0，且最终结构中存在非空字符串 data.note.note_id、data.note.title、data.note.note_url，才回复保存成功。

链接

1. 以 http:// 或 https:// 开头且用户表达保存意图时按链接保存，不当作普通文字。
2. CLI 会轮询异步任务。处理中可以告诉用户“正在抓取并生成笔记”，但不能提前给出成功结论。
3. 最终成功必须满足文字保存的三项字段，并且 data.note 已能读取；不要自行拼接链接。

图片

1. 使用本轮用户明确给出的本地图片路径，不把文件名保存成文字，也不带上历史图片。
2. CLI 会校验真实文件格式、上传图片并轮询识别任务。
3. 只有最终笔记详情返回有效 note_id/title/note_url 才算成功；“图片已上传”不是“笔记已生成”。

异步超时与安全重试

• getnote save ... -o json 正常会等待最终结果；若退出码非 0 且输出含 task_id、status=pending|processing，操作结果仍不确定。
• 结果不确定时使用 getnote task <task_id> -o json 查询原任务。done|success 且有有效 note_id 后再读取笔记；failed 时展示 error_msg 或 msg。
• 超时、断流或网络错误后禁止直接再次保存；先查询原任务或最近笔记。只有 CLI/API 明确 retryable=true 且已确认原操作没有成功时才重试。

查询和深层读取

1. “最近、列表、有哪些”使用 getnote notes；“找、搜、关于某主题”交给搜索 Skill。
2. 用户给出 ID 时直接读取详情；雪花 ID 全程按字符串原样传递。“这条笔记”只复用当前会话中已经由 CLI 返回并验证过的字符串 ID。当前 CLI 若不能直接接收某种私有链接，就先请用户提供 ID，不能自行截取、猜测或转成数字。
3. 列表先展示标题、字符串 ID 和真实 note_url，用户选择后再读取全文。
4. 不确定笔记类型时先读 getnote note <id> -o json：
   • 链接/文字原文：original；
   • 录音、会议、课堂逐字稿：transcript；
   • 图片、音频、文件：attachments；
   • 时间点与会议过程：timeline；
   • 用户现场快捷记录：quick-note；
   • 会议待办：todos，必须保留 source，不得把规则解析结果说成上游原生待办。
5. 不拿 content 中的 AI 摘要冒充原文。