dsh-agentone 0.5.6 → 0.5.7

package/lib/index.js

@@ -32,7 +32,7 @@ import { applyPlatformModel, removePlatformModel } from './model.js';
 import { installPlatformSkill, listPlatformSkills, removePlatformSkill } from './skill.js';
 import { platformFetch } from './http.js';
 import { donePageHtml, statusPageHtml } from './page.js';
-import { dshPluginCli, pnpmViewLatest, probeCliTool } from './proc.js';
+import { dshPluginCli, probeCliDetail, pnpmViewLatest, upgradeCliTool } from './proc.js';
 
 import { clearCredentials, loadCredentials, resolveDshHome, saveCredentials, updateCredentials } from './store.js';
 
@@ -218,7 +218,22 @@ function specLabel(spec) {
   return '';
 }
 
-/** dsh 官方 in-box bundle：profile 模板自带，不是用户可管理的插件。 */
+/** dsh 插件与 CLI 操作白名单：用户输入不得进入 execFile 的 tool 位。 */
+const CLI_TOOLS = new Set(['lark-cli', 'ccpg-cli']);
+
+/**
+ * 插件自身是否由平台托管镜像管理：镜像 Dockerfile 固有 ENV
+ * `DSH_FORWARDER_LISTEN_PORT`（forwarder 是镜像特有组件，独立桌面版不存在）。
+ * 托管镜像内插件版本随镜像走，禁自助升级；独立 dsh（用户自装）没有镜像
+ * 通道，允许在插件页自助升级 —— 否则用户会被卡在旧版只能命令行破局。
+ */
+function isSelfManaged() {
+  return Boolean(process.env.DSH_FORWARDER_LISTEN_PORT);
+}
+
+/**
+ * dsh 官方 in-box bundle：profile 模板自带，不是用户可管理的插件。
+ */
 const INBOX_BUNDLES = new Set([
   '@deepseek-ai/dsh-base',
   '@deepseek-ai/dsh-web-app',
@@ -274,7 +289,7 @@ async function listProfilePlugins(config) {
       active: bundle && bundles.includes(name),
       builtin: BUILTIN_PLUGINS.includes(name),
       // 自身随平台镜像升级：前端据此隐藏卸载/升级按钮（与后端拒绝逻辑同源）
-      self_managed: name === PLUGIN_PACKAGE_NAME,
+      self_managed: name === PLUGIN_PACKAGE_NAME && isSelfManaged(),
       description: BUILTIN_PLUGIN_DESCRIPTIONS[name] || null,
     });
   }
@@ -347,7 +362,7 @@ async function upgradeProfilePlugin(config, name) {
   if (INBOX_BUNDLES.has(name)) {
     throw new Error('dsh 内置组件随 dsh 一同升级，请等待平台更新 dsh');
   }
-  if (name === PLUGIN_PACKAGE_NAME) {
+  if (name === PLUGIN_PACKAGE_NAME && isSelfManaged()) {
     throw new Error('AgentOne 插件随平台镜像一同升级，无需手动操作');
   }
   const dir = pluginProfileDir(config);
@@ -900,15 +915,39 @@ export function apply(ctx, config) {
         response.end();
         return;
       }
-      // 真实探测本机 CLI：与平台 cli-deployd 的判定口径一致（tokenStatus
-      // valid/needs_refresh = 已授权）。并发探测，单个失败不影响另一个。
+      // 真实探测本机 CLI：三态与平台 cli-deployd 判定口径一致，附带版本
+      // 与最新版（查询失败降级 null，不阻塞三态）。并发探测，单个失败不影
+      // 响另一个。
       const [lark, ccpg] = await Promise.all([
-        probeCliTool('lark-cli').catch(() => 'missing'),
-        probeCliTool('ccpg-cli').catch(() => 'missing'),
+        probeCliDetail('lark-cli').catch(() => ({ state: 'missing', version: null, latest: null })),
+        probeCliDetail('ccpg-cli').catch(() => ({ state: 'missing', version: null, latest: null })),
       ]);
       sendJson(response, 200, { tools: { 'lark-cli': lark, 'ccpg-cli': ccpg } });
     });
 
