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

package/CHANGELOG.md

@@ -2,8 +2,22 @@
 
 ## 未发布
 
+## 0.1.0-beta.4 - 2026-09-11
+
+- auth status 展示三项敏感授权；旧 Gateway 未返回的授权显示未知，不推断为关闭。
+- 并发首次安装等待安装锁并复用已安装程序；超时不删除其他进程的锁。
+- 产品目录及订单中文名称依赖配套 Gateway/webhp；本版本不修改价格或自动付款。
+
+## 0.1.0-beta.3 - 2026-09-10
+
+- GitHub/npm 已公开，五平台与 Release→npm 自动串联通过；隔离环境验证 beta.2→beta.3 CLI/Skill 同步升级与匿名版本检查。
+
+- 增加匿名新版检查、确认后同步升级 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.4` 的发行结果见 [npm](https://www.npmjs.com/package/@zerozhang-giza/kdl-agent/v/0.1.0-beta.4) 和 [GitHub Release](https://github.com/gizaZerozhang/kdl-agent-cli/releases/tag/v0.1.0-beta.4)：
 
 ```bash
-npx @zerozhang-giza/kdl-agent@0.1.0-beta.2 install
+npx @zerozhang-giza/kdl-agent@0.1.0-beta.4 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.4`。
 
 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
-95a9aae626b807cd97b95fb73ff0207c72a88c10c936fc73da5a25fa4af14d10  openapi.yaml
-5a2bdc390c0fbfd0126d54db9c74258fb2b24e0ced3017315a7a894ea66ff5a4  release-notes.md
+0aa05c74b1ecd28a8abe886f93173301d6abe2b6615330112bd116b9f29cb277  BUILD.json
+85faeb4d602d4b643c1c7738b0c033024eeb2a2bfacf565aecb9d7ad6df82420  api-guide.md
+e76664cca18c3ed8faef86ac2d399d9b1ffe2b3693168b635881d0613b288c9e  cli-guide.md
+b7ed64ce497999e6989735300b5a28123877f5f5562dfea9905f33e0adcea391  install.md
+5f7418c92003826ee5938c287a866dac50f2917c8744be1f15846e73dc75bc51  kdl-agent-skill.zip
+8326b0c22d9e7b70abe5ea344320aa4659b310c4d6605bdd6c344f6fcdec4c63  kdl-agent_0.1.0-beta.4_darwin_amd64.tar.gz
+bd810dd50e4184bb122a663f6f0e1114a09de56c64383e283f4c5a8a0caf402f  kdl-agent_0.1.0-beta.4_darwin_arm64.tar.gz
+e16749ddc2687c45802d69a330fea7c922854f112eb14a8e7f3409457695ba86  kdl-agent_0.1.0-beta.4_linux_amd64.tar.gz
+6530677bbe7f64c18f157d808ee138ae8922de2882bc81b8d12ff9a73efd6c66  kdl-agent_0.1.0-beta.4_linux_arm64.tar.gz
+cc69897f95f64b2c888f27be80eeb6f2a4c555b31268b495ce8fe4cc15c93f1f  kdl-agent_0.1.0-beta.4_windows_amd64.zip
+9b5ae35d8e99c35432ed8d06bcbfb005e916e28b1810efd49b581d8554f574fe  openapi.yaml
+e1ea00191f05a675dd58a152e4a5bce81e77ef7f846de65e298ed524d1f39775  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.4",
   "description": "快代理 CLI：账户与订单查询、授权操作及代理便利命令",
   "license": "MIT",
   "engines": {

package/release.json

@@ -1,8 +1,8 @@
 {
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.4",
   "repository": "gizaZerozhang/kdl-agent-cli",
-  "commit": "b96a7061450d8b4c6899c52442307ac0ba9fdb89",
+  "commit": "0c8b369ef639a06ead2f218587ff71ad1a1f1c07",
   "dirty": false,
   "macosSigned": false,
-  "sha256": "be8a4f466beb4859053cbb2f1ef6c88a36399777c32ba5e76568f78373775e6a"
+  "sha256": "469505dd285b93e9f4e54e7af08360f746591695a57203cf1a91b69a93e7ca26"
 }

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/runtime/install.cjs

@@ -12,6 +12,8 @@ const yauzl = require('yauzl');
 
 const ROOT = path.resolve(__dirname, '../..');
 const MAX_BYTES = 256 * 1024 * 1024;
+const LOCK_WAIT_MS = 30000;
+const LOCK_POLL_MS = 250;
 const HOSTS = new Set(['github.com', 'release-assets.githubusercontent.com', 'objects.githubusercontent.com']);
 const TARGETS = new Set(['darwin-arm64', 'darwin-amd64', 'linux-arm64', 'linux-amd64', 'windows-amd64']);
 
@@ -166,7 +168,15 @@ function verifyBinary(file, version, commit) {
   if (result.status !== 0 || !output?.startsWith(`kdl-agent ${version} (commit `) || (commit && output !== `kdl-agent ${version} (commit ${commit})`)) throw new Error('下载程序无法运行或版本、来源不匹配');
 }
 
-async function ensureInstalled({ root = ROOT, fetchFile = download, platform = process.platform, arch = process.arch, verify = verifyBinary } = {}) {
+async function ensureInstalled({
+  root = ROOT,
+  fetchFile = download,
+  platform = process.platform,
+  arch = process.arch,
+  verify = verifyBinary,
+  lockWaitMs = LOCK_WAIT_MS,
+  lockPollMs = LOCK_POLL_MS,
+} = {}) {
   const { pkg, repository } = config(root);
   const release = JSON.parse(fs.readFileSync(path.join(root, 'release.json'), 'utf8'));
   if (release.version !== pkg.version || release.repository !== repository || !/^[a-f0-9]{40}$/.test(release.commit) || release.dirty !== false) throw new Error('发行元数据与 npm 包不一致');
@@ -177,9 +187,18 @@ async function ensureInstalled({ root = ROOT, fetchFile = download, platform = p
   fs.mkdirSync(directory, { recursive: true });
   if (fs.lstatSync(directory).isSymbolicLink()) throw new Error('安装目录不能是符号链接');
   const lock = path.join(directory, '.lock');
-  try { fs.mkdirSync(lock); } catch (error) {
-    if (error.code === 'EEXIST') throw new Error('另一个安装正在进行；确认没有安装进程后可删除 .native/.lock 重试');
-    throw error;
+  const started = Date.now();
+  while (true) {
+    try {
+      fs.mkdirSync(lock);
+      break;
+    } catch (error) {
+      if (error.code !== 'EEXIST') throw error;
+      if (Date.now() - started >= lockWaitMs) {
+        throw new Error('另一个安装正在进行；确认没有安装进程后可删除 .native/.lock 重试');
+      }
+      await new Promise(resolve => setTimeout(resolve, lockPollMs));
+    }
   }
   const destination = path.join(directory, artifact.binary);
   const old = destination + '.old';

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');