getnote-shared
/getnote-shared
使用 getnote CLI 前的共享基础规则:环境检查、CLI 安装、认证登录(浏览器 OAuth / API Key)、安全规则、笔记字段语义。使用 getnote 任何功能前必须先加载此技能。
- Author
- halojerry ↗
- Repository
- poundingcore ↗
- Licence
- Apache-2.0
- Last repository change
- 06.08.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 2
No signals detected. Repository changed on 06.08.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
What it does and when to use it
使用 getnote CLI 前的共享基础规则:环境检查、CLI 安装、认证登录(浏览器 OAuth / API Key)、安全规则、笔记字段语义。使用 getnote 任何功能前必须先加载此技能。
Original author description
使用 getnote CLI 前的共享基础规则:环境检查、CLI 安装、认证登录(浏览器 OAuth / API Key)、安全规则、笔记字段语义。使用 getnote 任何功能前必须先加载此技能。
How it works
- 环境准备
- 认证
- 输出格式
- 笔记字段语义
- 安全规则
- 异步任务
- 跨技能引用
SKILL.md preview
---
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` 或类似错误,**立即安装,无需询问用户**:
```bash
npm install -g @getnote/cli
```
安装完成后再次验证 `getnote --version`。
### 会员要求
GetNote OpenAPI **仅限会员使用**。如果命令返回 "OpenAPI 仅对会员开放" 的错误,告知用户在得到 App 或 [biji.com](https://biji.com) 购买会员。
## 认证
### 检查认证状态
```bash
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. **由你亲自执行**:`getnote auth login --api-key <api_key> --client-id <client_id>`
3. 验证:`getnote auth status`
4. **禁止缓存或存储用户的 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` — 标签管理
Versions
The database has no other skills named getnote-shared.
Database snapshot: 13.11.2026 · package version 0c42caaa4b33 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100getnote-kb
GetNote 知识库管理:列出/创建知识库、浏览笔记、添加/移除笔记、订阅知识库、博主内容、直播回放、配额查询。使用前先读 ../getnote-shared/SKILL.md。 - 85getnote
通过官方 getnote CLI 连接得到大脑,完成浏览器授权、连接诊断、CLI 升级,以及保存、查询、搜索和管理真实笔记。用户要按录音台或录音卡来源找笔记、保存链接/图片、上传文件到知识库、查询文件限制、读取标记/发芽报告/时间线、整理知识库/文件夹、订阅博主、管理标签,或明确要求登录、诊断或升级时使用;不会自行安装或更新 Skill。 - 100getnote-note
GetNote 笔记管理:保存链接/文本/图片、列表浏览、查看详情(区分原文与AI摘要)、更新标题/内容/标签、删除、分享。使用前先读 ../getnote-shared/SKILL.md。 - 100getnote-note
使用得到大脑保存文字、链接、图片和长笔记,按录音台或录音卡来源查找笔记,查看笔记详情、原文、录音转写、附件、时间线、标记、发芽报告、快捷笔记和会议待办,并安全更新、删除或分享笔记。标记、发芽与时间线分别读取。 - 90getnote-auth
安装和连接得到大脑,完成浏览器授权、环境诊断、配额检查、CLI 升级与领域 Skill 同步。用户说“安装/连接/登录/更新得到大脑”“检查为什么不能用”“查看额度”时使用。 - 90getnote
Save, search, list, and organize Get 笔记 notes, images, tags, and knowledge resources through the Get 笔记 OpenAPI. Use when storing text or links as notes, uploading an image into a note workflow, recalling prior notes, inspecting note details, managing tags or knowledge bases, or…