用途:通过官方 getnote CLI 对得到大脑笔记做真实增删改查,不自行拼 OpenAPI 请求、ID 或笔记链接;机器调用优先用 -o json,以退出码和结果契约判断成败。
主要能力:save 保存文字/链接/本地图片,task 查询异步保存任务;notes 列最近笔记;note 读详情,note original 读引用/链接/文字原文,transcript 读录音转写,attachments 读附件,timeline 读录音会议时间线,chapters 读总结章节,quick-note 读快捷笔记,todos 读会议待办;marks 读录音标记,sprouts/sprout 读发芽报告;update/delete/share 修改、删除、公开分享。
使用方式:不确定参数先运行目标命令 --help。结果结构为 success、data、request_id,失败读 error.code/message/reason/retryable。长文本或 Markdown 必须用 --content-file 或 --stdin;重试同一次创建复用同一 --idempotency-key。时间筛选须用带时区 RFC3339,区间 from 包含、to 不包含。来源筛选示例:getnote notes --source dedao --note-type ref --page-size 20 -o json;引用定位可用 getnote notes --source dedao --note-type ref --reference-type course_article --reference-id '<reference.resource_id>' --all -o json。
限制:HTTP 200、上传完成或任务 ID 不等于成功;只有非空 note_id/title/note_url 才算保存成功。original 不可用时不得用评论或摘要补全;“图片已上传”不等于“笔记已生成”。覆盖正文、替换标签、删除和公开分享须先确认再用 --yes;删除仅移入回收站。分享录音需说明是否含音频,可用 --exclude-audio。新筛选依赖服务端 meta.capabilities,不支持时应停止查询并说明,不自动移除筛选。笔记 ID 全程按字符串传递。