dsh-agentone 0.5.23 → 0.5.24

package/lib/page.js

@@ -672,11 +672,12 @@ const cliAuthDialog = async (tool) => {
   }
 };
 
-/** CLI 一键安装：lark 走 npm 全局安装、ccpg/python 走官方安装器，耗时
- * 可达分钟级。响应自带安装后立即探测的详情，直接合进缓存刷新界面。 */
+/** CLI 一键安装：lark 走 npm 全局安装（机器无 Node.js 时先自动补装）、
+ * ccpg/python 走官方安装器，耗时可达数分钟。响应自带安装后立即探测的
+ * 详情，直接合进缓存刷新界面。 */
 const cliInstall = async (tool, btn) => {
   btn.disabled = true;
-  btn.textContent = '安装中，可能需要 1–3 分钟…';
+  btn.textContent = '安装中，可能需要 3–5 分钟…';
   try {
     const resp = await fetch('api/cli/install', {
       method: 'POST',

package/lib/proc.js

@@ -6,7 +6,7 @@
 // 例外——按 CVE-2024-27980 后的 Node 约定经 cmd.exe /d /s /c 执行，
 // 参数仍是数组形态）与错误翻译；包名/版本白名单在 index.js 的调用侧执行。
 import { execFile } from 'node:child_process';
-import { existsSync, mkdirSync, readdirSync, renameSync } from 'node:fs';
+import { existsSync, mkdirSync, readdirSync, renameSync, rmSync } from 'node:fs';
 import { homedir, tmpdir } from 'node:os';
 import { join, isAbsolute, delimiter as pathDelimiter } from 'node:path';
 import { promisify } from 'node:util';
@@ -40,8 +40,13 @@ function extraBinDirs() {
     );
     // nodejs.org 官方安装器默认系统级安装位（机器级 Program Files；
     // 机器上没有 node.exe 时不会注入 PATH，但兑底目录里如果找到了，
-    // 就能解析出 node/npm，不用再要求用户装 Node）。
-    dirs.push(join(programFiles, 'nodejs'), join(programFilesX86, 'nodejs'));
+    // 就能解析出 node/npm，不用再要求用户装 Node）+ 本插件一键补装的
+    // 用户级安装位（%LOCALAPPDATA%\Programs\nodejs，免管理员）。
+    dirs.push(
+      join(programFiles, 'nodejs'),
+      join(programFilesX86, 'nodejs'),
+      join(localAppData, 'Programs', 'nodejs'),
+    );
     // npm -g 默认 prefix、pnpm 默认 PNPM_HOME，以及 ccpg-cli Windows 官方
     // 安装器的落点 %USERPROFILE%\bin（本机实测 C:\Users\<user>\bin\
     // ccpg-cli.exe；装完不重启也能立即探测/自升级）。nodejs.org 安装器的
@@ -88,25 +93,29 @@ function extraBinDirs() {
   }
   // DSH Desktop 自带的 node/pnpm/dsh shim（Electron 当 node 用）：宿主只把
   // 这目录注入桌面终端的 PATH，插件子进程看不到——不兑底的话 dsh 自身有
-  // node 环境但 lark-cli 安装仍报「未找到 npm」。目录名是 profile 的 hash，
-  // 扫一层取含 bin 的子目录。Windows 桌面版把 shim 放在
-  // %LOCALAPPDATA%\\DSH Desktop\\shims（按官方约定），一并覆盖。
-  try {
-    const cliRoot = join(home, 'Library', 'Application Support', 'DSH Desktop', 'cli');
-    for (const entry of readdirSync(cliRoot)) {
-      const shimBin = join(cliRoot, entry, 'bin');
-      if (existsSync(join(shimBin, 'node'))) dirs.push(shimBin);
-    }
-  } catch {
-    // 非 macOS / 未生成终端 shim：跳过
-  }
-  if (process.platform === 'win32') {
+  // node 环境但 lark-cli 安装仍报「未找到 npm」。macOS 位
+  // ~/Library/Application Support/DSH Desktop/cli/<profile hash>/bin；
+  // Windows 实测在 Roaming 下（真实用户机报错的命令路径前缀就是
+  // C:\Users\<user>\AppData\Roaming\DSH…），Local 也一并扫。两种布局都
+  // 兼容：shims/ 直挂、cli/<hash>/bin。
+  const desktopRoots = process.platform === 'win32'
+    ? [
+      join(process.env.APPDATA || join(home, 'AppData', 'Roaming'), 'DSH Desktop'),
+      join(process.env.LOCALAPPDATA || join(home, 'AppData', 'Local'), 'DSH Desktop'),
+    ]
+    : [join(home, 'Library', 'Application Support', 'DSH Desktop')];
+  for (const root of desktopRoots) {
     try {
-      const shimDir = join(
-        process.env.LOCALAPPDATA || join(home, 'AppData', 'Local'),
-        'DSH Desktop', 'shims',
-      );
-      if (existsSync(join(shimDir, 'node.exe')) || existsSync(join(shimDir, 'node.cmd'))) dirs.push(shimDir);
+      const shimDir = join(root, 'shims');
+      if (existsSync(join(shimDir, 'node')) || existsSync(join(shimDir, 'node.exe')) || existsSync(join(shimDir, 'node.cmd'))) {
+        dirs.push(shimDir);
+      }
+      for (const entry of readdirSync(join(root, 'cli'))) {
+        const shimBin = join(root, 'cli', entry, 'bin');
+        if (existsSync(join(shimBin, 'node')) || existsSync(join(shimBin, 'node.exe')) || existsSync(join(shimBin, 'node.cmd'))) {
+          dirs.push(shimBin);
+        }
+      }
     } catch {
       // 目录不存在：跳过
     }
@@ -133,12 +142,18 @@ export function candidateSuffixes(platform) {
 /** win32 下 .cmd/.bat shim 的 execFile 等价调用形态（纯函数，供测试）：
  * Node ≥ 18.20/20.12（CVE-2024-27980 修复，DSH Desktop 内置 Node 同样
  * 受影响）起 execFile 直接执行 .cmd/.bat 会同步抛 spawn EINVAL，必须经
- * cmd.exe /d /s /c 解释。参数仍走数组、由 Node 按 Windows 规则引号转义，
- * 不拼接用户输入。非 win32 或非 shim 返回 null。 */
+ * cmd.exe /d /s /c 解释。
+ * 形态必须整行单参数 + 外层引号 + windowsVerbatimArguments（与 Node
+ * shell:true 的内部构造一致）：逐参数传数组时，含空格路径（如
+ * "C:\Users\x\AppData\Roaming\DSH Desktop\shims\npm.cmd"）会被 cmd /s 的
+ * 引号剥离规则在空格处拆断，报「不是内部或外部命令」（真实用户机实测）。
+ * 参数不拼接用户输入（白名单 tool + 固定 flag + 校验过的设备码/URL）。 */
 export function cmdShimInvocation(platform, resolved, args) {
   if (platform !== 'win32') return null;
   if (!/\.(cmd|bat)$/i.test(resolved)) return null;
-  return { file: 'cmd.exe', args: ['/d', '/s', '/c', resolved, ...args] };
+  const quote = (s) => (/[\s"]/.test(s) ? `"${String(s).replace(/"/g, '""')}"` : String(s));
+  const line = [resolved, ...args].map(quote).join(' ');
+  return { file: 'cmd.exe', args: ['/d', '/s', '/c', `"${line}"`], verbatim: true };
 }
 
 /** PATH 环境变量键名（纯函数，供测试）：win32 下实际键通常是 Path，注入
@@ -192,12 +207,29 @@ export function resolveCommand(tool) {
   return resolveCommandOrNull(tool) || tool;
 }
 
+/** 子进程输出解码（纯函数，供测试）：Windows 中文系统的 cmd/批处理内部
+ * 错误是 GBK 编码（如「'xx' 不是内部或外部命令」），而 npm/node 自身输出
+ * 是 UTF-8——先按 UTF-8 严格解码，失败退化 GBK，乱码（♦/锟斤拷）不进
+ * 用户可见的错误提示。 */
+export function decodeOutput(buf) {
+  const bytes = Buffer.isBuffer(buf) ? buf : Buffer.from(String(buf ?? ''));
+  try {
+    return new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+  } catch {
+    try {
+      return new TextDecoder('gbk').decode(bytes);
+    } catch {
+      return bytes.toString('utf-8');
+    }
+  }
+}
+
 /** 统一的子进程执行：解析命令路径，并把**所有兑底目录**前置进子进程
  * PATH——win32 下 npm/lark-cli 是 .cmd shim（`%~dp0\node.exe` 找 node），
  * node 可能在另一个兑底目录（nodejs.org 系统安装位）；.cmd 又经
  * cmd.exe /d /s /c 路由，cmd.exe 在第三个兑底目录（System32）。只前置
- * 解析到的那个目录会让 shim 内部找不到依赖，必须整组前置。opts.env 只
- * 传增量变量。 */
+ * 解析到的那个目录会让 shim 内部找不到依赖，必须整组前置。输出按
+ * encoding:buffer 收回后 decodeOutput（GBK 容错）。opts.env 只传增量变量。 */
 function execResolved(tool, args, { timeoutMs, cwd, env } = {}) {
   const resolved = resolveCommand(tool);
   const childEnv = { ...process.env, ...(env || {}) };
@@ -212,7 +244,18 @@ function execResolved(tool, args, { timeoutMs, cwd, env } = {}) {
     killSignal: 'SIGKILL',
     cwd,
     env: childEnv,
-  });
+    encoding: 'buffer',
+    windowsVerbatimArguments: shim?.verbatim === true,
+  }).then(
+    ({ stdout, stderr }) => ({ stdout: decodeOutput(stdout), stderr: decodeOutput(stderr) }),
+    (error) => {
+      if (error && (error.stdout !== undefined || error.stderr !== undefined)) {
+        error.stdout = decodeOutput(error.stdout);
+        error.stderr = decodeOutput(error.stderr);
+      }
+      throw error;
+    },
+  );
 }
 
 /** 从 pnpm 冗长输出里提取对用户有意义的错误行。 */
@@ -503,13 +546,18 @@ export async function installCliTool(tool, { timeoutMs = 600_000 } = {}) {
   let stdout;
   if (tool === 'lark-cli') {
     // 预检+降级链：优先独立 npm；没有 npm 但有 pnpm（含 DSH Desktop 自带
-    // shim）时用 pnpm 全局装——lark-cli 官方支持 pnpm 安装方式，装出来的
-    // 二进制与 npm 路径一致，后续 lark-cli update 也能自升级。
-    // 两者都没有才报「装 Node.js」指引。
+    // shim）时用 pnpm 全局装；两者都没有时 Windows 先一键补装 Node.js
+    // （用户目录免管理员，npmmirror 镜像），再用其自带 npm 装 lark-cli。
+    // lark-cli 官方支持 pnpm 安装方式，装出来的二进制与 npm 路径一致，
+    // 后续 lark-cli update 也能自升级。
     if (resolveCommandOrNull('npm')) {
       ({ stdout } = await runCliTool('npm', ['install', '-g', '@larksuite/cli@latest'], { timeoutMs }));
     } else if (resolveCommandOrNull('pnpm')) {
       ({ stdout } = await runCliTool('pnpm', ['add', '-g', '@larksuite/cli@latest'], { timeoutMs }));
+    } else if (process.platform === 'win32') {
+      const nodeNote = await installNodeWindows(timeoutMs);
+      ({ stdout } = await runCliTool('npm', ['install', '-g', '@larksuite/cli@latest'], { timeoutMs }));
+      stdout = `${nodeNote}\n${stdout}`;
     } else {
       throw new Error(missingCommandGuidance('npm'));
     }
@@ -677,6 +725,58 @@ async function installPythonWindows(timeoutMs) {
   };
 }
 
+/** Node.js Windows 一键补装（lark-cli 的运行时依赖：机器无 node/npm/pnpm
+ * 时自动补，用户不再被要求「先自行安装 Node.js」）：
+ * 1) npmmirror 二进制镜像优先（官网 nodejs.org 国内慢/不稳），失败退官网；
+ *    zip 包绿色解压，不走 MSI（免管理员/UAC）
+ * 2) 解压到 %LOCALAPPDATA%\Programs\nodejs（与 python.org 每用户安装同
+ *    级的标准位置），写用户 PATH（注册表 User 作用域）
+ * 3) npm 全局 prefix 即该目录，后续装的 lark-cli 也落这里——兑底目录已
+ *    覆盖，装完本进程内即可探测
+ * 全程 execFile 参数数组，不经 shell。 */
+const NODE_WINDOWS_VERSION = 'v22.17.0';
+const NODE_WINDOWS_ZIP_URLS = [
+  `https://registry.npmmirror.com/-/binary/node/${NODE_WINDOWS_VERSION}/node-${NODE_WINDOWS_VERSION}-win-x64.zip`,
+  `https://nodejs.org/dist/${NODE_WINDOWS_VERSION}/node-${NODE_WINDOWS_VERSION}-win-x64.zip`,
+];
+
+async function installNodeWindows(timeoutMs) {
+  const localAppData = process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local');
+  const programsDir = join(localAppData, 'Programs');
+  const nodeHome = join(programsDir, 'nodejs');
+  const zip = join(tmpdir(), 'node-setup.zip');
+  let downloaded = false;
+  let lastError = null;
+  for (const url of NODE_WINDOWS_ZIP_URLS) {
+    try {
+      await runCliTool('curl', [
+        '-fsSL', '--retry', '2', '--retry-delay', '3', '--max-time', '600',
+        '--speed-limit', '65536', '--speed-time', '30',
+        '-o', zip, url,
+      ], { timeoutMs });
+      downloaded = true;
+      break;
+    } catch (error) {
+      lastError = error;
+    }
+  }
+  if (!downloaded) throw lastError || new Error('Node.js 安装包下载失败，请检查网络后重试');
+  mkdirSync(programsDir, { recursive: true });
+  // PowerShell Expand-Archive（Win10+ 自带）。路径单引号内嵌转义防空格/引号
+  const psQuote = (p) => `'${p.replace(/'/g, "''")}'`;
+  await runCliTool('powershell', [
+    '-NoProfile', '-Command',
+    `Expand-Archive -LiteralPath ${psQuote(zip)} -DestinationPath ${psQuote(programsDir)} -Force`,
+  ], { timeoutMs });
+  // zip 内层目录名 node-vX.Y.Z-win-x64 → 平铺为 nodejs（重装时先清旧目录）
+  rmSync(nodeHome, { recursive: true, force: true });
+  renameSync(join(programsDir, `node-${NODE_WINDOWS_VERSION}-win-x64`), nodeHome);
+  rmSync(zip, { force: true });
+  await ensureUserPathContains(nodeHome).catch(() => {});
+  resetExtraBinDirsCache();
+  return `Node.js ${NODE_WINDOWS_VERSION} 安装完成（${nodeHome}）`;
+}
+
 /**
  * 触发 CLI 官方自升级（`tool update`）：ccpg-cli 从更新服务器下载二进制
  * （~17MB），新版 lark-cli 自动探测 npm/pnpm/手动安装方式（手动时只打印

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-agentone",
-  "version": "0.5.23",
+  "version": "0.5.24",
   "description": "AgentOne 平台集成插件：飞书登录、平台模型（同步失败自愈重试）、SkillHub 技能（升级检测一键升级、装后即时刷新、套餐技能自动同步）、套餐申请、插件管理与自助升级、lark-cli / ccpg-cli 探测与一键安装（请求超时与错误码透传、令牌轮换 single-flight、凭据损坏容错与并发安全写入、状态页 UX 增强）",
   "type": "module",
   "main": "lib/index.js",