dsh-agentone 0.5.40 → 0.5.42

package/README.md

@@ -35,9 +35,17 @@ lark-cli / ccpg-cli 状态探测。
   不删除本机内容。平台暂时不可用时缓存仅展示，不用于安装。
 - **dsh 插件管理（M3+）**：列出当前 profile 的包、版本、bundle 注册状态；
   安装成功需物理版本、插件声明和 profile 注册同时成立。注册不证明运行时加载，
-  页面提示重启生效。Web 必须配置实际 `profileName`，Desktop 使用宿主当前 profile
-  和受管 pnpm 通道；安装/卸载串行排队、支持生命周期取消。自身与 DSH 基础组件
-  不属于平台默认清单，自身只在独立安装模式允许手动升级。
+  页面提示重启生效。Web 必须配置实际 `profileName`；桌面壳按宿主契约自动取
+  当前 profile——第三方壳（desktopProfiles + 受管 desktopPnpm 通道）与官方
+  DeepSeek Harness 应用（launcher 的 profileContext + 宿主 pluginManager，
+  与应用内「设置 → 插件」同一管线，不接受 pnpm 选项）分别适配；安装/卸载
+  串行排队、支持生命周期取消。自身与 DSH 基础组件不属于平台默认清单，
+  自身只在独立安装模式允许手动升级。
+- **旧版技能记录迁移（0.5.41）**：0.5.39 起本机安装真源是
+  `$DSH_HOME/agentone/skill-state/<slug>.json`；≤0.5.38 只写平台台账，升级后
+  这些技能会「有目录、无记录」。这类条目标注「旧版安装」，插件页提供
+  「重新应用旧版安装的技能」批量入口（按平台版本原子覆盖目录并重建记录）；
+  有本机记录但内容被改过的真冲突仍逐项人工确认，不自动覆盖。
 - **CLI 探测、安装与授权（M4）**：`lark-cli` / `ccpg-cli` 安装与授权态三态探测；
   未安装时「安装」一键自助安装（lark 走 `npm install -g @larksuite/cli@latest`，
   ccpg 走公司 `auto-install.sh`，口径与平台 cli-deployd 一致）；
@@ -123,17 +131,52 @@ dsh plugin --profile web add dsh-agentone
 lib/
   index.js   路由与业务编排（登录/状态/技能/套餐/插件/CLI）
   page.js    状态页与授权完成页的 HTML/CSS/JS 模板（纯静态）
+  desktop.js 桌面壳探测与 profile 解析（全仓唯一一份，见下节）
   http.js    平台请求统一通道（超时、错误码透传）
   auth.js    登录流、令牌轮换/吊销、能力面/套餐 API
   language.js 全局中文回复默认（$DSH_HOME/AGENTS.md 受标记管理注入）
   model.js   平台模型 → settings.yaml / .credentials.yaml
   skill.js   技能下载/解包/卸载（zip 穿越清洗、原子落盘）
