| name | getnote-shared |
| version | 1.0.0 |
| description | 使用 getnote CLI 前的共享基础规则：环境检查、CLI 安装、认证登录（浏览器 OAuth / API Key）、安全规则、笔记字段语义。使用 getnote 任何功能前必须先加载此技能。 |
| metadata | {"requires":{"bins":["getnote"]}} |
getnote 共享规则
本技能是所有 GetNote（得到笔记）技能的基础，定义了环境准备、认证、安全规则和跨领域注意事项。
环境准备
检查 getnote CLI
每次使用前先检查 getnote --version。如果输出 command not found 或类似错误，立即安装，无需询问用户：
npm install -g @getnote/cli
安装完成后再次验证 getnote --version。
会员要求
GetNote OpenAPI 仅限会员使用。如果命令返回 "OpenAPI 仅对会员开放" 的错误，告知用户在得到 App 或 biji.com 购买会员。
认证
检查认证状态
getnote auth status
浏览器 OAuth 登录（推荐）
GetNote CLI 支持浏览器 OAuth 登录，流程简单：
- 由你亲自执行：
getnote auth login
- CLI 会自动打开浏览器，用户在浏览器中完成授权
- 告知用户："请在弹出的浏览器窗口中完成得到笔记授权。完成后回复我，我会继续后续步骤。"
- 结束本轮，等待用户确认完成
- 用户确认后，验证认证状态：
getnote auth status
API Key 登录
适用于无图形界面的环境：
- 向用户索取 API Key 和 Client ID（敏感凭证，仅当轮使用）
- 由你亲自执行：
getnote auth login --api-key <api_key> --client-id <client_id>
- 验证：
getnote auth status
- 禁止缓存或存储用户的 API Key 和 Client ID
API Key 获取地址：https://www.biji.com/settings/developer（Key 以 gk_live_ 开头）
登出
切换账号时：getnote auth logout
输出格式
所有 getnote 命令都支持 -o json 以 JSON 格式输出。解析结果时优先使用 -o json。
响应结构：
- 大部分命令：
{"success": true, "data": {...}}
search：{"success": true, "results": [...]}（results 在顶层，非 data 下）save（文本）：{"note_id": "..."} 直接返回save（分享链接）：{"note_id": "...", "title": "...", ...} 直接返回tag list -o json：{"note_id": "...", "tags": [...]}（无 success 包装）
笔记字段语义
content 字段通常是 AI 摘要，不是原文。用户要求"读原文"时，先查 note_type，按下表选择正确字段：
| 笔记类型 | 原文/原始内容字段 | AI 摘要字段 |
|---|
普通文字 (plain_text) | content | content |
链接/网页 (link) | web_content | content |
录音 (audio) | audio_original | content |
| 知识库博主文章 | post_media_text（通过 kb blogger-content） | content |
| 知识库直播 | post_media_text（通过 kb live） | post_summary |
安全规则
- 禁止输出密钥：API Key、Client ID 等绝不输出到对话中
- 写入/删除前确认：删除笔记、从知识库移除内容等操作前必须确认用户意图
- 不缓存凭证：API Key 仅在当轮使用，不存入上下文
- 限额提示：知识库创建每天 50 个上限，搜索最多 10 条结果，注意提示用户
异步任务
保存链接和图片等操作会产生异步任务。使用 getnote task <task_id> 检查进度：
pending / processing → 继续等待success → 获取 note_id 进行后续操作failed → 报告错误
跨技能引用
其他 getnote 技能通过相对路径引用本技能：
../getnote-auth/SKILL.md — 认证详细操作../getnote-note/SKILL.md — 笔记管理../getnote-kb/SKILL.md — 知识库管理../getnote-search/SKILL.md — 语义搜索../getnote-tag/SKILL.md — 标签管理
