dsh-agentone 0.5.21 → 0.5.22

package/lib/index.js

@@ -34,7 +34,7 @@ import { applyPlatformSkillhub, removePlatformSkillhub } from './skillhub.js';
 import { beginCliAuth, cliAuthQrcode, completeCliAuth, parseCliAuthBeginOutput } from './cliauth.mjs';
 import { platformFetch } from './http.js';
 import { donePageHtml, statusPageHtml } from './page.js';
-import { compareSemver, dshPluginCli, firstErrorLines, installCliTool, probeCliDetail, pnpmViewLatest, upgradeCliTool } from './proc.js';
+import { compareSemver, dshPluginCli, firstErrorLines, installCliTool, isUnexpectedStoreError, probeCliDetail, pnpmViewLatest, runCliTool, unexpectedStoreGuidance, upgradeCliTool } from './proc.js';
 
 import { clearCredentials, loadCredentials, resolveDshHome, saveCredentials, updateCredentials } from './store.js';
 
@@ -300,6 +300,11 @@ export function desktopRunPlugin(service, invokingDir) {
             await sleep(2000 * attempt);
             continue;
           }
+          // pnpm store 主版本冲突（Windows 桌面版高发：用户全局 pnpm 与
+          // 受管 pnpm 版本不同）：给可操作指引，不裸抛英文堆栈
+          if (isUnexpectedStoreError(`${stderr}\n${stdout}`)) {
+            throw new Error(unexpectedStoreGuidance());
+          }
           // ERR_PNPM_IGNORED_BUILDS 等非零退出在这里抛出，由调用侧
           // install/upgrade 的「以落盘版本为准」兜底接管
           throw new Error(message || `命令执行失败（退出码 ${outcome.exitCode ?? '未知'}）`);
