得到大脑笔记

通过官方 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 notes batch
查看详情或字段	getnote note
引用/链接/文字原文	getnote note original
录音、会议或课堂转写	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
删除笔记	getnote note delete
公开分享	getnote note share

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

录音台与录音卡来源定位

设备来源与笔记类型是两个独立条件。用户明确说“录音台”“AI录音台”“墨案/MOAN录音台”时使用 --source vendor_moan；“录音卡”“GetSeed录音卡”使用 --source getseed。查设备全部笔记时只限定来源，不额外加 --note-type audio 或 meeting，避免漏掉其他实际类型；录音卡长录音和闪念也由同一个 getseed 来源覆盖。用户明确只要长录音/闪念时，才分别叠加 recorder_audio / recorder_flash_audio。

getnote notes --source vendor_moan --page-size 20 --all -o json
getnote notes --source getseed --page-size 20 --all -o json

“昨天/上周的录音台笔记”同时保留对应 --created-from/to，按用户时区换算为 RFC3339，from 包含、to 不包含；明确修改时间才改用 edited 或 record-updated。翻页始终保留 source、时间、知识库等原条件，核对 applied_filters.source 和每条笔记的 source，按真实游标继续并按字符串 note_id 去重。仅在遍历结束、没有未解决的 partial/warnings 或错误时，才能说当前授权范围已遍历；旧 total 不是设备范围的总条数。

结果只涵盖已经同步成笔记且当前账号有权读取的主笔记，不代表设备端未同步、尚未形成笔记的全部会议记录。空结果不能改查其他来源后声称完成，不能用“AI录音台”标签或标题猜来源。只说“录音笔记”而未限定设备时不加 vendor_moan/getseed；按已知录音模式核对真实类型，模式不明时保留不同类型候选并说明范围。

来源内有正文主题时，先在该来源和时间范围列出候选，再按需读取目标正文核实；search 不提供设备来源筛选，不能把全局 Top-K 后过滤当作该设备完整搜索。录音台/录音卡转写使用 getnote note transcript '<note_id>' -o json，不把 AI 总结、preview 或缺失转写当作原文。

来源筛选、轻量定位与原文

列表接口只返回定位信息，再用详情接口读取完整笔记。display_title 是展示标题，不覆盖原始 title；引用笔记空标题很正常。preview 是带来源和截断标记的定位片段，不是全文。

getnote notes --source dedao --note-type ref --page-size 20 -o json
getnote note '<note_id>' -o json
getnote note original '<note_id>' -o json

note_type	原文字段	content 的语义
ref	ref_content	用户评论，不是引用原文
plain_text	content	用户正文
link	web_page.content	通常是摘要
audio / local_audio	audio.original	通常是摘要

录音按真实类型选择：即时录音/普通录音用 --note-type audio，上传的音频文件用 local_audio，自己录制的课堂笔记用 class_audio，会议录音用 meeting，系统内录用 internal_record，录音卡长录音/闪念分别用 recorder_audio / recorder_flash_audio。这些类型与得到课程引用不同；用户未限定平台时不加 --source dedao 或课程筛选。只说“录音”且模式不明时保留候选并说明类型，不能把上传音频当即时录音。

getnote notes --note-type audio --all -o json
getnote notes --note-type local_audio --all -o json

original 只按真实类型读取上述字段，并返回 original_source；原文缺失或类型不支持会报错，不能把评论或定位片段补成原文。列表中的 content_state 会标明正文被省略；详情接口返回完整正文和元数据。用 metadata_state.reference/topics 区分完整、部分、不可用的元数据；缺失的作者、书 ID、来源 URL 不猜测补写。

得到课程无需知识库：已知课程名/老师时先按搜索 Skill 执行 getnote references list --source dedao --resource-type course --query '<课程名>' --all -o json，再用真实课程容器身份筛选；author 精确匹配老师，query 可显式 prefix。同名版本先消歧，topics=[] 不阻断；不要求用户提供内部 ID。

getnote notes --source dedao --course-type '<course_type>' --course-id '<course_id>' --note-type ref --all -o json

课程容器身份是 course_type+course_id；当前66，不能用课节65的 resource_id 代替。课程筛选包含课程直接引用和所属课节，增量 reference.course 不改旧 resource_id。首版 course+topic_id 不支持，不用个人笔记冒充知识库交集。新能力缺失时报告不支持，不删除筛选继续查询。

单篇文稿已有真实 reference ID 或文章 URL 时继续使用旧精确筛选：

getnote notes --source dedao --note-type ref --reference-type course_article --reference-id '<reference.resource_id>' --all -o json
# 缺少资源 ID，但有 reference.article.url 时，可改用精确文章 URL
getnote notes --source dedao --note-type ref --article-url '<reference.article.url>' --all -o json

平台值取 reference.source；资源类型取 reference.resource_type，不要用标签或内部 ptype 猜枚举。--reference-id 必须同时传 --source 和 --reference-type。课程文稿的 resource_id 指向单篇文稿，课程筛选再加 reference-id 时取交集。resource_id、course_id、original_note_id、书 ID 与笔记 ID 是不同身份；全程用返回的字符串。课程主页不传到 --article-url，也不解析编码 ID；文章 URL 保留 query/fragment。同篇文稿的不同笔记 ID 仍是不同划线。

创建、正文编辑、记录更新是三个独立时间轴。按需使用 --created-from/to、--edited-from/to、--record-updated-from/to，值必须为带时区 RFC3339；区间 from 包含、to 不包含。不得把 updated_at 当正文编辑时间。“今天/上周”按用户当前日期和时区换算边界；保存时间不是文章发布日期，不把“最近”擅自解释成固定一个月。用户同时限定课程/知识库时保留这些条件。

新参数需要服务端对应 meta.capabilities 且 applied_filters 与请求一致；不支持时停止该查询并说明升级服务/客户端的需要，不自动移除筛选。全量按知识库参考中的分页规则验收；只拿一页或一次语义搜索，不能说“全部找到”。

分页结束与来源完整性分别判断：partial=true、warnings、候选 metadata_state=partial 仍须说明。特别是 course_directory_no_lessons 表示课程目录缺少课节，即使 has_more=false 或 traversal.completed=true 也不能保证找全老师的所有课程；保留已找到的真实结果和缺口，不通过删除筛选或重复同一请求消除警告。

有预算的批量正文读取

不超过20个已定位个人笔记用 getnote notes batch '<note_id_1>' '<note_id_2>' --fields original -o json。默认 fields=content,ref_content,reference；original 显式选择，引用原文来自 ref_content，个人评论来自 content。默认32000个Unicode码点，--max-total-chars 可设1..64000，服务端另有1MiB上限；不是给旧单条详情加截断。

退出码0和 success=true 只代表批量调用成功：逐条检查 status=ok/unavailable/failed/deferred_budget、content_state、partial、pending_ids。成功项正文完整，deferred_budget 整条待读，不能把 omitted 当空正文；未知未来状态原样保留并说明未确认。用户确需全文时再用旧 getnote note original '<真实note_id>' -o json 补读，不自动并发20次单条请求。不存在与无权统一 unavailable，不判断对象是否存在；首版不批量读知识库共享笔记，不绕过原单条权限。

参数错误读取 field/supported_values；限流保留 retry_after_seconds。CLI 已对已知只读瞬时429做最多额外2次、累计等待5秒重试；Agent 不叠加重试，日/月配额、写操作与上传凭证不自动重试。

保存流程

文字与长文