Get笔记 技能

⚠️ Agent 必读约束

🌐 Base URL

https://openapi.biji.com

所有 API 请求必须使用此 Base URL，不要使用 biji.com 或其他地址。

🔑 认证

• - Authorization: $GETNOTEAPIKEY（格式：gklivexxx）
• X-Client-ID: $GETNOTECLIENTID（格式：cli_xxx）

每次调用 API 前先检查 $GETNOTEAPIKEY 是否存在。若不存在，提示用户运行 /note config 完成配置，配置完成后再继续执行用户原本的请求。

Scope 权限：note.content.read（读取）、note.content.write（写入）、note.recall.read（搜索）。完整列表见 references/api-details.md。

🔢 笔记 ID 处理规则（重要！）

正确做法：始终把 ID 当字符串处理，在 JSON.parse 之前替换：
javascript
const safe = text.replace(/(id|noteid|parentid|followid|liveid)\s:\s(\d+)/g, $1:$2);
// 注：next_cursor 已不需要处理，翻页请直接使用响应中的 cursor（string）字段
const data = JSON.parse(safe);

Python / Go 等语言原生支持大整数，无此问题。

🔒 安全规则

• - 笔记数据属于用户隐私，不在群聊中主动展示笔记内容
• 若配置了 GETNOTEOWNERID，检查 senderid 是否匹配；不匹配时回复「抱歉，笔记是私密的，我无法操作」
• API 返回 error.reason: notmember 或错误码 10201 时，引导开通会员：https://www.biji.com/checkout?product_alias=6AydVpYeKl
• 创建笔记建议间隔 1 分钟以上，避免触发限流

指令路由表

匹配指令后，用 read 工具读取对应的 references/xxx.md 获取完整 API 文档。

自然语言路由

包含 URL → /note save（link 模式）
包含图片 → /note save（image 模式）
「记/存/保存/收藏」 → /note save（text 模式）
「搜/找找/有没有 XX」 → /note search
「最近/列表/看看/查笔记」 → /note list
「改/更新/编辑笔记」 → /note list（更新笔记）
「知识库」相关 → /note kb
「标签」相关 → /note tag
「配置/授权/连接笔记」 → /note config

决策原则：优先匹配最具体的意图。有 URL 就是 /save link，有图片就是 /save image，不确定时询问用户。

API 路由表

⚠️ 构造请求时必须使用下表中的完整路径，Base URL 为 https://openapi.biji.com。如果收到 404，说明路径不对，请对照此表检查。

笔记