dsh-agentone 0.5.17 → 0.5.18

package/README.md

@@ -61,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`）。

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