dsh-agentone 0.5.17 → 0.5.19

package/README.md

@@ -13,8 +13,10 @@ lark-cli / ccpg-cli 状态探测。
   OpenAI 兼容代理（`/api/plugin/v1`），模型密钥不下发到本机；对话经平台
   走 TokenHub 按用户计量。平台 403 的 `plan_required` 错误码原样透传，
   前端据此引导申请套餐（不依赖中文文案匹配）。
-- **SkillHub 技能（M3）**：套餐技能启动/登录时自动装齐；技能市场搜索、
-  手动安装/卸载；已装技能平台侧对比 latest 版本/指纹，有更新时展示
+- **SkillHub 技能（M3）**：套餐技能自动装齐（启动/登录时，且常驻期间
+  套餐生效、套餐新配技能时由前端触发器与手动「同步套餐技能」按钮补装）；
+  技能市场搜索、手动安装/卸载，装/卸载后技能列表即时刷新（失效 45s
+  status 缓存）；已装技能平台侧对比 latest 版本/指纹，有更新时展示
   「v旧 → v新」并支持一键升级（覆盖式重装，原子替换旧目录）；技能包
   zip 走平台代理下载（穿越清洗 + 原子落盘）。
 - **SkillHub 连接配置（M3+）**：登录后自动从平台拉取 registry 与用户级
