dsh-agentone 0.5.32 → 0.5.34

package/lib/index.js

@@ -84,18 +84,23 @@ async function readJsonBody(request, limitBytes = 8192) {
   return JSON.parse(Buffer.concat(chunks).toString('utf8'));
 }
 
-/** 应用平台模型配置并把结果落盘（成功清 model_error，失败记录原因与错误码）。 */
+/** 应用平台模型配置并把结果落盘（成功清 model_error，失败记录原因与错误码）。
+ * model_apply 记录本次是否写进了活配置层（'live' 即时生效 / 'next-restart'）。 */
 async function syncPlatformModel(config, log) {
   try {
-    const result = await applyPlatformModel(config);
+    const result = await applyPlatformModel(config, settingsService);
     await updateCredentials(config, {
       models_count: result.models.length,
       default_model: result.defaultModel,
       model_synced_at: new Date().toISOString(),
+      model_apply: result.apply,
       model_error: null,
       model_error_code: null,
     });
-    log.info(`[dsh-agentone] platform model applied: ${result.defaultModel}（共 ${result.models.length} 个可用模型）`);
+    log.info(
+      `[dsh-agentone] platform model applied: ${result.defaultModel}（共 ${result.models.length} 个可用模型，`
+      + `${result.apply === 'live' ? '已即时生效' : '重启 dsh 后生效'}）`,
+    );
     return result;
   } catch (error) {
     const message = error?.message || String(error);
@@ -190,6 +195,12 @@ async function ensureFreshToken(config, log) {
 let PLUGIN_PROFILE = 'web';
 /** desktop 受管插件操作通道（desktopPnpm.runPlugin 包装），非 desktop 为 null。 */
 let desktopPluginCli = null;
+/**
+ * dsh ≥ 0.1.7 的官方 settings 服务（apply 时可选获取）：用来把平台模型写进
+ * profile patch 活配置层，同步即时生效。旧宿主没有该服务，取到 null 即回退
+ * 为「只写 settings.yaml + 下次启动导入」。
+ */
+let settingsService = null;
 
 function pluginProfileDir(config) {
   return join(resolveDshHome(config), 'profiles', PLUGIN_PROFILE);
@@ -772,6 +783,10 @@ export function apply(ctx, config) {
   // desktopPnpm 做装/卸/升级（desktop 里 dsh CLI 拒绝操作 desktop profile）。
   const desktopProfiles = ctx.get?.('desktopProfiles');
   const isDesktopRuntime = Boolean(desktopProfiles?.current?.name) || isDesktopHost();
+  // 官方 settings 服务（可选依赖）：dsh ≥ 0.1.7 用它把平台模型写进 profile
+  // patch 活配置层；取不到（旧宿主）就回退「只写 settings.yaml + 下次启动导入」。
+  // 不能写进 inject：那会让插件在旧宿主上一直 PENDING。
+  settingsService = ctx.get?.('settings') ?? null;
   if (desktopProfiles?.current?.name) {
     PLUGIN_PROFILE = desktopProfiles.current.name;
     ctx.inject(['desktopPnpm'], (desktopCtx) => {
@@ -864,6 +879,8 @@ export function apply(ctx, config) {
                 default_model: credentials.default_model ?? null,
                 models_count: credentials.models_count ?? 0,
                 synced_at: credentials.model_synced_at ?? null,
+                // 'live' 已写活配置层即时生效；'next-restart' 需重启 dsh 才导入
+                apply: credentials.model_apply ?? null,
                 error: credentials.model_error ?? null,
                 error_code: credentials.model_error_code ?? null,
               }
@@ -976,6 +993,7 @@ export function apply(ctx, config) {
           ok: true,
           default_model: result.defaultModel,
           models_count: result.models.length,
+          apply: result.apply,
         });
       } catch (error) {
         sendJson(response, 502, { error: error?.message || '同步平台模型失败' });
@@ -1490,7 +1508,7 @@ export function apply(ctx, config) {
           await revokePlatformToken(config.platformUrl, credentials.refresh_token);
         }
         await clearCredentials(config);
-        await removePlatformModel(config).catch((error) => {
+        await removePlatformModel(config, settingsService).catch((error) => {
           log.warn(`[dsh-agentone] remove platform model failed: ${error?.message || error}`);
         });
         await removePlatformSkillhub(config, log).catch((error) => {

package/lib/model.js

@@ -79,20 +79,16 @@ function parseYamlObject(text) {
   return {};
 }
 
-/** 合并出 settings.yaml 文本：覆盖 platform provider 与 agent-default-model。
- * direct（直连 Token Hub）时写 compat.supportsDeveloperRole=false：pi-ai 对
+/** 平台 provider 配置片段。settings.yaml 与 dsh「活配置层」（profile patch）
+ * 必须写出同一形状，两处共用本构造器，避免两份定义漂移。
+ *
+ * direct（直连 Token Hub）时带 compat.supportsDeveloperRole=false：pi-ai 对
  * reasoning 模型默认把系统提示发成 developer 角色（自定义域名不在它的
  * 非标准名单里），GLM 上游只认 system 会 400；false 保持 system。该配置键
  * 需要 dsh-llm-pi-ai ≥ 0.1.0-rc.8，代理模式不写（网关侧有同样的归一化）。
  */
-export function buildSettingsYaml(existingText, { baseUrl, models, defaultModel, direct = false }) {
-  const settings = parseYamlObject(existingText);
-  const existing = settings['llm-pi-ai'];
-  const llmPiAi =
-    existing && typeof existing === 'object' && existing.providers && typeof existing.providers === 'object'
-      ? existing
-      : { providers: {} };
-  llmPiAi.providers[PROVIDER_KEY] = {
+export function buildPlatformProvider(baseUrl, models, direct = false) {
+  return {
     displayName: '平台模型',
     apiKeyEnv: CREDENTIAL_REF,
     api: 'openai-completions',
@@ -103,12 +99,24 @@ export function buildSettingsYaml(existingText, { baseUrl, models, defaultModel,
       .map((item) => platformModelEntry(item))
       .filter((entry) => entry !== null),
   };
+}
+
+/** 平台默认模型配置片段（settings.yaml 与活层共用）。 */
+export function buildDefaultModel(defaultModel) {
+  return { provider: PROVIDER_KEY, model: defaultModel, reasoningEffort: 'high' };
+}
+
+/** 合并出 settings.yaml 文本：覆盖 platform provider 与 agent-default-model。 */
+export function buildSettingsYaml(existingText, { baseUrl, models, defaultModel, direct = false }) {
+  const settings = parseYamlObject(existingText);
+  const existing = settings['llm-pi-ai'];
+  const llmPiAi =
+    existing && typeof existing === 'object' && existing.providers && typeof existing.providers === 'object'
+      ? existing
+      : { providers: {} };
+  llmPiAi.providers[PROVIDER_KEY] = buildPlatformProvider(baseUrl, models, direct);
   settings['llm-pi-ai'] = llmPiAi;
-  settings['agent-default-model'] = {
-    provider: PROVIDER_KEY,
-    model: defaultModel,
-    reasoningEffort: 'high',
-  };
+  settings['agent-default-model'] = buildDefaultModel(defaultModel);
   return stringify(settings);
 }
 
@@ -177,11 +185,85 @@ function tmpName(path) {
 }
 
 /**
- * 拉取平台模型并写入本机 dsh 配置。返回 { models, defaultModel }。
+ * 在 dsh「活配置层」（profile patch）里写一个 entry 的 volatile 字段。
+ *
+ * 活层写操作都要带 revision：冲突只重试一次（重新读 revision），绝不盲循环。
+ */
+async function withLiveEntry(settings, ns, run) {
+  for (let attempt = 0; ; attempt += 1) {
+    const descriptor = settings.describe().find((row) => row?.ns === ns);
+    if (!descriptor) throw new Error(`配置项 ${ns} 不可用`);
+    try {
+      await run(descriptor.revision);
+      return;
+    } catch (error) {
+      if (error?.code !== 'SETTINGS_CONFLICT' || attempt >= 1) throw error;
+    }
+  }
+}
+
+/**
+ * 把平台 provider 写进 dsh 活配置层，返回是否即时生效。
+ *
+ * dsh ≥ 0.1.7 起用户配置真源迁到 profile patch 层：settings.yaml 只在 host
+ * 启动时被导入一次（dsh-settings 的 importLegacyDocument，导入后改名
+ * .imported），此后 patch 层才是活配置。所以插件只写 settings.yaml 的话，
+ * 面板点「重新同步模型」要等重启才生效，界面还会长期显示上一轮导入的旧值。
+ *
+ * 有官方 settings 服务（ctx.get('settings')）时把同一份 provider 写进活层：
+ * - `llm-pi-ai` 的 providers 与 `agent-default-model` 的字段在目标版本都是
+ *   volatile，可经 settings.update 写入；
+ * - 合并语义是对象深合并、数组整体替换，所以只覆盖 platform，不碰用户的
+ *   其它 provider；
+ * - llm-pi-ai 监听 loader/volatile-update 重新注册路由 → 改完即时生效。
+ *
+ * @returns 'live' 已写活层；'next-restart' 没有该服务或写入被拒（旧宿主行为）
+ */
+export async function applyPlatformProviderLive(settings, { baseUrl, models, defaultModel, direct = false }) {
+  if (!settings || typeof settings.describe !== 'function' || typeof settings.update !== 'function') {
+    return 'next-restart';
+  }
+  try {
+    const provider = buildPlatformProvider(baseUrl, models, direct);
+    await withLiveEntry(settings, 'llm-pi-ai', (revision) =>
+      settings.update('llm-pi-ai', { providers: { [PROVIDER_KEY]: provider } }, revision),
+    );
+  } catch {
+    // 活层写不进去不阻断：settings.yaml 已写成功，下次启动仍会导入（旧行为）
+    return 'next-restart';
+  }
+  try {
+    await withLiveEntry(settings, 'agent-default-model', (revision) =>
+      settings.update('agent-default-model', buildDefaultModel(defaultModel), revision),
+    );
+  } catch {
+    // 默认模型写不进去不影响模型可用（provider 已生效），保留用户当前默认
+  }
+  return 'live';
+}
+
+/**
+ * 登出时清掉活层的平台 provider。
+ *
+ * 用 mutate 的 unset 语义（applyPathOp 对对象键走 Reflect.deleteProperty）；
+ * 刻意不动 `agent-default-model`：它的 provider/model 是 schema required 字段，
+ * 置空会把 entry 弄成半残，而删掉 provider 已经足够让平台模型不可选。
+ */
+export async function removePlatformProviderLive(settings) {
+  if (!settings || typeof settings.describe !== 'function' || typeof settings.mutate !== 'function') return;
+  await withLiveEntry(settings, 'llm-pi-ai', (revision) =>
+    settings.mutate('llm-pi-ai', [{ op: 'unset', path: ['providers', PROVIDER_KEY] }], revision),
+  );
+}
+
+/**
+ * 拉取平台模型并写入本机 dsh 配置。返回 { models, defaultModel, apply }。
+ * apply='live' 表示已写进活配置层即时生效；'next-restart' 表示只能等下次
+ * 启动导入 settings.yaml。
  * 失败抛 PlatformError（中文 message + 平台错误码），由调用方记录/展示
  * （不影响已生效的旧配置）。
  */
-export async function applyPlatformModel(config) {
+export async function applyPlatformModel(config, settings) {
   const credentials = await loadCredentials(config);
   if (!credentials) throw new Error('尚未登录平台');
   const { models, defaultModel, direct } = await fetchPlatformModels(
@@ -205,11 +287,19 @@ export async function applyPlatformModel(config) {
     settingsPath,
     buildSettingsYaml(existingSettings, { baseUrl, models, defaultModel, direct: direct !== null }),
   );
-  return { models, defaultModel };
+  // settings.yaml 与活层双写：前者兼容旧宿主，也让下次启动的导入是幂等的
+  // （只写活层的话，settings.yaml 里的旧值会在下次启动把活层盖回去）。
+  const apply = await applyPlatformProviderLive(settings, {
+    baseUrl,
+    models,
+    defaultModel,
+    direct: direct !== null,
+  });
+  return { models, defaultModel, apply };
 }
 
-/** 登出时清理本机配置：删除凭据引用与 platform provider。 */
-export async function removePlatformModel(config) {
+/** 登出时清理本机配置：删除凭据引用与 platform provider（含活层）。 */
+export async function removePlatformModel(config, settings) {
   const home = resolveDshHome(config);
   const settingsPath = join(home, 'settings.yaml');
   const credentialsPath = join(home, '.credentials.yaml');
@@ -223,4 +313,5 @@ export async function removePlatformModel(config) {
   if (existingSettings) {
     await writeFileAtomic(settingsPath, buildLogoutSettingsYaml(existingSettings));
   }
+  await removePlatformProviderLive(settings).catch(() => {});
 }

package/lib/page.js

@@ -149,11 +149,13 @@ let lastStatus = null;
 // 上一次轮询到的套餐状态（pending→active 自动同步模型用）
 let lastPlanState = null;
 const notify = (message, kind) => {
-  toast.className = 'banner ' + (kind || 'ok');
+  // 保留 toast-fixed：覆盖 className 会把它一起抹掉，常驻可视区顶部的定位
+  // 失效，页面滚动后操作反馈落在视口外（CSS 注释里的「仍可见」不再成立）
+  toast.className = 'banner toast-fixed ' + (kind || 'ok');
   toast.textContent = message;
   clearTimeout(toastTimer);
   // 错误信息可能较长（含平台原因），给足阅读时间；成功提示维持 4s
-  toastTimer = setTimeout(() => { toast.className = 'banner'; }, kind === 'err' ? 10000 : 4000);
+  toastTimer = setTimeout(() => { toast.className = 'banner toast-fixed'; }, kind === 'err' ? 10000 : 4000);
 };
 // withLoading 收尾的刷新分两档：
 //   'status'（默认）——拉 /api/status 并整页 refresh()。模型/SkillHub/登录类
@@ -888,9 +890,15 @@ const renderPlugins = async () => {
       }).then(() => renderPlugins()), '插件已卸载');
   });
 };
+// ==about-upgrade-begin==
 // 关于页版本行：aboutSelf（GET api/plugin/self）有值时展示升级入口或
 // 「已安装待重启」提示；尚未取到时退化为运行中版本（状态轮询自带字段）。
 let aboutSelf = null;
+// 升级进行中标记。本行没有插件/技能列表那样的指纹保护：refresh() 的 5s 状态
+// 轮询每次都会重建它，而升级本身（pnpm view + pnpm add）要几十秒。不把这个态
+// 跨渲染保留，点击后的「升级中…」会在一次轮询内被抹回「升级」——按钮原样弹
+// 回，用户看到的就是「点了没反应」，且能再点一次触发并发重复升级。
+let aboutUpgrading = false;
 const aboutVersionRow = () => {
   const self = aboutSelf;
   if (!self) {
@@ -899,7 +907,9 @@ const aboutVersionRow = () => {
   let value;
   if (self.latest && !self.self_managed) {
     value = 'v' + esc(self.version || '?') + ' → <b>v' + esc(self.latest) + '</b>'
-      + ' <button id="about-upgrade-btn" class="btn small primary" data-loading="升级中…">升级</button>';
+      + (aboutUpgrading
+        ? ' <button id="about-upgrade-btn" class="btn small primary" disabled><span class="spin"></span>升级中…</button>'
+        : ' <button id="about-upgrade-btn" class="btn small primary" data-loading="升级中…">升级</button>');
   } else if (self.version && self.running && self.version !== self.running) {
     value = 'v' + esc(self.running) + '（运行中）· v' + esc(self.version) + ' 已安装，重启 DSH 后生效';
   } else {
@@ -909,8 +919,11 @@ const aboutVersionRow = () => {
 };
 const wireAboutUpgrade = () => {
   const btn = $('about-upgrade-btn');
-  if (!btn || btn.onclick) return;
+  // 升级中：行里已经是 disabled + spinner（aboutVersionRow 按 aboutUpgrading 渲染），
+  // 不重复接线；disabled 按钮本身也点不动，起不了第二个升级
+  if (!btn || aboutUpgrading || btn.onclick) return;
   btn.onclick = async () => {
+    aboutUpgrading = true;
     btn.disabled = true;
     btn.innerHTML = '<span class="spin"></span>升级中…';
     try {
@@ -921,15 +934,22 @@ const wireAboutUpgrade = () => {
       });
       const data = await resp.json().catch(() => ({}));
       if (!resp.ok) throw new Error(data.error || '插件升级失败');
+      aboutUpgrading = false;
       notify('插件已升级，重启 DSH 后生效');
       await refreshAboutSelf(true);
     } catch (error) {
+      aboutUpgrading = false;
       notify(error.message || '插件升级失败', 'err');
-      btn.disabled = false;
-      btn.innerHTML = '升级';
+      // 轮询可能刚重建过本行：按可见性整体重渲染，别只改手里这个已脱离文档的节点
+      rerenderAbout();
     }
   };
 };
+// 关于页重渲染，仅在「关于」tab 可见时执行：切 tab 拿到版本信息、升级结束后刷新
+const rerenderAbout = () => {
+  if (!$('about-body') || document.getElementById('pane-about').hidden) return;
+  renderAbout(lastStatus);
+};
 // 版本 + latest 查询有网络开销（pnpm view 打 registry）：1 分钟节流，
 // 切到「关于」tab 或升级完成后刷新
 const refreshAboutSelf = async (force = false) => {
@@ -944,8 +964,7 @@ const refreshAboutSelf = async (force = false) => {
   } catch {
     return; // 查询失败保持现状，版本行退化为运行中版本
   }
-  if (!$('about-body') || document.getElementById('pane-about').hidden) return;
-  renderAbout(lastStatus);
+  rerenderAbout();
 };
 const renderAbout = (s) => {
   const lines = [
@@ -958,6 +977,7 @@ const renderAbout = (s) => {
   $('about-body').innerHTML = lines.join('');
   wireAboutUpgrade();
 };
+// ==about-upgrade-end==
 const searchCatalog = async () => {
   const btn = $('search-btn');
   const q = $('search-input').value.trim();
@@ -992,6 +1012,21 @@ const searchCatalog = async () => {
     btn.innerHTML = '搜索';
   }
 };
+// 手动同步平台模型（模型卡与套餐阻断兜底两处共用）。成功提示必须区分是否
+// 已写进活配置层：dsh ≥0.1.7 走 settings 服务即时生效；旧宿主只落盘
+// settings.yaml，要重启才被导入——不区分的话用户会以为同步没生效。
+const syncModelNow = (btn) => withLoading(
+  btn,
+  async () => {
+    const resp = await fetch('api/model/sync', { method: 'POST' });
+    const data = await resp.clone().json().catch(() => ({}));
+    if (resp.ok) {
+      notify(data.apply === 'live' ? '平台模型已同步，已即时生效' : '平台模型已同步，重启 DSH 后生效');
+    }
+    return resp;
+  },
+  null,
+);
 const refresh = async () => {
   let s;
   try {
@@ -1044,6 +1079,10 @@ const refresh = async () => {
       lines.push('<div class="kv"><span class="k">默认模型</span><span class="v">' + esc(m.default_model || '未同步') + '</span></div>');
       lines.push('<div class="kv"><span class="k">可用模型</span><span class="v">' + esc(m.models_count) + ' 个</span></div>');
       if (m.synced_at) lines.push('<div class="kv"><span class="k">上次同步</span><span class="v">' + new Date(m.synced_at).toLocaleString() + '</span></div>');
+      // 旧宿主（无 settings 服务）才提示：同步内容要等下次启动导入才生效
+      if (m.apply === 'next-restart') {
+        lines.push('<div class="kv"><span class="k">生效方式</span><span class="v muted">重启 DSH 后生效</span></div>');
+      }
     }
     if (!planBlocked && m.error) lines.push('<div class="kv"><span class="k">同步状态</span><span class="v" style="color:var(--err)">' + esc(m.error) + '</span></div>');
     if (s.token_expires_at) {
@@ -1061,11 +1100,7 @@ const refresh = async () => {
     // planBlocked 兜底手动出口：旧错误残留时（套餐已批但本地还挂着
     // plan_required）可立即重同步，不等后端自愈的退避周期
     const retryModel = $('retry-model-btn');
-    if (retryModel) retryModel.onclick = () => withLoading(
-      retryModel,
-      () => fetch('api/model/sync', { method: 'POST' }),
-      '平台模型已同步',
-    );
+    if (retryModel) retryModel.onclick = () => syncModelNow(retryModel);
   }
   if (s.logged_in && s.skillhub) {
     const sh = s.skillhub;
@@ -1105,11 +1140,7 @@ $('login-btn').onclick = async () => {
   // 按钮保持可点：授权窗被用户关掉后可立即重新发起，无需等 2 分钟
   btn.textContent = '已打开授权窗口，完成后自动继续（可重开）';
 };
-$('sync-btn').onclick = () => withLoading(
-  $('sync-btn'),
-  () => fetch('api/model/sync', { method: 'POST' }),
-  '平台模型已同步',
-);
+$('sync-btn').onclick = () => syncModelNow($('sync-btn'));
 $('skillhub-sync-btn').onclick = () => withLoading(
   $('skillhub-sync-btn'),
   () => fetch('api/skillhub/sync', { method: 'POST' }),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-agentone",
-  "version": "0.5.32",
-  "description": "AgentOne 平台集成插件：飞书登录、平台模型（直连 Token Hub 不过境平台、同步失败自愈重试）、SkillHub 技能（升级检测一键升级、装后即时刷新、套餐技能自动同步）、套餐申请、插件管理与自助升级、lark-cli / ccpg-cli 探测与一键安装（请求超时与错误码透传、令牌轮换 single-flight、凭据损坏容错与并发安全写入、状态页 UX 增强、全局中文回复默认（AGENTS.md 受标记管理、永不覆盖用户设置）、桌面版设置页白屏修复（iframe 子框架导航无桌面令牌改走主框架 fetch + srcdoc 渲染））",
+  "version": "0.5.34",
+  "description": "AgentOne 平台集成插件：飞书登录、平台模型（直连 Token Hub 不过境平台、同步失败自愈重试）、SkillHub 技能（升级检测一键升级、装后即时刷新、套餐技能自动同步）、套餐申请、插件管理与自助升级、lark-cli / ccpg-cli 探测与一键安装（请求超时与错误码透传、令牌轮换 single-flight、凭据损坏容错与并发安全写入、状态页 UX 增强、全局中文回复默认（AGENTS.md 受标记管理、永不覆盖用户设置）、桌面版设置页白屏修复（iframe 子框架导航无桌面令牌改走主框架 fetch + srcdoc 渲染）、「关于」页升级中态跨状态轮询保留（点升级不再像没反应、不再并发重复升级）与 toast 常驻定位修复、平台模型同步写进 dsh 活配置层（DSH ≥0.1.7 即时生效不再要重启）与测试污染真实 home 修复）",
   "type": "module",
   "scripts": {
     "smoke": "node scripts/env-matrix-smoke.mjs"