@getnote/cli - npm Package Compare versions

Comparing version 1.1.9 to 1.2.0

package.json

 {
   "name": "@getnote/cli",
-  "version": "1.1.9",
+  "version": "1.2.0",
   "description": "CLI tool for 得到大脑（Get笔记） — manage notes and knowledge bases from the terminal",
@@ -5,0 +5,0 @@ "keywords": [

README.md

@@ -17,2 +17,10 @@ # 得到大脑（Get笔记） CLI
 
+**Windows 用户**：推荐直接从 [Releases](https://github.com/iswalle/getnote-cli/releases) 下载 `.exe` 文件，放到 PATH 里。用 `npm install -g` 安装时，如果遇到 `Expand-Archive` 相关报错，可尝试：
+
+```bash
+npm install -g @getnote/cli --ignore-scripts
+```
+
+然后手动从 Releases 下载对应平台的二进制文件。
+
 ---
@@ -165,3 +173,4 @@
                                      （id/title/content/type/
-                                       created_at/url/excerpt）
+                                       created_at/url/excerpt/
+                                       web_content/audio_original）
 
@@ -177,2 +186,16 @@ getnote note update <id>             更新笔记
 
+### 字段语义说明（适合 AI Agent 参考）
+
+不同笔记类型的"原文"字段不同，`content` 通常是 AI 总结而非原文：
+
+| 笔记类型 | 原文字段 | AI 总结字段 |
+|---------|---------|------------|
+| 普通文字笔记 | `content` | `content` |
+| 链接/网页笔记 | `web_content` | `content` |
+| 录音笔记 | `audio_original` | `content` |
+| 知识库博主内容 | `post_media_text`（via `kb blogger-content`）| `content` |
+| 知识库直播 | `post_media_text`（via `kb live`）| `post_summary` |
+
+> **AI Agent 提示**：用户要求"读原文"时，先用 `getnote note <id> -o json` 查看 `note_type`，再按上表选择对应字段。
+
 ### 搜索
@@ -202,2 +225,3 @@
   --all                              获取全部
+  --no-content                       JSON 输出时省略 content 字段（节省 AI token）
 
@@ -204,0 +228,0 @@ getnote kb create <名称>             新建知识库

skills/getnote-note/SKILL.md

@@ -104,2 +104,3 @@ ---
 | `web_content` | Full web page content (link notes only) |
+| `audio_original` | 录音笔记的转写原文（`audio` 类型笔记专用，非 AI 总结） |
 | `source` | Note source (e.g. `openapi`, `manual`) |
@@ -182,1 +183,13 @@ | `tags` | Comma-separated tag names |
 - Exit code `0` = success; non-zero = error. Error details go to stderr.
+
+### 字段语义提示（"原文" vs AI 总结）
+
+不同笔记类型的"原文"字段不同，`content` 通常是 AI 总结而非原文。用户要求"读原文"时，先用 `getnote note <id> -o json` 查看 `note_type`，再按下表选择对应字段：
+
+| 笔记类型 | 原文字段 | AI 总结字段 |
+|---------|---------|------------|
+| 普通文字笔记 | `content` | `content` |
+| 链接/网页笔记 | `web_content` | `content` |
+| 录音笔记 | `audio_original` | `content` |
+| 知识库博主内容 | `post_media_text`（via `kb blogger-content`）| `content` |
+| 知识库直播 | `post_media_text`（via `kb live`）| `post_summary` |

No alert changes

Improved metrics

Total package byte prevSize

7854996

0.02%

Number of lines in readme file

320

8.11%

No dependency changes