@zerozhang-giza/kdl-agent 0.1.0-beta.2 → 0.1.0-beta.3

package/CHANGELOG.md

@@ -2,8 +2,14 @@
 
 ## 未发布
 
+## 0.1.0-beta.3 - 2026-09-10
+
+- 增加匿名新版检查、确认后同步升级 CLI/Skill 的 npm update 入口，保留登录配置和失败恢复。
+- tag 流程经五平台验活和环境审批后自动公开 Release 并派发 npm；重复发布校验固定候选，冲突停止。
+
 ## 0.1.0-beta.2 - 2026-09-10
 
+- GitHub Release 与 npm 已公开，五平台安装验证通过；首次实际 Trusted Publishing/OIDC 发行成功，registry 包与固定候选一致并提供 provenance。
 - 新增代理 Basic 鉴权与白名单只读命令，明确订单 API 密钥和代理连接凭据的区别。
 - 统一 Gateway 错误信封、字段级校验和 Retry-After 提示，补齐 HTTPS 连接指南与配套 Skill。
 - 安装下载增加有限重试与半包清理，支持 KDL_AGENT_DOWNLOAD_TIMEOUT_MS；永久错误不重试，失败提供网络排查入口。

package/README.md

@@ -8,13 +8,13 @@
 
 ## npm 安装
 