@@ -61,6 +63,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`）。

package/lib/index.js

@@ -194,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) {
@@ -593,6 +628,12 @@ async function syncPlanSkills(config, log, credentials) {
 const STATUS_CACHE_TTL_MS = 45_000;
 let statusCache = { at: 0, key: null, skills: null, displayNames: null };
 
+/** 失效技能列表缓存：安装/卸载/同步改动台账后调用，让下一次 status 立即
+ * 拉到新列表（前端装完按钮的 refresh() 依赖这点，否则最长 45s 显示旧状态）。 */
+function invalidateStatusCache() {
+  statusCache = { at: 0, key: statusCache.key, skills: null, displayNames: null };
+}
+
 async function cachedPlatformStatus(config, credentials) {
   const capabilities = await fetchPlatformCapabilities(config.platformUrl, credentials.access_token);
   const key = `${config.platformUrl}|${credentials.access_token}`;
@@ -718,6 +759,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) => {
@@ -760,6 +804,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,
@@ -938,12 +990,35 @@ export function apply(ctx, config) {
           slug,
           { config },
         );
+        invalidateStatusCache();
         sendJson(response, 200, { ok: true, ...result });
       } catch (error) {
         sendJson(response, 502, { error: error?.message || '技能安装失败' });
       }
     });
 
+    // 套餐技能同步：把平台上 source=plan 且未安装的技能装齐。前端在套餐
+    // 生效联动与自动补装触发器里调，也可手动触发；同步结果失效技能缓存。
+    register('/agentone/api/skill/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 syncPlanSkills(config, log, credentials);
+        invalidateStatusCache();
+        sendJson(response, 200, { ok: true, installed: result?.installed ?? 0, failed: result?.failed ?? 0 });
+      } catch (error) {
+        sendJson(response, 502, { error: error?.message || '同步套餐技能失败' });
+      }
+    });
+
     register('/agentone/api/skill/catalog', async (request, response) => {
       if (request.method !== 'GET') {
         response.writeHead(405, { allow: 'GET' });
@@ -997,6 +1072,7 @@ export function apply(ctx, config) {
           return;
         }
         await removePlatformSkill(config.platformUrl, credentials.access_token, slug, { config });
+        invalidateStatusCache();
         sendJson(response, 200, { ok: true, canonical_slug: slug });
       } catch (error) {
         sendJson(response, 502, { error: error?.message || '技能卸载失败' });
@@ -1357,6 +1433,8 @@ export function apply(ctx, config) {
     return () => {
       pendingStates.clear();
       pendingCliAuth.clear();
+      clearModelRetry();
+      modelRetryAttempts = 0;
       log.info('[dsh-agentone] routes unmounted');
     };
   }, 'dsh-agentone: http routes');

package/lib/page.js

@@ -230,6 +230,33 @@ $('cli-recheck-btn').onclick = () => {
 document.querySelectorAll('.tab').forEach((tab) => {
   tab.onclick = () => activateTab(tab.dataset.tab);
 });
+// 套餐技能自动补装触发器：forced=true（套餐刚生效）直接触发；否则仅当
+// status 列表里有未安装的套餐技能才触发。60s 节流 + in-flight 单飞，
+// 失败靠下一次轮询自然重试（skills_error 由 status 带回展示）。
+let planSkillSyncAt = 0;
+let planSkillSyncing = false;
+const maybeAutoSyncPlanSkills = (forced) => {
+  if (planSkillSyncing) return;
+  const now = Date.now();
+  if (now - planSkillSyncAt < 60000) return;
+  const skills = lastStatus?.skills?.skills;
+  if (!forced) {
+    if (!Array.isArray(skills)) return;
+    if (!skills.some((skill) => skill.source === 'plan' && !skill.installed)) return;
+  }
+  planSkillSyncAt = now;
+  planSkillSyncing = true;
+  fetch('api/skill/sync', { method: 'POST' })
+    .catch(() => { planSkillSyncAt = 0; })
+    .finally(() => { planSkillSyncing = false; });
+};
+// 套餐技能同步：调后端 /skill/sync 装齐 source=plan 且未安装的技能。
+// 三个调用方：套餐生效联动、自动补装触发器、技能页手动按钮。
+const syncPlanSkills = (btn) => withLoading(
+  btn,
+  () => fetch('api/skill/sync', { method: 'POST' }),
+  null,
+);
 const skillAction = (slug, action, btn, successText) => withLoading(
   btn,
   () => fetch('api/skill/' + action, {
@@ -849,15 +876,20 @@ const refresh = async () => {
   }
   lastStatus = s;
   const modelEnabled = s.capabilities?.channels?.model?.enabled !== false;
-  // 套餐审批通过检测：plan_state 由非 active 变为 active 时自动同步模型
+  const skillhubEnabled = s.capabilities?.channels?.skillhub?.enabled !== false;
+  // 套餐审批通过检测：plan_state 由非 active 变为 active 时自动同步模型与技能
   const planState = s.capabilities?.plan_state;
   if (s.logged_in && modelEnabled) {
     if (planState === 'active' && lastPlanState && lastPlanState !== 'active') {
       notify('套餐已生效，正在同步模型…');
       fetch('api/model/sync', { method: 'POST' }).catch(() => {});
+      if (skillhubEnabled) maybeAutoSyncPlanSkills(true);
     }
     lastPlanState = planState || null;
   }
+  // 常驻期间自动补装：列表出现「套餐技能未安装」（管理员后配、启动时同步
+  // 瞬时失败）就触发一次同步；节流 + 单飞，装完列表变 installed 自然停
+  if (s.logged_in && skillhubEnabled) maybeAutoSyncPlanSkills(false);
   statePill.className = 'pill ' + (s.logged_in ? 'ok' : 'warn');
   statePill.textContent = s.logged_in ? '已登录' : '未登录';
   // 首个状态到达：骨架占位让位给登录卡/主内容
@@ -944,6 +976,20 @@ $('skillhub-sync-btn').onclick = () => withLoading(
   () => fetch('api/skillhub/sync', { method: 'POST' }),
   'SkillHub 配置已同步',
 );
+// 手动同步套餐技能：文案按结果给（装了几个），失败由 withLoading 展示
+$('skill-sync-btn').onclick = () => withLoading(
+  $('skill-sync-btn'),
+  async () => {
+    const resp = await fetch('api/skill/sync', { method: 'POST' });
+    const data = await resp.clone().json().catch(() => ({}));
+    if (resp.ok) {
+      const installed = Number(data.installed) || 0;
+      notify(installed > 0 ? '已同步，新装 ' + installed + ' 个套餐技能' : '套餐技能已是最新');
+    }
+    return resp;
+  },
+  null,
+);
 logoutBtn.onclick = () => withLoading(
   logoutBtn,
   () => fetch('api/logout', { method: 'POST' }),
@@ -1033,6 +1079,9 @@ export function statusPageHtml() {
         <h3>平台技能 <span class="muted">套餐自动同步</span></h3>
         <div id="skills-list"></div>
         <div class="hint" id="skills-meta"></div>
+        <div class="row" style="margin-top:8px">
+          <button id="skill-sync-btn" class="btn ghost small" data-loading="同步中…">同步套餐技能</button>
+        </div>
         <div class="search" style="margin-top:12px">
           <input id="search-input" placeholder="搜索技能市场，如：数据 / 报告 / lark" />
           <button id="search-btn" class="btn ghost small">搜索</button>

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