@getnote/cli 1.5.5 → 1.5.7

package/README.md

@@ -13,7 +13,7 @@
 适用于 OpenClaw（小龙虾）、QClaw、Claude Code、Codex、GitHub Copilot、Cursor、Gemini CLI、Windsurf、OpenCode、Cline 和 WorkBuddy：
 
 ```bash
-npx -y @getnote/cli@latest setup
+npm install -g @getnote/cli@latest && getnote setup
 ```
 
 这条命令会把 CLI 安装到稳定的全局路径、自动识别本机平台、安装五个 Skills，并引导完成一次得到大脑授权。安装时保留醒目的 `SKILLS` 开场，最终只显示每个平台是否安装成功，以及唯一需要用户完成的下一步，不再展示 `universal`、`symlink`、`overwrites` 等内部安装细节。WorkBuddy 安装后需要重启；OpenClaw（小龙虾）和 QClaw 的 Skill 由平台管理，命令会给出对应的 ClawHub 确认入口。
@@ -35,13 +35,14 @@ getnote auth login
 
 或者从 [Releases](https://github.com/iswalle/getnote-cli/releases) 下载对应平台的二进制文件，放到 `$PATH` 里。
 
-**Windows 用户**：推荐直接从 [Releases](https://github.com/iswalle/getnote-cli/releases) 下载 `.exe` 文件，放到 PATH 里。用 `npm install -g` 安装时，如果遇到 `Expand-Archive` 相关报错，可尝试：
+**pnpm 10+ 用户**：pnpm 默认会拦截依赖包的构建脚本。请在工作区的 `pnpm-workspace.yaml` 中允许 `@getnote/cli` 运行安装脚本：
 
-```bash
-npm install -g @getnote/cli --ignore-scripts
+```yaml
+allowBuilds:
+  '@getnote/cli': true
 ```
 
-然后手动从 Releases 下载对应平台的二进制文件。
+然后重新执行 `pnpm install`。也可以直接从 [Releases](https://github.com/iswalle/getnote-cli/releases) 下载对应平台的二进制文件并放入 `$PATH`。
 
 ---
 
@@ -102,16 +103,16 @@ getnote version --check-update
 # 只检查，不安装
 getnote update --check
 
-# 升级到最新 GitHub Release
+# 升级 CLI、同步全部已检测 AI 的 Skills，并运行 doctor 验证
 getnote update
 ```
 
-独立二进制升级会校验 GitHub Release 的 SHA-256；npm 安装会升级整个 `@getnote/cli` 包，使二进制、元数据和内置 Skills 保持一致。
+独立二进制升级会校验 GitHub Release 的 SHA-256；npm 安装会升级整个 `@getnote/cli` 包。升级成功后，`getnote update` 会使用新版 CLI 运行 `setup` 和 `doctor`，让二进制、元数据、内置 Skills 和本机 AI 接入状态保持一致。
 
-如果通过 npm 安装，也可以完整更新 npm 包和可执行程序：
+只想升级 CLI、不需要同步 Skills 时：
 
 ```bash
-npm install -g @getnote/cli@latest
+getnote update --cli-only
 ```
 
 ---
@@ -391,6 +392,7 @@ $ getnote search "工作日志" --limit 7 -o json
 
 | 日期 | 版本 | 新能力 | 适合怎么用 |
 |------|------|--------|------------|
+| 2026-08-19 | **v1.5.6** | 1. `getnote update` 默认升级 CLI、同步五个领域 Skill 并运行诊断<br>2. capabilities 2.2 提供机器可读的安装、更新、验证与平台托管边界<br>3. 移除失效的 `install.sh` 引导 | 用户只说“安装”或“更新”即可，AI Agent 无需让用户选择内部组件，并能按统一成功条件完成验收 |
 | 2026-08-19 | **v1.5.5** | 1. 一键安装自动识别本机 AI Agent，并按平台显示安装结果<br>2. 新增 GitHub Copilot、Gemini CLI、Windsurf、OpenCode 和 Cline 自动安装<br>3. OpenClaw（小龙虾）和 QClaw 仅在检测到时提供 ClawHub 确认入口<br>4. 保留 `SKILLS` 品牌开场，隐藏底层安装术语<br>5. `doctor` 按平台真实目录检查 Skill 状态 | 用户只需运行一次安装命令；AI 能根据结构化结果判断安装状态并给出明确修复动作 |
 | 2026-08-17 | **v1.5.3** | 1. `doctor` 新增稳定问题码、阻断级别、修复动作、平台 Skill 状态和在线/离线就绪语义<br>2. 诊断失败提供可靠退出码，JSON 保持单一、可解析<br>3. npm 与独立二进制采用匹配的升级路径，Release 下载增加 SHA-256 校验<br>4. WorkBuddy Skills 整套预检并支持失败回滚<br>5. 严格校验输出格式与多余参数 | 让技术用户和 AI 都能准确判断环境是否真正可用，并根据结构化结果完成修复；同时避免版本分裂、半安装和未校验更新包 |
 | 2026-08-14 | **v1.5.2** | 1. 补齐团队知识库、订阅知识库与文件夹操作的执行边界<br>2. 明确目录、资源及笔记 ID 的结构化结果字段，避免 AI 猜字段<br>3. 搜索结果按字符串 `note_id` 去重，不把同一笔记的多个命中片段重复展示<br>4. 完善“这条笔记”、录音分享与权限失败的安全处理 | 提升 CLI 内置 Skills 在知识库整理、搜索和笔记管理场景中的理解与执行准确度；本次不改变既有 CLI 命令和授权凭证 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getnote/cli",
-  "version": "1.5.5",
+  "version": "1.5.7",
   "description": "CLI tool for 得到大脑（Get笔记） — manage notes and knowledge bases from the terminal",
   "keywords": [
     "getnote",
@@ -19,7 +19,8 @@
     "gnote": "./bin/getnote.js"
   },
   "scripts": {
-    "postinstall": "node scripts/postinstall.js"
+    "postinstall": "node scripts/postinstall.js",
+    "test": "node --test scripts/postinstall.test.js"
   },
   "files": [
     "bin/getnote.js",

package/scripts/postinstall.js

@@ -37,6 +37,45 @@ function getDownloadURL(platform) {
   return `https://github.com/${REPO}/releases/download/v${VERSION}/${asset}`;
 }
 
+function getWindowsExtractArgs(archivePath, destinationPath) {
+  return [
+    '-NoProfile',
+    '-Command',
+    '& { Expand-Archive -LiteralPath $args[0] -DestinationPath $args[1] -Force }',
+    archivePath,
+    destinationPath,
+  ];
+}
+
+async function installArchive({
+  platform,
+  binDir,
+  binaryName,
+  binaryPath,
+  url,
+  tmpFile,
+  downloadFn = download,
+  verifyChecksumFn = verifyChecksum,
+  runFn = run,
+  chmodFn = fs.chmodSync,
+  unlinkFn = fs.unlinkSync,
+}) {
+  try {
+    await downloadFn(url, tmpFile);
+    await verifyChecksumFn(url, path.basename(url), tmpFile);
+    if (platform.platform === 'windows') {
+      runFn('powershell', getWindowsExtractArgs(tmpFile, binDir));
+    } else {
+      runFn('tar', ['-xzf', tmpFile, '-C', binDir, binaryName]);
+    }
+
+    chmodFn(binaryPath, 0o755);
+    console.log(`getnote installed at ${binaryPath}`);
+  } finally {
+    try { unlinkFn(tmpFile); } catch (_) {}
+  }
+}
+
 async function main() {
   const platform = getPlatform();
   const binDir = path.join(__dirname, '..', 'bin');
@@ -63,24 +102,7 @@ async function main() {
 
   fs.mkdirSync(binDir, { recursive: true });
 
-  try {
-    await download(url, tmpFile);
-    await verifyChecksum(url, path.basename(url), tmpFile);
-    if (platform.platform === 'windows') {
-      run('powershell', ['-NoProfile', '-Command', 'Expand-Archive -LiteralPath $args[0] -DestinationPath $args[1] -Force', tmpFile, binDir]);
-    } else {
-      run('tar', ['-xzf', tmpFile, '-C', binDir, binaryName]);
-    }
-
-    fs.chmodSync(binaryPath, 0o755);
-    console.log(`getnote installed at ${binaryPath}`);
-
-  } catch (err) {
-    console.error('Failed to install getnote:', err.message);
-    process.exit(1);
-  } finally {
-    try { fs.unlinkSync(tmpFile); } catch (_) {}
-  }
+  await installArchive({ platform, binDir, binaryName, binaryPath, url, tmpFile });
 }
 
 function run(command, args) {
@@ -128,7 +150,11 @@ async function verifyChecksum(assetURL, assetName, archivePath) {
   }
 }
 
-main().catch(err => {
-  console.error('Failed to install getnote:', err.message);
-  process.exit(1);
-});
+if (require.main === module) {
+  main().catch(err => {
+    console.error('Failed to install getnote:', err.message);
+    process.exitCode = 1;
+  });
+}
+
+module.exports = { getWindowsExtractArgs, installArchive };

package/scripts/postinstall.test.js

@@ -0,0 +1,37 @@
+'use strict';
+
+const assert = require('node:assert/strict');
+const test = require('node:test');
+
+const { getWindowsExtractArgs, installArchive } = require('./postinstall');
+
+test('Windows extraction invokes Expand-Archive inside a script block', () => {
+  assert.deepEqual(getWindowsExtractArgs('C:\\Temp\\getnote.zip', 'C:\\Program Files\\getnote'), [
+    '-NoProfile',
+    '-Command',
+    '& { Expand-Archive -LiteralPath $args[0] -DestinationPath $args[1] -Force }',
+    'C:\\Temp\\getnote.zip',
+    'C:\\Program Files\\getnote',
+  ]);
+});
+
+test('temporary archive is removed when installation fails', async () => {
+  const removed = [];
+  await assert.rejects(
+    installArchive({
+      platform: { platform: 'windows', arch: 'amd64' },
+      binDir: 'C:\\getnote\\bin',
+      binaryName: 'getnote.exe',
+      binaryPath: 'C:\\getnote\\bin\\getnote.exe',
+      url: 'https://example.invalid/getnote.zip',
+      tmpFile: 'C:\\Temp\\getnote-download.zip',
+      downloadFn: async () => { throw new Error('download failed'); },
+      verifyChecksumFn: async () => {},
+      runFn: () => {},
+      chmodFn: () => {},
+      unlinkFn: file => removed.push(file),
+    }),
+    /download failed/,
+  );
+  assert.deepEqual(removed, ['C:\\Temp\\getnote-download.zip']);
+});

package/skills/getnote-auth/SKILL.md

@@ -11,8 +11,8 @@ description: 安装和连接得到大脑，完成浏览器授权、环境诊断
 
 按顺序执行，已经满足的步骤直接跳过：
 
-1. 若当前来自独立 GetNote Skill 包，先运行 `bash scripts/install.sh --ensure`。它负责检查 Node.js 20+ 并确保官方 CLI 存在；不要因为 Skill 已安装就假设 CLI 存在。
-2. 若当前环境只有 CLI 内置 Skill、没有上述安装器，则用 `command -v getnote` 检查 CLI；缺失时检查 `node --version` 和 `npm --version`，再自动执行 `npm install -g @getnote/cli@latest`。这是 Agent 的工作，不要求用户手工复制命令；只有系统弹出安装授权时才请用户确认。
+1. 用 `command -v getnote` 检查 CLI；不要因为 Skill 已安装就假设 CLI 存在。独立的 ClawHub/OpenClaw Skill 由平台管理 CLI 依赖，不查找或运行 `scripts/install.sh`。
+2. CLI 缺失时检查 `node --version` 和 `npm --version`，再自动执行 `npm install -g @getnote/cli@latest`。这是 Agent 的工作，不要求用户手工复制命令；只有系统弹出安装授权时才请用户确认。
 3. 执行 `getnote version`，必须能够正常启动。
 4. 执行 `getnote auth status`。未登录时运行 `getnote auth login`，让用户只在浏览器中确认，不索要 API Key、Cookie 或 Authorization。
 5. 执行 `getnote doctor -o json`。只有 `diagnostics_completed=true`、`ready=true` 且 `status=ready`，才能宣布完整连接；`ready=true,status=degraded` 表示核心能力可用但仍应处理警告。`success` 和旧 `checks` 字段仅用于兼容。若未就绪，先处理 `issues[].blocking=true`，再按 `next_actions[]` 修复。需要确认的动作不得静默执行。
@@ -49,7 +49,7 @@ description: 安装和连接得到大脑，完成浏览器授权、环境诊断
 | `getnote quota -o json` | `data.read/write/write_note` 下的 `daily/monthly.limit/used/remaining/reset_at` | 按真实桶说明剩余额度，不自行换算或合并桶。 |
 | `getnote version` | 版本文本 | 只用于展示版本；机器契约仍以 `capabilities -o json` 为准。 |
 | `getnote update --check` | 当前/可用新版本文本 | 有新版本再运行 `getnote update`。 |
-| `getnote update` | 更新完成文本 | 必须再运行 `version` 和 `doctor -o json`，通过后才能说升级完成。 |
+| `getnote update` | CLI 更新、Skills 同步和 doctor 验证结果 | 默认由新版 CLI 自动完成完整更新闭环；只有全部步骤成功才能说升级完成。只升级 CLI 时使用 `--cli-only`。 |
 
 所有命令以退出码为第一判断：退出码非 0 即失败。使用 `-o json` 的 API 与本地错误均返回 `success=false`、`data=null`、`error.code/message/reason/retryable` 和可选 `request_id`；不能把 HTTP 200 或“命令运行过”当成成功。
 
@@ -65,13 +65,12 @@ description: 安装和连接得到大脑，完成浏览器授权、环境诊断
 
 ## 更新闭环
 
-用户说“帮我更新得到大脑”已经构成更新授权：
+用户说“帮我更新得到大脑”已经构成完整更新授权；不要再让用户选择 CLI、领域 Skill 等内部组件：
 
-1. 若当前来自独立 GetNote Skill 包，执行 `bash scripts/install.sh --update`。它升级 CLI，并在有新版发布包时刷新主 Skill 和五个领域 Skill。
-2. 若当前环境只有 CLI 内置 Skill，执行 `getnote update --check`；有新版本时执行 `getnote update`，若 CLI 明确提示 npm 安装方式，则用 `npm install -g @getnote/cli@latest`。
-3. 执行 `getnote version` 和 `getnote doctor -o json`。
-4. 执行 `getnote setup` 同步内置领域 Skill；技能市场托管的独立 Skill 需要平台更新时，只让用户完成唯一必要的点击。
-5. 用最近笔记读取做验收，再告诉用户版本、诊断结果和仍需动作。
+1. 执行 `getnote update --check`；有新版本或需要刷新 Skills 时执行 `getnote update`。命令会升级 CLI，再由新版 CLI 自动运行 `setup` 和 `doctor`，并同步 CLI 随附的五个领域 Skill。
+2. ClawHub/OpenClaw 托管的独立聚合 Skill 由平台更新；`getnote update` 不下载或覆盖该 Skill。若宿主支持检查 Skill 更新则继续使用宿主流程，否则只告知用户唯一必要的确认入口。
+3. 检查更新输出中的 CLI 版本、五个领域 Skill 同步结果和 doctor 结果。
+4. 用最近笔记读取做验收，再告诉用户版本、诊断结果和仍需动作。
 
 ## 安全与恢复