dsh-agentone 0.5.16 → 0.5.18

package/README.md

@@ -14,12 +14,24 @@ lark-cli / ccpg-cli 状态探测。
   走 TokenHub 按用户计量。平台 403 的 `plan_required` 错误码原样透传，
   前端据此引导申请套餐（不依赖中文文案匹配）。
 - **SkillHub 技能（M3）**：套餐技能启动/登录时自动装齐；技能市场搜索、
-  手动安装/卸载；技能包 zip 走平台代理下载（穿越清洗 + 原子落盘）。
+  手动安装/卸载；已装技能平台侧对比 latest 版本/指纹，有更新时展示
+  「v旧 → v新」并支持一键升级（覆盖式重装，原子替换旧目录）；技能包
+  zip 走平台代理下载（穿越清洗 + 原子落盘）。
+- **SkillHub 连接配置（M3+）**：登录后自动从平台拉取 registry 与用户级
+  个人 token，写入 `$DSH_HOME/agentone/skillhub.env`（0600，含
+  `SKILLHUB_BASE_URL`/`SKILLHUB_TOKEN`/`CLAWHUB_REGISTRY`/`CLAWHUB_TOKEN`
+  四个与平台托管容器同名的变量），本机有 clawhub CLI 时同步写入登录态；
+  登出时全部清理。会话内使用：`source $DSH_HOME/agentone/skillhub.env`。
 - **套餐申请（M3+）**：状态页「套餐」tab 展示当前套餐/审批中/可申请列表，
   一键提交申请；审批通过后前端轮询检测到 active 自动同步模型。
 - **dsh 插件管理（M3+）**：列出镜像内置与用户自装插件（版本/升级/激活态），
-  内置插件缺失时启动自动重装；自身随平台镜像升级（列表中不提供按钮）。
-- **CLI 探测（M4）**：`lark-cli` / `ccpg-cli` 安装与授权态三态探测。
+  内置插件缺失时启动自动重装（自身也在常驻保证清单内，防误删导致平台集成
+  失效）；desktop 受管 pnpm 通道操作串行排队，宿主并发锁占用时自动退避
+  重试（不把「another desktop pnpm operation is already running」抛给用户）；
+  自身随平台镜像升级（列表中不提供按钮）。
+- **CLI 探测与授权（M4）**：`lark-cli` / `ccpg-cli` 安装与授权态三态探测；
+  已装未授权时「去授权」发起官方 Device Flow（授权链接 + ASCII 二维码 +
+  验证码 + 自动轮询确认，设备码仅存插件进程内存）。
 - **首启引导**：dsh 首次启动弹出飞书登录引导（order -50，早于官方
   「添加 API Key」），登录一次即跳过官方密钥引导；暗色主题适配。
 
@@ -49,6 +61,9 @@ dsh plugin --profile web add dsh-agentone
 - `$DSH_HOME/.credentials.yaml` 写入 `refs.AGENTONE_API_KEY`（0600），内容
   是 30 天插件令牌而非真实模型密钥——密钥不出平台，TokenHub 按用户计量；
 - 只覆盖 `platform` 命名空间，用户自己配置的其它 provider 原样保留；
+- 同步失败（如平台侧 AirRouter 瞬时不可达）不阻断登录/启动，原因记录在
+  状态页「同步状态」；状态页轮询发现残留错误时按指数退避（1min 起、
+  封顶 30min、最多 30 次）自动重试，平台恢复后无需重启 dsh 即自愈；
 - 「退出登录」（页头按钮）会吊销平台令牌、移除凭据引用与 platform
   provider（其它 provider 的默认模型设置不受影响）；凭据文件损坏时也能
   正常退出（坏文件移开为 `credentials.json.corrupt`）。
@@ -89,7 +104,7 @@ lib/
   skill.js   技能下载/解包/卸载（zip 穿越清洗、原子落盘）
   store.js   凭据持久化（0600；损坏自动移开）
   proc.js    dsh/pnpm CLI 转发与 lark-cli/ccpg-cli 探测
