getnote-shared

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 登录，流程简单：

1. 由你亲自执行：getnote auth login
2. CLI 会自动打开浏览器，用户在浏览器中完成授权
3. 告知用户："请在弹出的浏览器窗口中完成得到笔记授权。完成后回复我，我会继续后续步骤。"
4. 结束本轮，等待用户确认完成
5. 用户确认后，验证认证状态：getnote auth status

API Key 登录

适用于无图形界面的环境：

1. 向用户索取 API Key 和 Client ID（敏感凭证，仅当轮使用）
2. 由你亲自执行：