+  skill-state.js 技能本机记录（$DSH_HOME/agentone/skill-state/<slug>.json）与状态判定
+  defaults-sync.js 平台默认能力协调器（清单拉取/对齐/缓存）
+  profile-plugins.js 当前 profile 的插件操作（通道选择见下节）
   store.js   凭据持久化（0600；损坏自动移开）
   proc.js    dsh/pnpm CLI 转发与 lark-cli/ccpg-cli 探测
   qrcode.mjs 授权 URL 的二维码 SVG（vendor qrcode-generator，MIT；lark/ccpg 通用）
   client.js  dsh 浏览器端 bundle（设置菜单 iframe + 首启引导 + 设置导航 workbench 图标换肤）
 ```
 
+## 桌面宿主契约（两类壳，判定只有一份）
+
+宿主服务面差异是 0.5.39/0.5.40 两次事故的根因类别（品牌正则抄了两份漏改一份；
+只接了一类壳的契约）。**品牌判定与 profile 解析只允许 `lib/desktop.js` 一份实现**，
+`test/desktop-srcdoc.test.mjs` 用源码扫描守卫这一点。
+
+| | 第三方壳（dsh-plugin-desktop） | 官方 Electron 应用（DeepSeek Harness / DSH NEXT） |
+|---|---|---|
+| profile 来源 | `ctx.get('desktopProfiles').current`（name + dir） | `ctx.get('profileContext')`（name/dir/packageManager，launcher 发布） |
+| 安装通道 | `ctx.get('desktopPnpm').runPlugin(argv, dir, signal)` → `{stdout, stderr, done, cancel}` | `ctx.get('pluginManager').installBundle(spec, {requestId})` / `removeBundle(name)` / `cancelInstall(requestId)` → `{application: applied\|restart-required\|overridden\|cancelled\|failed, packageResult, error}` |
+| 不发布 | `pluginManager` | `desktopProfiles`、`desktopPnpm`（app.asar 均 0 命中，实测 2026-10） |
+| CLI 兜底 | dsh CLI 拒绝 `--profile desktop` | 同左；profileContext 是唯一答案 |
+
+要点：
+
+- 官方 `pluginManager` 与应用内「设置 → 插件」同一管线，**不接受 pnpm 选项**；
+  `--allow-build` 不转发（构建审批由官方管线自理），其余附加参数必须拒绝而不是
+  静默丢弃（`profile-plugins.js` 的 `desktopManagerRun`）。
+- `application: 'overridden'` 是「改动保留、被别的层覆盖显示」，不是失败。
+- 非桌面宿主（`dsh web`/CLI）：插件配置 `profileName` 优先，launcher 的
+  `profileContext` 次之（`desktop.js` 的 `resolveProfileTarget`）。
+- **installed ≠ enabled**（读官方 `dsh-plugin-manager` 源码确认）：
+  `dsh.profile.bundles` 是**启用集**，`node_modules` 里的依赖只是「已安装」。
+  官方「已安装列表」= 启用集 ∪ profile 依赖 ∪ 应用自带依赖
+  （`installation.dependencies`——rc.2 那批 browser-use/computer-use 由应用
+  供给、不可卸载），因此会出现「已安装但未启用」条目；`installBundle` 装新包时
+  reconcile 会**自动启用**带 `dsh.bundle` 声明的新依赖，但不会悄悄启用存量
+  未启用包。前端术语用「已启用/未启用」，别叫「已注册」——和官方 UI 对不上。
+  peer 不兼容的启用会被宿主拒绝（结构化错误 `incompatible-version`），需在
+  应用内授权该精确版本（version exemptions）或等插件发兼容版本。
+
 ## 开发
 
 ```bash
@@ -144,3 +187,16 @@ dsh plugin --profile web add /path/to/plugins/dsh/dsh-agentone
 无构建步骤（纯 ESM JS）；运行时 peer 依赖 `@deepseek-ai/cordis` /
 `@deepseek-ai/schemastery` 由 dsh host 提供。测试：`npm install && node --test`
 （YAML 合并/登出清理语义、路由冒烟、凭据容错、令牌轮换等）。
+
+发版前真实宿主门禁（单测全绿但宿主内翻车的两类事故都由它拦）：
+
+```bash
+# 1) 把候选版本装进 desktop profile（用应用自带 pnpm，与应用内安装同源）
+#    RT="/Applications/DeepSeek Harness.app/Contents/Resources/runtime"
+#    cd ~/.dsh/profiles/desktop && \
+#    DSH_DESKTOP_NODE_EXECUTABLE="/Applications/DeepSeek Harness.app/Contents/MacOS/DeepSeek Harness" \
+#      "$RT/bin/node" "$RT/pnpm/bin/pnpm.mjs" add 'dsh-agentone@<版本>'
+# 2) 完全退出并重开 DeepSeek Harness（插件代码 restart-required）
+# 3) 跑门禁：逐条断言本次事故签名（旧代码未重启/profile 解析/插件清单/技能搁浅）
+node scripts/desktop-host-smoke.mjs
+```

package/lib/defaults-sync.js

