@keruyun/agent-cli 1.4.6 → 1.4.7-beta.0

package/binaries.json

@@ -1,47 +1,47 @@
 {
-  "version": "1.4.6",
+  "version": "1.4.7-beta.0",
   "targets": {
     "darwin-arm64": {
-      "url": "https://s.koubei.com/zj7pzbY3cMXDnaRdX7DZbcHY86t8Near.br",
-      "sha256": "3da543bfaf7e339bce2bbab41d5b5e58e55fe1a9c33a629240dcf9c73d07b04f",
-      "brSha256": "6d67a08f47a1a4c6ea9c340f4750c46b3afa7db76268e2cf362bf147c8c8fbf8",
-      "brBytes": 19912488,
+      "url": "https://s.koubei.com/MHm6TEBf5ji3fPMT3Tk4YyX8dkkZDaJE.br",
+      "sha256": "729c0e9176b04adf4a47579204a79fedabd1415dd9556b545104076e8741afdb",
+      "brSha256": "c8e1167e13541962bd80f566139a740d446fcca637d452470414223e6d05fc50",
+      "brBytes": 19912300,
       "bytes": 68994146
     },
     "darwin-x64": {
-      "url": "https://s.koubei.com/edYQCTkSxktN6JkSpmQSRkPJQyPzrkyP.br",
-      "sha256": "afbf746c57f23c60a53da0477e49f83edd489c7d55fc5ddbcbb715a88742f681",
-      "brSha256": "4cd3af0825ad271502a4ffb9e33e91a1b76cd30f738091b8eab25b654b99cdad",
-      "brBytes": 22342215,
+      "url": "https://s.koubei.com/BBkmZ3kNYxbPfmedATcEQ4Fp2b8aNhFG.br",
+      "sha256": "23f60110cfcafe65fe9c6073b92b0ce56e21c58098ce6d791db43a18eef0c04d",
+      "brSha256": "0cefe05ce7b051a1e6795a64b87fd83a190f19dfcef68a82ae0a721ce382b6aa",
+      "brBytes": 22343190,
       "bytes": 74678352
     },
     "linux-x64": {
-      "url": "https://s.koubei.com/nfMYin3ZNeARSnMexm5ybRYckGn6bdC8.br",
-      "sha256": "5410f0ba31969e0a27e88009b8e3e3121a6318ea807b5c5d4fef02d8e8a442b0",
-      "brSha256": "31c25058d30a66343f81161480a3fd87d3451be40b7394f2eb4caaf18514a7b0",
-      "brBytes": 30769311,
+      "url": "https://s.koubei.com/szBKPzZTcHNDX5YWKEeMyt6KjbYAYGGs.br",
+      "sha256": "bbdc431d7236c8a5bc6ffe042cfc7c2d6b5498d9535a429343f8d0c9dc49b29b",
+      "brSha256": "2f8bf78b40556f59dc4461779ae6e1c4c25b330ee924605dbd26ec1c2e0ead46",
+      "brBytes": 30768615,
       "bytes": 100087936
     },
     "linux-arm64": {
-      "url": "https://s.koubei.com/APw88pFf77tQkc2pc46iFtHZH2AEEjAf.br",
-      "sha256": "b283a500144bf9775c47a78d8ec68ee39f2d2d9e7ed2d02aa899c02789f8c545",
-      "brSha256": "f001d7cd45c6364c3b82bd616090480b69a4dae50653e164c632783dbba5540d",
-      "brBytes": 30161735,
+      "url": "https://s.koubei.com/wRSdWQGbpMndDWc2zaCFXwEjKJNkT22i.br",
+      "sha256": "5255c2ae6adbbb2b99acf49b4750ab55f4c6475048ab66c3de4926c91b0a3a8d",
+      "brSha256": "4f91c8697e2176431ffb9d6b0934e3ef9b344992b7b23fa4f8f7c68ba0b0f755",
+      "brBytes": 30161883,
       "bytes": 99199120
     },
     "linux-x64-musl": {
-      "url": "https://s.koubei.com/fz5fXzrNyXWKNsmpKG85tzYbP8x5ZWZj.br",
-      "sha256": "1f9c5409eb6e8b2ab0dc74645508d04518340b84b56d96ab282771d02692f04c",
-      "brSha256": "dad4a2e508a5f9a18fa3f5cd3caea4df08c5f85dc3882bdd64c93f8172f8db29",
-      "brBytes": 29961703,
+      "url": "https://s.koubei.com/w3ZfXTSXsdtAC7shma2yJDZkQNi6EBkZ.br",
+      "sha256": "36b9e1fe62b0fdb05bdd159186a8c04fa2bb8e39755d55447e047f11f30cef7c",
+      "brSha256": "fb11080f9374708b1aeb9d6e9966c2061ef46ef8b811d3c21bb7f78a953ec013",
+      "brBytes": 29961712,
       "bytes": 96667936
     },
     "win32-x64": {
-      "url": "https://s.koubei.com/ihiHSAKWEzzAk2SZH2KjKefyZpAatkk2.br",
-      "sha256": "1ad4aadf0277165170a5e561e2b171865b6c407b8d826854c978197118635a53",
-      "brSha256": "c18eae1e6d53f6ae298eae2f804a96f8cbd9fcae14ee83b4623fb9fda1df51be",
-      "brBytes": 32632770,
-      "bytes": 103978496
+      "url": "https://s.koubei.com/43BsNP7nYMxBaB3rSrAs4XnZBNHP5wZM.br",
+      "sha256": "465aef88bdc98cff3c1ea8f7ee12a7bcf9ae18919d43ebb2a8b7284a696dc5cc",
+      "brSha256": "22a8b3f1e02a0ed589cabbf1023c939820942c08ba311c1e3a6759ff671d417b",
+      "brBytes": 32633253,
+      "bytes": 103979520
     }
   }
 }

