dsh-armory 1.9.0 → 1.9.2

package/README.en.md

@@ -9,6 +9,7 @@
 <p align="center">
   <a href="https://github.com/2026heshao/dsh-armory/stargazers"><img src="https://img.shields.io/github/stars/2026heshao/dsh-armory?style=social" alt="stars"></a>
   <a href="https://github.com/2026heshao/dsh-armory/releases"><img src="https://img.shields.io/github/v/release/2026heshao/dsh-armory?label=release" alt="release"></a>
+  <a href="https://www.npmjs.com/package/dsh-armory"><img src="https://img.shields.io/npm/dt/dsh-armory?label=npm%20downloads" alt="npm downloads"></a>
   <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="license"></a>
   <img src="https://img.shields.io/badge/DSH-%3E%3D0.1.5--rc.1-blue" alt="DSH">
   <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/topic-dsh--plugin-8b5cf6" alt="topic: dsh-plugin"></a>
@@ -17,10 +18,14 @@
 ## Install in one line
 
 ```sh
+# npm (recommended: no build-approval step, ready to use)
+dsh plugin --profile web add dsh-armory
+
+# GitHub
 dsh plugin --profile web add github:2026heshao/dsh-armory
 ```
 
-Restart DSH, then open **Skills · MCP** from the global panel list at the top of the sidebar (or the floating button bottom-right). Desktop users on the `desktop` profile: swap `--profile web` for `--profile desktop`.
+Restart DSH, then open **Skills · MCP · Experts** from the global panel list at the top of the sidebar (or the floating button bottom-right). Desktop users on the `desktop` profile: swap `--profile web` for `--profile desktop`. You can also search `armory` and one-click install inside [dsh-market](https://github.com/dsh-market/dsh-market#readme).
 
 ## What it solves
 
@@ -87,10 +92,14 @@ A **unified board** for DeepSeek Harness (Web and desktop): five top-level tabs
 ## Install (details)
 
 ```sh
+# npm (recommended)
+dsh plugin --profile web add dsh-armory
+
+# GitHub
 dsh plugin --profile web add github:2026heshao/dsh-armory
 ```
 
-Then **restart `dsh web`**. To upgrade (GitHub installs: re-add with a new tag):
+Then **restart DSH** (restart the desktop app, or `dsh web` for the browser GUI; desktop users: swap `--profile web` for `--profile desktop`). To upgrade: npm installs can click the in-panel upgrade banner; GitHub installs re-add with a new tag:
 
 ```sh
 dsh plugin --profile web update dsh-armory
@@ -113,7 +122,7 @@ Details, local development installs, and troubleshooting: [docs/installation.md]
 Two entry points, one panel:
 
 - **Floating button (bottom-right)**: draggable, position remembered;
-- **Sidebar entry at the bottom**: above "Settings" when expanded, icon-only in the 56px rail.
+- **Sidebar entry "Skills · MCP · Experts"**: above "Settings" when expanded, icon-only in the 56px rail.
 
 The panel floats above the session; closing it ("Close" or Esc) does not affect the conversation.
 

package/README.md

@@ -9,6 +9,7 @@
 <p align="center">
   <a href="https://github.com/2026heshao/dsh-armory/stargazers"><img src="https://img.shields.io/github/stars/2026heshao/dsh-armory?style=social" alt="stars"></a>
   <a href="https://github.com/2026heshao/dsh-armory/releases"><img src="https://img.shields.io/github/v/release/2026heshao/dsh-armory?label=release" alt="release"></a>
+  <a href="https://www.npmjs.com/package/dsh-armory"><img src="https://img.shields.io/npm/dt/dsh-armory?label=npm%20downloads" alt="npm downloads"></a>
   <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="license"></a>
   <img src="https://img.shields.io/badge/DSH-%3E%3D0.1.5--rc.1-blue" alt="DSH">
   <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/topic-dsh--plugin-8b5cf6" alt="topic: dsh-plugin"></a>
@@ -17,10 +18,14 @@
 ## 一键安装
 
 ```sh
+# npm（推荐：免构建授权，装完即用）
+dsh plugin --profile web add dsh-armory
+
+# GitHub
 dsh plugin --profile web add github:2026heshao/dsh-armory
 ```
 
-装完**重启 DSH**，侧栏顶部「全局面板」里点 **技能 · MCP**（或右下角悬浮按钮）。桌面端装在 `desktop` profile 时把 `--profile web` 换成 `--profile desktop`。
+装完**重启 DSH**，侧栏顶部「全局面板」里点 **技能 · MCP · 专家**（或右下角悬浮按钮）。桌面端装在 `desktop` profile 时把 `--profile web` 换成 `--profile desktop`。也可以在装了 [dsh-market](https://github.com/dsh-market/dsh-market#readme) 的 DSH 里搜 `armory` 一键安装。
 
 ## 它解决什么
 
@@ -73,10 +78,14 @@ dsh plugin --profile web add github:2026heshao/dsh-armory
 ## 安装
 
 ```sh
+# 从 npm 安装（推荐）
+dsh plugin --profile web add dsh-armory
+
+# 从 GitHub 安装
 dsh plugin --profile web add github:2026heshao/dsh-armory
 ```
 
-装完**重启 `dsh web`**（桌面端把 `--profile web` 换成 `--profile desktop`）。升级：换新版 tag 重新 `add`，或在面板「一键升级」提示条上直接点。卸载（不会删除 profile 里已有的 MCP 条目）：
+装完**重启 DSH**（桌面端重启应用，Web 端重启 `dsh web`；桌面端把 `--profile web` 换成 `--profile desktop`）。升级：npm 安装可在面板「一键升级」提示条上直接点，GitHub 安装换新版 tag 重新 `add`。卸载（不会删除 profile 里已有的 MCP 条目）：
 
 ```sh
 dsh plugin --profile web remove dsh-armory
@@ -93,7 +102,7 @@ dsh plugin --profile web remove dsh-armory
 两个入口，同一个面板：
 
 - **右下角悬浮按钮**：可拖拽移动，位置会被记住；
-- **侧栏底部「MCP」**：展开态在「设置」上方，侧栏收起成 56px 轨道时只剩图标。
+- **侧栏「技能 · MCP · 专家」**：展开态在「设置」上方，侧栏收起成 56px 轨道时只剩图标。
 
 面板浮在会话之上，关掉它（右上角「关闭」或 Esc）不会影响会话。
 
@@ -181,12 +190,18 @@ dsh plugin --profile web remove dsh-armory
 ## 开发
 
 ```sh
-npm test                              # 全部测试（含真机集成用例）
-dsh --profile web --dump-config       # 看 profile 的有效配置
-dsh web                               # 起 Web 做真实操作验证
+npm install --no-save yaml@2            # 测试唯一的裸依赖（node:test 内置）
+npm test                                # 专家市场写链 33 断言（与 CI / 发版门槛同一条）
+npm run test:e2e                        # 可选：用宿主补丁算法验证专家预设进入组合树
+dsh --profile web --dump-config         # 看 profile 的有效配置
+dsh web                                 # 起 Web 做真实操作验证
 ```
 
-`npm test` 里除替身用例（验证插件内部自洽）外，还有一组**真机集成用例**：真 `cordis` + 真 `dsh-tools` + 真 `dsh-scope` + 真 `dsh-mcp-client` + 一个真 stdio MCP 子进程，覆盖「同项目两个会话共用一份连接、工具投射进会话层、不泄漏到全局、子进程随最后一个会话退出」。CI（push 到 main / PR，以及推 tag 发版）跑的是同一条门槛，发版流程见 [安装与升级](docs/installation.md#发布流程维护者)。
+`npm test` 跑的是 `test/expert-manual.mjs`：真网拉 WorkBuddy 专家目录（ETag 命中后走磁盘缓存）与 senior-developer 人设，再对 `lib/expert-market.js` 的 patch 写链做 33 条断言——含 1.9.1 修复的回归用例（召唤预设必须写成顶层 `- insert:` 指令、旧版顶层裸条目要能被迁移）。本机存在 `~/.dsh/profiles/desktop/cordis.patch.yml` 时会追加一组真实 profile 往返断言，没有则记 `SKIP`。
+
+CI（push 到 main / PR，见 `.github/workflows/ci.yml`）与发版门槛（推 tag，见 `.github/workflows/release.yml`）跑的是**逐字相同**的命令（装 `yaml@2` → `node ./test/run-expert-manual.mjs`），两处口径不许分叉；发版流程见 [安装与升级](docs/installation.md#发布流程维护者)。
+
+> 本机若没有 `yaml`，`npm test` 会以 `ERR_MODULE_NOT_FOUND` 退出——`test/loader.mjs` 会先试标准解析，失败才回退开发机的 profile 副本（`~/.dsh/profiles/desktop/node_modules`），所以干净环境必须先装依赖。
 
 ## 文档
 

package/docs/installation.md

@@ -116,25 +116,35 @@ npm 与 GitHub Releases 必须**同一次发布里都更新**：用户从 npm
 
 ```sh
 # 1) 改版本：package.json + README/docs 里的版本与 tag 引用 + lib/whats-new.js 的更新条目
-#    + .github/release-notes/v<新版本>.md（后两项缺一项，下面的 npm test 就会红）
-npm test
+#    + .github/release-notes/v<新版本>.md（后两项缺一项，release.yml 的校验步骤就会红）
+npm install --no-save yaml@2   # 测试唯一的裸依赖；干净 checkout 必须先装
+npm test                       # 专家市场写链 33 断言（与 CI / 发版门槛同一条命令）
 
 # 2) 真机过一遍（触发条件见下），**必须在打 tag 之前**
 dsh web    # 打开面板点一遍
 
-# 3) 提交并推 tag（CI 会校验 tag 与 version 一致，不一致就拒绝发布）
+# 3) 提交并推 tag（release.yml 会校验 tag 与 version 一致，不一致就拒绝发布）
 git add -A && git commit -m "..."
 git push origin main
-git tag -a v1.9.0 -m "v1.8.0 ..." && git push origin v1.9.0
+git tag -a v1.9.1 -m "v1.9.1 ..." && git push origin v1.9.1
 ```
 
-推 tag 后 CI 依次做：校验版本 → `pnpm install --frozen-lockfile` → `npm test` → `npm publish`（trusted publishing，无需 token）→ `gh release create`。
+推 tag 后 `.github/workflows/release.yml` 依次做：校验 tag 与版本一致 → 校验 whats-new 有当前版本条目 → 校验 release notes 稿存在 → 装 `yaml@2` → `node ./test/run-expert-manual.mjs` → `npm publish`（trusted publishing，无需 token）→ `gh release create`。
 
-**第 2 步的真机检查什么时候必须做**：客户端那一半是替身测试——组件在 node 里渲染不起来（见[设计与限制](design.md#版本范围怎么定以及它管不到什么)），所以 CI 全绿也证明不了面板能显示。因此**只要本次改动碰了 `lib/client.js`、或推进了 DSH 基线，就必须做**：起 `dsh web`，确认侧栏入口能打开面板、悬浮按钮在位，然后导入 / 预览 / 启停各点一次。本次改名恰好动了 `lib/client.js`（插件 id、CSS 去重键、typert method id、localStorage 迁移），所以这一遍不能省。
+CI 分工（两条工作流，门槛命令**逐字相同**，改一处必须改另一处）：
+
+| 工作流 | 触发 | 跑什么 |
+| --- | --- | --- |
+| `.github/workflows/ci.yml` | push 到 main、PR、手动 | 装 `yaml@2` → `node ./test/run-expert-manual.mjs`（只验证，不发布） |
+| `.github/workflows/release.yml` | 推 `v*.*.*` tag、手动 | 同上门槛 + 版本 / whats-new / release-notes 三项校验 → `npm publish` → GitHub Release |
+
+> **本仓库没有 `pnpm-lock.yaml`**（运行依赖全是宿主提供的 peer，不装进包），而 devDependencies 里的 `@deepseek-ai/*` 是宿主内部包、npm registry 上不存在。所以两条工作流都**不能用** `pnpm install --frozen-lockfile`——改回它会立刻红（历史上失败过一次）。测试只需 `yaml`，用 `npm install --no-save` 装。
+
+**第 2 步的真机检查什么时候必须做**：客户端那一半是替身测试——组件在 node 里渲染不起来（见[设计与限制](design.md#版本范围怎么定以及它管不到什么)），所以 CI 全绿也证明不了面板能显示。因此**只要本次改动碰了 `lib/client.js`、或推进了 DSH 基线，就必须做**：起 `dsh web`，确认侧栏入口能打开面板、悬浮按钮在位，然后导入 / 预览 / 启停各点一次。
 
 为什么不能交给 CI：这类失败的表现是**面板白屏**，不会让任何用例变红（注册契约是好的，渲染不出来而已）。宿主改 slot 就是这种改动的典型——`0.1.6-alpha.2` 的发布说明里有「客户端 Session 会话支持多实例共存，相关 API 及 slot 有变化」，2026-09-24 推进基线到 `0.1.7-rc.1`、09-28 推进到 `0.1.7-rc.2` 时也属于这一类，所以它固定成检查单而不是靠记得。纯 Host 侧改动（`lib/index.js`、`lib/workspace-*.js` 等）可以跳过这一步。
 
-**Release notes 是必写的**，稿子放 `.github/release-notes/vX.Y.Z.md`（**不要**放 `docs/`，docs 会随包发布到 npm）；有稿子就用它，没有才退回 `--generate-notes`。为什么必写：本仓库全部直接提交到 main、没有 PR，自动生成几乎生成不出内容（v1.3.0 及之前每个 Release 页面都只有一行 compare 链接），而面板的更新提示正是把用户指到那一页。`test/package-contract.test.mjs` 会拦下「bump 了版本却没写稿」，所以在打 tag 之前本地就会红。
+**Release notes 是必写的**，稿子放 `.github/release-notes/vX.Y.Z.md`（**不要**放 `docs/`，docs 会随包发布到 npm）；`release.yml` 的「校验 release notes 稿子存在」步骤会拦下漏写，`gh release create --notes-file` 用它作为 Release 页面正文。为什么必写：本仓库全部直接提交到 main、没有 PR，自动生成几乎生成不出内容（v1.3.0 及之前每个 Release 页面都只有一行 compare 链接），而面板的更新提示正是把用户指到那一页。
 
 **应用内的「更新到 vX」提示是另一件事**：它的内容真源是 `lib/whats-new.js`（随包发布，宿主的 `whatsNew` RPC 直接转发它），发布前必须给它写上当前版本那一条——`test/whats-new.test.mjs` 会拦下「bump 了版本却没写更新内容」。只写一条就够，不必和 GitHub Release notes 逐字一致。
 

package/lib/client.js

@@ -375,9 +375,6 @@ const MCP_CSS = `body{--mcp-accent:var(--dsw-alias-brand-primary);--mcp-ok:var(-
 .dsh-mcp-quick-note{padding:7px 11px;margin-bottom:4px;border-radius:var(--mcp-r-sm);background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary);font-size:11px;line-height:15px;display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:3;overflow:hidden;white-space:normal;word-break:break-word}
 .dsh-mcp-quick-note.err{color:var(--mcp-err)}
 .dsh-mcp-quick-note.ok{color:var(--mcp-ok)}
-.dsh-mcp-quick-new-session{width:calc(100% - 8px);margin:0 4px 6px;border:1px solid color-mix(in srgb,var(--mcp-accent) 35%,transparent);border-radius:var(--mcp-r-sm);background:color-mix(in srgb,var(--mcp-accent) 10%,transparent);color:var(--mcp-accent);font:inherit;font-size:12px;line-height:26px;cursor:pointer;display:flex;align-items:center;justify-content:center;gap:6px;white-space:nowrap;overflow:hidden}
-.dsh-mcp-quick-new-session:hover{background:color-mix(in srgb,var(--mcp-accent) 18%,transparent)}
-.dsh-mcp-quick-new-session span{overflow:hidden;text-overflow:ellipsis}
 .dsh-mcp-quick-err{color:var(--mcp-err)}
 /* ── 主面板页（main slot，和「插件」同级的入口页）────────────────────────
    入口型页面要用 --dsh-frame-top-clearance 让出窗口顶带（官方 ui-layout 的约定：
@@ -1529,21 +1526,35 @@ const McpTab = (props) => {
   // 探测一键升级的可用性：官方 pluginManager 在不在 + 本插件是不是 npm 装的。
   // 与 updateHint 同一条纪律：任何失败都静默（按钮不出现即可），绝不因它让面板报错。
   // 只在确实有新版时才探测——没有新版时按钮本来就不显示，省一次 remote 调用。
+  //
+  // 安装来源必须问宿主（call('installInfo')）：宿主 listBundles() 的行里没有 source
+  // 字段，客户端拿它判来源会恒判「npm 装的」；而 installBundle 执行 `pnpm add <spec>`，
+  // 本地 file:/link: 安装的用户一点就把开发副本换成 npm 包。installInfo 读的是 profile
+  // manifest 里本插件那一行的真实 spec，是唯一可信判据。
   useEffect(() => {
     if (!updateHint?.latest || !pluginManager || typeof pluginManager[UPGRADE_METHOD] !== 'function') return undefined;
     let cancelled = false;
     (async () => {
       try {
-        const res = await pluginManager.listBundles();
-        if (cancelled || !res || res.ok !== true || !Array.isArray(res.value)) return;
-        const bundle = res.value.find((b) => b && b.name === UPGRADE_PACKAGE) || null;
-        // 只有判定为「可升级」才记 state；不可升级时保持 idle，按钮走旧的链接形态。
-        const plan = upgradePlan({ service: pluginManager, hint: updateHint, bundle });
-        if (!cancelled && plan.supported) setUpgradeState({ phase: 'idle', bundle, spec: plan.spec });
+        const [bundleRes, installRes] = await Promise.all([
+          pluginManager.listBundles(),
+          call('installInfo').catch(() => null),
+        ]);
+        if (cancelled) return;
+        const bundle = bundleRes && bundleRes.ok === true && Array.isArray(bundleRes.value)
+          ? bundleRes.value.find((b) => b && b.name === UPGRADE_PACKAGE) || null
+          : null;
+        const install = installRes && installRes.ok ? installRes : null;
+        // 只有判定为「可升级」才记 spec；不可升级时也记下 source/reason，
+        // 供横幅按真实来源说清「为什么不能一键升」（本地安装 vs 来源未知）。
+        const plan = upgradePlan({ service: pluginManager, hint: updateHint, bundle, spec: install?.spec ?? null, source: install?.source ?? null });
+        if (cancelled) return;
+        if (plan.supported) setUpgradeState({ phase: 'idle', bundle, spec: plan.spec, source: install?.source ?? null });
+        else setUpgradeState({ phase: 'idle', bundle, source: install?.source ?? null, reason: plan.reason });
       } catch { /* 探测失败 = 没有一键升级，退回链接；不报错 */ }
     })();
     return () => { cancelled = true; };
-  }, [pluginManager, updateHint]);
+  }, [pluginManager, updateHint, call]);
 
   // 挂载失败按 serverName 索引：既标到列表行上，也注入详情的错误区，避免「顶部报错但那一行看着正常」。
   // 挂载失败的汇总横幅用的就是这个列表；行与详情都读 Host 标在行上的 mountFailed。
@@ -1710,33 +1721,31 @@ const McpTab = (props) => {
   // 更不该报错（这一整块是纯增值信息，与 updateHint 同一条纪律）。
   const [upgradeState, setUpgradeState] = useState({ phase: 'idle' });
   const runUpgrade = async () => {
-    const svc = pluginManager;
-    const plan = upgradePlan({ service: svc, hint: updateHint, bundle: upgradeState.bundle || null });
-    if (!plan.supported) {
-      // 只有「本地链接安装」值得明说：其余情况（宿主没提供、已是最新）按钮本来就不显示。
-      setUpgradeState({ phase: 'blocked', reason: plan.reason });
-      return;
-    }
-    setUpgradeState({ phase: 'running', version: plan.version });
+    // 判定在探测 effect 里已用真实 spec（宿主 installInfo）做完；按钮只在 supported 时
+    // 才渲染，所以这里拿到 spec 就能执行。状态过期（spec 被清掉）时只提示、不动安装。
+    const targetSpec = upgradeState.spec;
+    if (!targetSpec) { setUpgradeState({ phase: 'blocked', reason: upgradeState.reason || 'not-ready' }); return; }
+    const targetVersion = targetSpec.split('@^')[1] || updateHint?.latest || '';
+    setUpgradeState((current) => ({ ...current, phase: 'running', version: targetVersion }));
     try {
       // 两个参数：installBundle(spec, options)。少传第二个会被 wire 直接拒绝
       // （client api: pluginManager/installBundle expected 2 argument(s), got 1）。
-      const res = await svc[UPGRADE_METHOD](plan.spec, {});
+      const res = await pluginManager[UPGRADE_METHOD](targetSpec, {});
       if (!res || res.ok !== true) {
-        setUpgradeState({ phase: 'failed', text: (res && res.error && (res.error.message || res.error.code)) || '调用失败' });
+        setUpgradeState((current) => ({ ...current, phase: 'failed', text: (res && res.error && (res.error.message || res.error.code)) || '调用失败' }));
         return;
       }
       const r = res.value || {};
       if (r.application === 'failed' || r.application === 'cancelled') {
-        setUpgradeState({ phase: 'failed', text: upgradeFailureText(r.error, r.packageResult && r.packageResult.exitCode) });
+        setUpgradeState((current) => ({ ...current, phase: 'failed', text: upgradeFailureText(r.error, r.packageResult && r.packageResult.exitCode) }));
         return;
       }
       // applied / restart-required / overridden 都算装上了。宿主代码在进程内执行，升级已存在的包
       // 时官方**无条件**返回 restart-required（installBundle 里 `if (Object.hasOwn(before, name))
       // return 'restart-required'`，与 HMR 开不开无关），所以这里必须告诉用户去重启。
-      setUpgradeState({ phase: 'done', version: plan.version || updateHint?.latest || '' });
+      setUpgradeState({ phase: 'done', version: targetVersion });
     } catch (e) {
-      setUpgradeState({ phase: 'failed', text: String(e?.message || e) });
+      setUpgradeState((current) => ({ ...current, phase: 'failed', text: String(e?.message || e) }));
     }
   };
   const filtered = useMemo(() => {
@@ -1814,8 +1823,12 @@ const McpTab = (props) => {
           : upgradeState.phase === 'done' ? '已升级到 v' + upgradeState.version + '，重启宿主后生效'
             : upgradeState.phase === 'failed' ? '升级失败：' + upgradeState.text
               : upgradeState.phase === 'blocked' && upgradeState.reason === 'not-npm'
-                ? '本地链接安装，无法一键升级' + (updateHint?.current ? '（当前 v' + updateHint.current + '）' : '')
-                : '新版本 v' + updateHint.latest + ' 可用'),
+                ? '本地安装（' + (upgradeState.source || 'file') + '），一键升级会把本地副本换成 npm 包，故只提示' + (updateHint?.current ? '（当前 v' + updateHint.current + '）' : '')
+                : upgradeState.phase === 'idle' && upgradeState.reason === 'not-npm'
+                  // 探测阶段就判定不可一键升：这是本地开发安装的常态（file:/link:），
+                  // 说清原因，免得用户以为按钮坏了。
+                  ? '新版本 v' + updateHint.latest + ' 可用；本地安装（' + (upgradeState.source || 'file') + '）请手动更新后重启'
+                  : '新版本 v' + updateHint.latest + ' 可用'),
       // 可升级时给按钮，否则退回链接。按钮只在探测确认过 service + npm 来源后出现——
       // 探测失败时这一整条与改动前完全一致，不会出现点了没反应的按钮。
       upgradeState.phase === 'idle' && upgradeState.spec
@@ -2843,7 +2856,7 @@ const ExpertMarket = ({ call }) => {
 const QUICK_MENU_KINDS = [
   { key: 'skill', label: '技能', icon: 'skill', hint: '技能按需触发：选择后以 /技能名 插入输入框' },
   { key: 'mcp', label: 'MCP', icon: 'plug', hint: 'MCP 工具按 server 生效：选择后点名 mcp__服务__* 工具' },
-  { key: 'expert', label: '专家', icon: 'expert', hint: '专家挂到当前会话：整个会话由该专家人设接管' },
+  { key: 'expert', label: '专家', icon: 'expert', hint: '专家随时挂/换/摘：点一个即接管本会话，再点别的直接换，点 chip 的 × 取消' },
 ];
 const QUICK_RECENT_LIMIT = 6;
 // 引用文本格式（对齐宿主真实语义，避免「同名空文档」）：
@@ -3026,109 +3039,92 @@ const SummonQuickMenu = ({ call, inputActions, sessionId: sessionIdProp }) => {
   const itemLabel = (kind, item) => (kind === 'expert' ? item.name || item.plugin : item.name);
   const itemDesc = (kind, item) => (kind === 'mcp' ? (item.transport ? item.transport : '') : (item.description || '').slice(0, 48));
 
-  // ── 挂专家（WorkBuddy 式）：条目点击 = agentPresets.select(sessionId, presetId) ──
-  // 官方会话头部的预设选择器同款通道：blank 会话立即生效（整个会话由专家人设接管）；
-  // 已开始的会话宿主拒绝（agent-preset/locked），此时提示改为新会话生效。挂载状态
-  // 由本组件自持（chip 显示 + 移除按钮）；移除 = select 回默认预设。
+  // ── 挂专家（WorkBuddy 式：随时挂 / 换 / 摘）──────────────────────────────
+  // 主通道是宿主新的会话级人设 RPC expertAttach/expertDetach：它把专家人设作为
+  // systemPrompt 的「本会话作用域 section」注入（与 dsh-persona / dsh-subagent 同款
+  // deployment:persona-prefix 遮蔽机制），因此：
+  //   - 不受 agent-preset/locked 限制 —— 会话已开过口也能挂、能换、能摘；
+  //   - 只影响这一个会话，不动工具目录、不写任何持久化配置；
+  //   - 反复点不同专家 = 直接替换（Host 先摘旧的再装新的），不再是一次性。
+  // 预设通道（agentPresets.select）作为 blank 会话的增强：它连工具目录一起接管，语义更
+  // 彻底；只在「该专家已被召唤 + 会话还是空白」时成功，失败就自动退回人设通道——
+  // 两条路都不通的情况不存在，所以「换专家」永远有出路。
   // sessionId 来源：conversation.input.right 是 session 座位，slot 渲染时把 sessionId
   // 作为 prop 显式传入（apply() 注册处 inject: (sessionId) => ({ call, sessionId })）；
   // 会话 summary 行本身不带 id 字段（id 只走 props），所以不能从 useSession 投影里取。
   const MODULE = MODULE_CTX.ctx;
-  const [attached, setAttached] = useState(null); // { plugin, name, presetId }
+  const [attached, setAttached] = useState(null); // { plugin, name, mode: 'persona'|'preset' }
   const [attachBusy, setAttachBusy] = useState(false);
   const [attachNote, setAttachNote] = useState('');
-  // locked 后的「带专家新建会话」待办：宿主硬规则是已开始的会话不能换预设
-  // （agent-preset/locked），但官方 hero 预设选择器对 blank 会话可用——所以
-  // 提供「新建会话并挂上该专家」的一键路径：sessions.create() → agentPresets.select() →
-  // uiWorkspace.openSession()，与官方「新会话选预设」语义完全一致，只是自动化了。
-  const [pendingExpert, setPendingExpert] = useState(null);
   const sessionId = typeof sessionIdProp === 'string' && sessionIdProp !== '' ? sessionIdProp : null;
   const expertPresetIdOf = (item) => 'wbexpert-' + String(item.plugin || '').toLowerCase().replace(/[^a-z0-9_-]+/g, '-').replace(/^-+|-+$/g, '');
-  const createWithExpert = async (item) => {
-    const ctx = MODULE;
-    if (!ctx || typeof ctx.get !== 'function') { setAttachNote('宿主上下文不可用，无法新建会话'); return; }
-    const sessions = ctx.get('sessions');
-    const uiWorkspace = ctx.get('uiWorkspace');
-    const remote = ctx.get('remote.agentPresets');
-    if (!sessions || typeof sessions.create !== 'function') { setAttachNote('宿主未提供会话创建接口（sessions 不可用）'); return; }
-    if (!uiWorkspace || typeof uiWorkspace.openSession !== 'function') { setAttachNote('宿主未提供会话导航接口（uiWorkspace 不可用）'); return; }
-    if (!remote || typeof remote.select !== 'function') { setAttachNote('宿主未提供 agentPresets 接口（remote.agentPresets 不可用）'); return; }
-    setAttachBusy(true); setAttachNote('');
-    try {
-      // 继承当前会话的工作目录（拿不到就让宿主用默认 workspace）。
-      const cwd = sessionId && sessions.list && typeof sessions.list.getSnapshot === 'function'
-        ? sessions.list.getSnapshot().byId[sessionId]?.cwd : undefined;
-      // ClientSessions.create 成功直接返回 sessionId 字符串，失败抛 SessionCreateError
-      // （workspace-client 的 reuseOrCreateBlank 同款走法）。
-      const newId = await sessions.create(cwd ? { cwd } : {});
-      if (typeof newId !== 'string' || !newId) throw new Error('创建会话未返回会话 id');
-      const presetId = expertPresetIdOf(item);
-      const selected = await remote.select(newId, presetId);
-      if (!selected || !selected.ok) {
-        throw new Error('专家预设挂载失败：' + ((selected && selected.error && (selected.error.message || selected.error.code)) || '未知错误'));
-      }
-      uiWorkspace.openSession(newId);
-      setAttached({ plugin: item.plugin, name: item.name || item.plugin, presetId: (selected.value && selected.value) || presetId });
-      setPendingExpert(null);
-      setAttachNote('✓ 已新建专家会话：' + (item.name || item.plugin) + '（人设全程接管）');
-      call('wbExpertRecordUse', { kind: 'expert', row: { plugin: item.plugin, name: item.name || item.plugin } }).catch(() => {});
-    } catch (e) {
-      setAttachNote('新建专家会话失败：' + String((e && e.message) || e));
-    } finally {
-      setAttachBusy(false);
-    }
-  };
-  const attachExpert = async (item) => {
+  const attachExpert = async (item, { quiet = false } = {}) => {
     setHoverKind(null);
-    setPendingExpert(null);
-    // 结果显示回菜单内（菜单不关）：成功 ✓ + 挂载名；失败显示真实报错。
-    // 上一版把 attachNote 从界面拿掉导致失败无声，用户无从判断「为什么没显示」。
-    if (!sessionId) { setPendingExpert(item); setAttachNote('没有活动会话：可直接带该专家新建会话'); return; }
+    if (!sessionId) { setAttachNote('没有活动会话：请先进入一个会话再挂专家'); return; }
     const presetId = expertPresetIdOf(item);
-    const remote = MODULE && typeof MODULE.get === 'function' ? MODULE.get('remote.agentPresets') : null;
-    if (!remote || typeof remote.select !== 'function') { setAttachNote('宿主未提供 agentPresets 接口（remote.agentPresets 不可用）'); return; }
     setAttachBusy(true); setAttachNote('');
     try {
-      const result = await remote.select(sessionId, presetId);
-      if (result && result.ok) {
-        setAttached({ plugin: item.plugin, name: item.name || item.plugin, presetId: (result.value && result.value) || presetId });
-        setAttachNote('✓ 已挂到当前会话：' + (item.name || item.plugin));
+      // ① blank 会话 + 已召唤 → 先用预设通道（连工具目录一起接管，最彻底）。
+      const remote = MODULE && typeof MODULE.get === 'function' ? MODULE.get('remote.agentPresets') : null;
+      if (remote && typeof remote.select === 'function') {
+        const result = await remote.select(sessionId, presetId).catch(() => null);
+        if (result && result.ok) {
+          setAttached({ plugin: item.plugin, name: item.name || item.plugin, mode: 'preset' });
+          setAttachNote('✓ 已挂到当前会话：' + (item.name || item.plugin));
+          call('wbExpertRecordUse', { kind: 'expert', row: { plugin: item.plugin, name: item.name || item.plugin } }).catch(() => {});
+          return;
+        }
+      }
+      // ② 其余情况（会话已开始 / 未召唤 / 无 agentPresets）→ 会话级人设通道，必定可用。
+      const res = await call('expertAttach', { sessionId, plugin: item.plugin });
+      if (res && res.ok) {
+        setAttached({ plugin: item.plugin, name: res.name || item.name || item.plugin, mode: 'persona' });
+        setAttachNote('✓ 已挂到当前会话：' + (res.name || item.name || item.plugin) + (res.replaced ? '（已替换原专家）' : ''));
         call('wbExpertRecordUse', { kind: 'expert', row: { plugin: item.plugin, name: item.name || item.plugin } }).catch(() => {});
       } else {
-        const locked = result && result.error && /locked/i.test(String(result.error.code || '') + String(result.error.message || ''));
-        if (locked) {
-          // 宿主硬规则：会话已开始（有 turn）就不允许换预设。给出一键替代路径
-          // 而不是让用户自己去预设选择器里翻——见 createWithExpert。
-          setPendingExpert(item);
-          setAttachNote('该会话已开始对话，无法中途挂专家（宿主规则：预设只在空白会话可换）；可一键带该专家新建会话');
-        } else {
-          setAttachNote('挂载失败：' + ((result && result.error && (result.error.message || result.error.code)) || JSON.stringify(result && result.error) || '未知错误'));
-        }
+        setAttachNote('挂载失败：' + ((res && res.error) || '未知错误'));
       }
     } catch (e) {
-      setAttachNote('挂载异常：' + String((e && e.message) || e));
+      if (!quiet) setAttachNote('挂载异常：' + String((e && e.message) || e));
     } finally {
       setAttachBusy(false);
     }
   };
   const detachExpert = async () => {
-    if (!attached || !sessionId) return;
-    const remote = MODULE && typeof MODULE.get === 'function' ? MODULE.get('remote.agentPresets') : null;
-    if (!remote || typeof remote.list !== 'function' || typeof remote.select !== 'function') { setAttached(null); return; }
-    setAttachBusy(true);
+    if (!sessionId) return;
+    setAttachBusy(true); setAttachNote('');
     try {
-      const list = await remote.list();
-      const options = list && list.ok && Array.isArray(list.presets) ? list.presets : [];
-      const fallback = (options.find((row) => row.isDefault) || options[0] || {}).id;
-      if (fallback) await remote.select(sessionId, fallback);
+      // 会话级人设一定清（不管当初走的是哪条路）；预设通道只在当初走预设时回退默认。
+      const res = await call('expertDetach', { sessionId }).catch(() => null);
+      const remote = MODULE && typeof MODULE.get === 'function' ? MODULE.get('remote.agentPresets') : null;
+      if (attached?.mode === 'preset' && remote && typeof remote.list === 'function' && typeof remote.select === 'function') {
+        try {
+          const list = await remote.list();
+          const options = list && list.ok && Array.isArray(list.presets) ? list.presets : [];
+          const fallback = (options.find((row) => row.isDefault) || options[0] || {}).id;
+          if (fallback) await remote.select(sessionId, fallback);
+        } catch { /* 预设回退失败不影响「已摘掉」这一事实 */ }
+      }
       setAttached(null);
-      setAttachNote('');
+      setAttachNote(res && res.ok && res.removed ? '✓ 已取消本会话的专家' : '本会话没有挂着专家');
     } catch (e) {
-      setAttachNote(String((e && e.message) || e));
+      setAttachNote('取消失败：' + String((e && e.message) || e));
     } finally {
       setAttachBusy(false);
     }
   };
+  // 会话切换 / 组件重挂时对齐真实状态：宿主是唯一真源（专家可能由别的入口挂上，
+  // 或会话被重启），不能只信组件自己的 state。
+  useEffect(() => {
+    if (!sessionId) return undefined;
+    let cancelled = false;
+    call('expertActive').then((res) => {
+      if (cancelled || !res || !res.ok || !Array.isArray(res.sessions)) return;
+      const mine = res.sessions.find((row) => row.sessionId === sessionId);
+      setAttached(mine ? { plugin: mine.plugin, name: mine.name, mode: 'persona' } : null);
+    }).catch(() => { /* 对齐失败保持现状：不影响使用 */ });
+    return () => { cancelled = true; };
+  }, [sessionId, call]);
 
   // ── 悬停开合（整树统一管理）───────────────────────────────────────────
   // enter/leave 挂组件根，而不是每行：菜单顶部还有提示条/错误行/新建会话按钮，
@@ -3171,19 +3167,6 @@ const SummonQuickMenu = ({ call, inputActions, sessionId: sessionIdProp }) => {
           copied ? h('div', { className: 'dsh-mcp-quick-note' }, '已复制，粘贴到输入框：' + copied) : null,
           attachBusy ? h('div', { className: 'dsh-mcp-quick-note' }, '正在挂载专家…') : null,
           attachNote ? h('div', { className: 'dsh-mcp-quick-note' + (/^✓/.test(attachNote) ? ' ok' : ' err'), role: 'alert' }, attachNote) : null,
-          // locked / 无会话时的一键替代路径：带该专家新建会话（createWithExpert）。
-          // 按钮挂在 attachNote 下方，只在该动作可用时出现；busy 期间禁用防连点。
-          pendingExpert && !attachBusy
-            ? h('button', {
-                type: 'button',
-                className: 'dsh-mcp-quick-new-session',
-                title: '新建一个空白会话并立即挂上「' + (pendingExpert.name || pendingExpert.plugin) + '」预设，人设全程接管',
-                onClick: (e) => { e.stopPropagation(); createWithExpert(pendingExpert); },
-              },
-                h(Icon, { d: ICONS.expert, size: 12 }),
-                h('span', null, '带「' + (pendingExpert.name || pendingExpert.plugin) + '」新建会话'),
-              )
-            : null,
           listError ? h('div', { className: 'dsh-mcp-quick-err' }, listError) : null,
           !recent && !listError ? h('div', { className: 'dsh-mcp-quick-loading' }, '正在读取…') : null,
           QUICK_MENU_KINDS.map((kind) => {
@@ -3221,7 +3204,7 @@ const SummonQuickMenu = ({ call, inputActions, sessionId: sessionIdProp }) => {
                           type: 'button',
                           role: 'menuitem',
                           className: 'dsh-mcp-quick-item',
-                          title: kind.key === 'expert' ? '挂到当前会话：整个会话由该专家接管' : (itemDesc(kind.key, item) || itemLabel(kind.key, item)),
+                          title: kind.key === 'expert' ? '挂到当前会话（可随时换或取消）；再点别的专家 = 直接替换' : (itemDesc(kind.key, item) || itemLabel(kind.key, item)),
                           onClick: (e) => { e.stopPropagation(); if (kind.key === 'expert') attachExpert(item); else pick(kind.key, item, quickMentionText(kind.key, item)); },
                         },
                           kind.key === 'expert' && attached && attached.plugin === item.plugin
@@ -3933,26 +3916,43 @@ const UPGRADE_PACKAGE = 'dsh-armory';
 /**
  * 这次升级能不能做、为什么不能——纯判定，便于单测。
  *
- * 三种「不能升」的来源各不相同，报给用户的话也必须不同：
+ * 四种「不能升」的来源各不相同，报给用户的话也必须不同：
  *   - 宿主没提供 pluginManager（老宿主 / 非 web 形态）→ 退回手动命令；
  *   - 插件不是 npm 装的（link:/file:/github:）→ 覆盖安装会把它换成 npm 包，不能做；
+ *   - 安装来源未知（宿主没回 installInfo / 读不到 profile manifest）→ 同样不做：
+ *     宁可少一个按钮，也不做可能毁掉用户本地副本的写操作；
  *   - 当前版本不低于最新 → 无需升级。
  *
  * @param {object} input - 判定输入。
  * @param {object|null} input.service - 探测到的 pluginManager 命名空间（null = 宿主没提供）。
  * @param {object|null} input.hint - updateHint 的结果（current / latest / updateAvailable）。
- * @param {object|null} input.bundle - listBundles 里本插件那一行（source / installed / version）。
- * @returns {{supported: boolean, reason: string, spec: string|null, canRestart: boolean}} 判定结果。
+ * @param {object|null} input.bundle - listBundles 里本插件那一行（version / installed / …）。
+ * @param {string|null} input.spec - 宿主 installInfo 报回的 profile manifest spec。
+ * @param {string|null} input.source - 宿主 installInfo 报回的来源分类（registry/file/link/…）。
+ * @returns {{supported: boolean, reason: string, spec: string|null, version?: string}} 判定结果。
  */
-function upgradePlan({ service, hint, bundle }) {
+function upgradePlan({ service, hint, bundle, spec = null, source = null }) {
   const hasMethod = !!service && typeof service[UPGRADE_METHOD] === 'function';
   if (!hasMethod) return { supported: false, reason: 'no-service', spec: null };
   if (!hint?.updateAvailable || !hint?.latest) return { supported: false, reason: 'up-to-date', spec: null };
-  // 本地安装形态（link:/file:/github:/tarball）不归 installBundle 管：拿 npm spec 覆盖会把
-  // 用户的本地开发链接换成 npm 包，那是破坏而不是升级。只认 registry 来源。
-  const source = typeof bundle?.source === 'string' ? bundle.source : '';
-  const isRegistry = source === '' || /^\d|^\^|^~|^latest$/.test(source);
-  if (!isRegistry) return { supported: false, reason: 'not-npm', spec: null };
+  // 本地安装形态不归 installBundle 管：它执行的是 `pnpm add <npm spec>`，会把用户的本地开发
+  // 链接/文件依赖换成 npm 包——那是破坏而不是升级。只认 registry 来源。
+  //
+  // 判据必须来自宿主 installInfo（读 profile manifest 的真实 spec），**不能用
+  // bundle.source**：宿主 listBundles() 的行里没有该字段（只有 name/version/description/
+  // meta/enabled/installed/optional/removable/readOnlyReason/rows/overrides），旧实现据此
+  // 恒判「可以升」，本地 file: 安装的用户一点就把开发副本换成了 npm 包。
+  const sourceText = typeof source === 'string' ? source.trim() : '';
+  const specText = typeof spec === 'string' ? spec.trim() : '';
+  // 来源未知（新客户端配旧宿主，installInfo 还没上线 / manifest 读不到）→ 不做写操作。
+  if (sourceText === '' || sourceText === 'unknown') return { supported: false, reason: 'unknown-source', spec: null };
+  if (sourceText !== 'registry') return { supported: false, reason: 'not-npm', spec: null };
+  // 双保险：spec 前缀也必须像 registry spec（宿主分类与客户端判据两处独立成立才算数）。
+  const looksRegistry = specText === '' || /^[\^~]?\d/.test(specText) || /^(latest|\*|next|\*)$/i.test(specText);
+  if (!looksRegistry) return { supported: false, reason: 'not-npm', spec: null };
+  // 宿主将来若补上 bundle.source，两种信号取更保守的一侧（任一像本地就否决）。
+  const legacySource = typeof bundle?.source === 'string' ? bundle.source.trim() : '';
+  if (legacySource !== '' && !/^\d|^\^|^~|^latest$/.test(legacySource)) return { supported: false, reason: 'not-npm', spec: null };
   return {
     supported: true,
     reason: 'ok',
@@ -4276,6 +4276,9 @@ const MCP_CONTRIBUTION = {
     { id: 'dsh-armory#mcpManager/projectConnections', service: 'mcpManager', namespace: 'mcpManager', method: 'projectConnections', invocation: { kind: 'direct' }, parameters: [], result: mcpCodec('ProjectConnectionsResult') },
     { id: 'dsh-armory#mcpManager/reconnectWorkspaceServer', service: 'mcpManager', namespace: 'mcpManager', method: 'reconnectWorkspaceServer', invocation: { kind: 'direct' }, parameters: [mcpParam('payload', 'ImportPayload')], result: mcpCodec('NoteResult') },
     { id: 'dsh-armory#mcpManager/updateHint', service: 'mcpManager', namespace: 'mcpManager', method: 'updateHint', invocation: { kind: 'direct' }, parameters: [], result: mcpCodec('UpdateHintResult') },
+    // 安装形态（spec / source）：一键升级的安全判据。与宿主 method、typert.js 三处必须同步，
+    // 漏一处就是恒 404（toolTailor 踩过）。
+    { id: 'dsh-armory#mcpManager/installInfo', service: 'mcpManager', namespace: 'mcpManager', method: 'installInfo', invocation: { kind: 'direct' }, parameters: [], result: mcpCodec('InstallInfoResult') },
     // 「这次更新了什么」：数据在 lib/whats-new.js，宿主只转发，判定“该不该弹”在客户端。
     { id: 'dsh-armory#mcpManager/whatsNew', service: 'mcpManager', namespace: 'mcpManager', method: 'whatsNew', invocation: { kind: 'direct' }, parameters: [], result: mcpCodec('WhatsNewResult') },
     // ── Skill 看板：与 MCP 同一命名空间、同一信封（payload 进、{ok} 出）──
@@ -4300,7 +4303,12 @@ const MCP_CONTRIBUTION = {
     { id: 'dsh-armory#mcpManager/wbExpertDismiss', service: 'mcpManager', namespace: 'mcpManager', method: 'wbExpertDismiss', invocation: { kind: 'direct' }, parameters: [mcpParam('payload', 'ImportPayload')], result: mcpCodec('NoteResult') },
     { id: 'dsh-armory#mcpManager/wbExpertInstalled', service: 'mcpManager', namespace: 'mcpManager', method: 'wbExpertInstalled', invocation: { kind: 'direct' }, parameters: [], result: mcpCodec('WbExpertInstalledResult') },
     { id: 'dsh-armory#mcpManager/wbExpertRecent', service: 'mcpManager', namespace: 'mcpManager', method: 'wbExpertRecent', invocation: { kind: 'direct' }, parameters: [], result: mcpCodec('WbExpertRecentResult') },
-    { id: 'dsh-armory#mcpManager/wbExpertRecordUse', service: 'mcpManager', namespace: 'mcpManager', method: 'wbExpertRecordUse', invocation: { kind: 'direct' }, parameters: [mcpParam('payload', 'ImportPayload')], result: mcpCodec('NoteResult') }
+    { id: 'dsh-armory#mcpManager/wbExpertRecordUse', service: 'mcpManager', namespace: 'mcpManager', method: 'wbExpertRecordUse', invocation: { kind: 'direct' }, parameters: [mcpParam('payload', 'ImportPayload')], result: mcpCodec('NoteResult') },
+    // 会话级专家人设（随时挂 / 换 / 摘）：不受 agent-preset/locked 限制。
+    // 与宿主 method、typert.js 三处必须同步，漏一处这条通道就恒 404。
+    { id: 'dsh-armory#mcpManager/expertAttach', service: 'mcpManager', namespace: 'mcpManager', method: 'expertAttach', invocation: { kind: 'direct' }, parameters: [mcpParam('payload', 'ImportPayload')], result: mcpCodec('NoteResult') },
+    { id: 'dsh-armory#mcpManager/expertDetach', service: 'mcpManager', namespace: 'mcpManager', method: 'expertDetach', invocation: { kind: 'direct' }, parameters: [mcpParam('payload', 'ImportPayload')], result: mcpCodec('NoteResult') },
+    { id: 'dsh-armory#mcpManager/expertActive', service: 'mcpManager', namespace: 'mcpManager', method: 'expertActive', invocation: { kind: 'direct' }, parameters: [], result: mcpCodec('ExpertActiveResult') }
   ].map((descriptor) => ({ ...descriptor, sourceLocation: { file: 'dsh-armory/lib/typert.js', line: 7, column: 1 } }))
 };
 async function apply(ctx) {

package/lib/index.js

@@ -15,6 +15,7 @@ import { allMcpEntries, entriesForName, projectToolSchema, revisionOf, toolInven
 import { WHATS_NEW } from "./whats-new.js";
 import { wbConnectorCatalog, wbConnectorPreview, wbSkillCatalog, wbSkillDetail, wbSkillFiles, wbSkillInstall, wbSkillInstalled, wbSkillUninstall } from "./wb-market.js";
 import { installExpertSkills, listExpertRecent, listExpertSkills, readExpertPresets, recordExpertRecent, removeExpertPreset, uninstallExpertSkills, wbExpertCatalog, wbExpertDetail, writeExpertPreset } from "./expert-market.js";
+import { attachPersona, detachPersona, listPersonas, reconcilePersonas } from "./session-persona.js";
 import { scanSessionLedger } from "./tool-ledger.js";
 import { evaluateEnvExpression, jsExpressionToTemplate } from "./workspace-config.js";
 import { canonicalWorkspacePath, installAgentRuntime, listWorkspaceRecords, liveWorkspaceAgentCount, projectConnectionsView, readWorkspaceConfigCached, reconcileWorkspaceConnections, reconcileWorkspaceRestricts, reconnectWorkspaceServer, withWorkspaceWrite, workspaceConnectionStatus, workspaceMountErrorsView, workspaceRestrictErrorView, workspaceScopeErrorsView, workspaceToolSchemas, writeWorkspaceConfigFile } from "./workspace-runtime.js";
@@ -167,6 +168,32 @@ function patchPath(ctx) {
 	const filename = path.startsWith("file:") ? fileURLToPath(path) : path;
 	return join(dirname(filename), "cordis.patch.yml");
 }
+// profile 目录：与 patchPath 同一条受信发现路径（根 include 的 path 所在目录），
+// 不是从 ctx.fs 或 cwd 猜出来的——installInfo 只读它下面的 package.json。
+function profileDirOf(ctx) {
+	const path = patchPath(ctx);
+	return path ? dirname(path) : null;
+}
+/**
+ * 安装来源分类：客户端据此决定「一键升级」能不能做。
+ * 本仓库历史上踩过的坑：listBundles() 的返回行里**没有 source 字段**，客户端拿它判
+ * 来源会恒判「npm 装的」，于是本地 file: 安装的用户一点升级就被 `pnpm add` 换成 npm 包。
+ * 这里只按 profile manifest 里的 spec 前缀分类，分类结果直接决定按钮出不出现。
+ * @returns {"registry"|"file"|"link"|"git"|"remote"|"path"|"unknown"}
+ */
+function classifyInstallSpec(spec) {
+	const text = typeof spec === "string" ? spec.trim() : "";
+	if (text === "") return "unknown";
+	if (/^(file:|portal:|workspace:)/i.test(text)) return "file";
+	if (/^link:/i.test(text)) return "link";
+	if (/^(github:|git\+|git:|https?:\/\/.*\.git)/i.test(text)) return "git";
+	if (/^https?:/i.test(text)) return "remote";
+	if (/^(\.{1,2}[\\/]|[A-Za-z]:[\\/]|\/)/.test(text)) return "path";
+	// registry spec：版本范围（^1.9.0 / ~1.9.0 / 1.9.0 / latest / * / 空=latest）
+	if (/^[\^~]?\d/.test(text) || /^(latest|\*)$/i.test(text)) return "registry";
+	if (/^[a-z@]/i.test(text)) return "registry";
+	return "unknown";
+}
 // Profile persistence is a Host-owned configuration capability, not a session workspace mutation.
 // `ctx.fs` is intentionally fenced by the active workspace-write policy, so this target is
 // derived only from the trusted root include and committed through the Host atomic writer.
@@ -312,6 +339,10 @@ const UPDATE_CHECK_URL = "https://api.github.com/repos/2026heshao/dsh-armory/rel
 const UPDATE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
 const UPDATE_CHECK_TIMEOUT_MS = 5000;
 const UPDATE_CHECK_DISABLED_ENV = "DSH_ARMORY_DISABLE_UPDATE_CHECK";
+// 本插件的两个 profile 依赖名：1.9.0 改名后新名是 dsh-armory，旧名 dsh-skill-mcp-board
+// 是「从旧版升级但还没删掉旧条目」的过渡态——installInfo 两行都查，命中哪行就报哪行。
+const UPGRADE_PACKAGE_NAME = "dsh-armory";
+const LEGACY_PACKAGE_NAME = "dsh-skill-mcp-board";
 let updateCheckState = { checkedAt: 0, result: null };
 
 function pluginVersion() {
@@ -1286,6 +1317,45 @@ let McpManagerGateway = (() => {
 	async updateHint() {
 		return checkForUpdate();
 	}
+	/**
+	 * 本插件的安装形态与来源 spec —— 客户端「一键升级」的安全判据。
+	 *
+	 * 为什么必须由宿主读：客户端问得到的 listBundles() 行里**没有 source 字段**
+	 * （只有 name/version/description/meta/enabled/installed/optional/removable/
+	 * readOnlyReason/rows/overrides），客户端据此判断会恒判「可以一键升级」，而
+	 * installBundle 执行的是 `pnpm add <npm spec>`——本地 file:/link: 安装的用户一点
+	 * 就会把开发副本换成 npm 包。真源只有 profile manifest 的 dependencies。
+	 *
+	 * 只读、只回本插件自己的两行（新名 + 兼容旧名），失败一律降级为 unknown 而不是抛错：
+	 * 升级按钮不该因为读不到 manifest 就让面板报错。
+	 */
+	async installInfo() {
+		const names = [UPGRADE_PACKAGE_NAME, LEGACY_PACKAGE_NAME];
+		const info = {
+			packageName: UPGRADE_PACKAGE_NAME,
+			version: pluginVersion(),
+			spec: null,
+			source: "unknown",
+			profileDir: null,
+		};
+		try {
+			const dir = profileDirOf(this.ctx);
+			if (dir) {
+				info.profileDir = dir;
+				const manifest = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
+				const deps = manifest && typeof manifest.dependencies === "object" && manifest.dependencies ? manifest.dependencies : {};
+				const hit = names.find((name) => typeof deps[name] === "string");
+				if (hit) {
+					info.spec = String(deps[hit]);
+					info.installedAs = hit;
+					info.source = classifyInstallSpec(info.spec);
+				}
+			}
+		} catch {
+			// 读不到就维持 unknown：客户端据此退回「查看更新方式」链接，不做写操作。
+		}
+		return info;
+	}
 	async whatsNew() {
 		// 只回数据，不在宿主判定「该不该弹」：「上次看到的版本」是每台浏览器自己的事实
 		// （localStorage），宿主没有这个视角；判定在客户端（whatsNewFor）。
@@ -1391,6 +1461,32 @@ let McpManagerGateway = (() => {
 	// 数据与安装逻辑都在 lib/expert-market.js；这里只做 RPC 转发与 patch 写盘收尾。
 	// 召唤 = 往 profile patch 插入一条独立 @deepseek-ai/dsh-agent-preset 行（persona.prefix
 	// = 专家人设），DSH 热加载后新会话即可在预设选择器里选它——多专家共存，卸载即摘除。
+	// ── 会话级专家人设（随时挂 / 换 / 摘，不受 agent-preset/locked 限制）──────
+	// 机制与边界见 lib/session-persona.js 顶部注释：走 systemPrompt 的会话作用域
+	// section，遮蔽该会话的部署人设前缀；不动工具目录、不写任何持久化配置。
+	async expertAttach(payload) {
+		const sessionId = String(payload?.sessionId || "").trim();
+		const plugin = String(payload?.plugin || "").trim();
+		if (!sessionId) throw new Error("缺少 sessionId");
+		if (!plugin) throw new Error("缺少 plugin");
+		const detail = await wbExpertDetail({ plugin });
+		const result = attachPersona(this.ctx, sessionId, {
+			plugin,
+			name: detail.name,
+			personaText: detail.persona,
+		});
+		await recordExpertRecent("expert", { plugin, name: detail.name, profession: detail.profession, presetId: `session-${plugin}` }).catch(() => {});
+		return { ...result, profession: detail.profession };
+	}
+	async expertDetach(payload) {
+		const sessionId = String(payload?.sessionId || "").trim();
+		if (!sessionId) throw new Error("缺少 sessionId");
+		return detachPersona(this.ctx, sessionId);
+	}
+	async expertActive() {
+		reconcilePersonas(this.ctx);
+		return { sessions: listPersonas() };
+	}
 	async wbExpertCatalog() {
 		return wbExpertCatalog();
 	}

package/lib/session-persona.js

@@ -0,0 +1,120 @@
+// 会话级专家人设注入 —— 让「专家」像 WorkBuddy 一样可随时挂/换/摘，不受 agent-preset/locked 限制。
+//
+// 为什么需要这条独立通道：宿主的 agentPresets.select() 有硬锁（会话一旦开过口就
+// `agent-preset/locked`），因为**预设**决定工具目录与提示词结构，中途换会破坏前后一致。
+// 但用户要的是 WorkBuddy 式体验：任何会话、任何时刻都能换专家或摘掉。可行的原因是
+// 人设（persona）与预设是两件事——preset 的 persona 行只是一段提示词 section：
+//
+//   dsh-persona 的注释写明该行是 **scope-only**：挂进某个 agent 预设时，它只遮蔽
+//   「那一个会话」的部署人设。dsh-subagent 也用同一手法给子会话装人设：
+//     childCtx.systemPrompt.section({ name: "deployment:persona-prefix",
+//       order: childCtx.systemPrompt.getSectionOrder("DEPLOYMENT_PERSONA_PREFIX"),
+//       text: persona })
+//
+// 而 systemPrompt.section() 的归属 scope 取自定义层自身 ctx 的 kScope（见 dsh-scope
+// 的 scopeOf / ScopedLayers.effect），cordis 的 tracker 代理会把服务方法的 this.ctx
+// 重绑为**调用方 ctx** —— 所以用 `agent.ctx.systemPrompt.section(...)` 注册，段就落在
+// 该会话自己的 scope 层：只影响这个会话，且 ctx.effect 返回的 disposer 可随时撤销。
+//
+// 与「召唤预设」的分工：召唤写 profile patch，管**新会话的预设选择器**（长期身份）；
+// 本模块管**当前会话的即时人设**（会话内挂/换/摘）。两者互不干扰：预设仍在，随时可用；
+// 会话内挂的专家只是这段提示词 section 的替换，不动工具目录与任何持久化配置。
+
+/** 与 dsh-persona / dsh-subagent 共用的 section 名（同名即遮蔽，最近 scope 胜出）。 */
+const PERSONA_PREFIX_SECTION = "deployment:persona-prefix";
+/** 单个会话最多保留的撤销记录（防泄漏；正常使用远小于此）。 */
+const MAX_SESSIONS = 64;
+/** sessionId -> { plugin, name, disposer } */
+const activePersonas = new Map();
+
+function agentCtxOf(ctx, sessionId) {
+	const agents = typeof ctx?.get === "function" ? ctx.get("agents") : undefined;
+	if (!agents || typeof agents.get !== "function") return { error: "宿主未提供 agents 服务（agentRegistry 不可用），无法定位会话" };
+	const agent = agents.get(sessionId);
+	if (agent === undefined) return { error: "会话不在运行中（可能已归档或尚未激活）：" + sessionId };
+	const agentCtx = agent.ctx;
+	if (agentCtx === undefined) return { error: "该会话没有可用的作用域上下文" };
+	return { agentCtx };
+}
+
+/**
+ * 摘掉某会话当前注入的人设（若有）。
+ * @returns {boolean} 是否真的摘掉了一段。
+ */
+function clearPersona(sessionId) {
+	const current = activePersonas.get(sessionId);
+	if (!current) return false;
+	activePersonas.delete(sessionId);
+	try {
+		current.disposer?.();
+	} catch { /* 撤销失败不回滚状态：section 已随 scope 失效，重复撤销无害 */ }
+	return true;
+}
+
+/** 当前挂在某会话上的专家（供客户端 chip 显示真实状态）。 */
+export function personaOf(sessionId) {
+	const row = activePersonas.get(sessionId);
+	return row ? { plugin: row.plugin, name: row.name } : null;
+}
+
+/** 所有会话的挂载快照（会话被销毁后由 reconcile 清理）。 */
+export function listPersonas() {
+	return [...activePersonas.entries()].map(([sessionId, row]) => ({ sessionId, plugin: row.plugin, name: row.name }));
+}
+
+/** 会话已不在运行 → 清掉它的撤销记录（disposer 早已随 scope 失效）。 */
+export function reconcilePersonas(ctx) {
+	const agents = typeof ctx?.get === "function" ? ctx.get("agents") : undefined;
+	if (!agents || typeof agents.get !== "function") return;
+	const live = new Set(agents.list().map((agent) => agent.id));
+	for (const sessionId of [...activePersonas.keys()]) {
+		if (!live.has(sessionId)) activePersonas.delete(sessionId);
+	}
+}
+
+/**
+ * 给一个运行中的会话注入（或替换）专家人设。同一会话可反复调用：先摘旧的再装新的。
+ * @param {object} ctx - 插件宿主上下文。
+ * @param {string} sessionId - 目标会话。
+ * @param {object} spec - { plugin, name, personaText }。
+ * @returns {{ok: true, plugin: string, name: string, replaced: boolean}}
+ */
+export function attachPersona(ctx, sessionId, spec) {
+	const id = String(sessionId || "").trim();
+	if (!id) throw new Error("缺少会话 id");
+	const text = String(spec?.personaText || "").trim();
+	if (!text) throw new Error("人设内容为空，无法挂载");
+	const { agentCtx, error } = agentCtxOf(ctx, id);
+	if (error) throw new Error(error);
+	const prompt = agentCtx.systemPrompt;
+	if (!prompt || typeof prompt.section !== "function") {
+		throw new Error("该会话没有 systemPrompt 服务，无法注入人设");
+	}
+	const replaced = clearPersona(id);
+	// 与 dsh-persona 同款：同名 section + 同一处 order = 遮蔽该会话的部署人设前缀。
+	const disposer = prompt.section({
+		name: PERSONA_PREFIX_SECTION,
+		order: typeof prompt.getSectionOrder === "function"
+			? prompt.getSectionOrder("DEPLOYMENT_PERSONA_PREFIX")
+			: 0,
+		text,
+	});
+	activePersonas.set(id, {
+		plugin: String(spec?.plugin || ""),
+		name: String(spec?.name || spec?.plugin || "专家"),
+		disposer,
+	});
+	// 防泄漏：超出上限时丢掉最早的记录（其 disposer 一并撤销）。
+	while (activePersonas.size > MAX_SESSIONS) {
+		const oldest = activePersonas.keys().next().value;
+		clearPersona(oldest);
+	}
+	return { ok: true, plugin: String(spec?.plugin || ""), name: String(spec?.name || spec?.plugin || "专家"), replaced };
+}
+
+/** 摘掉某会话的专家人设。@returns {{ok: true, removed: boolean}} */
+export function detachPersona(ctx, sessionId) {
+	const id = String(sessionId || "").trim();
+	if (!id) throw new Error("缺少会话 id");
+	return { ok: true, removed: clearPersona(id) };
+}

package/lib/typert.js

@@ -71,6 +71,9 @@ export const TYPERT = {
     mv('reconnectWorkspaceServer', [payloadParam], 'NoteResult'),
     mv('updateHint', [], 'UpdateHintResult'),
     mv('whatsNew', [], 'WhatsNewResult'),
+    // 安装形态（spec / source / profileDir）：客户端「一键升级」的安全判据。
+    // 缺这一行 = 客户端 call('installInfo') 恒 404 → 按钮退回链接形态（同 toolTailor 的坑）。
+    mv('installInfo', [], 'InstallInfoResult'),
     // Skill 看板（与 MCP 同一命名空间、同一信封：payload 进、{ok} 出）。
     mv('listSkills', [payloadParam], 'SkillListResult'),
     mv('skillDetail', [payloadParam], 'SkillDetailResult'),
@@ -98,6 +101,11 @@ export const TYPERT = {
     mv('wbExpertInstalled', [], 'WbExpertInstalledResult'),
     mv('wbExpertRecent', [], 'WbExpertRecentResult'),
     mv('wbExpertRecordUse', [payloadParam], 'NoteResult'),
+    // 会话级专家人设（随时挂/换/摘）：走 systemPrompt 的会话作用域 section，
+    // 不受 agent-preset/locked 限制。payload 交给 lib/session-persona.js 校验。
+    mv('expertAttach', [payloadParam], 'NoteResult'),
+    mv('expertDetach', [payloadParam], 'NoteResult'),
+    mv('expertActive', [], 'ExpertActiveResult'),
   ],
   model: { services: [], events: [], objects: [] },
 }

package/lib/whats-new.js

@@ -8,9 +8,10 @@
 // **顺序就是语义**：客户端按数组顺序算「上次看到的版本之后还有哪些」，所以只能从旧到新
 // 追加，不要按版本号大小或字母重排。
 //
-// 维护约定（由 test/whats-new.test.mjs 钉住）：`package.json` 的版本必须是这里的最后一条。
-// 也就是说——bump 了版本却没写更新内容，本地就会红。这正是「新功能没人发现」的根治点：
-// 发布前不写清楚「变了什么、在哪找」，就发不出去。
+// 维护约定（由 test/upgrade-plan.mjs 第 8 组断言钉住）：`package.json` 的版本必须是这里的
+// 最后一条，且 `.github/release-notes/v<版本>.md` 必须存在。也就是说——bump 了版本却没写
+// 更新内容、或没写 Release 稿，本地 `npm test` 与 CI 都会红。这正是「新功能没人发现」的
+// 根治点：发布前不写清楚「变了什么、在哪找」，就发不出去。
 //
 // 条目形状：`{ version, items: [{ text, where? }] }`。`where` 用来回答「在哪儿能找到它」，
 // 是这次加这个提示的直接原因（新开关藏在面板头部，不主动指路等于没加）。
@@ -207,4 +208,38 @@ export const WHATS_NEW = [
       },
     ],
   },
+  {
+    version: '1.9.1',
+    items: [
+      {
+        text: '修复「挂载失败：Unknown agent preset」：召唤专家写的预设行以前是写在补丁顶层的裸条目，宿主按「覆盖已有行」解释后整条跳过（预设永远不注册）；现在按宿主规范写成 insert 指令，并自动把旧格式的行迁移过来——升级后首次打开面板/重新召唤即修复，已有会话的正常使用',
+        where: '会话输入框召唤菜单 → 专家',
+      },
+      {
+        text: '会话已开始也能用专家：宿主规则不允许中途换预设，改为提供「带「专家」新建会话」一键路径（自动建新会话 → 挂上专家 → 跳过去），不再是死路一条',
+        where: '召唤菜单 → 专家 → 提示条下方的按钮',
+      },
+      {
+        text: '召唤菜单两处体验修复：鼠标移过「技能」不再把菜单关掉（开合判定收归整个菜单，提示区不再误判为「离开」）；提示条让菜单变高时页面不再抖动（菜单改为视口浮层，不再撑动会话滚动区）',
+        where: '会话输入框工具行右侧的看板小图标',
+      },
+      {
+        text: '一键升级更安全：以前它靠宿主返回的一个并不存在的字段判断「是不是 npm 装的」，本地 file:/link: 安装的用户一点升级就会把开发副本换成 npm 包；现在改问宿主读 profile 里的真实安装来源，本地安装与来源不明一律只提示、不写盘',
+        where: '面板顶部的更新提示条',
+      },
+    ],
+  },
+  {
+    version: '1.9.2',
+    items: [
+      {
+        text: '专家升级为 WorkBuddy 式「随时挂 / 换 / 摘」：任何会话（包括已经聊了一半的）都能挂专家、直接点另一个专家就换掉、点 chip 的 × 立刻取消——不再有「会话已开始，无法中途挂专家」的死路，也不再是一个对话只能引用一次',
+        where: '会话输入框工具行右侧的看板小图标 → 专家',
+      },
+      {
+        text: '换专家会明确告诉你「已替换原专家」，取消后点别的专家又能重新挂上；组件重挂或切换会话时自动向宿主对账，chip 显示的始终是真实状态（专家也能由预设选择器等其他入口挂上）',
+        where: '专家 chip 与召唤菜单内的提示条',
+      },
+    ],
+  },
 ]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-armory",
-  "version": "1.9.0",
-  "description": "Unified Skill + MCP + Expert board for DeepSeek Harness Web — global panel page, JSON import, WorkBuddy connector & SkillHub & Expert market installs, tool-usage tailor, and profile-backed Host Remote management.",
+  "version": "1.9.2",
+  "description": "Unified Skill + MCP + Expert board for DeepSeek Harness (desktop app and Web GUI) 鈥?global panel page, JSON import, WorkBuddy connector & SkillHub & Expert market installs, tool-usage tailor, and profile-backed Host Remote management.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/2026heshao/dsh-armory.git"
@@ -13,7 +13,12 @@
   "type": "module",
   "main": "lib/index.js",
   "scripts": {
-    "test": "node --test"
+    "test": "node ./test/run-all.mjs",
+    "test:expert": "node ./test/run-expert-manual.mjs",
+    "test:upgrade": "node ./test/upgrade-plan.mjs",
+    "test:install": "node ./test/verify-install-info.mjs",
+    "test:e2e": "node ./test/run-e2e.mjs",
+    "migrate": "node ./test/run.mjs migrate"
   },
   "exports": {
     "./typert": "./lib/typert.js",