@@ -176,8 +176,18 @@ export function createDefaultsSync({ config, profiles, credentials, log, interva
         try {
           const local = await localSkillState(owner.platform, item.canonical_slug, options);
           if (!active(currentGeneration)) return;
-          Object.assign(entry, { state: local.state, version: local.record?.version || null });
-          if (local.state === 'conflict' && (options.missingOnly || !selectedItem)) { entry.error = '本机技能已有用户内容或来源不一致，请确认后手动应用'; continue; }
+          // 0.5.39 起「本机记录文件」才是安装真源；更早版本（≤0.5.38）只写
+          // 平台台账，升级后这些目录必然「有目录、无记录」——和「用户改过
+          // 内容」撞在同一个 conflict 状态里，必须区分开，否则升级当天全部
+          // 技能被误报成来源不一致/未安装（实测 11/11 命中）。
+          const legacy = local.state === 'conflict' && !local.record && Boolean(item.installed_fingerprint);
+          Object.assign(entry, { state: local.state, version: local.record?.version || null, legacy });
+          if (local.state === 'conflict' && (options.missingOnly || !selectedItem)) {
+            entry.error = legacy
+              ? '旧版本安装的技能缺少本机记录，请点「重新应用」重建（按平台版本覆盖技能目录）'
+              : '本机技能已有用户内容或来源不一致，请确认后手动应用';
+            continue;
+          }
           if (local.state === 'current' && (!item.latest_version || !item.latest_fingerprint) && options.missingOnly) {
             entry.state = 'failed'; entry.error = '暂时无法确认技能最新版本，请稍后重试'; continue;
           }

package/lib/desktop.js

@@ -0,0 +1,42 @@
+// 桌面壳探测与 profile 解析：判定只允许一份实现。
+//
+// 两种桌面契约（实测当前官方应用只满足后者）：
+//   1. 第三方壳（dsh-plugin-desktop）：发布 `desktopProfiles.current`
+//      （name + dir），装包走 `desktopPnpm`；
+//   2. 官方 DeepSeek Harness Electron 应用：**不发布** desktopProfiles /
+//      desktopPnpm（app.asar 里两个名字均 0 命中），由 launcher 发布
+//      `profileContext`（name/dir/packageManager），装包走 `pluginManager`。
+//      该壳里 dsh CLI 明确拒绝 `--profile desktop`，profileContext 是唯一答案。
+import { join } from 'node:path';
+
+/** 桌面壳品牌：DSH Desktop（第三方壳）/ DSH NEXT、DeepSeek HARNESS
+ * （NEXT 及其公开发布名）。宿主进程是 Electron 时 execPath 指向壳可执行文件。 */
+export function isDesktopHost() {
+  return /(?:DSH Desktop|DSH NEXT|DeepSeek HARNESS)\.(?:app|exe)/i.test(process.execPath);
+}
+
+export function validProfileName(name) {
+  return typeof name === 'string' && /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,119}$/.test(name) && name !== 'node_modules';
+}
+
+/**
+ * 解析当前 profile。桌面宿主以壳/launcher 的答案为准（桌面壳里 dsh CLI 拒绝
+ * 操作 desktop profile，猜出来的目录一定对不上）；普通 Web/CLI 宿主仍以插件
+ * 配置的 profileName 优先，其次 launcher 的 profileContext。
+ * 目录优先取 launcher 自己给的 dir——profile 落在哪里由 launcher 决定。
+ * @returns {{home: string, name: string, dir: string, desktop: boolean}|null}
+ */
+export function resolveProfileTarget({ ctx, config = {}, home, desktop }) {
+  const shell = ctx?.get?.('desktopProfiles');
+  const launched = ctx?.get?.('profileContext');
+  const candidates = desktop
+    ? [shell?.current?.name, launched?.name, config.profileName]
+    : [config.profileName, launched?.name, shell?.current?.name];
+  const name = candidates.find(validProfileName);
+  if (!name) return null;
+  const owned = [
+    [shell?.current?.name, shell?.current?.dir],
+    [launched?.name, launched?.dir],
+  ].find(([owner, dir]) => owner === name && typeof dir === 'string' && dir.trim() !== '');
+  return { home, name, dir: owned ? owned[1].trim() : join(home, 'profiles', name), desktop };
+}

package/lib/index.js

@@ -34,6 +34,7 @@ import { applyPlatformModel, removePlatformModel } from './model.js';
 import { installPlatformSkill, listPlatformSkills, removePlatformSkill } from './skill.js';
 import { applyPlatformSkillhub, removePlatformSkillhub } from './skillhub.js';
 import { createProfilePlugins, validatePackage, PROTECTED_PACKAGES } from './profile-plugins.js';
+import { isDesktopHost } from './desktop.js';
 import { createDefaultsSync } from './defaults-sync.js';
 import { canonicalSkillSlug, localSkillState } from './skill-state.js';
 import { ensureLanguageDefault } from './language.js';
@@ -565,16 +566,6 @@ button{font:inherit;padding:9px 22px;border-radius:10px;border:none;cursor:point
   });
 }
 
