dsh-agentone 0.5.23 → 0.5.25

package/README.md

@@ -108,6 +108,7 @@ lib/
   skill.js   技能下载/解包/卸载（zip 穿越清洗、原子落盘）
   store.js   凭据持久化（0600；损坏自动移开）
   proc.js    dsh/pnpm CLI 转发与 lark-cli/ccpg-cli 探测
+  qrcode.mjs 授权 URL 的二维码 SVG（vendor qrcode-generator，MIT；lark/ccpg 通用）
   client.js  dsh 浏览器端 bundle（设置菜单 iframe + 首启引导 + 设置导航 workbench 图标换肤）
 ```
 

package/lib/cliauth.mjs

@@ -7,8 +7,8 @@
 //                    --json 时去掉重试（文本解析兜底）。
 //   completeCliAuth  用 begin 拿到的设备码轮询并完成授权（阻塞至用户在
 //                    授权页同意或超时）。
-//   cliAuthQrcode    lark-cli 的 auth qrcode --ascii 生成终端二维码（状态页
-//                    等宽字体直接渲染）。
+//   cliAuthQrcode    授权 URL 渲染二维码 SVG（内置生成，见 lib/qrcode.mjs；
+//                    页面 <img> 直接展示）。
 //
 // 安全：所有子进程经 runCliTool（execFile 参数数组，无 shell 参与）。设备码
 // 是 begin 步骤本机 CLI 自己签发的随机 token，非用户自由输入；仍先过
@@ -16,6 +16,7 @@
 // 失败直接抛中文错误、不触碰子进程。校验后的 token 以独立 argv 元素传给
 // execFile——无 shell 二次解析，token 字符集也决定了它不可能被解释为选项。
 import { runCliTool } from './proc.js';
+import { qrSvg } from './qrcode.mjs';
 
 /** 授权 begin/complete 超时对齐平台 cli-deployd（begin 30s / complete 240s）。 */
 export const CLI_AUTH_BEGIN_TIMEOUT_MS = 30_000;
@@ -69,12 +70,16 @@ export async function completeCliAuth(tool, rawDeviceCode, { timeoutMs = CLI_AUT
   return combineOutput(stdout, stderr);
 }
 
-/** lark-cli 生成授权 URL 的 ASCII 二维码（状态页等宽字体直接渲染）。 */
-export async function cliAuthQrcode(url, { timeoutMs = 15_000 } = {}) {
-  const { stdout } = await runCliTool('lark-cli', ['auth', 'qrcode', String(url || ''), '--ascii'], {
-    timeoutMs,
-  });
-  return String(stdout || '').trim();
+/** 授权 URL 的二维码 SVG（内置生成，lark-cli / ccpg-cli 通用——ccpg
+ * 没有二维码子命令，也不应让 lark-cli 成为 ccpg 授权的前置依赖；与平台
+ * /api/qr 服务端生成同一模式；页面 <img data:URL> 直接渲染）。失败抛
+ * 中文错误。 */
+export function cliAuthQrcode(url) {
+  const text = String(url || '');
+  if (!/^https?:\/\//.test(text)) {
+    throw new Error('授权链接格式不正确，无法生成二维码');
+  }
+  return qrSvg(text);
 }
 
 /**

package/lib/index.js

@@ -1350,7 +1350,9 @@ export function apply(ctx, config) {
           // 单次 complete 限时 25s：complete 是真长轮询（CLI 阻塞到用户同意
           // 或设备码过期），若不限时前端每轮询一次就叠一个子进程，几十个
           // lark-cli 同时轮同一码。这里 25s 一掐，前端串行重试（见 page.js）。
+          const startedAt = Date.now();
           await completeCliAuth(tool, deviceCode, { timeoutMs: 25_000 });
+          log.info(`cli auth complete ok: tool=${tool} elapsed=${Date.now() - startedAt}ms`);
           pendingCliAuth.delete(tool);
           const detail = await probeCliDetail(tool).then(withCliUpgradeGuard).catch(() => null);
           sendJson(response, 200, { ok: true, tool: detail });
@@ -1360,7 +1362,20 @@ export function apply(ctx, config) {
           // 慢一点授权就会因会话被删而 400「重新发起」。
           const message = String(error?.message || '');
           const terminal = /expired|invalid|denied|拒绝|失效|过期/i.test(message);
+          // 快速失败 ≠ 还在等：真实用户机实测，lark-cli 在部分宿主环境拒绝
+          // 阻塞轮询（打印 [AI agent] 提示后退出），且设备码被同意消费后
+          // 重放会快速报 JSON 错——这两种情况用户其实已完成授权，纯 202
+          // 会让弹窗永远停在「正在等待」。用 auth status 实测兜底：已授权
+          // 直接按成功返回，弹窗关闭、状态刷新。
+          const detail = await probeCliDetail(tool).then(withCliUpgradeGuard).catch(() => null);
+          if (detail?.state === 'authorized') {
+            pendingCliAuth.delete(tool);
+            log.info(`cli auth complete ok (via status probe): tool=${tool}`);
+            sendJson(response, 200, { ok: true, tool: detail });
+            return;
+          }
           if (terminal) pendingCliAuth.delete(tool);
+          log.warn(`cli auth complete ${terminal ? 'terminal' : 'timeout'}: tool=${tool} message=${message.slice(0, 160)}`);
           sendJson(response, terminal ? 502 : 202, {
             pending: !terminal,
             error: message,
@@ -1378,25 +1393,19 @@ export function apply(ctx, config) {
         return;
       }
       // 只为 begin 返回过的 URL 生成二维码：URL 来自本机 CLI 输出，但也不
-      // 直接接受前端任意 URL（避免把本接口当任意二维码渲染器）。
+      // 直接接受前端任意 URL（避免把本接口当任意二维码渲染器）。任意
+      // CLI（lark-cli / ccpg-cli）的进行中授权会话均可——二维码由内置
+      // 编码器生成（lib/qrcode.mjs），不依赖 lark-cli 本机存在。
       const queryUrl = new URL(request.url, 'http://localhost').searchParams.get('url') || '';
-      const pending = [...pendingCliAuth.keys()];
-      let matched = false;
-      for (const tool of pending) {
-        if (tool === 'lark-cli' && queryUrl) {
-          matched = true;
-          break;
-        }
-      }
-      if (!matched) {
+      if (!queryUrl || pendingCliAuth.size === 0) {
         sendJson(response, 400, { error: '没有进行中的授权会话' });
         return;
       }
       try {
-        const ascii = await cliAuthQrcode(queryUrl);
-        if (!ascii) throw new Error('二维码生成失败');
-        response.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
-        response.end(ascii);
+        const svg = await cliAuthQrcode(queryUrl);
+        if (!svg) throw new Error('二维码生成失败');
+        response.writeHead(200, { 'Content-Type': 'image/svg+xml' });
+        response.end(svg);
       } catch (error) {
         sendJson(response, 502, { error: error?.message || '二维码生成失败' });
       }

package/lib/page.js

@@ -567,14 +567,13 @@ const renderCliData = (s, tools, python) => {
  * 弹窗关闭即停轮询；设备码只存插件后端内存，前端不回传。
  */
 const cliAuthDialog = async (tool) => {
-  const toolLabel = CLI_TOOL_META[tool]?.label || tool;
   const overlay = document.createElement('div');
   overlay.className = 'modal-backdrop';
   overlay.innerHTML = '<div class="card" style="max-width:420px;margin:8% auto;text-align:left">'
     + '<h3 style="margin:0 0 6px">授权 ' + esc(tool) + '</h3>'
     + '<div id="cli-auth-status" class="skill-sub">正在发起授权…</div>'
-    + '<pre id="cli-auth-qr" style="display:none;background:var(--card,#fff);color:#111;'
-    + 'border-radius:10px;padding:8px;font:11px/1.15 ui-monospace,monospace;overflow:auto;margin:10px 0"></pre>'
+    + '<img id="cli-auth-qr" alt="授权二维码" style="display:none;width:100%;max-width:300px;'
+    + 'background:#fff;border-radius:10px;margin:10px 0">'
     + '<div id="cli-auth-link"></div>'
     + '<div class="row" style="margin-top:12px;justify-content:flex-end">'
     + '<button id="cli-auth-open" class="btn small primary" hidden>打开授权页</button>'
@@ -601,14 +600,15 @@ const cliAuthDialog = async (tool) => {
     });
     const data = await resp.json().catch(() => ({}));
     if (!resp.ok) throw new Error(data.error || '发起授权失败');
-    statusEl.textContent = '用' + esc(toolLabel) + '扫二维码，或打开链接完成授权。同意后此处会自动确认。';
-    // ASCII 二维码（lark-cli 本机生成；失败退化为纯链接）
+    statusEl.textContent = '用手机飞书 App 扫二维码，或打开链接完成授权。同意后此处会自动确认。';
+    // 二维码 SVG（服务端内置生成，lark-cli / ccpg-cli 通用；矢量随卡片缩放，
+    // 失败退化为纯链接）
     fetch('api/cli/auth/qrcode?url=' + encodeURIComponent(data.verification_url))
       .then((r) => (r.ok ? r.text() : ''))
-      .then((ascii) => {
+      .then((svg) => {
         const qr = overlay.querySelector('#cli-auth-qr');
-        if (ascii) {
-          qr.textContent = ascii;
+        if (svg && svg.startsWith('<svg')) {
+          qr.src = 'data:image/svg+xml;utf8,' + encodeURIComponent(svg);
           qr.style.display = 'block';
         }
       })
@@ -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,9 +6,9 @@
 // 例外——按 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 { join, dirname, isAbsolute, delimiter as pathDelimiter } from 'node:path';
 import { promisify } from 'node:util';
 
 const execFileAsync = promisify(execFile);
@@ -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 安装器的
@@ -86,40 +91,100 @@ function extraBinDirs() {
     }
     dirs.push(join(home, '.local/bin'), '/opt/homebrew/bin', '/usr/local/bin');
   }
-  // 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') {
+  // DSH Desktop shim 目录固定排在兑底列表末尾：这些 shim 是 Electron 当
+  // node 用的包装（见 desktopShimDirs），真工具链存在时应让位。
+  dirs.push(...desktopShimDirs());
+  extraBinDirsCache = dirs;
+  return dirs;
+}
+
+/** DSH Desktop 自带的 node/pnpm/dsh shim 目录（Electron 当 node 用）：宿主
+ * 只把这目录注入桌面终端的 PATH，插件子进程看不到——不兑底的话 dsh 自身有
+ * 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。独立成函数并单独缓存：extraBinDirs
+ * 引用之外，execResolved 还要用它把这些 shim 目录排到子进程 PATH 末尾。 */
+let desktopShimDirsCache = null;
+export function desktopShimDirs() {
+  if (desktopShimDirsCache !== null) return desktopShimDirsCache;
+  const dirs = [];
+  const home = homedir();
+  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 {
       // 目录不存在：跳过
     }
   }
-  extraBinDirsCache = dirs;
+  desktopShimDirsCache = dirs;
   return dirs;
 }
 
+/** Windows 端 DSH Desktop shim（node.cmd/pnpm.cmd/dsh.cmd）本体是批处理，
+ * 靠 DSH_DESKTOP_APP_EXECUTABLE / DSH_DESKTOP_PNPM_ENTRY /
+ * DSH_DESKTOP_ELECTRON_VERSION 三个环境变量定位 Electron 与 pnpm 入口；
+ * 但这组变量是桌面端「集成终端」专属生成环境（desktop-terminal 模块的
+ * WINDOWS_GENERATED_ENVIRONMENT_KEYS），插件宿主进程（utilityProcess.fork
+ * 起的 Electron-as-node）并不携带——变量为空时 shim 里 "%VAR%" 展开成
+ * ""，任何命中 shim 的调用都报 '""' 不是内部或外部命令（0.5.24 把 shim
+ * 目录加进兑底后，lark-cli.cmd 内层 `node` 查找也会命中它）。
+ * 插件宿主本身就是同一个 Electron 二进制以 ELECTRON_RUN_AS_NODE 跑的，
+ * 缺的值可以精确补齐：可执行文件 = process.execPath，版本 =
+ * process.versions.electron，pnpm 入口 = <安装目录>/resources/app/
+ * node_modules/pnpm/bin/pnpm.mjs（桌面端 terminalEnvironment 同源）。
+ * 仅在 win32 + Electron 宿主 + 变量缺失时补；已有值（集成终端内）不覆盖。 */
+export function desktopShimEnvDefaults({
+  env = process.env,
+  execPath = process.execPath,
+  versions = process.versions,
+  platform = process.platform,
+} = {}) {
+  if (platform !== 'win32') return {};
+  if (!versions || !versions.electron) return {};
+  if (env.DSH_DESKTOP_APP_EXECUTABLE) return {};
+  const defaults = {
+    DSH_DESKTOP_APP_EXECUTABLE: execPath,
+    DSH_DESKTOP_ELECTRON_VERSION: versions.electron,
+  };
+  const pnpmEntry = join(dirname(execPath), 'resources', 'app', 'node_modules', 'pnpm', 'bin', 'pnpm.mjs');
+  if (existsSync(pnpmEntry)) defaults.DSH_DESKTOP_PNPM_ENTRY = pnpmEntry;
+  return defaults;
+}
+
+/** 组装子进程 PATH（纯函数，供测试）：非 shim 兑底目录排最前（GUI 贫瘠
+ * PATH 也能解析到真工具），原有 PATH 居中，DSH Desktop shim 目录垫底——
+ * shim 是 Electron 包装，真 node/pnpm 存在时优先用真的；贫瘠机器上原
+ * PATH 找不到，shim 仍能兜底（配合 desktopShimEnvDefaults 补齐变量）。 */
+export function childPathWithExtras(originalPath, extras, shimDirs) {
+  const shimSet = new Set(shimDirs);
+  const head = extras.filter((dir) => !shimSet.has(dir));
+  const tail = extras.filter((dir) => shimSet.has(dir));
+  return [...head, originalPath || '', ...tail].filter(Boolean).join(pathDelimiter);
+}
+
 /** 安装完成后清空兑底目录缓存：一键安装 python/ccpg 后新目录要立即可
  * 探测（python.org 装到 %LOCALAPPDATA%\Programs\Python\Python3xx），不
  * 能等 DSH Desktop 重启。 */
 export function resetExtraBinDirsCache() {
   extraBinDirsCache = null;
+  desktopShimDirsCache = null;
 }
 
 /** 候选扩展名顺序（纯函数，供测试）：win32 下 CreateProcess 只认可执行
@@ -133,12 +198,21 @@ 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] };
+  // 引号判定必须覆盖 cmd 元字符：& | < > ^ ( ) 在裸参里会被 cmd 当命令
+  // 分隔/重定向/转义符——授权 URL 里的 &user_code=... 曾被拆成独立命令，
+  // lark-cli 收到截断 URL 直接报错；引号内这些字符全部是字面量。
+  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,19 +266,36 @@ 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 || {}) };
+  const childEnv = { ...process.env, ...desktopShimEnvDefaults(), ...(env || {}) };
   const key = pathEnvKey(childEnv, process.platform);
   const extras = extraBinDirs().filter((dir) => existsSync(dir));
   if (extras.length) {
-    childEnv[key] = [...extras, childEnv[key] || ''].filter(Boolean).join(pathDelimiter);
+    childEnv[key] = childPathWithExtras(childEnv[key], extras, desktopShimDirs());
   }
   const shim = cmdShimInvocation(process.platform, resolved, args);
   return execFileAsync(shim ? shim.file : resolved, shim ? shim.args : args, {
@@ -212,7 +303,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 +605,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'));
     }
@@ -602,11 +709,19 @@ async function installCcpgCliWindows(timeoutMs) {
   mkdirSync(binDir, { recursive: true });
   const url = await resolveCcpgWindowsDownloadUrl();
   const staging = join(binDir, 'ccpg-cli.exe.download');
-  await runCliTool('curl', [
-    '-fsSL', '--retry', '3', '--retry-delay', '5', '--max-time', '600',
-    '--speed-limit', '65536', '--speed-time', '30',
-    '-o', staging, url,
-  ], { timeoutMs });
+  try {
+    await runCliTool('curl', [
+      '-fsSL', '--retry', '3', '--retry-delay', '5', '--max-time', '600',
+      '--speed-limit', '65536', '--speed-time', '30',
+      '-o', staging, url,
+    ], { timeoutMs });
+  } catch (error) {
+    // 公司下载服务 504/超时时 curl 带重试日志的原样输出对用户既不可读也
+    // 无法行动（真实用户机实测弹了三行「curl:(22) …504」）——翻译成一句
+    // 可执行的中文；服务本身是否恢复是外部依赖，插件侧只能明确告知
+    try { rmSync(staging, { force: true }); } catch { /* 尽力清理半截文件 */ }
+    throw new Error(`ccpg-cli 下载失败：公司下载服务当前不可用（网关超时或连接失败），请稍后重试「安装」；若持续失败请联系管理员检查下载服务（bms.einwin.com）。技术详情：${firstErrorLines(`${error.stdout || ''}\n${error.stderr || ''}`) || '下载中断'}`);
+  }
   renameSync(staging, target);
   // 校验二进制可执行（PE 完整、架构匹配）
   const { stdout: versionOut } = await runCliTool(target, ['--version'], { timeoutMs: 30_000 });
@@ -677,6 +792,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/lib/qrcode.mjs

@@ -0,0 +1,50 @@
+// 内置二维码生成（授权 URL 渲染 SVG，页面 <img> 直接展示）。
+//
+// 与平台 `/api/qr`（Python qrcode 库，服务端 SVG）同一模式：服务端生成、
+// 不依赖任何本机 CLI——ccpg-cli 没有二维码子命令，lark-cli 也不该成为
+// ccpg 授权的前置条件。编码用 vendor 的 qrcode-generator（MIT，Kazuhiko
+// Arase；矩阵正确性已经 OpenCV 解码回原文 + 与 lark-cli 原生二维码功能
+// 图形比对双重验证）。
+//
+// 渲染选 SVG 而非 ASCII：ASCII 的块字符（█▀▄）在 Windows 网页字体回退下
+// 列宽错位、行高不满格，真机出现过「显示不全 + 识别不出」；SVG 矢量无
+// 字体依赖、随容器缩放。ASCII 版保留给终端/日志场景。
+import createQrcode from './vendor/qrcode-generator.mjs';
+
+/** 生成二维码模块矩阵：qr.isDark(row, col) / getModuleCount()（供测试比对）。 */
+export function qrMatrix(text, { ecLevel = 'M' } = {}) {
+  const qr = createQrcode(0, ecLevel);
+  qr.addData(String(text || ''), 'Byte');
+  qr.make();
+  return qr;
+}
+
+/** 授权二维码 SVG（scalable，无固定宽高，随 <img> 容器缩放）。
+ * 注意 vendor 的 margin 是像素单位：静区 4 模块必须传 cellSize * 4，
+ * 传 4 只会得到 1 模块静区（真机识别失败的另一半原因）。 */
+export function qrSvg(text, { ecLevel = 'M', cellSize = 4 } = {}) {
+  const qr = qrMatrix(text, { ecLevel });
+  return qr.createSvgTag({ cellSize, margin: cellSize * 4, scalable: true });
+}
+
+/** 渲染 ASCII 二维码（终端/日志场景；两行一字符 + 四模块静区）。
+ * 行尾空白保留——右侧静区是扫码识别的规格要求，裁掉会识别失败。 */
+export function qrAscii(text, { ecLevel = 'M', quietZone = 4 } = {}) {
+  const qr = qrMatrix(text, { ecLevel });
+  const size = qr.getModuleCount();
+  const total = size + quietZone * 2;
+  const darkAt = (row, col) => (row >= quietZone && row < quietZone + size
+    && col >= quietZone && col < quietZone + size
+    && qr.isDark(row - quietZone, col - quietZone));
+  const lines = [];
+  for (let row = 0; row < total; row += 2) {
+    let line = '';
+    for (let col = 0; col < total; col += 1) {
+      const top = darkAt(row, col);
+      const bottom = darkAt(row + 1, col);
+      line += top && bottom ? '█' : top ? '▀' : bottom ? '▄' : ' ';
+    }
+    lines.push(line);
+  }
+  return lines.join('\n');
+}