-需要 Node.js 22.14+ 和用户可写的 npm 全局目录。`0.1.0-beta.2` 已发布至 [npm](https://www.npmjs.com/package/@zerozhang-giza/kdl-agent/v/0.1.0-beta.2) 和 [GitHub Release](https://github.com/gizaZerozhang/kdl-agent-cli/releases/tag/v0.1.0-beta.2)，匿名安装与 Codex Skill 实装已验证：
+需要 Node.js 22.14+ 和用户可写的 npm 全局目录。配套版本 `0.1.0-beta.3` 的发行结果见 [npm](https://www.npmjs.com/package/@zerozhang-giza/kdl-agent/v/0.1.0-beta.3) 和 [GitHub Release](https://github.com/gizaZerozhang/kdl-agent-cli/releases/tag/v0.1.0-beta.3)：
 
 ```bash
-npx @zerozhang-giza/kdl-agent@0.1.0-beta.2 install
+npx @zerozhang-giza/kdl-agent@0.1.0-beta.3 install
 ```
 
-向导安装 CLI 与同版本 Skill，然后引导本机隐藏输入凭证并验证首次只读查询。Agent 自动安装使用 `install --yes --agent codex --no-login`，由用户在本地终端完成登录。仅安装 CLI 可执行 `npm install -g @zerozhang-giza/kdl-agent@0.1.0-beta.2`。
+向导安装 CLI 与同版本 Skill，然后引导本机隐藏输入凭证并验证首次只读查询。Agent 自动安装使用 `install --yes --agent codex --no-login`，由用户在本地终端完成登录。仅安装 CLI 可执行 `npm install -g @zerozhang-giza/kdl-agent@0.1.0-beta.3`。
 
 npm 包按平台下载 GitHub Release 原生二进制并验证内置 SHA256。当前请显式指定 beta 版本或 `@beta`；npm 自动附加的 `latest` 仍指向该预发行版，不代表稳定就绪。beta 的 macOS 程序未签名/公证；最低系统和真实业务仍待专项验收。安装、升级、回退与卸载见[安装指南](./docs/install.md)，维护者见[发行操作](./docs/releasing.md)。
 

package/SHA256SUMS

@@ -1,12 +1,12 @@
-aae212b4c6db35f9f4be104da9c3f7296be48412ead33effea8e9448b1b31e5c  BUILD.json
-75be41758770cf5e84f5fc452ab2974019d99765bf92ad62e741479b82e1a853  api-guide.md
-8c3ce39ed33e6b6f40d32ceb7710ffeac3f8cb5d7f760682464fc45c11ea71f5  cli-guide.md
-42c64de18e06869e5e605d05b568a9626bbcaf7ed1dedc69020550abd8523355  install.md
-5486870fad78662f91b787d1f4679d982f3a2edb460fbc2b4d8dc2b308876134  kdl-agent-skill.zip
-c185e1403a706a4419a0b2919c6d48b3c4263fca2b3fe296679eca6c55efe67c  kdl-agent_0.1.0-beta.2_darwin_amd64.tar.gz
-84f635f230b136186730cdbfad2b17f1e6530b43a05123ab55030bbd1586981c  kdl-agent_0.1.0-beta.2_darwin_arm64.tar.gz
-6a01dcdb0f773d07ac41d5b9d2979a4bd3ca1d2b2453a9696ce60767f94a5051  kdl-agent_0.1.0-beta.2_linux_amd64.tar.gz
-308e58093d6d72e41e0f424a4b39e193e95a7e0c70ff1806657a023a6c15a507  kdl-agent_0.1.0-beta.2_linux_arm64.tar.gz
-94ada3486eefa490770a2f6abb95368e90d9ff00b3008735805250ea1b6ad007  kdl-agent_0.1.0-beta.2_windows_amd64.zip
+c137d2d90fbcfff703f9bbce6215690e1e22c15eb513afbd47dc141b29510bbe  BUILD.json
+dfbfb2350f131474ae69f6862e1fbedab8afcb0fe154d3bc55df01057fca7785  api-guide.md
+56cae14d0fff44d867275806126b7a90bd1d399d08ac41826d3df96eafaa3f9a  cli-guide.md
+5dbf7cef1797457ae91b67b2d8ef619c6f9c19477dc7ae3a2fc7c70f85bdc995  install.md
+7f0e934259d96e8c541af62b47f3baa863f964c5a8185d80c62902020034997b  kdl-agent-skill.zip
+f7e89f716ac88879802374acaeed9954cc83cc95e528cf734312a1daabfe6bbc  kdl-agent_0.1.0-beta.3_darwin_amd64.tar.gz
+1871774881bf1821a1ec64371e276121480d56ab697d39ce08d1c237579b1430  kdl-agent_0.1.0-beta.3_darwin_arm64.tar.gz
+5b2f8a2450c560be269d4e4f3d087a419cca54bab6acaed3723a42c3019527c0  kdl-agent_0.1.0-beta.3_linux_amd64.tar.gz
+47fc0affd2c8c4776be8827528330b6c70af4f5120c5255d8ba3347f9eaff2b7  kdl-agent_0.1.0-beta.3_linux_arm64.tar.gz
+32cc0f58e2096d28e3147f0b10a89b4f97bb90a2d64442181d8161355878e853  kdl-agent_0.1.0-beta.3_windows_amd64.zip
 95a9aae626b807cd97b95fb73ff0207c72a88c10c936fc73da5a25fa4af14d10  openapi.yaml
-5a2bdc390c0fbfd0126d54db9c74258fb2b24e0ced3017315a7a894ea66ff5a4  release-notes.md
+8ef746e7d7f54b599c15f57941436e95f9a3688d7301c29b4418f1234e4d6de5  release-notes.md

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerozhang-giza/kdl-agent",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.3",
   "description": "快代理 CLI：账户与订单查询、授权操作及代理便利命令",
   "license": "MIT",
   "engines": {

package/release.json

@@ -1,8 +1,8 @@
 {
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.3",
   "repository": "gizaZerozhang/kdl-agent-cli",
-  "commit": "b96a7061450d8b4c6899c52442307ac0ba9fdb89",
+  "commit": "75934e505a6355bbe71b3db998c3026f6f8ff318",
   "dirty": false,
   "macosSigned": false,
-  "sha256": "be8a4f466beb4859053cbb2f1ef6c88a36399777c32ba5e76568f78373775e6a"
+  "sha256": "ff499485dbb890557f07637e58bc74b03f394411a7c2b4aa11c28188e4498c69"
 }

package/scripts/run.cjs

@@ -4,6 +4,7 @@ const { spawn } = require('node:child_process');
 async function main() {
   const args = process.argv.slice(2);
   if (args[0] === 'install') return require('./wizard.cjs').main(args.slice(1));
+  if (args[0] === 'update' && args[1] !== 'check') return require('./wizard.cjs').main(args.slice(1), { mode: 'update' });
   const binary = await require('./runtime/install.cjs').ensureInstalled();
   const child = spawn(binary, args, { stdio: 'inherit' });
   for (const signal of ['SIGINT', 'SIGTERM']) process.on(signal, () => child.kill(signal));

package/scripts/wizard.cjs

@@ -31,8 +31,22 @@ function parse(args) {
   return options;
 }
 
-async function main(args, { run = command, install = ensureInstalled, readConfig = config, checkBinary = verifyBinary, tty = process.stdin.isTTY } = {}) {
+async function confirmUpdate() {
+  const prompt = readline.createInterface({ input: process.stdin, output: process.stdout });
+  try { return /^y(es)?$/i.test((await prompt.question('确认升级 CLI 与同版本 Skill？[y/N] ')).trim()); }
+  finally { prompt.close(); }
+}
+
+async function main(args, { run = command, install = ensureInstalled, readConfig = config, checkBinary = verifyBinary, tty = process.stdin.isTTY, mode = 'install', confirm = confirmUpdate } = {}) {
   const options = parse(args);
+  if (mode === 'update') {
+    options.noLogin = true;
+    if (options.help) {
+      console.log('同步升级 CLI 与同版本 Skill\n检查新版：kdl-agent update check --format json\n用法：npx --yes @zerozhang-giza/kdl-agent@<目标版本> update --agent codex [--yes]\n默认询问确认；非交互必须显式 --yes。保留登录配置，Skill 失败时重复同一命令修复。');
+      return;
+    }
+    if (options.noSkills) throw new Error('同步升级不能跳过 Skill；请移除 --no-skills');
+  }
   if (options.help) {
     console.log('安装快代理 CLI 与同版本 Skill\n\n用法：npx <包名>@<版本> install [--yes] [--agent codex] [--no-login] [--no-skills]\n\n--yes 非交互安装；安装 Skill 时须指定 --agent\n--no-login 仅安装，稍后在本地终端执行 kdl-agent auth login\n--no-skills 跳过 Skill，适用于直接使用 CLI\n升级或回退：使用目标版本再次运行；卸载 npm 包保留 .kdl 与 Skill。');
     return;
@@ -42,6 +56,7 @@ async function main(args, { run = command, install = ensureInstalled, readConfig
   const { pkg, repository } = readConfig();
   if (!/^@[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._-]*$/.test(pkg.name)) throw new Error('npm 包名尚未绑定');
   console.log(`目标版本：${pkg.name}@${pkg.version}`);
+  if (mode === 'update' && !options.yes && !await confirm()) { console.log('已取消升级，保留现有 CLI 与 Skill。'); return; }
   console.log('正在下载并校验原生程序...');
   await install();
   const prefixResult = run('npm', ['prefix', '-g'], { timeout: 15000 });
@@ -76,7 +91,7 @@ async function main(args, { run = command, install = ensureInstalled, readConfig
     if (result.status !== 0) throw new Error('CLI 已安装，Skill 安装未完成；重新运行此向导重试，已安装 CLI 将跳过');
     console.log('Skill：已安装；目标 Agent 可能需要刷新会话');
   } else console.log('Skill：按要求跳过');
-  if (options.noLogin) { console.log('登录：按要求跳过；用户稍后在本地终端执行 kdl-agent auth login 和 kdl-agent auth status'); return; }
+  if (options.noLogin) { console.log(mode === 'update' ? '升级完成，登录配置保持不变；请核对 kdl-agent --version，并刷新 Agent 会话。' : '登录：按要求跳过；用户稍后在本地终端执行 kdl-agent auth login 和 kdl-agent auth status'); return; }
   let status = run(binary, ['auth', 'status', '--format', 'json'], { timeout: 25000 });
   if (status.status !== 0) {
     if (!tty) throw new Error('CLI/Skill 已安装，登录待用户在本地终端完成：kdl-agent auth login');