package/install.cjs

@@ -23,11 +23,27 @@
  *      但 x64 构建需要 AVX 而 Rosetta 不模拟，装上去直接 SIGILL。查 sysctl.proc_translated。
  *   3. 目标文件名固定 kry-cli.exe：.exe 后缀 + 无 shebang，让 npm 的 cmd-shim 在
  *      Windows 上直接 exec；Unix 忽略后缀。
+ *
+ * ## 埋点（2026-08）
+ *
+ * 首装曾是唯一一段完全没有观测的路径：下面那 8 条返回路径以前只写 stderr，而 npm 通常把
+ * postinstall 的 stderr 折叠掉 —— 于是「有多少人装不上、卡在下载还是校验、哪个平台最惨」
+ * 一个都答不出来。现在每条路径都上报一条，logstore 与 CLI 侧同一个（自升级已经在报了，
+ * 见 `src/core/update.ts`），拼起来才是完整的装机图。
+ *
+ * 三条硬约束：
+ *   1. **埋点失败绝不影响安装结果** —— 全程吞异常，返回码只由安装本身决定。
+ *   2. **不打印任何东西** —— `release:verify` 有断言盯着 postinstall 的输出。
+ *   3. **必须 await** —— 本文件结尾是 `process.exit(code)`，fire-and-forget 的 fetch 会被
+ *      直接掐掉、一条都发不出去。代价是安装最多多等 TRACK_TIMEOUT_MS。
+ *
+ * `KRY_CLI_NO_TRACK=1` 整体关掉（CI、离线环境、端到端验证用）。
  */
 
 'use strict';
 
 const fs = require('fs');
+const os = require('os');
 const path = require('path');
 const crypto = require('crypto');
 const zlib = require('zlib');
@@ -38,6 +54,13 @@ const TARGET = path.join(BIN_DIR, 'kry-cli.exe');
 const LOG_PREFIX = '[krycli]';
 const DOWNLOAD_TIMEOUT_MS = 300000;
 
+/**
+ * 这次安装已经知道的事实：main() 一路填，埋点上报时并进 data ——
+ * 否则那 8 个 return 每个都要重列一遍字段。声明在这里而不在下面的埋点段，
+ * 是因为 download() 也要往里写一笔（retried）。
+ */
+const ctx = { startedAt: Date.now() };
+
 function log(msg) {
   process.stdout.write(`${LOG_PREFIX} ${msg}\n`);
 }
@@ -149,24 +172,193 @@ async function download(url) {
   try {
     return await once();
   } catch (e) {
+    ctx.retried = 1;
     warn(`下载失败（${e && e.message ? e.message : e}），重试一次…`);
     return once();
   }
 }
 
