@xyagent/cli 1.1.2 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyagent/cli",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "private": false,
   "description": "Relay-first CLI for pairing and bridging OpenClaw gateway traffic",
   "type": "module",
@@ -37,4 +37,4 @@
     "qrcode": "^1.5.4",
     "qrcode-terminal": "^0.12.0"
   }
-}
+}

package/src-ext/commands/pair.mjs

@@ -189,7 +189,7 @@ export async function runPairInstall({ runtime, code, options, log }) {
         `   卸载：agentlink uninstall -r ${runtime}\n`,
       );
     } else {
-      const logDir = `${process.env.HOME || "~"}/.agentlink/logs`;
+      const logDir = path.join(os.homedir(), ".agentlink", "logs");
       process.stderr.write(
         `⚠️  service 已装，但进程 3 秒内未运行起来。\n` +
         `   最可能原因：后台 PATH 里找不到 claude/codex，或 agent 启动崩溃。\n` +

package/src-ext/core/relayWorker.mjs

@@ -32,6 +32,9 @@ const POLL_WAIT_SECONDS = 25;
 const POLL_TIMEOUT_MS = (POLL_WAIT_SECONDS + 5) * 1000;
 // 默认 publishEvent 超时:单条事件 10s 足够(数据通常 < 1MB)。
 const PUBLISH_TIMEOUT_MS = 10_000;
+// 上报耗时超过这个值才记一行。正常是几十毫秒(同机 curl 实测 80ms),
+// 逐条 chunk 全记会把日志冲爆,所以只记异常的那些。
+const PUBLISH_SLOW_MS = 500;
 // 心跳间隔。服务端 gateway meta TTL 是 30s(http_gateway.go::gatewayMetaTTL),
 // 取 1/3 留充足容错(2 次心跳丢失仍保活)。
 export const META_HEARTBEAT_MS = 10_000;
@@ -88,22 +91,33 @@ export function createRelayWorker(opts) {
       return false;
     }
     const url = `${base}/v1/gateways/${gw}/requests/${encodeURIComponent(requestId)}/events`;
+    const startedAt = Date.now();
     try {
       const res = await fetchJson(
         url,
         { method: "POST", headers: { ...auth, "Content-Type": "application/json" }, body: JSON.stringify(event) },
         PUBLISH_TIMEOUT_MS,
       );
+      const elapsedMs = Date.now() - startedAt;
       if (!res.ok) {
         log.warn("publish.fail", extractError(res, `publish failed (HTTP ${res.status})`), {
-          requestId, event: event.event, status: res.status,
+          requestId, event: event.event, status: res.status, elapsedMs,
         });
         return false;
       }
+      // 🔴 成功也记耗时（2026-08-31 排查「桌面端每 25 秒才收到一批增量」时加的）：
+      // 那次卡在「增量到底是产生得晚，还是产生了但发出去慢」分不开 —— 上报成功
+      // 时一行日志都没有，等于这段完全不可观测。判据很简单：
+      //   · 个位数～几十 ms  → 上报是快的，慢在别处（relay 出口 / 桌面端接收）；
+      //   · 逼近 PUBLISH_TIMEOUT_MS(10s) → 请求在排队，多半是 long-poll 长期占着
+      //     同一条 keep-alive 连接（HTTP/1.1 同连接上的请求必须串行）。
+      // 只记耗时与事件名，不记 data（正文可能很长，且含用户对话内容）。
+      logSlowPublish(log, { requestId, event: event.event, elapsedMs });
       return true;
     } catch (err) {
       log.warn("publish.err", "publish errored", {
         requestId, event: event.event, err: err?.message || String(err),
+        elapsedMs: Date.now() - startedAt,
       });
       return false;
     }
@@ -119,6 +133,7 @@ export function createRelayWorker(opts) {
   // detail === "stopped" 时表示主动下线，其它（"ready" / "heartbeat" / "alive"）都视为在线。
   async function sendMeta(detail) {
     const url = `${base}/v1/gateways/${gw}/meta`;
+    const metaStartedAt = Date.now();
     const isAlive = detail !== "stopped";
     const stateLabel = detail === "stopped" ? "stopped"
                      : detail === "ready"   ? "running"
@@ -151,7 +166,12 @@ export function createRelayWorker(opts) {
       }
       return true;
     } catch (err) {
-      log.warn("meta.err", "meta heartbeat errored", { err: err?.message || String(err) });
+      // 带上耗时：贴着 PUBLISH_TIMEOUT_MS(10s) 说明是被超时掐的（排队 / 服务端慢），
+      // 远小于它则是连接层面直接失败（DNS / TCP / TLS）。两者的排查方向完全不同。
+      log.warn("meta.err", "meta heartbeat errored", {
+        err: err?.message || String(err),
+        elapsedMs: Date.now() - metaStartedAt,
+      });
       return false;
     }
   }
@@ -299,6 +319,25 @@ export function createRelayWorker(opts) {
   };
 }
 
+/**
+ * 上报慢到不正常时记一行。
+ *
+ * 判据（排查「桌面端每 25 秒才收到一批增量」用的）：
+ *   · 日志里一条都没有        → 上报是快的,慢在别处(relay 出口 / 桌面端接收侧);
+ *   · 大量 elapsedMs 逼近 10s → 请求在排队。最可能的原因是 long-poll
+ *     (POLL_WAIT_SECONDS=25) 长期占着同一条 keep-alive 连接,而 HTTP/1.1
+ *     同一连接上的请求必须串行,排在它后面的只能干等。
+ */
+export function logSlowPublish(log, fields) {
+  if (!fields || typeof fields.elapsedMs !== "number") return false;
+  if (fields.elapsedMs < PUBLISH_SLOW_MS) return false;
+  // 返回值 = 「有没有真的记下来」。log 不可用时如实返回 false,
+  // 不要因为「判定为慢」就报 true —— 调用方据此判断的是日志有没有落地。
+  if (typeof log?.warn !== "function") return false;
+  log.warn("publish.slow", "publish took unusually long", fields);
+  return true;
+}
+
 function sleep(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }

package/src-ext/runtime/_shared/ndjsonProcess.mjs

@@ -1,7 +1,62 @@
 import { spawn, spawnSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
 import readline from "node:readline";
 
 const VERSION_PROBE_TIMEOUT_MS = 5_000;
+
+// ── Windows .cmd shim 解析（openspec m-20260817-windows-runtime-parity 追加）──
+//
+// 🔴 为什么需要：qwen / kimi / codebuddy / opencode 在 Windows 上是 npm 的
+// `.cmd` shim；Node 对 .cmd/.bat 的无 shell spawn 直接失败（CVE-2024-27980 后
+// EINVAL），而 `shell: true` 会把含**用户 prompt**的 args 交给 cmd.exe 解析
+// （注入/折断面）。所以：`where` 解析出真实文件 → `.exe` 直接 spawn；
+// `.cmd`/`.bat` 读 shim 文本提取 node 入口 JS → `spawn(process.execPath,
+// [js, ...args])`（无 shell、无注入）。两者都不成立才兜底 shell:true。
+
+/**
+ * 从 npm cmd-shim 文本里提取 node 入口 JS 的相对路径（相对 shim 所在目录）。
+ * npm 生成的模板固定形如 `"%~dp0\node_modules\<pkg>\bin\x.js" %*`。
+ * 提不出返回 null（交给兜底）。
+ */
+export function parseCmdShimTarget(text) {
+  const m = /%~?dp0%?[\\/]([^"\r\n]+?\.(?:c|m)?js)"/i.exec(String(text || ""));
+  return m ? m[1] : null;
+}
+
+/** 把「裸命令名 + args」解析成当前平台可安全 spawn 的形态。 */
+function resolveSpawnSpec(binary, args) {
+  if (process.platform !== "win32" || path.isAbsolute(binary)) {
+    return { command: binary, args, shell: false };
+  }
+  const found = spawnSync("where", [binary], { encoding: "utf8", windowsHide: true });
+  const candidates = String(found.stdout || "")
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter(Boolean);
+  const exe = candidates.find((c) => /\.exe$/i.test(c));
+  if (exe) {
+    return { command: exe, args, shell: false };
+  }
+  const shim = candidates.find((c) => /\.(cmd|bat)$/i.test(c));
+  if (shim) {
+    try {
+      const target = parseCmdShimTarget(fs.readFileSync(shim, "utf8"));
+      if (target) {
+        const jsPath = path.resolve(path.dirname(shim), target);
+        if (fs.existsSync(jsPath)) {
+          return { command: process.execPath, args: [jsPath, ...args], shell: false };
+        }
+      }
+    } catch {
+      // 读 shim 失败走兜底
+    }
+    // 兜底：shell 方式跑 shim。args 会经 cmd 解析，是已知的折断面，
+    // 但比 ENOENT 完全不可用强 —— 只在解析失败时才落到这里。
+    return { command: shim, args, shell: true };
+  }
+  return { command: binary, args, shell: false };
+}
 const MAX_STDERR_CHARS = 8_000;
 export const PROCESS_TERMINATION_GRACE_MS = 3_000;
 // 子进程连续无任何 stdout/stderr 输出超过该上限视为卡死：kill 进程树并抛错，
@@ -24,10 +79,12 @@ function signalProcessTree(child, signal) {
 }
 
 export function probeBinary(binary) {
-  const result = spawnSync(binary, ["--version"], {
+  const spec = resolveSpawnSpec(binary, ["--version"]);
+  const result = spawnSync(spec.command, spec.args, {
     encoding: "utf8",
     timeout: VERSION_PROBE_TIMEOUT_MS,
     windowsHide: true,
+    shell: spec.shell,
   });
   if (result.error || result.status !== 0) {
     return {
@@ -52,10 +109,11 @@ export async function runNdjsonProcess({
   idleTimeoutMs = DEFAULT_IDLE_TIMEOUT_MS,
 }) {
   const childEnv = env ? { ...process.env, ...env } : process.env;
-  const child = spawn(binary, args, {
+  const spec = resolveSpawnSpec(binary, args);
+  const child = spawn(spec.command, spec.args, {
     cwd,
     env: childEnv,
-    shell: false,
+    shell: spec.shell,
     windowsHide: true,
     detached: process.platform !== "win32",
     // stdin 必须是 EOF：留 pipe 不关闭会让子进程（如 opencode run）等 stdin

package/src-ext/runtime/hermes/gatewayManager.mjs

@@ -776,7 +776,8 @@ export function spawnGatewayDetached({ binary, logPath, env, log }) {
     detached: true,
     stdio: ["ignore", fd, fd],
     env: { ...process.env, ...(env || {}) },
-    cwd: process.env.HOME || "/",
+    // os.homedir() 而非 process.env.HOME：Windows 上 HOME 常不存在（USERPROFILE 才有）
+    cwd: os.homedir(),
   });
   // 让 stdio FD 不阻塞 GC
   try { fs.closeSync(fd); } catch { /* ok */ }