dsh-agentone 0.5.24 → 0.5.26

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

@@ -44,6 +44,8 @@ body {
 .kv { display: flex; justify-content: space-between; gap: 12px; padding: 5px 0; }
 .kv .k { color: var(--muted); flex-shrink: 0; }
 .kv .v { text-align: right; word-break: break-all; }
+.kv .v a { color: var(--brand); text-decoration: none; }
+.kv .v a:hover { text-decoration: underline; }
 button {
   font: inherit; cursor: pointer; border-radius: 10px; transition: filter .15s, opacity .15s;
   border: 1px solid transparent;
@@ -153,7 +155,23 @@ const notify = (message, kind) => {
   // 错误信息可能较长（含平台原因），给足阅读时间；成功提示维持 4s
   toastTimer = setTimeout(() => { toast.className = 'banner'; }, kind === 'err' ? 10000 : 4000);
 };
-const withLoading = async (btn, action, okMessage) => {
+// withLoading 收尾的刷新分两档：
+//   'status'（默认）——拉 /api/status 并整页 refresh()。模型/SkillHub/登录类
+//     操作后的语义（页面各卡都要对齐新状态）。
+//   'quiet'——只拉一次 status 快照（不打散正在看的列表）+ 刷新技能列表
+//     （指纹保护下内容没变不会重绘）。技能/插件操作用这档：整页 refresh
+//     会把当前列表闪一遍「读取中…」，还重建按钮节点打断二次确认。
+//   null——完全不动界面（调用方自己刷，如插件列表升级后 renderPlugins）。
+const refreshStatusQuietly = async () => {
+  try {
+    const s = await (await fetch('api/status')).json();
+    lastStatus = s;
+    renderSkills(s);
+  } catch {
+    // 网络抖动：保持现状，下一轮 5s 轮询会自然对齐
+  }
+};
+const withLoading = async (btn, action, okMessage, refreshMode = 'status') => {
   const original = btn.innerHTML;
   btn.disabled = true;
   btn.innerHTML = '<span class="spin"></span>' + (btn.dataset.loading || '处理中…');
@@ -167,7 +185,8 @@ const withLoading = async (btn, action, okMessage) => {
   } finally {
     btn.disabled = false;
     btn.innerHTML = original;
-    await refresh();
+    if (refreshMode === 'status') await refresh();
+    else if (refreshMode === 'quiet') await refreshStatusQuietly();
   }
 };
 // 卸载类破坏性操作的轻量二次确认：第一次点击把按钮变成「确认卸载？」，
@@ -256,6 +275,7 @@ const syncPlanSkills = (btn) => withLoading(
   btn,
   () => fetch('api/skill/sync', { method: 'POST' }),
   null,
+  'quiet',
 );
 const skillAction = (slug, action, btn, successText) => withLoading(
   btn,
@@ -265,6 +285,8 @@ const skillAction = (slug, action, btn, successText) => withLoading(
     body: JSON.stringify({ slug }),
   }),
   successText || (action === 'install' ? '技能已安装' : '技能已卸载'),
+  // 技能装/卸后只需技能列表指纹更新；整页 refresh 会闪一遍各卡片
+  'quiet',
 );
 const PLAN_CAPABILITY_LABELS = {
   image_understanding_enabled: '图片理解',
@@ -462,8 +484,13 @@ const renderCli = async (s) => {
     body.innerHTML = '<div class="skill-sub">平台未开启 CLI 功能。</div>';
     return;
   }
-  // 真实探测本机安装与授权态（数秒），期间先展示读取中
-  body.innerHTML = '<div class="skill-sub">检测中…</div>';
+  // 真实探测本机安装与授权态（数秒）。有旧数据（renderCli._tools）时先用
+  // 缓存渲染再后台刷新——不清屏闪「检测中…」，内容回来后整块替换一次。
+  if (renderCli._tools && Object.keys(renderCli._tools).length) {
+    renderCliData(s, {});
+  } else {
+    body.innerHTML = '<div class="skill-sub">检测中…</div>';
+  }
   let tools;
   let python;
   try {
@@ -473,7 +500,10 @@ const renderCli = async (s) => {
     tools = data.tools || {};
     python = data.python || null;
   } catch {
-    body.innerHTML = '<div class="skill-sub" style="color:var(--err)">CLI 状态检测失败，请稍后重试。</div>';
+    // 探测失败：已有内容保持不动，首载才显示错误
+    if (!renderCli._tools || !Object.keys(renderCli._tools).length) {
+      body.innerHTML = '<div class="skill-sub" style="color:var(--err)">CLI 状态检测失败，请稍后重试。</div>';
+    }
     return;
   }
   renderCliData(s, tools, python);
@@ -567,14 +597,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 +630,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';
         }
       })
@@ -744,17 +774,27 @@ const pluginAction = (name, action, btn) => withLoading(
   action === 'install' ? '插件已安装，重启 DSH 后生效'
     : action === 'remove' ? '插件已卸载'
       : '插件已升级，重启 DSH 后生效',
+  // 插件列表由下方 renderPlugins 定向刷新（自带指纹保护），不走整页 refresh
+  null,
 ).then(() => renderPlugins());
 const renderPlugins = async () => {
   const list = $('plugins-list');
-  list.innerHTML = '<div class="skill-sub">读取中…</div>';
+  // 有旧内容时不闪「读取中…」：后台拉取，回来后整块替换（配合下方指纹
+  // 保护，内容没变连替换都省了）。首载（空容器）才显示占位。
+  if (!list.children.length) {
+    list.innerHTML = '<div class="skill-sub">读取中…</div>';
+  }
   let data;
   try {
     const resp = await fetch('api/plugin/list');
     data = await resp.json().catch(() => ({}));
     if (!resp.ok) throw new Error(data.error || '读取插件列表失败');
   } catch (error) {
-    list.innerHTML = '<div class="skill-sub" style="color:var(--err)">' + esc(error.message) + '</div>';
+    // 拉取失败：已有内容保持不动（只是旧了），首载才显示错误
+    if (!list.children.length || list.dataset.loaded === '1') {
+      list.innerHTML = '<div class="skill-sub" style="color:var(--err)">' + esc(error.message) + '</div>';
+      delete list.dataset.loaded;
+    }
     return;
   }
   // 渲染成功即标记已加载：避免切 tab 重复拉取（outdated 查询有网络开销）
@@ -805,7 +845,21 @@ const renderPlugins = async () => {
       + (plugin.bundled && !plugin.active ? ' · 未在 bundle 层，重启 dsh 后生效' : '')
       + '</div></div>' + actionHtml + '</div>';
   });
-  list.innerHTML = rows.join('');
+  // 指纹保护（与 renderSkills 同思路）：内容没变不碰 innerHTML——升级后
+  // 的定向刷新、切 tab 重入都不会重建按钮节点（打断卸载二次确认）或闪动
+  const fingerprint = data.plugins.map((plugin) => [
+    plugin.name,
+    plugin.version || '',
+    plugin.latest || '',
+    plugin.active ? 1 : 0,
+    plugin.bundled ? 1 : 0,
+    plugin.self_managed ? 1 : 0,
+  ].join(':')).join('|');
+  if (list.dataset.fingerprint !== fingerprint) {
+    list.dataset.fingerprint = fingerprint;
+    list.dataset.loaded = '1';
+    list.innerHTML = rows.join('');
+  }
   list.querySelectorAll('[data-install-pkg]').forEach((btn) => {
     btn.dataset.loading = '安装中…';
     btn.onclick = () => pluginAction(btn.dataset.installPkg, 'install', btn);
@@ -889,6 +943,7 @@ const renderAbout = (s) => {
     '<div class="kv"><span class="k">登录账号</span><span class="v">' + esc(s.user_email || '未登录') + '</span></div>',
     '<div class="kv"><span class="k">所属套餐</span><span class="v">' + esc(s.capabilities?.plan_name || '—') + '</span></div>',
     '<div class="kv"><span class="k">平台地址</span><span class="v muted">' + esc(s.platform_url || '—') + '</span></div>',
+    '<div class="kv"><span class="k">开发者</span><span class="v"><a href="mailto:chumingjun@cc-pg.cn">chumingjun@cc-pg.cn</a></span></div>',
   ];
   $('about-body').innerHTML = lines.join('');
   wireAboutUpgrade();
@@ -1061,6 +1116,7 @@ $('skill-sync-btn').onclick = () => withLoading(
     return resp;
   },
   null,
+  'quiet',
 );
 logoutBtn.onclick = () => withLoading(
   logoutBtn,

package/lib/proc.js

@@ -8,7 +8,7 @@
 import { execFile } from 'node:child_process';
 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);
@@ -91,13 +91,26 @@ 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」。macOS 位
-  // ~/Library/Application Support/DSH Desktop/cli/<profile hash>/bin；
-  // Windows 实测在 Roaming 下（真实用户机报错的命令路径前缀就是
-  // C:\Users\<user>\AppData\Roaming\DSH…），Local 也一并扫。两种布局都
-  // 兼容：shims/ 直挂、cli/<hash>/bin。
+  // 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'),
@@ -120,15 +133,58 @@ function extraBinDirs() {
       // 目录不存在：跳过
     }
   }
-  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 只认可执行
@@ -151,7 +207,10 @@ export function candidateSuffixes(platform) {
 export function cmdShimInvocation(platform, resolved, args) {
   if (platform !== 'win32') return null;
   if (!/\.(cmd|bat)$/i.test(resolved)) return null;
-  const quote = (s) => (/[\s"]/.test(s) ? `"${String(s).replace(/"/g, '""')}"` : String(s));
+  // 引号判定必须覆盖 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 };
 }
@@ -232,11 +291,11 @@ export function decodeOutput(buf) {
  * 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, {
@@ -650,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 });

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