+    register('/agentone/api/cli/upgrade', async (request, response) => {
+      if (request.method !== 'POST') {
+        response.writeHead(405, { allow: 'POST' });
+        response.end();
+        return;
+      }
+      try {
+        const body = await readJsonBody(request);
+        const tool = String(body.tool || '');
+        if (!CLI_TOOLS.has(tool)) {
+          sendJson(response, 400, { error: '不支持的 CLI 工具' });
+          return;
+        }
+        // 官方自升级（ccpg 下载二进制可达分钟级），输出尾部透传给前端
+        // （lark-cli 手动安装时含 GitHub 下载地址）
+        const output = await upgradeCliTool(tool);
+        const detail = await probeCliDetail(tool).catch(() => null);
+        sendJson(response, 200, { ok: true, output, tool: detail });
+      } catch (error) {
+        sendJson(response, 502, { error: error?.message || 'CLI 升级失败，请稍后重试' });
+      }
+    });
+
     register('/agentone/api/plan', async (request, response) => {
       if (request.method !== 'GET') {
         response.writeHead(405, { allow: 'GET' });

package/lib/page.js

@@ -423,19 +423,56 @@ const renderCli = async (s) => {
     return;
   }
   const rows = Object.entries(CLI_TOOL_META).map(([name, meta]) => {
-    const state = tools[name] || 'missing';
+    const info = tools[name] || { state: 'missing' };
+    const state = info.state || 'missing';
     const status = state === 'authorized'
       ? '<span class="pill ok" style="font-size:11px">已授权</span>'
       : 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
+        ? ' → <b>v' + esc(info.latest) + '</b>'
+        : '');
+    const upgradable = info.latest && info.latest !== info.version;
+    const actions = upgradable
+      ? '<button class="btn small primary" data-cli-upgrade="' + esc(name) + '">升级</button>'
+      : '';
     return '<div class="skill-item"><div class="skill-info"><div class="skill-name">'
       + esc(name) + status + '</div><div class="skill-sub">'
-      + esc(meta.desc) + ' · ' + esc(meta.label) + '</div></div></div>';
+      + versionLine + '</div></div><div>' + actions + '</div></div>';
   });
   body.innerHTML = rows.join('')
     + '<div class="hint">在对话中直接使用（如 /lark 帮助），由 dsh 自动调用。</div>'
-    + '<div class="hint">未安装/未授权时，请联系管理员在镜像或本机完成 lark-cli、ccpg-cli 的安装与授权。</div>';
+    + '<div class="hint">未安装/未授权时，请联系管理员在镜像或本机完成安装与授权；有新版本时可在此一键升级。</div>';
+  body.querySelectorAll('[data-cli-upgrade]').forEach((btn) => {
+    btn.onclick = () => cliUpgrade(btn.dataset.cliUpgrade, btn);
+  });
+};
+
+/** CLI 一键升级：官方 tool update（ccpg 下载二进制可达分钟级）。 */
+const cliUpgrade = async (tool, btn) => {
+  btn.disabled = true;
+  btn.textContent = '升级中，可能需要 1–2 分钟…';
+  try {
+    const resp = await fetch('api/cli/upgrade', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ tool }),
+    });
+    const data = await resp.json().catch(() => ({}));
+    if (!resp.ok) throw new Error(data.error || 'CLI 升级失败');
+    // lark-cli 手动安装时 update 只会打印下载地址，原样展示给用户
+    if (data.output) alert(data.output);
+    renderCli._probedAt = 0;
+    renderCli(lastStatus);
+  } catch (error) {
+    alert(error.message || 'CLI 升级失败，请稍后重试');
+    btn.disabled = false;
+    btn.textContent = '升级';
+  }
 };
 const pluginAction = (name, action, btn) => withLoading(
   btn,

package/lib/proc.js

@@ -89,7 +89,29 @@ export async function pnpmViewLatest(name, cwd) {
  *              ∈ {valid, needs_refresh}（access 过期但 refresh 可用仍算已授权）
  */
 export async function probeCliTool(tool, { timeoutMs = 15000 } = {}) {
+  const detail = await probeCliDetail(tool, { timeoutMs });
+  return detail.state;
+}
+
+/** --version 输出解析：提取首个 x.y[.z…] 版本号（两 CLI 均为
+ * "xxx version 1.2.3" 形态）。 */
+export function parseCliVersion(stdout) {
+  const match = /(\d+\.\d+(?:\.\d+)*)/.exec(String(stdout || ''));
+  return match ? match[1] : null;
+}
+
+/**
+ * 三态探测 + 版本 + 最新版（任一失败降级为 null，不阻塞三态）：
+ *   version: `tool --version`
+ *   latest:  ccpg-cli 走官方 `update --check --json`（结构化，为 agent
+ *            设计）；lark-cli 无 check 子命令，用 `npm view @larksuite/cli
+ *            version`（版本号全局一致，对 npm/pnpm/手动安装都成立）。
+ * npm view 需要 npm 在 PATH（node 环境下成立）；查询超时/失败返回 null，
+ * 前端只显示当前版本不显示升级按钮。
+ */
+export async function probeCliDetail(tool, { timeoutMs = 15000 } = {}) {
   let stdout;
+  let state = 'unauthorized';
   try {
     ({ stdout } = await execFileAsync(tool, ['auth', 'status'], {
       timeout: timeoutMs,
@@ -97,11 +119,55 @@ export async function probeCliTool(tool, { timeoutMs = 15000 } = {}) {
       env: tool === 'ccpg-cli' ? { ...process.env, CCPG_FULL_CLI: '1' } : process.env,
     }));
   } catch (error) {
-    if (error.code === 'ENOENT') return 'missing';
+    if (error.code === 'ENOENT') return { state: 'missing', version: null, latest: null };
     // 探测失败不区分超时/非零退出：统一按已装但状态未知处理
     stdout = `${error.stdout || ''}`;
   }
-  return larkStyleAuthorized(stdout) || ccpgStyleAuthorized(stdout) ? 'authorized' : 'unauthorized';
+  if (larkStyleAuthorized(stdout) || ccpgStyleAuthorized(stdout)) state = 'authorized';
+
+  const [version, latest] = await Promise.all([
+    execFileAsync(tool, ['--version'], { timeout: 10_000, killSignal: 'SIGKILL' })
+      .then((r) => parseCliVersion(r.stdout))
+      .catch(() => null),
+    cliLatestVersion(tool, timeoutMs).catch(() => null),
+  ]);
+  return { state, version, latest };
+}
+
+/** 最新版查询：ccpg-cli 官方 check 接口；lark-cli 查 npm 包 dist-tag。 */
+async function cliLatestVersion(tool, timeoutMs) {
+  if (tool === 'ccpg-cli') {
+    const { stdout } = await execFileAsync(
+      tool,
+      ['update', '--check', '--json'],
+      { timeout: timeoutMs, killSignal: 'SIGKILL', env: { ...process.env, CCPG_FULL_CLI: '1' } },
+    );
+    const data = JSON.parse(String(stdout).trim());
+    return typeof data?.latest_version === 'string' ? data.latest_version : null;
+  }
+  if (tool === 'lark-cli') {
+    const { stdout } = await execFileAsync(
+      'npm',
+      ['view', '@larksuite/cli', 'version'],
+      { timeout: timeoutMs, killSignal: 'SIGKILL' },
+    );
+    return parseCliVersion(stdout);
+  }
+  return null;
+}
+
+/**
+ * 触发 CLI 官方自升级（`tool update`）：ccpg-cli 从更新服务器下载二进制
+ * （~17MB），lark-cli 自动探测 npm/pnpm/手动安装方式（手动时只打印
+ * GitHub 下载地址）。返回输出尾部给前端展示（含手动安装的下载链接）。
+ */
+export async function upgradeCliTool(tool, { timeoutMs = 300_000 } = {}) {
+  const { stdout } = await runCliTool(tool, ['update'], {
+    timeoutMs,
+    env: tool === 'ccpg-cli' ? { ...process.env, CCPG_FULL_CLI: '1' } : process.env,
+  });
+  const lines = String(stdout).split('\n').map((l) => l.trim()).filter(Boolean);
+  return lines.slice(-6).join('\n');
 }
 
 /** lark-cli 形态：identities 下的 tokenStatus 或新版 status/available 组合。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-agentone",
-  "version": "0.5.6",
+  "version": "0.5.7",
   "description": "AgentOne 平台集成插件：飞书登录、平台模型、SkillHub 技能、套餐申请、插件管理、lark-cli / ccpg-cli 探测（请求超时与错误码透传、令牌轮换 single-flight、凭据损坏容错、状态页 UX 增强）",
   "type": "module",
   "main": "lib/index.js",