-/**
- * 是否运行在桌面壳内：宿主进程是 Electron（execPath 指向桌面壳可执行文件）。
- * 壳品牌：DSH Desktop / DSH NEXT / DeepSeek HARNESS（NEXT 的公开发布名）。
- * 与页面侧标记（page.js 传 desktop:true）互为兜底——iframe 内
- * location.search 不含宿主 query，页面自检在设置 iframe 场景会漏。
- */
-function isDesktopHost() {
-  return /(?:DSH Desktop|DSH NEXT|DeepSeek HARNESS)\.(?:app|exe)/i.test(process.execPath);
-}
-
 export function apply(ctx, config) {
   const log = ctx.logger || console;
   // 托管实例：注入的平台地址优先。容器内只有这个地址可达（本地部署是
@@ -584,9 +575,11 @@ export function apply(ctx, config) {
     log.info(`[dsh-agentone] platform url from instance env: ${injectedPlatformUrl}`);
     config.platformUrl = injectedPlatformUrl;
   }
-  // Desktop 环境探测（官方契约，见 harness-one DESKTOP.md）：desktopProfiles
-  // 只在 DSH Desktop 存在。据此把插件管理切到当前 profile，并用受管
-  // desktopPnpm 做装/卸/升级（desktop 里 dsh CLI 拒绝操作 desktop profile）。
+  // Desktop 环境探测：第三方壳发布 desktopProfiles + desktopPnpm，官方
+  // Electron 应用只发布 profileContext + pluginManager，判定统一在 desktop.js
+  // （品牌名与 profile 解析只有一份实现）。与页面侧标记（page.js 传
+  // desktop:true）互为兜底——iframe 内 location.search 不含宿主 query，
+  // 页面自检在设置 iframe 场景会漏。
   const desktopProfiles = ctx.get?.('desktopProfiles');
   const isDesktopRuntime = Boolean(desktopProfiles?.current?.name) || isDesktopHost();
   // 官方 settings 服务（可选依赖）：dsh ≥ 0.1.7 用它把平台模型写进 profile
@@ -992,6 +985,50 @@ export function apply(ctx, config) {
       }
     });
 
