Getnote Note

getnote-note 技能

管理 Get笔记 中的笔记：保存、列表、查看、更新、删除、分享。

使用前先读 ../getnote-shared/SKILL.md（认证、字段语义、安全规则）。

命令

保存笔记

getnote save <url|text|image_path> [--title <title>] [--tag <tag>]...

• URL（http:// 或 https://）→ 链接笔记：
  • 分享链接（biji.com/note/share_note/* 或 d.biji.com/* 短链接）→ 同步，直接返回 note_id
  • 内部笔记链接（biji.com/note/{note_id}）→ 用于笔记内容中引用其他笔记；如当前笔记将公开发布，优先使用被引用笔记的分享链接
  • 其他 URL → 异步，自动轮询直到完成
• 本地图片路径 → 图片笔记（异步）
• 其他 → 文字笔记（同步）

getnote save https://example.com --title "好文章"
getnote save "记得查看文档" --tag 工作 --tag 重要
getnote save ./screenshot.png --title "设计稿"

使用 -o json 时静默轮询并返回最终笔记 JSON（含 title、content、note_type、tags、created_at）。

跟踪保存任务

getnote task <task_id>

手动检查异步保存任务进度。

getnote task task_xyz789 -o json

返回 status（pending / processing / success / failed），完成后含 note_id。

列表浏览

getnote notes [--since-id <id>] [--all]

每页固定 20 条，无 --limit 参数。

getnote notes
getnote notes --all
getnote notes --since-id 1234567890
getnote notes -o json

笔记类型：plain_text / img_text / link / audio / meeting / local_audio / internal_record / class_audio / recorder_audio / recorder_flash_audio

查看详情

getnote note <id> [--field <field>]

返回完整笔记（含内容、标签、附件）。--field 提取单个字段。

getnote note 1234567890
getnote note 1234567890 --field content
getnote note 1234567890 --field url
getnote note 1234567890 -o json

更新笔记

getnote note update <id> [--title <title>] [--content <content>] [--tag <tags>]

getnote note update 1234567890 --title "新标题"
getnote note update 1234567890 --tag "工作,重要"

⚠️ --tag 替换全部标签。部分修改请用 getnote tag add/remove。 ⚠️ 内容更新仅适用于 plain_text 笔记。

删除笔记

getnote note delete <id> [-y]

移至回收站。

getnote note delete 1234567890 -y

分享笔记

getnote note share <id> [--exclude-audio]

生成公开分享链接。幂等操作——多次调用返回相同 URL。

getnote note share 1234567890
getnote note share 1234567890 --exclude-audio
getnote note share 1234567890 -o json

返回：share_url（如 https://biji.com/note/share_note/rBzdMlXrzgYVM）

Agent 使用注意事项

• 优先用 -o json 解析响应
• 大部分 JSON 响应格式为 {"success":true,"data":{...}}，例外：
  • save(文字)：{"note_id":"..."} 直接返回
  • save(分享链接)：{"note_id":"...","title":"...","created_at":"...","updated_at":"..."} 直接返回
  • save(普通链接/图片)：{"data":{"tasks":[{"task_id":"..."}],...}}
  • task：{"success":true,"data":{"status":"...","note_id":"..."}}
• notes 列表每页 20 条；用 --since-id 翻页
• note ID 为 int64，处理时当字符串避免 JS 精度丢失
• 退出码 0 = 成功，非零 = 错误，stderr 输出错误详情

字段语义（"原文" vs AI 摘要）

不同笔记类型的"原文"字段不同，content 通常是 AI 摘要而非原文。用户要求"读原文"时，先用 getnote note <id> -o json 查看 note_type，再按下表选择：