+// ─────────────────────────── 埋点 ───────────────────────────
+
+/**
+ * 上报地址与 body 形状必须与 `src/core/log.ts` 的 LOG_URL 保持一致 —— 同一个 logstore，
+ * 字段对不上就等于另开一个孤岛，跟 CLI 侧日志（含自升级）拼不成一张图。
+ * 这是 SLS 的 Web Tracking 端点：裸 POST JSON，无签名、无凭证。
+ *
+ * 刻意写字面量而不 import：install.cjs 是壳包里的独立脚本，装到用户机器上时既没有 src/、
+ * 也没有构建产物。这与平台判定同时存在于本文件和 self-update.ts 是同一个道理 ——
+ * 重复是分发形态强加的。**改 core/log.ts 的 LOG_URL 时必须同步改这里**，
+ * 目前靠人守，还没有单测把两边钉在一起。
+ */
+const TRACK_URL = 'https://tnnm-alsc-saas-merchant-spider-fy21.cn-wulanchabu.log.aliyuncs.com/logstores/kry-cli/track?APIVersion=0.6.0';
+/** 埋点超时。安装最多为此多等这么久，所以给得比 CLI 侧保守 */
+const TRACK_TIMEOUT_MS = 2000;
+
+/**
+ * 埋点的 errorCode 取值。**看板与查询会依赖这些字面量，只能新增，不能改名或删除。**
+ *
+ * 与 `src/core/format.ts` 的 ErrorCode 是两套东西：那套是 `--format json` 的对外契约，
+ * 这套只出现在日志里，不要互相借用。
+ *
+ *   SKIPPED_BY_ENV        KRY_CLI_SKIP_POSTINSTALL=1，用户主动跳过（exit 0）
+ *   TARGET_NOT_PROVIDED   binaries.json 里没有当前平台
+ *   DOWNLOAD_FAILED       CDN 下载失败（已内部重试一次，看 data.retried）
+ *   BR_SHA256_MISMATCH    压缩件校验不符 —— 传输层坏了
+ *   DECOMPRESS_FAILED     brotli 解压失败
+ *   SHA256_MISMATCH       解压件校验不符 —— 落盘前的硬校验
+ *   WRITE_FAILED          写 bin/kry-cli.exe 失败（权限 / 磁盘）
+ *   UNEXPECTED_ERROR      兜底：main() 抛出的未预期异常
+ */
+
+const traceId = crypto.randomUUID().replaceAll('-', '');
+
+function evOk() {
+  return { code: 0, level: 'info', message: '首装成功', data: { stage: 'done', result: 'ok' } };
+}
+function evSkip(errorCode) {
+  return { code: 0, level: 'info', message: '首装跳过', data: { stage: 'skip', result: 'skip', errorCode } };
+}
+function evFail(stage, errorCode, error) {
+  return {
+    code: 1,
+    level: 'error',
+    message: '首装失败',
+    data: { stage, result: 'fail', errorCode, error: error ? String((error && error.message) || error).slice(0, 300) : undefined },
+  };
+}
+
+function isTrackDisabled() {
+  return process.env.KRY_CLI_NO_TRACK === '1' || process.env.KRY_CLI_NO_TRACK === 'true';
+}
+
+/**
+ * 复刻 `core/config.ts` 的 getEnv 前两级：CLIENT_CLAW_ENV > KRY_FORCE_ENV。
+ *
+ * **但刻意不复刻它那个 `prod` 兜底。** `getEnv()` 兜底成 prod 是对的 —— 二进制里
+ * 编译期 `--define KRY_FORCE_ENV` 可能已经把真环境打进去了，兜底只是缺省值。
+ * 而壳包脚本读不到那个 define（那是二进制自己的事），一旦兜底就等于**把内网预发通道的
+ * 安装标成 prod** —— 不是「维度缺失」而是「静默标错」，比空着更坏。
+ *
+ * 所以推不出来就返回 undefined，让 compact() 把这个字段丢掉。通道维度本来就有
+ * `pkg` tag 顶着（@alife/krycli vs @keruyun/agent-cli），真正准的 env 得看 CLI 侧日志。
+ */
+function detectEnv() {
+  const clawMap = { daily: 'gld', pre: 'pre', prod: 'prod' };
+  const claw = process.env.CLIENT_CLAW_ENV;
+  if (claw && clawMap[claw]) return clawMap[claw];
+  const forced = process.env.KRY_FORCE_ENV;
+  if (forced && ['prod', 'pre', 'gld', 'safety'].includes(forced)) return forced;
+  return undefined;
+}
+
+/** 与 core/config.ts 的 parseUserId 同一条正则（兼容 Unix / Windows 路径） */
+function parseUserId(p) {
+  const m = p && p.match(/(?:^|[/\\])(user-[^/\\]+)[/\\]?$/);
+  return (m && m[1]) || '';
+}
+
+/** 与 cli.ts 的 init hook 同一套判定，kryClaw 优先 */
+function detectSource(userId) {
+  if (process.env.CLIENT_CLAW_TYPE === 'KRY_CLAW') return 'kryclaw';
+  return userId ? 'wukong' : 'other';
+}
+
+/** 文件字节数，不存在返回 undefined */
+function sizeOf(file) {
+  try {
+    return fs.statSync(file).size;
+  } catch {
+    return undefined;
+  }
+}
+
+/** 丢掉 undefined 与空串，避免往 logstore 里灌一堆空字段 */
+function compact(obj) {
+  return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined && v !== ''));
+}
+
+/**
+ * 上报一次安装结果。**全程吞异常、不打印、不改变返回码** ——
+ * 「装不装得上」与「埋不埋得上」是两件事，后者不能影响前者。
+ */
+async function track(outcome) {
+  try {
+    if (isTrackDisabled()) return;
+    const self = readJson(path.join(__dirname, 'package.json')) || {};
+    const workRoot = process.env.AGENT_WORK_ROOT || '';
+    const userId = parseUserId(workRoot);
+    const sessionId = process.env.REWIND_SESSION_ID || '';
+    const tags = compact({
+      env: detectEnv(),
+      version: self.version,
+      // 内网（@alife/krycli）还是外网（@keruyun/agent-cli）通道
+      pkg: self.name,
+      // 平台判定的最终结果，可能被 Rosetta / musl 纠正过，与 platform+arch 未必一致
+      target: ctx.target,
+      platform: process.platform,
+      arch: process.arch,
+      hostname: os.hostname(),
+      source: detectSource(userId),
+      userId,
+      sessionId,
+      // 与 core/log.ts 的 isTestRunner 同一个判据
+      test: /^eval-sess-eval/.test(sessionId) ? 'TestRunner' : undefined,
+    });
+    const data = compact({
+      ...outcome.data,
+      note: ctx.note,
+      // 覆盖前 bin/kry-cli.exe 有多大：占位文件几百字节，真二进制几十 MB → 区分首装与重装
+      prevBinaryBytes: ctx.prevBinaryBytes,
+      bytes: ctx.bytes,
+      brBytes: ctx.brBytes,
+      cdnHost: ctx.cdnHost,
+      downloadMs: ctx.downloadMs,
+      decompressMs: ctx.decompressMs,
+      totalMs: Date.now() - ctx.startedAt,
+      // 下载内部重试过一次；重试率就是 CDN 质量指标
+      retried: ctx.retried,
+      nodeVersion: process.versions.node,
+      // 能分辨 npm / tnpm / pnpm / yarn 与 CI
+      npmUserAgent: process.env.npm_config_user_agent,
+      npmCommand: process.env.npm_command,
+      global: process.env.npm_config_global,
+      ci: process.env.CI,
+    });
+    // body 形状照抄 core/log.ts 的 sendLog：__logs__ 里每个值都是字符串，data 整体 JSON 化
+    const body = JSON.stringify({
+      __logs__: [{ traceId, level: outcome.level, message: outcome.message, tag: 'install', data: JSON.stringify(data) }],
+      __tags__: tags,
+    });
+    await fetch(TRACK_URL, { method: 'POST', headers: new Headers(), body, signal: AbortSignal.timeout(TRACK_TIMEOUT_MS) });
+  } catch {
+    // 埋点失败不影响安装结果，也不打印 —— 用户不需要为此困惑
+  }
+}
+
 async function main() {
   if (process.env.KRY_CLI_SKIP_POSTINSTALL === '1' || process.env.KRY_CLI_SKIP_POSTINSTALL === 'true') {
     warn('KRY_CLI_SKIP_POSTINSTALL=1，跳过平台二进制安装（krycli 将不可用）');
-    return 0;
+    return evSkip('SKIPPED_BY_ENV');
   }
 
   const { name: target, note } = detectTarget();
+  ctx.target = target;
+  ctx.note = note;
   const binaries = readJson(path.join(__dirname, 'binaries.json'));
   const entry = binaries && binaries.targets && binaries.targets[target];
   if (!entry || !entry.url || !entry.sha256) {
     warn(`binaries.json 里没有当前平台（${target}）的二进制，暂未提供该平台的预编译产物`);
-    return 1;
+    return evFail('resolve', 'TARGET_NOT_PROVIDED');
+  }
+  ctx.bytes = entry.bytes;
+  ctx.brBytes = entry.brBytes;
+  try {
+    ctx.cdnHost = new URL(entry.url).host;
+  } catch {
+    // URL 形状不对下载自然会失败，这里不用管
   }
+  // 必须在下面 unlink 之前取：占位文件几百字节，真二进制几十 MB
+  ctx.prevBinaryBytes = sizeOf(TARGET);
 
   let brBuf;
   const started = Date.now();
@@ -175,8 +367,9 @@ async function main() {
   } catch (error) {
     warn(downloadFailedHelp(entry, target));
     warn(`  错误：${error && error.message ? error.message : String(error)}`);
-    return 1;
+    return evFail('download', 'DOWNLOAD_FAILED', error);
   }
+  ctx.downloadMs = Date.now() - started;
 
   // 先校验压缩件本身，再解压 —— 传输层坏了在这一步就能说清楚
   if (entry.brSha256) {
@@ -186,18 +379,20 @@ async function main() {
       warn(`  期望 sha256: ${entry.brSha256}`);
       warn(`  实际 sha256: ${brActual}`);
       warn('  下载可能已损坏或被篡改，请重装重试');
-      return 1;
+      return evFail('verify-br', 'BR_SHA256_MISMATCH');
     }
   }
 
   let out;
+  const decompressStarted = Date.now();
   try {
     out = zlib.brotliDecompressSync(brBuf);
   } catch (error) {
     warn(`解压平台二进制失败：${error && error.message ? error.message : String(error)}`);
     warn('  下载可能已损坏，请重装重试');
-    return 1;
+    return evFail('decompress', 'DECOMPRESS_FAILED', error);
   }
+  ctx.decompressMs = Date.now() - decompressStarted;
 
   // 解压后 sha256 是硬校验：binaries.json 里没有它上面已经拒绝，这里不一致就拒绝落盘
   const actual = crypto.createHash('sha256').update(out).digest('hex');
@@ -206,7 +401,7 @@ async function main() {
     warn(`  期望 sha256: ${entry.sha256}`);
     warn(`  实际 sha256: ${actual}`);
     warn('  下载可能已损坏或被篡改，请重装重试');
-    return 1;
+    return evFail('verify-bin', 'SHA256_MISMATCH');
   }
 
   fs.mkdirSync(BIN_DIR, { recursive: true });
@@ -220,7 +415,7 @@ async function main() {
     fs.writeFileSync(TARGET, out, { mode: 0o755 });
   } catch (error) {
     warn(`放置二进制失败：${error && error.message ? error.message : String(error)}`);
-    return 1;
+    return evFail('write', 'WRITE_FAILED', error);
   }
   try {
     fs.chmodSync(TARGET, 0o755);
@@ -232,12 +427,17 @@ async function main() {
   const packedMB = (brBuf.length / 1048576).toFixed(1);
   log(`已安装 ${target}${note} ${sizeMB} MB（CDN 下载 ${packedMB} MB，${((Date.now() - started) / 1000).toFixed(1)}s）`);
   log(`installed at: ${TARGET}`);
-  return 0;
+  return evOk();
 }
 
 main()
   .catch((error) => {
     warn(`安装失败：${error && error.stack ? error.stack : String(error)}`);
-    return 1;
+    return evFail('unexpected', 'UNEXPECTED_ERROR', error);
   })
-  .then((code) => process.exit(code));
+  .then(async (outcome) => {
+    // 必须 await：process.exit 会掐掉一切在途请求。track 自己吞掉所有异常，
+    // 所以这里拿到的 outcome.code 与埋点成败无关
+    await track(outcome);
+    process.exit(outcome.code);
+  });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keruyun/agent-cli",
-  "version": "1.4.6",
+  "version": "1.4.7-beta.0",
   "description": "客如云 CLI 工具",
   "author": "玄宫",
   "license": "MIT",