+    // 旧版本（≤0.5.38）装的技能没有本机记录：目录和平台台账都在，但本机
+    // 状态判定只会得到 conflict。按平台台账逐个重新应用（原子覆盖目录 +
+    // 重建记录 + 回报平台），一次点击修完一台机器。只处理「无本机记录」
+    // 的旧版安装；真有记录却内容不一致（用户改过）的仍走人工确认。
+    register('/agentone/api/skill/repair', 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: '请先完成 AgentOne 登录' });
+          return;
+        }
+        const result = await defaults.manualOperation(async (owner, options) => {
+          const listing = await listPlatformSkills(owner.platform, owner.token, { signal: options.signal });
+          const repaired = [];
+          const failed = [];
+          for (const item of listing?.skills || []) {
+            if (!item.installed_fingerprint) continue;
+            const local = await localSkillState(owner.platform, item.canonical_slug, options);
+            if (!(local.state === 'conflict' && !local.record)) continue;
+            try {
+              await installPlatformSkill(owner.platform, owner.token, item.canonical_slug, {
+                ...options,
+                source: ['plan', 'builtin'].includes(item.source) ? item.source : 'manual',
+              });
+              repaired.push(item.canonical_slug);
+            } catch (error) {
+              failed.push({ name: item.canonical_slug, error: error?.message || '重新应用失败' });
+            }
+          }
+          return { repaired: repaired.length, failed: failed.length, names: repaired, errors: failed };
+        });
+        invalidateStatusCache();
+        void defaults.sync({ manual: true }).catch(() => {});
+        sendJson(response, 200, { ok: true, ...result });
+      } catch (error) {
+        sendJson(response, 502, { error: error?.message || '重新应用旧版技能失败' });
+      }
+    });
+
     // 套餐技能同步：把平台上 source=plan 且未安装的技能装齐。前端在套餐
     // 生效联动与自动补装触发器里调，也可手动触发；同步结果失效技能缓存。
     register('/agentone/api/skill/sync', async (request, response) => {

package/lib/page.js

@@ -263,7 +263,10 @@ const maybeAutoSyncPlanSkills = (forced) => {
   const skills = lastStatus?.skills?.skills;
   if (!forced) {
     if (!Array.isArray(skills)) return;
-    if (!skills.some((skill) => skill.source === 'plan' && !skill.installed)) return;
+    // 只有本机真的缺目录（missing）才值得补装。conflict 是「目录在、记录/
+    // 来源对不上」，missingOnly 的同步会跳过它——旧版技能升级后这里每 60s
+    // 空转一次，用户只会看到重复提示却什么都不变。
+    if (!skills.some((skill) => skill.source === 'plan' && !skill.installed && skill.local_state === 'missing')) return;
   }
   planSkillSyncAt = now;
   planSkillSyncing = true;
@@ -399,12 +402,18 @@ const renderDefaults = (s) => {
     failed: '失败', conflict: '本机冲突', report_pending: '已安装，待回报', restart_required: '已安装，重启后生效' };
   const sources = { platform: '平台清单', compatibility: '旧平台兼容默认', cache: '本机缓存' };
   if (!config || !s.logged_in) { body.innerHTML = '<div class="muted">登录后检查平台默认能力</div>'; return; }
+  const entries = [...(config.skills || []), ...(config.plugins || [])];
+  // legacy：0.5.39 之前装的技能只有平台台账、没有本机记录（见 defaults-sync）。
+  // 这类条目单独给一个批量入口，不然升级后每台机器都要点 N 次「确认应用」。
+  const legacyCount = entries.filter((item) => item.legacy).length;
   const summary = '<div class="skill-sub">' + esc(sources[config.source] || '尚未检查')
     + (config.revision !== null ? ' · 版本 ' + esc(config.revision) : '')
     + (config.checked_at ? ' · ' + esc(new Date(config.checked_at).toLocaleString()) : '')
     + (config.running ? ' · 正在检查' : '') + '</div>'
-    + (config.error || config.profile_error ? '<div class="skill-sub" style="color:var(--err)">' + esc(config.error || config.profile_error) + '</div>' : '');
-  const entries = [...(config.skills || []), ...(config.plugins || [])];
+    + (config.error || config.profile_error ? '<div class="skill-sub" style="color:var(--err)">' + esc(config.error || config.profile_error) + '</div>' : '')
+    + (legacyCount ? '<div class="skill-sub"><button id="defaults-repair" class="btn small ghost"'
+      + (config.running ? ' disabled' : '') + '>重新应用旧版安装的技能（' + legacyCount + '）</button>'
+      + ' 技能目录会按平台当前版本覆盖</div>' : '');
   const html = summary + entries.map((item) => {
     const action = ['failed', 'report_pending', 'missing'].includes(item.state) ? 'retry'
       : ['conflict', 'pending'].includes(item.state) ? 'apply' : null;
@@ -414,6 +423,7 @@ const renderDefaults = (s) => {
     return '<div class="skill-item"><div class="skill-info"><div class="skill-name">'
       + esc(item.description || item.name) + ' <span class="tag">' + (item.kind === 'skill' ? '技能' : '插件')
       + '</span></div><div class="skill-sub">' + esc(item.name) + ' · ' + esc(labels[item.state] || item.state)
+      + (item.legacy ? '（旧版安装）' : '')
       + (item.version ? ' · ' + esc(item.version) : '')
       + (item.target_version && item.target_version !== item.version ? ' → ' + esc(item.target_version) : '')
       + (item.error ? '<br><span style="color:var(--err)">' + esc(item.error) + '</span>' : '')
@@ -429,6 +439,37 @@ const renderDefaults = (s) => {
         ? confirmThen(btn, '替换当前版本？', request, '已开始应用，请查看同步状态')
         : withLoading(btn, request, '已开始重试，请查看同步状态');
     });
+    const repair = body.querySelector('#defaults-repair');
+    if (repair) repair.onclick = async () => {
+      if (repair.dataset.confirming !== '1') {
+        repair.dataset.confirming = '1';
+        repair.dataset.originalLabel = repair.textContent;
+        repair.textContent = '确认按平台版本覆盖？';
+        repair.dataset.confirmTimer = String(setTimeout(() => {
+          repair.textContent = repair.dataset.originalLabel || '重新应用';
+          delete repair.dataset.confirming;
+        }, 3000));
+        return;
+      }
+      delete repair.dataset.confirming;
+      const original = repair.innerHTML;
+      repair.disabled = true;
+      repair.innerHTML = '<span class="spin"></span>重新应用中…';
+      try {
+        const resp = await fetch('api/skill/repair', { method: 'POST' });
+        const data = await resp.json().catch(() => ({}));
+        if (!resp.ok) throw new Error(data.error || '重新应用失败');
+        notify(data.failed
+          ? '已重新应用 ' + data.repaired + ' 个技能，' + data.failed + ' 个失败'
+          : '已重新应用 ' + data.repaired + ' 个旧版技能');
+      } catch (error) {
+        notify(error.message || '重新应用失败', 'err');
+      } finally {
+        repair.disabled = false;
+        repair.innerHTML = original;
+        await refresh();
+      }
+    };
   }
   $('defaults-sync-btn').disabled = config.running;
 };
@@ -461,14 +502,19 @@ const renderSkills = (s) => {
     // 可升级：平台对比 latest 指纹/版本后给的结论，提示「v旧 → v新」；
     // latest 查询失败时平台降级 false，这里不额外猜测
     const upgradable = skill.installed && skill.upgrade_available;
+    // 目录在、记录不符：不是「没装」，重新应用会按平台版本覆盖目录
+    const stranded = !skill.installed && skill.local_state === 'conflict';
     const meta = !skill.installed
-      ? '<span class="muted">未安装</span>'
+      ? (stranded
+        ? '<span class="muted">本机有目录但记录不符，需重新应用</span>'
+        : '<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>'
+      ? '<button class="btn small primary" data-install="' + esc(skill.canonical_slug) + '">'
+        + (stranded ? '重新应用' : '安装') + '</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>'
@@ -487,7 +533,7 @@ const renderSkills = (s) => {
   // 次确认
   const fingerprint = list.map((skill) =>
     skill.canonical_slug + ':' + (skill.installed ? 1 : 0) + ':' + (skill.installed_version || '')
-      + ':' + (skill.upgrade_available ? 1 : 0),
+      + ':' + (skill.upgrade_available ? 1 : 0) + ':' + (skill.local_state || ''),
   ).join('|') + '#' + metaHtml;
   if ($('skills-list').dataset.fingerprint !== fingerprint) {
     $('skills-list').dataset.fingerprint = fingerprint;
@@ -1003,15 +1049,18 @@ const renderPlugins = async () => {
     return;
   }
   const rows = data.plugins.map((plugin) => {
-    // 状态区分三种：未安装 → 安装按钮；插件（带 bundle 声明）→ 激活态；
+    // 状态区分三种：未安装 → 安装按钮；插件（带 bundle 声明）→ 启用态；
     // 纯依赖（无 bundle 声明，如 @larksuite/cli 这类 CLI 工具包）→ 「依赖」
-    // 标签——它永远不进 bundle 层，不能显示「未激活/重启生效」误导用户
+    // 标签——它永远不进 bundle 层，不能显示「未启用/重启生效」误导用户。
+    // 术语与官方「设置 → 插件」对齐：installed（在 node_modules）和
+    // enabled（在 dsh.profile.bundles）是两个维度，官方列表把两类都显示为
+    // 「已安装」，这里的「未启用」= 已安装但没挂进 profile。
     const statePill = !plugin.version
       ? '<span class="pill warn" style="font-size:11px">未安装</span>'
       : plugin.registered
-        ? '<span class="pill ok" style="font-size:11px">已注册</span>'
+        ? '<span class="pill ok" style="font-size:11px">已启用</span>'
         : plugin.bundled
-          ? '<span class="pill warn" style="font-size:11px">未注册</span>'
+          ? '<span class="pill warn" style="font-size:11px">未启用</span>'
           : '<span class="tag">依赖</span>';
     const builtinTag = plugin.builtin
       ? '<span class="tag">受管</span>'
@@ -1041,7 +1090,7 @@ const renderPlugins = async () => {
     return '<div class="skill-item"><div class="skill-info"><div class="skill-name">'
       + esc(plugin.name) + builtinTag + statePill
       + '</div><div class="skill-sub">' + desc + esc(plugin.source) + ' · ' + version
-      + (plugin.registered ? ' · 已安装并注册，重启后生效' : plugin.bundled ? ' · 未注册到当前 profile' : '')
+      + (plugin.registered ? ' · 已启用，重启后生效' : plugin.bundled ? ' · 已安装，未启用当前 profile（「升级」或重装可启用）' : '')
       + '</div></div>' + actionHtml + '</div>';
   });
   // 指纹保护（与 renderSkills 同思路）：内容没变不碰 innerHTML——升级后

package/lib/profile-plugins.js

@@ -1,6 +1,8 @@
 // 当前 profile 的插件操作；读取真实包和注册状态，写操作共享实例队列。
+import { randomUUID } from 'node:crypto';
 import { readFile } from 'node:fs/promises';
 import { isAbsolute, join, relative, resolve } from 'node:path';
+import { isDesktopHost, resolveProfileTarget } from './desktop.js';
 import { dshPluginCli, pnpmViewLatest } from './proc.js';
 import { resolveDshHome } from './store.js';
 
@@ -20,22 +22,97 @@ async function readJson(path) {
   try { return JSON.parse(await readFile(path, 'utf8')); }
   catch (error) { if (error.code === 'ENOENT') return null; throw new Error('插件配置文件无法读取，请检查本机 profile'); }
 }
-function validProfile(name) {
-  return typeof name === 'string' && /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,119}$/.test(name) && name !== 'node_modules';
+
+/** npm spec 白名单：`name` 或 `name@version`（`TARGET_RE` 同时用于官方
+ * 桌面端 pluginManager 通道，那个通道只接受包名/版本，不接受 pnpm 选项）。 */
+export const TARGET_RE = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*(?:@[^\s@]+)?$/i;
+
+/** 官方桌面端 pluginManager 的返回：application 为终态枚举，packageResult
+ * 是 pnpm 段的输出。`overridden` 是「改动保留了，只是被别的层覆盖显示」，
+ * 不是失败（市场侧踩过这个坑）。 */
+const MANAGER_APPLIED = new Set(['applied', 'restart-required', 'overridden']);
+
+/** 官方宿主的结构化错误 → 中文可操作文案。宿主的 error 是 JSON 对象
+ * （实测 dsh-im@1.0.5 在 dsh 0.2.0-rc.2 上返回 incompatible-version），
+ * 直接 stringify 会把英文原文甩给用户（AGENTS.md 报错规范）。 */
+function failureDetail(error) {
+  if (typeof error === 'string') return error;
+  if (error instanceof Error) return error.message;
+  if (error && typeof error === 'object' && !Array.isArray(error)) {
+    if (error.code === 'incompatible-version' && Array.isArray(error.incompatible) && error.incompatible.length) {
+      return error.incompatible.map((item) => {
+        const peers = Object.entries(item.peers || {})
+          .map(([name, range]) => `${name}@${range}`).join('、');
+        return `${item.name || '插件'}@${item.version || '?'} 与当前宿主 dsh ${item.runtimeVersion || '?'} 不兼容`
+          + (peers ? `（peer 依赖要求 ${peers}）` : '')
+          + '：请在「设置 → 插件」为该版本授权，或等插件发布兼容新版本';
+      }).join('；');
+    }
+    if (typeof error.message === 'string' && error.message) return error.message;
+    if (typeof error.code === 'string' && error.code) return `插件操作未完成（${error.code}），请在「设置 → 插件」里查看详情`;
+  }
+  if (error === undefined) return '';
+  try { return JSON.stringify(error); } catch { return String(error); }
 }
-export function createProfilePlugins({ ctx, config = {}, desktopRun, runCli = dshPluginCli, latest = pnpmViewLatest }) {
+
+/**
+ * 官方 Electron 桌面端通道：这个 profile 完全由宿主 in-process 的
+ * pluginManager 管（安装/卸载只会走它自己的「设置 → 插件」管线）。只接受
+ * `add <spec>` / `remove <name>`——官方管线自己处理构建脚本审批，不接受
+ * pnpm 选项，传进去会让整次操作被拒（`--allow-build` 因此不转发）。
+ * 返回契约与 dshPluginCli 一致：成功 {stdout, stderr}，失败抛 Error。
+ */
+export function desktopManagerRun(manager) {
+  let queue = Promise.resolve();
+  const settle = (result) => {
+    const stdout = String(result?.packageResult?.output || '');
+    if (MANAGER_APPLIED.has(result?.application)) return { stdout, stderr: '' };
+    throw new Error(failureDetail(result?.error) || '插件操作未完成，请在「设置 → 插件」里重试');
+  };
+  const run = async (args, options = {}) => {
+    options.signal?.throwIfAborted();
+    const [command, target, ...extra] = args;
+    // 官方管线自己处理构建脚本审批（与应用内「设置 → 插件」同一管线），
+    // 不接受 pnpm 选项：除了 dsh-agentone 自己生成的 --allow-build，其余
+    // 参数一律拒绝，避免「静默丢参数改变用户意图」。
+    const rejected = extra.filter((argument) => !/^--allow-build=[^@\s]+$/.test(argument));
+    if (rejected.length) throw new Error('官方桌面端的插件操作由应用自己执行，不接受附加参数');
+    if (typeof target !== 'string' || !TARGET_RE.test(target)) throw new Error('插件名不合法，请填写完整的 npm 包名');
+    if (command === 'add') {
+      const requestId = randomUUID();
+      const cancel = () => manager.cancelInstall?.(requestId);
+      options.signal?.addEventListener('abort', cancel, { once: true });
+      try {
+        const result = await manager.installBundle(target, { requestId });
+        options.signal?.throwIfAborted();
+        return settle(result);
+      } finally {
+        options.signal?.removeEventListener('abort', cancel);
+      }
+    }
+    if (command === 'remove') return settle(await manager.removeBundle(target));
+    throw new Error(`官方桌面端不支持这个插件操作（${command}），请在「设置 → 插件」里完成`);
+  };
+  return (args, options = {}) => {
+    const next = queue.then(() => run(args, options));
+    queue = next.catch(() => undefined);
+    return next;
+  };
+}
+
+export function createProfilePlugins({ ctx, config = {}, desktopRun, runCli = dshPluginCli, latest = pnpmViewLatest,
+  isDesktop = () => Boolean(ctx.get?.('desktopProfiles')) || isDesktopHost(),
+  managerRun = desktopManagerRun }) {
   let queue = Promise.resolve();
   let closed = false;
   let policy = [];
   function target() {
     if (closed) throw new Error('插件已停止，请重新打开后再试');
-    const desktop = ctx.get?.('desktopProfiles');
-    const isDesktop = Boolean(desktop) || /DSH Desktop\.(?:app|exe)/i.test(process.execPath);
-    const name = desktop?.current?.name || (!isDesktop ? config.profileName : null);
-    if (!validProfile(name)) throw new Error('无法确定当前 DSH profile，请在 AgentOne 插件配置中填写 profileName 后重启');
     const homeService = ctx.get?.('dshHomePath');
     const home = resolve(config.dshHome || (typeof homeService === 'function' ? homeService() : homeService) || resolveDshHome());
-    return { home, name, dir: join(home, 'profiles', name), desktop: isDesktop };
+    const resolved = resolveProfileTarget({ ctx, config, home, desktop: isDesktop() });
+    if (!resolved) throw new Error('无法确定当前 DSH profile，请在 AgentOne 插件配置中填写 profileName 后重启');
+    return resolved;
   }
   function enqueue(operation) {
     let expected;
@@ -91,9 +168,12 @@ export function createProfilePlugins({ ctx, config = {}, desktopRun, runCli = ds
     await options.beforeCommit?.();
     check(current, options);
     if (current.desktop) {
+      // 第三方壳：受管 desktopPnpm；官方 Electron 应用：pluginManager。
       const service = ctx.get?.('desktopPnpm');
-      if (!service || !desktopRun) throw new Error('桌面插件安装通道尚未就绪，请稍后重试');
-      return desktopRun(service, current.dir)(args, options);
+      if (service && desktopRun) return desktopRun(service, current.dir)(args, options);
+      const manager = ctx.get?.('pluginManager');
+      if (manager) return managerRun(manager)(args, options);
+      throw new Error('桌面插件安装通道尚未就绪，请稍后重试');
     }
     return runCli(args, current.name, { env: { DSH_HOME: current.home }, signal: options.signal });
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-agentone",
-  "version": "0.5.40",
-  "description": "AgentOne 平台集成：平台模型、SkillHub 技能、套餐与 CLI；lark-cli 首装一键初始化飞书应用；修复 DeepSeek HARNESS 桌面壳登录回调地址不合法",
+  "version": "0.5.42",
+  "description": "AgentOne 平台集成：平台模型、SkillHub 技能、套餐与 CLI；宿主插件错误中文化与启用态术语对齐官方插件管理",
   "type": "module",
   "scripts": {
     "smoke": "node scripts/env-matrix-smoke.mjs"