Skip to content
Skills Library
Personal productivity · Tool integration

getnote-shared

/getnote-shared

使用 getnote CLI 前的共享基础规则:环境检查、CLI 安装、认证登录(浏览器 OAuth / API Key)、安全规则、笔记字段语义。使用 getnote 任何功能前必须先加载此技能。

Licence
Apache-2.0
Last repository change
06.08.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 06.08.2026, without references to retired models or APIs.

Licence

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

  1. 环境准备
  2. 认证
  3. 输出格式
  4. 笔记字段语义
  5. 安全规则
  6. 异步任务
  7. 跨技能引用
Original SKILL.md headings · 100 lines, 287 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.