@@ -807,8 +812,22 @@ export function apply(ctx, config) {
           // 失败自愈：模型同步残留错误时由轮询驱动后台重试（成功即清，
           // 下次轮询状态页恢复）；错误已被登录/手动同步清除时取消待定
           // 重试并复位退避计数。
-          if (credentials.model_error) scheduleModelRetry(config, log);
-          else {
+          if (credentials.model_error) {
+            // 套餐已生效（active）却残留 model_error：多半是审批前同步失败
+            // 的旧错误（plan_required），此时重试必然成功——立即同步一次，
+            // 不走首轮 60s 的指数退避。常量幂等：同步成功清掉错误后不再进。
+            const planActive = capabilities?.plan_state === 'active';
+            if (planActive) {
+              syncPlatformModel(config, log)
+                .then(() => {
+                  clearModelRetry();
+                  modelRetryAttempts = 0;
+                })
+                .catch(() => scheduleModelRetry(config, log));
+            } else {
+              scheduleModelRetry(config, log);
+            }
+          } else {
             clearModelRetry();
             modelRetryAttempts = 0;
           }
@@ -1191,12 +1210,29 @@ export function apply(ctx, config) {
       }
       // 真实探测本机 CLI：三态与平台 cli-deployd 判定口径一致，附带版本
       // 与最新版（查询失败降级 null，不阻塞三态）。并发探测，单个失败不影
-      // 响另一个。
-      const [lark, ccpg] = await Promise.all([
+      // 响另一个。附带 Python 环境探测（技能脚本标准依赖，Windows GUI 启动
+      // 时 PATH 常缺 python，缺失时前端给安装指引）。
+      const pythonCandidates = process.platform === 'win32'
+        ? ['python', 'python3', 'py']
+        : ['python3', 'python'];
+      const probePython = async () => {
+        for (const name of pythonCandidates) {
+          try {
+            const result = await runCliTool(name, ['--version'], { timeoutMs: 10_000 });
+            const match = /(\d+\.\d+(?:\.\d+)?)/.exec(`${result.stdout || ''}${result.stderr || ''}`);
+            if (match) return { available: true, command: name, version: match[1] };
+          } catch {
+            // 未安装或 Store 假别名：试下一个候选
+          }
+        }
+        return { available: false, command: null, version: null };
+      };
+      const [lark, ccpg, python] = await Promise.all([
         probeCliDetail('lark-cli').catch(() => ({ state: 'missing', version: null, latest: null })),
         probeCliDetail('ccpg-cli').catch(() => ({ state: 'missing', version: null, latest: null })),
+        probePython().catch(() => ({ available: false, command: null, version: null })),
       ]);
-      sendJson(response, 200, { tools: { 'lark-cli': lark, 'ccpg-cli': ccpg } });
+      sendJson(response, 200, { tools: { 'lark-cli': lark, 'ccpg-cli': ccpg }, python });
     });
 
     register('/agentone/api/cli/install', async (request, response) => {

package/lib/page.js

@@ -465,22 +465,26 @@ const renderCli = async (s) => {
   // 真实探测本机安装与授权态（数秒），期间先展示读取中
   body.innerHTML = '<div class="skill-sub">检测中…</div>';
   let tools;
+  let python;
   try {
     const resp = await fetch('api/cli/status');
     const data = await resp.json().catch(() => ({}));
     if (!resp.ok) throw new Error(data.error || '检测失败');
     tools = data.tools || {};
+    python = data.python || null;
   } catch {
     body.innerHTML = '<div class="skill-sub" style="color:var(--err)">CLI 状态检测失败，请稍后重试。</div>';
     return;
   }
-  renderCliData(s, tools);
+  renderCliData(s, tools, python);
 };
-// 纯渲染：tools 形如 { 'lark-cli': {state,version,latest}, ... }。
+// 纯渲染：tools 形如 { 'lark-cli': {state,version,latest}, ... }，
+// python 形如 { available, command, version }（null 表示未探测到数据）。
 // 升级成功后端会带回升级后立即探测的单工具详情，直接合进缓存同步刷新，
 // 不再整页二次探测（否则要再等一轮「检测中…」，用户以为没生效）。
-const renderCliData = (s, tools) => {
+const renderCliData = (s, tools, python) => {
   renderCli._tools = { ...(renderCli._tools || {}), ...tools };
+  if (python !== undefined && python !== null) renderCli._python = python;
   const allTools = renderCli._tools;
   const cliEnabled = s.capabilities?.cli_deployd_enabled !== false;
   const body = $('cli-body');
@@ -500,7 +504,6 @@ const renderCliData = (s, tools) => {
       : state === 'unauthorized'
         ? '<span class="pill warn" style="font-size:11px">未授权</span>'
         : '<span class="pill warn" style="font-size:11px">未安装</span>';
-    // 版本展示：当前版 · 有新版时「v旧 → v新」+ 升级按钮（查询失败静默退化）
     const versionLine = meta.desc + ' · ' + meta.label
       + (info.version ? ' · v' + esc(info.version) : '')
       + (info.latest && info.latest !== info.version
@@ -523,7 +526,23 @@ const renderCliData = (s, tools) => {
       + esc(name) + status + '</div><div class="skill-sub">'
       + versionLine + '</div></div><div style="display:flex;gap:6px">' + actions + '</div></div>';
   });
-  body.innerHTML = rows.join('')
+  // Python 环境行：技能脚本的标准依赖，缺失时按平台给安装指引
+  const py = renderCli._python;
+  const isWin = navigator.platform && /win/i.test(navigator.platform);
+  const pythonRow = py
+    ? '<div class="skill-item"><div class="skill-info"><div class="skill-name">Python '
+      + (py.available
+        ? '<span class="pill ok" style="font-size:11px">可用</span>'
+        : '<span class="pill warn" style="font-size:11px">未安装</span>')
+      + '</div><div class="skill-sub">'
+      + (py.available
+        ? '技能脚本运行环境 · ' + esc(py.command) + ' · v' + esc(py.version)
+        : isWin
+          ? '技能脚本运行环境 · 未检测到 Python，从 python.org 下载安装（勾选 Add to PATH）后重启 DSH Desktop'
+          : '技能脚本运行环境 · 未检测到 Python，可用系统包管理器安装（如 brew install python）后重启 dsh')
+      + '</div></div></div>'
+    : '';
+  body.innerHTML = rows.join('') + pythonRow
     + '<div class="hint">在对话中直接使用（如 /lark 帮助），由 dsh 自动调用。</div>'
     + '<div class="hint">未安装时点「安装」自助安装；已安装未授权时点「去授权」用飞书扫码完成即可。</div>';
   body.querySelectorAll('[data-cli-upgrade]').forEach((btn) => {
@@ -957,11 +976,21 @@ const refresh = async () => {
     }
     $('model-body').innerHTML = lines.join('')
       + (planBlocked
-        ? '<div class="row" style="margin-top:10px"><button id="goto-plan-btn" class="btn primary small">去申请套餐</button></div>'
+        ? '<div class="row" style="margin-top:10px">'
+          + '<button id="retry-model-btn" class="btn ghost small" data-loading="同步中…">重新同步模型</button>'
+          + '<button id="goto-plan-btn" class="btn primary small">去申请套餐</button></div>'
         : '');
     $('sync-btn').hidden = !modelEnabled || planBlocked;
     const gotoPlan = $('goto-plan-btn');
     if (gotoPlan) gotoPlan.onclick = () => activateTab('plan');
+    // planBlocked 兜底手动出口：旧错误残留时（套餐已批但本地还挂着
+    // plan_required）可立即重同步，不等后端自愈的退避周期
+    const retryModel = $('retry-model-btn');
+    if (retryModel) retryModel.onclick = () => withLoading(
+      retryModel,
+      () => fetch('api/model/sync', { method: 'POST' }),
+      '平台模型已同步',
+    );
   }
   if (s.logged_in && s.skillhub) {
     const sh = s.skillhub;

package/lib/proc.js

@@ -13,39 +13,80 @@ import { promisify } from 'node:util';
 const execFileAsync = promisify(execFile);
 
 /** 常见安装目录兑底（环境 PATH 之外的补充）：GUI 启动的 DSH Desktop 继承
- * launchd 的 PATH（/usr/bin:/bin:…），不含 nvm/homebrew/.local —— 实测
+ * launchd 的 PATH（/usr/bin:/bin/…），不含 nvm/homebrew/.local —— 实测
  * 从 Dock 启动时 pnpm/lark-cli 全部 ENOENT，插件页 latest 查不到、CLI
- * 全显示未安装。nvm 取最高 node 版本的 bin；结果进程内缓存。 */
+ * 全显示未安装。Windows 同理：GUI 启动继承系统 PATH，常缺 %APPDATA%\npm
+ * （npm 全局 bin）与 %LOCALAPPDATA%\pnpm（pnpm 默认 home）。nvm 取最高
+ * node 版本的 bin；结果进程内缓存。 */
 let extraBinDirsCache = null;
 function extraBinDirs() {
   if (extraBinDirsCache !== null) return extraBinDirsCache;
   const dirs = [];
   const home = homedir();
+  if (process.platform === 'win32') {
+    const appData = process.env.APPDATA || join(home, 'AppData', 'Roaming');
+    const localAppData = process.env.LOCALAPPDATA || join(home, 'AppData', 'Local');
+    // npm -g 默认 prefix 与 pnpm 默认 PNPM_HOME；nodejs.org 安装器的
+    // 系统级安装不在这，但那种环境 PATH 里有 node，不需要兑底。
+    dirs.push(join(appData, 'npm'), join(localAppData, 'pnpm'));
+  } else {
+    try {
+      // nvm 目录名形如 v24.18.0，用 compareSemver 取最高版（compareSemver
+      // 在本文件后文定义，函数提升可用）
+      const versions = readdirSync(join(home, '.nvm/versions/node'))
+        .filter((v) => /^v?\d/.test(v))
+        .sort((a, b) => compareSemver(a.replace(/^v/, ''), b.replace(/^v/, '')));
+      if (versions.length) dirs.push(join(home, '.nvm/versions/node', versions[versions.length - 1], 'bin'));
+    } catch {
+      // 无 nvm：跳过，走后面的通用目录
+    }
+    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 {
-    // nvm 目录名形如 v24.18.0，用 compareSemver 取最高版（compareSemver
-    // 在本文件后文定义，函数提升可用）
-    const versions = readdirSync(join(home, '.nvm/versions/node'))
-      .filter((v) => /^v?\d/.test(v))
-      .sort((a, b) => compareSemver(a.replace(/^v/, ''), b.replace(/^v/, '')));
-    if (versions.length) dirs.push(join(home, '.nvm/versions/node', versions[versions.length - 1], 'bin'));
+    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 {
-    // 无 nvm（Windows/其他包管理器）：跳过，走后面的通用目录
+    // 非 macOS / 未生成终端 shim：跳过
+  }
+  if (process.platform === 'win32') {
+    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);
+    } catch {
+      // 目录不存在：跳过
+    }
   }
-  dirs.push(join(home, '.local/bin'), '/opt/homebrew/bin', '/usr/local/bin');
   extraBinDirsCache = dirs;
   return dirs;
 }
 
-/** 命令解析：PATH 里找不到时从兑底目录解析绝对路径（找不到返回原名，
- * 后续 ENOENT 走既有 missing/降级语义）。所有 execFile 调用统一过这里。 */
-export function resolveCommand(tool) {
+/** 命令解析：PATH 里找不到时从兑底目录解析绝对路径（找不到返回 null）。
+ * 所有 execFile 调用统一过这里；返回 null 时调用方走「未找到命令」的
+ * 中文指引分支。 */
+export function resolveCommandOrNull(tool) {
   const pathDirs = String(process.env.PATH || '').split(pathDelimiter).filter(Boolean);
   const candidates = [];
   for (const dir of [...pathDirs, ...extraBinDirs()]) {
     candidates.push(join(dir, tool));
     if (process.platform === 'win32') candidates.push(join(dir, `${tool}.exe`), join(dir, `${tool}.cmd`));
   }
-  return candidates.find((p) => existsSync(p)) || tool;
+  return candidates.find((p) => existsSync(p)) || null;
+}
+
+/** 兼容旧签名：找不到时返回原名（后续 ENOENT 走既有 missing/降级语义）。 */
+export function resolveCommand(tool) {
+  return resolveCommandOrNull(tool) || tool;
 }
 
 /** 统一的子进程执行：解析命令路径，并把解析到的目录前置进子进程 PATH
@@ -76,6 +117,21 @@ export function firstErrorLines(raw) {
   return picked.slice(0, 300);
 }
 
+/** pnpm store 版本冲突（受管 pnpm 与用户全局 pnpm 主版本不同，store 目录
+ * 格式不兼容）。Windows 桌面版高发：用户装了独立 pnpm 且主版本与 DSH
+ * Desktop 内置的不同。识别后给可操作指引而非裸抛英文堆栈。 */
+export function isUnexpectedStoreError(message) {
+  return /ERR_PNPM_UNEXPECTED_STORE/i.test(String(message || ''));
+}
+
+/** 翻译 pnpm store 冲突为人话 + 自愈指引。 */
+export function unexpectedStoreGuidance() {
+  return '检测到 pnpm 存储版本冲突（DSH Desktop 内置的 pnpm 与你电脑上安装的 pnpm 主版本不一致）。'
+    + '请在 DSH Desktop 外自行执行一次插件安装即可自动重建存储：关闭本窗口后运行 '
+    + (process.platform === 'win32' ? 'dsh plugin --profile desktop add dsh-agentone' : 'dsh plugin --profile web add dsh-agentone')
+    + '，或删除 profile 目录下的 node_modules 后重试。';
+}
+
 /**
  * 运行一次性命令。webServer 注册的处理器是同步 Node handler 场景下的
  * async 函数；execFile 不经过 shell，参数数组中的每个元素都是独立参数，
@@ -91,16 +147,36 @@ export async function runCliTool(tool, args, { timeoutMs = 300000, cwd, env } =
     return { stdout, stderr };
   } catch (error) {
     if (error.code === 'ENOENT') {
-      throw new Error(`未找到 ${tool} 命令，请确认已安装`);
+      throw new Error(missingCommandGuidance(tool));
     }
     if (error.killed) {
       throw new Error('命令执行超时，请稍后重试');
     }
-    const message = firstErrorLines(`${error.stderr || ''}\n${error.stdout || ''}`);
+    const raw = `${error.stderr || ''}\n${error.stdout || ''}`;
+    if (isUnexpectedStoreError(raw)) {
+      throw new Error(unexpectedStoreGuidance());
+    }
+    const message = firstErrorLines(raw);
     throw new Error(message || `命令执行失败（退出码 ${error.code ?? '未知'}）`);
   }
 }
 
+/** 工具缺失时的中文指引：不同工具有不同的安装出路。 */
+function missingCommandGuidance(tool) {
+  if (tool === 'npm' || tool === 'npx') {
+    return process.platform === 'win32'
+      ? '未找到 npm/npx 命令：lark-cli 依赖 Node.js 环境，请先从 https://nodejs.org 下载安装 Node.js（LTS 版，安装时保持默认选项），安装完成后重启 DSH Desktop 再点「安装」'
+      : '未找到 npm/npx 命令：lark-cli 依赖 Node.js 环境，请先安装 Node.js（推荐 nvm：nvm install --lts），安装完成后重启 DSH Desktop 再点「安装」';
+  }
+  if (tool === 'pnpm') {
+    return '未找到 pnpm 命令，无法查询插件最新版本。可安装 pnpm（npm install -g pnpm）后重启 DSH Desktop；不影响插件正常使用，仅影响升级提示。';
+  }
+  if (tool === 'dsh') {
+    return '未找到 dsh 命令，请确认已安装 dsh 并在终端可用';
+  }
+  return `未找到 ${tool} 命令，请确认已安装`;
+}
+
 /** dsh plugin 子命令：转发给官方 CLI（profile 由调用方给出）。 */
 export function dshPluginCli(args, profile = 'web') {
   return runCliTool('dsh', ['plugin', '--profile', profile, ...args]);
@@ -157,16 +233,25 @@ export function compareSemver(a, b) {
 }
 
 /**
- * 查询包在 registry 的最新版本（`pnpm view <name>@latest version`）。
- * 为什么不用 `pnpm outdated` / `update -L` / `add pkg@latest`：实测 pnpm 11
- * 里 outdated 受 dist-tag 元数据缓存与 minimumReleaseAge 冷却期影响（新版
- * 发布后一段时间查不到），update -L 对精确 pin 的依赖是 no-op，add@latest
- * 会解析到缓存旧版；只有显式版本号可用。view 单字段查询每次真实打
- * registry，是这里唯一的实时数据源。查询失败返回 null（前端按钮不出现）。
+ * 查询包在 registry 的最新版本。优先 `pnpm view`；pnpm 不可用（Windows
+ * 桌面版常见——受管 pnpm 不在 PATH）时退化 `npm view`（输出同为版本行，
+ * parseLatestVersionLine 通吃）。为什么不用 `pnpm outdated` /
+ * `update -L` / `add pkg@latest`：实测 pnpm 11 里 outdated 受 dist-tag
+ * 元数据缓存与 minimumReleaseAge 冷却期影响（新版发布后一段时间查不到），
+ * update -L 对精确 pin 的依赖是 no-op，add@latest 会解析到缓存旧版；只有
+ * 显式版本号可用。view 单字段查询每次真实打 registry，是这里唯一的实时
+ * 数据源。查询失败返回 null（前端按钮不出现）。
  */
 export async function pnpmViewLatest(name, cwd) {
-  const { stdout } = await pnpmCli(['view', `${name}@latest`, 'version'], 30000, cwd);
-  return parseLatestVersionLine(stdout);
+  try {
+    const { stdout } = await pnpmCli(['view', `${name}@latest`, 'version'], 30000, cwd);
+    return parseLatestVersionLine(stdout);
+  } catch (error) {
+    // pnpm 缺失（含 store 冲突指引类可操作错误）不影响升级检测本身：
+    // npm view 同样实时打 registry，版本号全局一致
+    const { stdout } = await runCliTool('npm', ['view', `${name}@latest`, 'version'], { timeoutMs: 30_000, cwd });
+    return parseLatestVersionLine(stdout);
+  }
 }
 
 /**
@@ -233,7 +318,9 @@ async function cliLatestVersion(tool, timeoutMs) {
     return typeof data?.latest_version === 'string' ? data.latest_version : null;
   }
   if (tool === 'lark-cli') {
-    const { stdout } = await execResolved('npm', ['view', '@larksuite/cli', 'version'], { timeoutMs });
+    // runCliTool 而非裸 execResolved：走 Windows 兑底目录解析 npm，
+    // ENOENT 时抛中文指引由上层 catch 降级（按钮不出现）而非静默挂死
+    const { stdout } = await runCliTool('npm', ['view', '@larksuite/cli', 'version'], { timeoutMs });
     return parseCliVersion(stdout);
   }
   return null;
@@ -276,26 +363,42 @@ async function installLarkSkills({ timeoutMs = 180_000 } = {}) {
 export async function installCliTool(tool, { timeoutMs = 300_000 } = {}) {
   let stdout;
   if (tool === 'lark-cli') {
-    ({ stdout } = await runCliTool('npm', ['install', '-g', '@larksuite/cli@latest'], { timeoutMs }));
+    // 预检+降级链：优先独立 npm；没有 npm 但有 pnpm（含 DSH Desktop 自带
+    // shim）时用 pnpm 全局装——lark-cli 官方支持 pnpm 安装方式，装出来的
+    // 二进制与 npm 路径一致，后续 lark-cli update 也能自升级。
+    // 两者都没有才报「装 Node.js」指引。
+    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 {
+      throw new Error(missingCommandGuidance('npm'));
+    }
     const skillsNote = await installLarkSkills().catch((error) => {
       // 软失败：技能装不上不影响 CLI 本体已装成功（如 GitHub 不可达）
       return `lark-cli skills install soft-failed: ${error?.message || error}`;
     });
     stdout = `${stdout}\n${skillsNote}`;
   } else if (tool === 'ccpg-cli') {
-    // 下载 auto-install.sh（curl 失败退化 wget）后交 bash 执行；execFile 不经
-    // 外层 shell，脚本文本作为 bash -c 的单一参数，与平台侧 `| bash` 等价。
-    const fetchScript = () => runCliTool('curl', [
-      '-fsSL', '--retry', '3', '--retry-delay', '5', '--max-time', '120',
-      `${CCPG_CLI_INSTALL_URL_PREFIX}/auto-install.sh`,
-    ], { timeoutMs: 120_000 })
-      .catch(() => runCliTool('wget', ['-qO-', `${CCPG_CLI_INSTALL_URL_PREFIX}/auto-install.sh`], { timeoutMs: 120_000 }));
-    const fetched = (await fetchScript()).stdout.trim();
-    if (!fetched) throw new Error('安装脚本下载失败，请检查网络后重试');
-    ({ stdout } = await runCliTool('bash', ['-c', fetched], {
-      timeoutMs,
-      env: { CCPG_CLI_URL_PREFIX: CCPG_CLI_INSTALL_URL_PREFIX },
-    }));
+    if (process.platform === 'win32') {
+      ({ stdout } = await installCcpgCliWindows(timeoutMs));
+    } else {
+      // 下载 auto-install.sh（curl 失败退化 wget）后交 bash 执行；脚本文本
+      // 来自固定公司 URL（非用户输入），作为 bash -c 的单一参数，与平台
+      // 侧 `| bash` 等价。
+      const scriptUrl = `${CCPG_CLI_INSTALL_URL_PREFIX}/auto-install.sh`;
+      const fetchScript = () => runCliTool('curl', [
+        '-fsSL', '--retry', '3', '--retry-delay', '5', '--max-time', '120',
+        scriptUrl,
+      ], { timeoutMs: 120_000 })
+        .catch(() => runCliTool('wget', ['-qO-', scriptUrl], { timeoutMs: 120_000 }));
+      const fetched = (await fetchScript()).stdout.trim();
+      if (!fetched) throw new Error('安装脚本下载失败，请检查网络后重试');
+      ({ stdout } = await runCliTool('bash', ['-c', fetched], {
+        timeoutMs,
+        env: { CCPG_CLI_URL_PREFIX: CCPG_CLI_INSTALL_URL_PREFIX },
+      }));
+    }
   } else {
     throw new Error('不支持的 CLI 工具');
   }
@@ -303,6 +406,32 @@ export async function installCliTool(tool, { timeoutMs = 300_000 } = {}) {
   return lines.slice(-6).join('\n');
 }
 
+/** ccpg-cli Windows 安装（官方教程口径，202607151817）：
+ * 1) Windows 10 1803+ 自带 curl.exe 下载官方自安装 exe
+ *    （https://bms.einwin.com/media/ccpg-cli/202607151817/ccpg-cli-windows-amd64.exe）
+ * 2) 静默运行安装（/S 安静模式，装到用户目录并注册 PATH）
+ * 3) 教程要求装完必须 ccpg-cli update（拉最新功能）——自动补上。
+ * 全程 execFile 参数数组，不经 shell。 */
+const CCPG_CLI_WINDOWS_INSTALLER_URL = 'https://bms.einwin.com/media/ccpg-cli/202607151817/ccpg-cli-windows-amd64.exe';
+
+async function installCcpgCliWindows(timeoutMs) {
+  const tempDir = join(homedir(), 'AppData', 'Local', 'Temp');
+  const installer = join(tempDir, 'ccpg-cli-setup.exe');
+  await runCliTool('curl', [
+    '-fsSL', '--retry', '3', '--retry-delay', '5', '--max-time', '300',
+    '-o', installer, CCPG_CLI_WINDOWS_INSTALLER_URL,
+  ], { timeoutMs });
+  // NSIS 风格安装器：/S 静默安装；退出码非 0 视为失败
+  await runCliTool(installer, ['/S'], { timeoutMs });
+  // 官方教程的必做步骤：安装完成后立即自升级到最新版（软失败不阻断）
+  const updateNote = await runCliTool('ccpg-cli', ['update'], { timeoutMs: 120_000 })
+    .then((r) => String(r.stdout || '').trim().split('\n').slice(-2).join('\n'))
+    .catch(() => 'ccpg-cli update 未完成，安装后请手动执行 ccpg-cli update');
+  return {
+    stdout: `ccpg-cli 安装完成\n${updateNote}\n如命令不可用，请重启 DSH Desktop 后点「重新检测」`,
+  };
+}
+
 /**
  * 触发 CLI 官方自升级（`tool update`）：ccpg-cli 从更新服务器下载二进制
  * （~17MB），lark-cli 自动探测 npm/pnpm/手动安装方式（手动时只打印

package/package.json

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