-  client.js  dsh 浏览器端 bundle（设置菜单 iframe + 首启引导）
+  client.js  dsh 浏览器端 bundle（设置菜单 iframe + 首启引导 + 设置导航 workbench 图标换肤）
 ```
 
 ## 开发

package/lib/cliauth.mjs

@@ -0,0 +1,115 @@
+// CLI Device Flow 授权（与平台 cli-deployd auth_begin/auth_complete 同源语义）。
+//
+// 独立 dsh 的 CLI 授权由插件进程直接驱动本机 CLI（lark-cli / ccpg-cli 官方
+// 设备流命令，两 CLI 参数面一致）：
+//   beginCliAuth     发起授权（--no-wait --json），解析出 verification_url /
+//                    user_code / 设备码 / expires_in；ccpg-cli 老版本不支持
+//                    --json 时去掉重试（文本解析兜底）。
+//   completeCliAuth  用 begin 拿到的设备码轮询并完成授权（阻塞至用户在
+//                    授权页同意或超时）。
+//   cliAuthQrcode    lark-cli 的 auth qrcode --ascii 生成终端二维码（状态页
+//                    等宽字体直接渲染）。
+//
+// 安全：所有子进程经 runCliTool（execFile 参数数组，无 shell 参与）。设备码
+// 是 begin 步骤本机 CLI 自己签发的随机 token，非用户自由输入；仍先过
+// sanitizeDeviceCode 白名单（字母数字、连字符与点号，无空白与其它符号），校验
+// 失败直接抛中文错误、不触碰子进程。校验后的 token 以独立 argv 元素传给
+// execFile——无 shell 二次解析，token 字符集也决定了它不可能被解释为选项。
+import { runCliTool } from './proc.js';
+
+/** 授权 begin/complete 超时对齐平台 cli-deployd（begin 30s / complete 240s）。 */
+export const CLI_AUTH_BEGIN_TIMEOUT_MS = 30_000;
+export const CLI_AUTH_COMPLETE_TIMEOUT_MS = 240_000;
+
+/** 设备码白名单：官方设备码为字母数字、连字符与点号（实测 lark-cli 的
+ * device_code 含 base64url 段 + '.' 分隔的签名后缀），长度 4–256。 */
+const DEVICE_CODE_RE = /^[A-Za-z0-9_.-]{4,256}$/;
+
+/** 校验设备码：非法值返回 null（调用方直接拒绝，不进任何子进程参数）。 */
+export function sanitizeDeviceCode(raw) {
+  const value = String(raw || '').trim();
+  return DEVICE_CODE_RE.test(value) ? value : null;
+}
+
+function cliToolEnv(tool) {
+  return tool === 'ccpg-cli' ? { CCPG_FULL_CLI: '1' } : undefined;
+}
+
+function combineOutput(stdout, stderr) {
+  return `${stdout || ''}\n${stderr || ''}`.trim();
+}
+
+/** 发起 Device Flow：auth login --no-wait，返回原始输出（含 JSON/URL）。 */
+export async function beginCliAuth(tool, { timeoutMs = CLI_AUTH_BEGIN_TIMEOUT_MS } = {}) {
+  const options = { timeoutMs, env: cliToolEnv(tool) };
+  let result;
+  try {
+    result = await runCliTool(tool, ['auth', 'login', '--no-wait', '--json'], options);
+  } catch (error) {
+    if (tool !== 'ccpg-cli') throw error;
+    result = await runCliTool(tool, ['auth', 'login', '--no-wait'], options);
+  }
+  return combineOutput(result.stdout, result.stderr);
+}
+
+/**
+ * 完成 Device Flow：用 begin 返回的设备码轮询并完成授权（阻塞至用户同意
+ * 或超时）。设备码先过白名单（见文件头）；失败抛中文错误。
+ */
+export async function completeCliAuth(tool, rawDeviceCode, { timeoutMs = CLI_AUTH_COMPLETE_TIMEOUT_MS } = {}) {
+  const token = sanitizeDeviceCode(rawDeviceCode);
+  if (token === null) {
+    throw new Error('设备授权码格式不正确');
+  }
+  const args = ['auth', 'login', '--device-code', token];
+  const { stdout, stderr } = await runCliTool(tool, args, {
+    timeoutMs,
+    env: cliToolEnv(tool),
+  });
+  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();
+}
+
+/**
+ * 从 auth begin 输出解析授权信息（verification_url / user_code / 设备码）。
+ * 与平台 _normalize_cli_auth_data 同口径：JSON 优先（lark-cli --json），
+ * 键名兼容 snake/camel；ccpg-cli 纯文本输出退化为正则抽 URL/code。
+ */
+export function parseCliAuthBeginOutput(raw) {
+  const text = String(raw || '');
+  const jsonMatcher = /\{[^{}]*\}/g;
+  for (const chunk of text.match(jsonMatcher) || []) {
+    try {
+      const data = JSON.parse(chunk);
+      if (!data || typeof data !== 'object') continue;
+      const verificationUrl = data.verification_url || data.verificationUrl || data.verification_uri || data.url;
+      const userCode = data.user_code || data.userCode || data.code || '';
+      const deviceCode = data.device_code || data.deviceCode || '';
+      const expiresIn = Number(data.expires_in ?? data.expiresIn) || 600;
+      if (verificationUrl && (deviceCode || userCode)) {
+        return {
+          verificationUrl: String(verificationUrl),
+          userCode: String(userCode),
+          deviceCode: String(deviceCode),
+          expiresIn,
+        };
+      }
+    } catch {
+      // 非 JSON 块继续
+    }
+  }
+  // ccpg-cli 文本形态：URL 与 code 各取首个出现
+  const urlMatch = /https?:\/\/[^\s"'<>]+/.exec(text);
+  if (!urlMatch) return null;
+  const withoutUrl = text.slice(0, urlMatch.index) + ' ' + text.slice(urlMatch.index + urlMatch[0].length);
+  const codeMatch = /\b([A-Z0-9]{4,12})\b/.exec(withoutUrl);
+  if (!codeMatch) return null;
+  return { verificationUrl: urlMatch[0], userCode: codeMatch[1], deviceCode: codeMatch[1], expiresIn: 600 };
+}

package/lib/client.js

@@ -189,7 +189,58 @@ window.__ModuleLoader__.load({
       );
     }
 
+    // ── 设置导航图标（workbench_fill）─────────────────────────────────────
+    // dsh 设置弹窗的导航图标由 shell（ui-settings-general）按 section id 硬编码，
+    // 注册项没有 icon 选项（仅 models/agent-presets/plugins 有专用图标，其余一律
+    // fallback 齿轮）。改用「标记 + CSS」换肤：给「AgentOne」导航格打 data 属性，
+    // 注入样式隐藏官方 svg、用 mask 画 workbench 图标；颜色取 currentColor（导航格
+    // color 即 --dsw-alias-label-primary），随 dsh 明暗主题自动适配。只加属性不
+    // 改节点结构，React 重渲染/卸载都不会被破坏。
+    const NAV_ICON_LABEL = 'AgentOne'; // 与 settings.section 注册的 label 保持一致
+    const NAV_ICON_PATH = 'M160 800.256C160 835.424 188.608 864 223.712 864h92.48V448H160v352.256zM380.16 864h420.096A63.808 63.808 0 0 0 864 800.256V448H380.16v416zM800.256 160H223.68A63.808 63.808 0 0 0 160 223.744V384h704V223.744A63.776 63.776 0 0 0 800.256 160';
+
+    function tagNavIconCells() {
+      for (const cell of document.querySelectorAll('button')) {
+        if (cell.textContent.trim() !== NAV_ICON_LABEL) continue;
+        if (cell.querySelector('svg')) cell.setAttribute('data-agentone-nav-cell', '');
+      }
+    }
+
+    function injectNavIconStyle() {
+      if (document.getElementById('agentone-nav-icon-style')) return;
+      const icon = `data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 1024 1024'%3E%3Cpath d='${NAV_ICON_PATH}'/%3E%3C/svg%3E`;
+      const style = document.createElement('style');
+      style.id = 'agentone-nav-icon-style';
+      style.textContent = [
+        'button[data-agentone-nav-cell] > svg { display: none; }',
+        'button[data-agentone-nav-cell]::before {',
+        "  content: ''; flex: none; width: 16px; height: 16px;",
+        '  background-color: currentColor;',
+        `  -webkit-mask: url("${icon}") center / contain no-repeat;`,
+        `  mask: url("${icon}") center / contain no-repeat;`,
+        '}',
+      ].join('\n');
+      document.head.appendChild(style);
+    }
+
+    // 设置面板每次打开都重新挂载导航节点：监听 DOM 变化补打标记
+    // （rAF 节流，且只在有新增节点时才扫描）
+    function setupNavIcon() {
+      injectNavIconStyle();
+      let scheduled = false;
+      new MutationObserver((records) => {
+        if (scheduled || !records.some((record) => record.addedNodes.length)) return;
+        scheduled = true;
+        requestAnimationFrame(() => {
+          scheduled = false;
+          tagNavIconCells();
+        });
+      }).observe(document.body, { childList: true, subtree: true });
+      tagNavIconCells();
+    }
+
     function apply(ctx) {
+      setupNavIcon();
       ctx.slots.inject('settings.section', () =>
         ctx.slots.register(
           {

package/lib/index.js

@@ -30,6 +30,8 @@ import {
 } from './auth.js';
 import { applyPlatformModel, removePlatformModel } from './model.js';
 import { installPlatformSkill, listPlatformSkills, removePlatformSkill } from './skill.js';
+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, probeCliDetail, pnpmViewLatest, upgradeCliTool } from './proc.js';
@@ -105,6 +107,33 @@ async function syncPlatformModel(config, log) {
   }
 }
 
+/** 应用平台 SkillHub 配置并落盘（成功清 skillhub_error，失败记录原因）。
+ * 与 syncPlatformModel 同容错模式：失败不阻断登录/启动，状态页展示原因。 */
+async function syncPlatformSkillhub(config, log, credentials) {
+  const accessToken = credentials?.access_token;
+  if (!accessToken) return null;
+  try {
+    const result = await applyPlatformSkillhub(
+      config,
+      credentials.platform_url || config.platformUrl,
+      accessToken,
+    );
+    await updateCredentials(config, {
+      skillhub_registry: result.registryUrl,
+      skillhub_token: result.token,
+      skillhub_synced_at: new Date().toISOString(),
+      skillhub_error: null,
+    });
+    log.info(`[dsh-agentone] platform skillhub config applied: ${result.registryUrl}`);
+    return result;
+  } catch (error) {
+    const message = error?.message || String(error);
+    await updateCredentials(config, { skillhub_error: message }).catch(() => {});
+    log.warn(`[dsh-agentone] platform skillhub config sync failed: ${message}`);
+    throw error;
+  }
+}
+
 /** 进行中的令牌轮换：临期窗口内多个请求共享同一次 refresh（轮换是
  * 一次性的，并发各刷一次会 401 把用户登出）。 */
 let tokenRefreshInFlight = null;
@@ -165,6 +194,41 @@ function pluginProfileDir(config) {
   return join(resolveDshHome(config), 'profiles', PLUGIN_PROFILE);
 }
 
+/** 模型同步失败自愈重试调度（模块级单例：apply 重入先清旧定时器）。
+ * 平台侧瞬时故障（如 AirRouter 短暂不可达）会让启动同步失败，错误一直
+ * 挂在状态页直到下次 dsh 重启——这里由 5s 状态轮询驱动：发现 model_error
+ * 就按指数退避后台重试，成功即清错误，无需用户干预。 */
+export const MODEL_RETRY_BASE_MS = 60_000;
+export const MODEL_RETRY_MAX_MS = 30 * 60_000;
+export const MODEL_RETRY_MAX_ATTEMPTS = 30;
+let modelRetryTimer = null;
+let modelRetryAttempts = 0;
+
+function clearModelRetry() {
+  if (modelRetryTimer !== null) {
+    clearTimeout(modelRetryTimer);
+    modelRetryTimer = null;
+  }
+}
+
+function scheduleModelRetry(config, log) {
+  if (modelRetryTimer !== null || modelRetryAttempts >= MODEL_RETRY_MAX_ATTEMPTS) return;
+  const delay = Math.min(MODEL_RETRY_BASE_MS * 2 ** modelRetryAttempts, MODEL_RETRY_MAX_MS);
+  modelRetryAttempts += 1;
+  modelRetryTimer = setTimeout(() => {
+    modelRetryTimer = null;
+    log.info(`[dsh-agentone] model sync self-heal retry #${modelRetryAttempts}`);
+    syncPlatformModel(config, log)
+      .then(() => {
+        modelRetryAttempts = 0;
+      })
+      .catch(() => {
+        scheduleModelRetry(config, log);
+      });
+  }, delay);
+  modelRetryTimer.unref?.();
+}
+
 /** 转发 dsh plugin 子命令：desktop 走受管 pnpm，普通 dsh 走官方 CLI。 */
 async function runPluginCli(args) {
   if (desktopPluginCli) {
@@ -173,6 +237,12 @@ async function runPluginCli(args) {
   return dshPluginCli(args, PLUGIN_PROFILE);
 }
 
+/** 宿主 DesktopPnpmService 的并发锁占用报错（同一时刻只允许一个 pnpm
+ * 操作——设计如此，不是故障）。识别后应排队等待而非把错误抛给用户。 */
+const DESKTOP_PNPM_BUSY_RE = /another desktop pnpm operation is already running/i;
+
+const sleep = (ms) => new Promise((resolve) => { setTimeout(resolve, ms); });
+
 /**
  * 包装宿主 desktopPnpm.runPlugin，对齐 dshPluginCli 的返回契约（成功
  * {stdout, stderr}，失败 throw Error）。宿主契约（dsh-plugin-desktop 的
@@ -183,36 +253,69 @@ async function runPluginCli(args) {
  *   2. 返回 {stdout, stderr, done, cancel} 句柄而非 Promise，done 结算
  *      {exitCode, signal} 且不因非零退出 reject——直接 await 句柄会立即
  *      返回，装完前的落盘校验必然读到旧版本，误报「升级未生效」。
+ *
+ * 并发占用（启动时常驻检测 vs 用户在插件市场装包同时发生）是高频场景：
+ * 宿主 busy 时同步抛错。这里做两层防御——
+ *   1. 插件自身操作串行队列：自己绝不和自己抢锁；
+ *   2. 对宿主 busy 退避重试（2s 起最多 5 次约 2 分钟）：等宿主侧的其它
+ *      操作（插件市场安装等）结束后继续，而不是报错打断用户。
  */
 export function desktopRunPlugin(service, invokingDir) {
-  return async (args) => {
-    const handle = service.runPlugin([...args], invokingDir);
-    let stdout = '';
-    let stderr = '';
-    const append = (acc, chunk) => (acc + String(chunk)).slice(-64 * 1024);
-    handle.stdout?.on?.('data', (chunk) => { stdout = append(stdout, chunk); });
-    handle.stderr?.on?.('data', (chunk) => { stderr = append(stderr, chunk); });
-    // 与 web 通道 runCliTool 同宽的超时（300s）：宿主自身不设整体超时
-    let timedOut = false;
-    const timer = setTimeout(() => {
-      timedOut = true;
-      handle.cancel();
-    }, 300_000);
-    try {
-      const outcome = await handle.done;
-      if (timedOut) throw new Error('命令执行超时，请稍后重试');
-      if (outcome.exitCode !== 0 || outcome.signal != null) {
-        // ERR_PNPM_IGNORED_BUILDS 等非零退出在这里抛出，由调用侧
-        // install/upgrade 的「以落盘版本为准」兜底接管
-        const message = firstErrorLines(`${stderr}\n${stdout}`)
-          || `命令执行失败（退出码 ${outcome.exitCode ?? '未知'}）`;
-        throw new Error(message);
+  let queue = Promise.resolve();
+  const run = async (args) => {
+    // 宿主 lock 是同步抛错（runPlugin 调用即抛），先探再跑 + 失败退避都做
+    let attempt = 0;
+    for (;;) {
+      let handle;
+      try {
+        handle = service.runPlugin([...args], invokingDir);
+      } catch (error) {
+        const message = error?.message || String(error);
+        if (DESKTOP_PNPM_BUSY_RE.test(message) && attempt < 5) {
+          attempt += 1;
+          await sleep(2000 * attempt);
+          continue;
+        }
+        throw error;
+      }
+      let stdout = '';
+      let stderr = '';
+      const append = (acc, chunk) => (acc + String(chunk)).slice(-64 * 1024);
+      handle.stdout?.on?.('data', (chunk) => { stdout = append(stdout, chunk); });
+      handle.stderr?.on?.('data', (chunk) => { stderr = append(stderr, chunk); });
+      // 与 web 通道 runCliTool 同宽的超时（300s）：宿主自身不设整体超时
+      let timedOut = false;
+      const timer = setTimeout(() => {
+        timedOut = true;
+        handle.cancel();
+      }, 300_000);
+      try {
+        const outcome = await handle.done;
+        if (timedOut) throw new Error('命令执行超时，请稍后重试');
+        if (outcome.exitCode !== 0 || outcome.signal != null) {
+          const message = firstErrorLines(`${stderr}\n${stdout}`);
+          // 旧版宿主在子进程段抛 busy：同样排队重试
+          if (DESKTOP_PNPM_BUSY_RE.test(message) && attempt < 5) {
+            attempt += 1;
+            await sleep(2000 * attempt);
+            continue;
+          }
+          // ERR_PNPM_IGNORED_BUILDS 等非零退出在这里抛出，由调用侧
+          // install/upgrade 的「以落盘版本为准」兜底接管
+          throw new Error(message || `命令执行失败（退出码 ${outcome.exitCode ?? '未知'}）`);
+        }
+        return { stdout, stderr };
+      } finally {
+        clearTimeout(timer);
       }
-      return { stdout, stderr };
-    } finally {
-      clearTimeout(timer);
     }
   };
+  return (args) => {
+    const next = queue.then(() => run(args));
+    // 队列尾吞错，避免一次失败卡死后续排队操作
+    queue = next.catch(() => undefined);
+    return next;
+  };
 }
 
 /**
@@ -289,7 +392,17 @@ const INBOX_BUNDLES = new Set([
  * 每次 dsh 启动时检测：缺失则静默重装（常驻保证），已装则不碰（尊重用户
  * 的版本选择）。
  */
-const BUILTIN_PLUGINS = ['dsh-better-sidebar', 'dsh-harness-one', 'dshmarket', 'dsh-im'];
+const BUILTIN_PLUGINS = [
+  'dsh-better-sidebar',
+  'dsh-harness-one',
+  'dshmarket',
+  'dsh-im',
+  // 自身也纳入常驻保证：独立/桌面版用户删掉依赖或 profile 损坏导致本插件
+  // 缺失时，最后一个运行周期内无法自救（插件代码不在了）——但只要还装着，
+  // 卸载残留/版本损坏后的重装走这里。镜像内 self_managed 时列表页隐藏
+  // 卸载按钮，不会出现「自动重装刚被用户卸载的自己」的拉扯。
+  PLUGIN_PACKAGE_NAME,
+];
 
 /**
  * 内置插件的用途说明（以各自官方 README 为准）：用户视角讲清楚装了能
@@ -304,6 +417,8 @@ const BUILTIN_PLUGIN_DESCRIPTIONS = {
     '插件市场：在 dsh 设置里逛社区插件，像应用商店一样点一下就装好',
   'dsh-im':
     'IM 桥核心：让 dsh 接入飞书等聊天工具——群内 @机器人 干活、收通知与审批卡片',
+  [PLUGIN_PACKAGE_NAME]:
+    'AgentOne 平台集成：飞书登录、平台模型、SkillHub 技能与 CLI 授权（本插件）',
 };
 
 /** 汇总 profile 插件状态：dependencies（去掉 in-box）+ 已装版本 + 激活态。 */
@@ -368,6 +483,7 @@ const BUILTIN_PLUGIN_ALLOW_BUILD = {
   'dsh-harness-one': ['--allow-build=node-pty'],
   dshmarket: ['--allow-build=node-pty'],
   'dsh-im': [],
+  [PLUGIN_PACKAGE_NAME]: [],
 };
 
 /** 安装：白名单校验后转发（desktop 受管 pnpm / 官方 CLI；参数数组，无 shell）。
@@ -589,6 +705,10 @@ button{font:inherit;padding:9px 22px;border-radius:10px;border:none;cursor:point
         });
         log.info('[dsh-agentone] platform login stored (desktop callback server)');
         await syncPlatformModel(config, log).catch(() => {});
+        await syncPlatformSkillhub(config, log, {
+          ...(await loadCredentials(config)),
+          access_token: result.access_token,
+        }).catch(() => {});
         await syncPlanSkills(config, log, {
           ...(await loadCredentials(config)),
           access_token: result.access_token,
@@ -633,6 +753,9 @@ export function apply(ctx, config) {
     });
   }
   ctx.effect(() => {
+    // 模块级重试定时器跨 apply 存活：重入先清，避免旧定时器引用旧 config
+    clearModelRetry();
+    modelRetryAttempts = 0;
     const register = (path, handler) => ctx.webServer.register({ kind: 'exact', path, handler });
 
     register('/agentone/', (request, response) => {
@@ -675,6 +798,14 @@ export function apply(ctx, config) {
           if (userEmail) {
             ({ capabilities, skills, displayNames } = await cachedPlatformStatus(config, credentials));
           }
+          // 失败自愈：模型同步残留错误时由轮询驱动后台重试（成功即清，
+          // 下次轮询状态页恢复）；错误已被登录/手动同步清除时取消待定
+          // 重试并复位退避计数。
+          if (credentials.model_error) scheduleModelRetry(config, log);
+          else {
+            clearModelRetry();
+            modelRetryAttempts = 0;
+          }
         }
         sendJson(response, 200, {
           platform_url: config.platformUrl,
@@ -696,6 +827,13 @@ export function apply(ctx, config) {
                 error_code: credentials.model_error_code ?? null,
               }
             : null,
+          skillhub: credentials
+            ? {
+                registry: credentials.skillhub_registry ?? null,
+                synced_at: credentials.skillhub_synced_at ?? null,
+                error: credentials.skillhub_error ?? null,
+              }
+            : null,
         });
       } catch (error) {
         log.warn(`[dsh-agentone] status failed: ${error?.message || error}`);
@@ -768,8 +906,12 @@ export function apply(ctx, config) {
           expires_at: expiresIn ? new Date(Date.now() + expiresIn * 1000).toISOString() : null,
         });
         log.info('[dsh-agentone] platform login stored');
-        // 登录即配置模型 + 同步套餐技能：失败不阻断登录，状态页展示原因
+        // 登录即配置模型 + SkillHub + 同步套餐技能：失败不阻断登录，状态页展示原因
         await syncPlatformModel(config, log).catch(() => {});
+        await syncPlatformSkillhub(config, log, {
+          ...(await loadCredentials(config)),
+          access_token: result.access_token,
+        }).catch(() => {});
         await syncPlanSkills(config, log, {
           ...(await loadCredentials(config)),
           access_token: result.access_token,
@@ -799,6 +941,25 @@ export function apply(ctx, config) {
       }
     });
 
+    register('/agentone/api/skillhub/sync', async (request, response) => {
+      if (request.method !== 'POST') {
+        response.writeHead(405, { allow: 'POST' });
+        response.end();
+        return;
+      }
+      try {
+        const credentials = await ensureFreshToken(config, log);
+        if (!credentials) {
+          sendJson(response, 401, { error: '请先完成飞书登录' });
+          return;
+        }
+        const result = await syncPlatformSkillhub(config, log, credentials);
+        sendJson(response, 200, { ok: true, registry: result.registryUrl });
+      } catch (error) {
+        sendJson(response, 502, { error: error?.message || '同步 SkillHub 配置失败' });
+      }
+    });
+
     register('/agentone/api/skill/install', async (request, response) => {
       if (request.method !== 'POST') {
         response.writeHead(405, { allow: 'POST' });
@@ -1031,6 +1192,123 @@ export function apply(ctx, config) {
       }
     });
 
+    // 进行中的 Device Flow：deviceCode 只存内存（进程级），complete 用后即删。
+    // 与 pendingStates 同生命周期语义——插件重启后用户重新发起即可。
+    const pendingCliAuth = new Map();
+
+    register('/agentone/api/cli/auth/begin', 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;
+        }
+        const detail = await probeCliDetail(tool).catch(() => null);
+        if (detail?.state === 'missing') {
+          sendJson(response, 400, { error: 'CLI 未安装，请先安装或联系管理员' });
+          return;
+        }
+        const raw = await beginCliAuth(tool);
+        const parsed = parseCliAuthBeginOutput(raw);
+        if (!parsed?.verificationUrl || !parsed?.deviceCode) {
+          sendJson(response, 502, { error: '发起授权失败，请稍后重试' });
+          return;
+        }
+        pendingCliAuth.set(tool, parsed.deviceCode);
+        sendJson(response, 200, {
+          ok: true,
+          tool,
+          verification_url: parsed.verificationUrl,
+          user_code: parsed.userCode,
+          expires_in: parsed.expiresIn,
+        });
+      } catch (error) {
+        sendJson(response, 502, { error: error?.message || '发起授权失败，请稍后重试' });
+      }
+    });
+
+    register('/agentone/api/cli/auth/complete', 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;
+        }
+        // 只信 begin 存在本进程内存里的设备码，不接收前端回传——前端回环
+        // 会让任意页面伪造 complete 调用。
+        const deviceCode = pendingCliAuth.get(tool);
+        if (!deviceCode) {
+          sendJson(response, 400, { error: '授权会话不存在或已过期，请重新发起授权' });
+          return;
+        }
+        try {
+          // 单次 complete 限时 25s：complete 是真长轮询（CLI 阻塞到用户同意
+          // 或设备码过期），若不限时前端每轮询一次就叠一个子进程，几十个
+          // lark-cli 同时轮同一码。这里 25s 一掐，前端串行重试（见 page.js）。
+          await completeCliAuth(tool, deviceCode, { timeoutMs: 25_000 });
+          pendingCliAuth.delete(tool);
+          const detail = await probeCliDetail(tool).catch(() => null);
+          sendJson(response, 200, { ok: true, tool: detail });
+        } catch (error) {
+          // 超时=我们主动掐断轮询（用户还没在授权页同意）：保留会话，202
+          // 让前端继续等；只有终态（设备码失效/被拒）才删会话，否则用户
+          // 慢一点授权就会因会话被删而 400「重新发起」。
+          const message = String(error?.message || '');
+          const terminal = /expired|invalid|denied|拒绝|失效|过期/i.test(message);
+          if (terminal) pendingCliAuth.delete(tool);
+          sendJson(response, terminal ? 502 : 202, {
+            pending: !terminal,
+            error: message,
+          });
+        }
+      } catch (error) {
+        sendJson(response, 502, { error: error?.message || '授权确认失败，请稍后重试' });
+      }
+    });
+
+    register('/agentone/api/cli/auth/qrcode', async (request, response) => {
+      if (request.method !== 'GET') {
+        response.writeHead(405, { allow: 'GET' });
+        response.end();
+        return;
+      }
+      // 只为 begin 返回过的 URL 生成二维码：URL 来自本机 CLI 输出，但也不
+      // 直接接受前端任意 URL（避免把本接口当任意二维码渲染器）。
+      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) {
+        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);
+      } catch (error) {
+        sendJson(response, 502, { error: error?.message || '二维码生成失败' });
+      }
+    });
+
     register('/agentone/api/plan', async (request, response) => {
       if (request.method !== 'GET') {
         response.writeHead(405, { allow: 'GET' });
@@ -1098,6 +1376,9 @@ export function apply(ctx, config) {
         await removePlatformModel(config).catch((error) => {
           log.warn(`[dsh-agentone] remove platform model failed: ${error?.message || error}`);
         });
+        await removePlatformSkillhub(config, log).catch((error) => {
+          log.warn(`[dsh-agentone] remove platform skillhub failed: ${error?.message || error}`);
+        });
         sendJson(response, 200, { ok: true });
       } catch (error) {
         // 本地清理任何一步失败都明确报错（中文），不再静默挂起连接
@@ -1106,8 +1387,8 @@ export function apply(ctx, config) {
       }
     });
 
-    // 启动时若已有登录态：先保鲜令牌（临期轮换），再后台刷新模型配置与套餐技能。
-    // 内置插件常驻检测与登录无关，独立先行。
+    // 启动时若已有登录态：先保鲜令牌（临期轮换），再后台刷新模型配置、
+    // SkillHub 配置与套餐技能。内置插件常驻检测与登录无关，独立先行。
     ensureBuiltinPlugins(config, log).catch((error) => {
       log.warn(`[dsh-agentone] builtin plugin check failed: ${error?.message || error}`);
     });
@@ -1115,11 +1396,15 @@ export function apply(ctx, config) {
       const credentials = await ensureFreshToken(config, log);
       if (!credentials) return;
       await syncPlatformModel(config, log).catch(() => {});
+      await syncPlatformSkillhub(config, log, credentials).catch(() => {});
       await syncPlanSkills(config, log, credentials).catch(() => {});
     })();
 
     return () => {
       pendingStates.clear();
+      pendingCliAuth.clear();
+      clearModelRetry();
+      modelRetryAttempts = 0;
       log.info('[dsh-agentone] routes unmounted');
     };
   }, 'dsh-agentone: http routes');

package/lib/page.js

@@ -69,6 +69,11 @@ button:disabled { opacity: .55; cursor: default; }
 }
 .banner.ok { background: var(--ok-weak); color: var(--ok); display: block; }
 .banner.err { background: var(--err-weak); color: var(--err); display: block; }
+/* CLI 授权弹窗遮罩：全屏半透明，点遮罩关闭 */
+.modal-backdrop {
+  position: fixed; inset: 0; z-index: 50; display: block;
+  background: rgba(0, 0, 0, 0.45); padding: 0 12px; overflow-y: auto;
+}
 /* toast 常驻可视区顶部：页面滚动到底部时操作反馈仍可见 */
 .toast-fixed { position: sticky; top: 8px; z-index: 10; }
 /* 首屏骨架占位：慢网下 status 未回来前不至于一片空白 */
@@ -225,14 +230,14 @@ $('cli-recheck-btn').onclick = () => {
 document.querySelectorAll('.tab').forEach((tab) => {
   tab.onclick = () => activateTab(tab.dataset.tab);
 });
-const skillAction = (slug, action, btn) => withLoading(
+const skillAction = (slug, action, btn, successText) => withLoading(
   btn,
   () => fetch('api/skill/' + action, {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify({ slug }),
   }),
-  action === 'install' ? '技能已安装' : '技能已卸载',
+  successText || (action === 'install' ? '技能已安装' : '技能已卸载'),
 );
 const PLAN_CAPABILITY_LABELS = {
   image_understanding_enabled: '图片理解',
@@ -360,12 +365,21 @@ const renderSkills = (s) => {
   }
   const rows = list.map((skill) => {
     const tag = skill.source === 'plan' ? '<span class="tag">套餐</span>' : '';
-    const meta = skill.installed
-      ? '已装 ' + esc(skill.installed_version || '')
-      : '<span class="muted">未安装</span>';
-    const action = skill.installed
-      ? '<button class="btn small danger" data-uninstall="' + esc(skill.canonical_slug) + '">卸载</button>'
-      : '<button class="btn small primary" data-install="' + esc(skill.canonical_slug) + '">安装</button>';
+    // 可升级：平台对比 latest 指纹/版本后给的结论，提示「v旧 → v新」；
+    // latest 查询失败时平台降级 false，这里不额外猜测
+    const upgradable = skill.installed && skill.upgrade_available;
+    const meta = !skill.installed
+      ? '<span class="muted">未安装</span>'
+      : upgradable
+        ? '已装 ' + esc(skill.installed_version || '')
+          + ' → <b>v' + esc(skill.latest_version || '新版本') + '</b>'
+        : '已装 ' + esc(skill.installed_version || '');
+    const action = !skill.installed
+      ? '<button class="btn small primary" data-install="' + esc(skill.canonical_slug) + '">安装</button>'
+      : upgradable
+        ? '<button class="btn small primary" data-upgrade="' + esc(skill.canonical_slug) + '">升级</button>'
+          + '<button class="btn small danger" data-uninstall="' + esc(skill.canonical_slug) + '">卸载</button>'
+        : '<button class="btn small danger" data-uninstall="' + esc(skill.canonical_slug) + '">卸载</button>';
     return '<div class="skill-item"><div class="skill-info"><div class="skill-name">'
       + esc(displayName(skill.canonical_slug)) + tag + '</div><div class="skill-sub">'
       + esc(skill.canonical_slug) + ' · ' + meta + '</div></div>' + action + '</div>';
@@ -375,10 +389,12 @@ const renderSkills = (s) => {
   if (s.skills_synced_at) metaLine.push('自动同步：' + new Date(s.skills_synced_at).toLocaleString());
   if (s.skills_error) metaLine.push('<span style="color:var(--err)">' + esc(s.skills_error) + '</span>');
   const metaHtml = metaLine.join(' · ');
-  // 5s 轮询会反复调用本函数：指纹（slug:装否:版本 + meta 行）没变时跳过
-  // innerHTML 重写，避免替换按钮节点吞掉正在进行的点击、打断卸载二次确认
+  // 5s 轮询会反复调用本函数：指纹（slug:装否:版本:可升级 + meta 行）没变
+  // 时跳过 innerHTML 重写，避免替换按钮节点吞掉正在进行的点击、打断卸载二
+  // 次确认
   const fingerprint = list.map((skill) =>
-    skill.canonical_slug + ':' + (skill.installed ? 1 : 0) + ':' + (skill.installed_version || ''),
+    skill.canonical_slug + ':' + (skill.installed ? 1 : 0) + ':' + (skill.installed_version || '')
+      + ':' + (skill.upgrade_available ? 1 : 0),
   ).join('|') + '#' + metaHtml;
   if ($('skills-list').dataset.fingerprint !== fingerprint) {
     $('skills-list').dataset.fingerprint = fingerprint;
@@ -388,6 +404,11 @@ const renderSkills = (s) => {
       btn.dataset.loading = '安装中…';
       btn.onclick = () => skillAction(btn.dataset.install, 'install', btn);
     });
+    // 升级即覆盖式重装（staging 原子替换旧目录），成功提示与安装同口径
+    $('skills-list').querySelectorAll('[data-upgrade]').forEach((btn) => {
+      btn.dataset.loading = '升级中…';
+      btn.onclick = () => skillAction(btn.dataset.upgrade, 'install', btn, '技能已升级');
+    });
     $('skills-list').querySelectorAll('[data-uninstall]').forEach((btn) => {
       btn.dataset.loading = '卸载中…';
       btn.onclick = () => confirmThen(btn, '确认卸载？', () =>
@@ -459,19 +480,139 @@ const renderCliData = (s, tools) => {
         ? ' → <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>'
-      : '';
+    // 已装未授权 → 「去授权」：发起官方 Device Flow（扫码/链接 + 轮询确认）
+    const actions = [
+      state === 'unauthorized'
+        ? '<button class="btn small primary" data-cli-auth="' + esc(name) + '">去授权</button>'
+        : '',
+      upgradable
+        ? '<button class="btn small ghost" data-cli-upgrade="' + esc(name) + '">升级</button>'
+        : '',
+    ].join('');
     return '<div class="skill-item"><div class="skill-info"><div class="skill-name">'
       + esc(name) + status + '</div><div class="skill-sub">'
-      + versionLine + '</div></div><div>' + actions + '</div></div>';
+      + versionLine + '</div></div><div style="display:flex;gap:6px">' + actions + '</div></div>';
   });
   body.innerHTML = rows.join('')
     + '<div class="hint">在对话中直接使用（如 /lark 帮助），由 dsh 自动调用。</div>'
-    + '<div class="hint">未安装/未授权时，请联系管理员在镜像或本机完成安装与授权；有新版本时可在此一键升级。</div>';
+    + '<div class="hint">未安装时请联系管理员；已安装未授权时点「去授权」用飞书扫码完成即可。</div>';
   body.querySelectorAll('[data-cli-upgrade]').forEach((btn) => {
     btn.onclick = () => cliUpgrade(btn.dataset.cliUpgrade, btn);
   });
+  body.querySelectorAll('[data-cli-auth]').forEach((btn) => {
+    btn.onclick = () => cliAuthDialog(btn.dataset.cliAuth);
+  });
+};
+
+/**
+ * CLI 授权弹窗：begin 拿授权链接与 user_code → 展示链接 + ASCII 二维码 →
+ * 轮询 complete（用户在授权页同意后 CLI 落盘 token）→ 成功刷新面板。
+ * 弹窗关闭即停轮询；设备码只存插件后端内存，前端不回传。
+ */
+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>'
+    + '<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>'
+    + '<button id="cli-auth-copy" class="btn small ghost" hidden>复制验证码</button>'
+    + '<button id="cli-auth-close" class="btn small ghost">关闭</button></div></div>';
+  document.body.appendChild(overlay);
+  let pollTimer = null;
+  let expiryTimer = null;
+  let closed = false;
+  const statusEl = overlay.querySelector('#cli-auth-status');
+  const close = () => {
+    closed = true;
+    if (pollTimer) clearTimeout(pollTimer);
+    if (expiryTimer) clearTimeout(expiryTimer);
+    overlay.remove();
+  };
+  overlay.querySelector('#cli-auth-close').onclick = close;
+  overlay.addEventListener('click', (event) => { if (event.target === overlay) close(); });
+  try {
+    const resp = await fetch('api/cli/auth/begin', {
+      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 || '发起授权失败');
+    statusEl.textContent = '用' + esc(toolLabel) + '扫二维码，或打开链接完成授权。同意后此处会自动确认。';
+    // ASCII 二维码（lark-cli 本机生成；失败退化为纯链接）
+    fetch('api/cli/auth/qrcode?url=' + encodeURIComponent(data.verification_url))
+      .then((r) => (r.ok ? r.text() : ''))
+      .then((ascii) => {
+        const qr = overlay.querySelector('#cli-auth-qr');
+        if (ascii) {
+          qr.textContent = ascii;
+          qr.style.display = 'block';
+        }
+      })
+      .catch(() => {});
+    const openBtn = overlay.querySelector('#cli-auth-open');
+    openBtn.hidden = false;
+    openBtn.onclick = () => window.open(data.verification_url, '_blank');
+    const copyBtn = overlay.querySelector('#cli-auth-copy');
+    if (data.user_code) {
+      copyBtn.hidden = false;
+      copyBtn.onclick = async () => {
+        try {
+          await navigator.clipboard.writeText(data.user_code);
+          copyBtn.textContent = '已复制';
+        } catch {
+          copyBtn.textContent = data.user_code;
+        }
+      };
+      overlay.querySelector('#cli-auth-link').innerHTML
+        = '<div class="skill-sub">验证码：<b>' + esc(data.user_code) + '</b></div>';
+    }
+    // 自调度串行轮询：上一次 complete 返回后才发起下一次（setInterval 会在
+    // 长轮询未返回时叠加并发子进程）。complete 单次后端限时 25s：
+    //   200 → 授权成功；202 → 仍在等待，3s 后重试；其它 → 终态错误停止。
+    const pollComplete = async () => {
+      if (closed) return;
+      try {
+        const r = await fetch('api/cli/auth/complete', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ tool }),
+        });
+        const d = await r.json().catch(() => ({}));
+        if (r.ok && d.ok) {
+          statusEl.textContent = '✓ 授权成功';
+          setTimeout(close, 800);
+          if (d.tool) renderCliData(lastStatus, { [tool]: d.tool });
+          else renderCli(lastStatus);
+          return;
+        }
+        if (r.status === 202 && d.pending !== false) {
+          statusEl.textContent = '正在等待你在授权页完成同意…';
+          pollTimer = setTimeout(pollComplete, 3000);
+          return;
+        }
+        statusEl.textContent = d.error || '授权失败，请重新发起';
+      } catch {
+        // 网络抖动继续轮询
+        pollTimer = setTimeout(pollComplete, 3000);
+      }
+    };
+    pollTimer = setTimeout(pollComplete, 3000);
+    const expiresInSeconds = Number(data.expires_in) || 600;
+    expiryTimer = setTimeout(() => {
+      closed = true;
+      if (pollTimer) clearTimeout(pollTimer);
+      statusEl.textContent = '授权超时，请关闭后重试。';
+    }, Math.max(expiresInSeconds, 60) * 1000);
+  } catch (error) {
+    statusEl.textContent = error.message || '发起授权失败';
+  }
 };
 
 /** CLI 一键升级：官方 tool update（ccpg 下载二进制可达分钟级）。 */
@@ -757,6 +898,16 @@ const refresh = async () => {
     const gotoPlan = $('goto-plan-btn');
     if (gotoPlan) gotoPlan.onclick = () => activateTab('plan');
   }
+  if (s.logged_in && s.skillhub) {
+    const sh = s.skillhub;
+    const lines = [];
+    if (sh.registry) lines.push('<div class="kv"><span class="k">Registry</span><span class="v">' + esc(sh.registry) + '</span></div>');
+    else lines.push('<div class="kv"><span class="k">SkillHub</span><span class="v muted">未同步</span></div>');
+    if (sh.synced_at) lines.push('<div class="kv"><span class="k">上次同步</span><span class="v">' + new Date(sh.synced_at).toLocaleString() + '</span></div>');
+    if (sh.error) lines.push('<div class="kv"><span class="k">同步状态</span><span class="v" style="color:var(--err)">' + esc(sh.error) + '</span></div>');
+    lines.push('<div class="kv"><span class="k">环境变量</span><span class="v muted">已写入 agentone/skillhub.env（0600）</span></div>');
+    $('skillhub-body').innerHTML = lines.join('');
+  }
   renderSkills(s);
   renderAbout(s);
 };
@@ -788,6 +939,11 @@ $('sync-btn').onclick = () => withLoading(
   () => fetch('api/model/sync', { method: 'POST' }),
   '平台模型已同步',
 );
+$('skillhub-sync-btn').onclick = () => withLoading(
+  $('skillhub-sync-btn'),
+  () => fetch('api/skillhub/sync', { method: 'POST' }),
+  'SkillHub 配置已同步',
+);
 logoutBtn.onclick = () => withLoading(
   logoutBtn,
   () => fetch('api/logout', { method: 'POST' }),
@@ -856,6 +1012,13 @@ export function statusPageHtml() {
           <button id="sync-btn" class="btn ghost small" data-loading="同步中…">重新同步模型</button>
         </div>
       </div>
+      <div class="card">
+        <h3>SkillHub 连接 <span class="muted">技能市场与 clawhub CLI 认证</span></h3>
+        <div id="skillhub-body"></div>
+        <div class="row" style="margin-top:10px">
+          <button id="skillhub-sync-btn" class="btn ghost small" data-loading="同步中…">重新获取 SkillHub 配置</button>
+        </div>
+      </div>
     </div>
 
     <div class="tabpane" id="pane-plan" hidden>

package/lib/skillhub.js

@@ -0,0 +1,130 @@
+// 平台 SkillHub 连接配置自动落地：对齐平台托管容器的注入语义。
+//
+// 平台侧（app/executor/docker_executor.py start_gateway）给托管容器注入
+// SKILLHUB_BASE_URL / SKILLHUB_TOKEN + CLAWHUB_* 兼容别名，hermes 另写
+// /opt/data/.env 供 Gateway 子进程读取。独立/桌面版 dsh 通过本模块拿到
+// 同等配置：
+//   1. fetchSkillhubConfig   拉平台 /api/plugin/v1/skillhub/config
+//      （registry + 用户级个人 token，平台不下发默认/admin token）；
+//   2. applyPlatformSkillhub 写 $DSH_HOME/agentone/skillhub.env（0600，
+//      4 个变量与平台同名单）——与托管容器 .env 对等的落盘形态；
+//   3. clawhubLogin          本机有 clawhub CLI 时写入登录态（与平台容器
+//      内安装命令同源：clawhub login --token … --registry …）；无 clawhub
+//      静默跳过。
+// token 明文只进 0600 的 env 文件与 credentials.json（本就 owner-only）。
+import { chmod, mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+
+import { platformError, platformFetch } from './http.js';
+import { runCliTool } from './proc.js';
+import { resolveDshHome } from './store.js';
+
+/** clawhub login/logout 超时：登录要打 registry，网络慢时放宽。 */
+const CLAWHUB_TIMEOUT_MS = 60_000;
+
+/** SkillHub token 形态校验：与平台 _is_skillhub_token 同口径（sk_ / sk- 前缀）。 */
+export function isSkillhubToken(token) {
+  return typeof token === 'string' && /^(sk_|sk-)/.test(token);
+}
+
+export function skillhubEnvPath(config) {
+  return join(resolveDshHome(config), 'agentone', 'skillhub.env');
+}
+
+/** 生成 skillhub.env 文本：标准变量 + 兼容别名，与平台容器注入同名单。 */
+export function buildSkillhubEnv({ registryUrl, token }) {
+  return [
+    '# AgentOne 平台 SkillHub 配置（插件自动生成，登出时删除）',
+    `SKILLHUB_BASE_URL=${registryUrl}`,
+    `SKILLHUB_TOKEN=${token}`,
+    `CLAWHUB_REGISTRY=${registryUrl}`,
+    `CLAWHUB_TOKEN=${token}`,
+    '',
+  ].join('\n');
+}
+
+/** 拉平台 SkillHub 连接配置；enabled=false 或失败时返回 { enabled:false }。 */
+export async function fetchSkillhubConfig(platformUrl, accessToken) {
+  const response = await platformFetch(
+    `${platformUrl.replace(/\/+$/, '')}/api/plugin/v1/skillhub/config`,
+    { headers: { Authorization: `Bearer ${accessToken}` } },
+  );
+  if (!response.ok) {
+    throw await platformError(response, '获取 SkillHub 配置失败');
+  }
+  return response.json();
+}
+
+async function writeFileAtomic(path, text, mode) {
+  await mkdir(join(path, '..'), { recursive: true, mode: 0o700 });
+  const tmp = `${path}.agentone-${process.pid}-${Date.now()}.tmp`;
+  await writeFile(tmp, text, { mode });
+  await rename(tmp, path);
+}
+
+/**
+ * 拉取并落地 SkillHub 配置（env 文件 + clawhub 登录态）。返回
+ * { registryUrl, token }。失败抛错（中文 message），由调用方记录到
+ * credentials 的 skillhub_error，不阻断登录/启动。
+ */
+export async function applyPlatformSkillhub(config, platformUrl, accessToken) {
+  const data = await fetchSkillhubConfig(platformUrl, accessToken);
+  if (!data?.enabled) {
+    throw new Error('平台未启用 SkillHub');
+  }
+  const registryUrl = String(data.registry_url || '').replace(/\/+$/, '');
+  const token = String(data.token || '');
+  if (!registryUrl || !isSkillhubToken(token)) {
+    throw new Error('平台返回的 SkillHub 配置不完整');
+  }
+
+  await writeFileAtomic(skillhubEnvPath(config), buildSkillhubEnv({ registryUrl, token }), 0o600);
+  // 插件自身进程 env 也设置一份：插件派生的子进程直接继承
+  process.env.SKILLHUB_BASE_URL = registryUrl;
+  process.env.SKILLHUB_TOKEN = token;
+  process.env.CLAWHUB_REGISTRY = registryUrl;
+  process.env.CLAWHUB_TOKEN = token;
+
+  await clawhubLogin(registryUrl, token).catch(() => {});
+  return { registryUrl, token };
+}
+
+/** 本机 clawhub 写登录态；未安装返回 false（静默跳过），其余错误上抛由调用方容错。 */
+export async function clawhubLogin(registryUrl, token) {
+  try {
+    await runCliTool(
+      'clawhub',
+      ['login', '--token', token, '--registry', registryUrl],
+      { timeoutMs: CLAWHUB_TIMEOUT_MS },
+    );
+    return true;
+  } catch (error) {
+    if (/未找到 clawhub 命令/.test(error?.message || '')) return false;
+    throw error;
+  }
+}
+
+/** 登出清理：删 env 文件、清进程 env、尽力 clawhub logout。 */
+export async function removePlatformSkillhub(config, log) {
+  await rm(skillhubEnvPath(config), { force: true }).catch(() => {});
+  for (const key of ['SKILLHUB_BASE_URL', 'SKILLHUB_TOKEN', 'CLAWHUB_REGISTRY', 'CLAWHUB_TOKEN']) {
+    delete process.env[key];
+  }
+  try {
+    await runCliTool('clawhub', ['logout'], { timeoutMs: CLAWHUB_TIMEOUT_MS });
+  } catch {
+    // 无 clawhub 或登出失败都不阻断登出
+  }
+  if (log) log.info('[dsh-agentone] local skillhub config removed');
+}
+
+/** 读取 env 文件内容（测试与状态展示用；文件不存在返回 null）。 */
+export async function readSkillhubEnv(config) {
+  try {
+    const text = await readFile(skillhubEnvPath(config), 'utf8');
+    await chmod(skillhubEnvPath(config), 0o600).catch(() => {});
+    return text;
+  } catch {
+    return null;
+  }
+}

package/lib/store.js

@@ -1,5 +1,5 @@
 // 平台凭据持久化：$DSH_HOME/agentone/credentials.json（0600，仅本机插件可读）。
-import { copyFile, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { copyFile, mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 
@@ -15,6 +15,26 @@ function credentialsPath(config) {
   return join(storeDir(config), 'credentials.json');
 }
 
+/**
+ * 凭据更新互斥链：启动块、登录回调、手动同步、自愈重试可能在同一进程
+ * 内并发执行 read-merge-write（updateCredentials）。无锁时两个并发写会
+ * 互相丢补丁，且 writeFile 非原子——读到半截 JSON 会触发 loadCredentials
+ * 的容错把文件当损坏移开（登录态直接丢失）。这里把所有更新串行化，
+ * 写入改为 tmp + rename 原子替换，任一时刻磁盘上都是完整 JSON。
+ */
+let credentialsWriteChain = Promise.resolve();
+
+function serializedWrite(config, writeFn) {
+  const next = credentialsWriteChain.then(writeFn, writeFn);
+  // 链上错误不阻断后续更新，也不进调用方的结果
+  credentialsWriteChain = next.catch(() => {});
+  return next;
+}
+
+function tmpName(path) {
+  return `${path}.tmp-${process.pid}-${Date.now()}`;
+}
+
 /**
  * 读取凭据。文件损坏（截断/手改坏）不抛出：把坏文件移开为
  * credentials.json.corrupt，返回 null 回到未登录态——否则 logout 也依赖
@@ -40,21 +60,32 @@ export async function loadCredentials(config) {
   }
 }
 
-export async function saveCredentials(config, credentials) {
-  const dir = storeDir(config);
-  await mkdir(dir, { recursive: true, mode: 0o700 });
-  await writeFile(credentialsPath(config), JSON.stringify(credentials, null, 2) + '\n', {
-    mode: 0o600,
-    flag: 'w',
+export function saveCredentials(config, credentials) {
+  return serializedWrite(config, async () => {
+    const dir = storeDir(config);
+    await mkdir(dir, { recursive: true, mode: 0o700 });
+    const path = credentialsPath(config);
+    const tmp = tmpName(path);
+    await writeFile(tmp, JSON.stringify(credentials, null, 2) + '\n', { mode: 0o600, flag: 'w' });
+    await rename(tmp, path);
   });
 }
 
 /** 读取-合并-写回：模型同步结果等增量字段落盘。 */
-export async function updateCredentials(config, patch) {
-  const current = (await loadCredentials(config)) || {};
-  await saveCredentials(config, { ...current, ...patch });
+export function updateCredentials(config, patch) {
+  return serializedWrite(config, async () => {
+    const current = (await loadCredentials(config)) || {};
+    const path = credentialsPath(config);
+    const merged = { ...current, ...patch };
+    const dir = storeDir(config);
+    await mkdir(dir, { recursive: true, mode: 0o700 });
+    const tmp = tmpName(path);
+    await writeFile(tmp, JSON.stringify(merged, null, 2) + '\n', { mode: 0o600, flag: 'w' });
+    await rename(tmp, path);
+    return merged;
+  });
 }
 
-export async function clearCredentials(config) {
-  await rm(credentialsPath(config), { force: true });
+export function clearCredentials(config) {
+  return serializedWrite(config, () => rm(credentialsPath(config), { force: true }));
 }

package/package.json

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