@yangdcm/dsh-expert-team 1.2.3 → 1.3.1

package/CHANGELOG.md

@@ -3,6 +3,76 @@
 本包遵循[语义化版本](https://semver.org/lang/zh-CN/)。dsh 宿主版本线的对应关系写在
 `package.json` 的 `engines.dsh` 与 `dsh.compatibility` 里，插件市场按它判断"这个插件跟你的宿主兼不兼容"。
 
+## 1.3.1
+
+**只改文案与文档，不动任何功能逻辑。**
+
+### 设置页那句"需重启"改成与事实一致
+
+- 页面顶部原文是「改动即保存（`编制` / `门禁` 两类需重启 `dsh web` 后生效）」——这在 1.1.x 成立，
+  **1.2.0 起不再成立**：设置写入后两条路径都会在进程内重算派生值（容量上限 `resolveLimits`、
+  轮次上限 `resolveRoundLimits`、档位门 `resolveTierGate`、A 线开关 `resolveLeadToolFace`，见
+  `reapplySettingsDerived()`）：
+  - **宿主路径**（宿主有 settings 服务时，也就是官方面板/浮层实际在用的那条）：
+    `scope.watch()` → `onResolved` → 重算；保存回执原文即"已在进程内重算，**无需重启**"；
+  - **文件回退路径**（宿主不可用、写 `settings.json`）：路由里同样显式调用了重算；
+    但该路径的保存回执仍按既有契约返回 `needsRestart: true`（被 `settings.test.mjs` 钉住），
+    因此文案**不能一概而论**。
+- 新文案如实覆盖两种形态：「改动即保存。宿主设置可用时（默认）上限与档位门在进程内即时重算，
+  无需重启；若保存提示"重启后生效"，按提示操作。」（英文版同步）
+- 没有测试断言过这句话，故无需改任何断言。
+
+### README 新增「装上之后怎么用」
+
+- 写实"装完**重启一次** `dsh web` 即自动就位"：插件加载时把「专家团模式」预设铺到
+  `$DSH_HOME/.agent-presets/expert-team`（带版本戳、升级整目录重铺），**不需要手工创建预设**。
+- 实测依据（2026-09-15）：删掉该目录模拟全新安装 → 仅重启一次 ⇒ 目录被**自动新建**
+  （APFS birth time 落在该次启动内，比插件落盘晚 621 秒 ⇒ 排除"安装时铺"）、版本戳 = 插件版本、
+  与包内逐字节一致；选择器里随即出现「专家团模式」，`会话插件` 页 12/12 角色行齐全。
+
+### README 新增「自定义预设」
+
+- 创建入口与机制（`设置 → Agent 预设 → 用「创造模式」创作自定义预设`，本质是"复制一份既有预设"）。
+- 陷阱写清：**不要**用 `expert-team` 这个 id 去「创建 preset」——那只会得到所选**源**的组合
+  （通常是标准模式），既不是我们的预设，还会占住该 id 让自动重铺失效；要给专家团做定制，
+  请以「专家团模式」为源、**另用一个自己的 id**，改动只写在自己的目录里（`expert-team/` 归插件所有，
+  加载/升级会整目录重铺）。
+## 1.3.0
+
+**设置页搬进官方「设置」菜单 + 预设在插件加载时就位 + 门禁两处修复**
+
+### 设置页进官方设置菜单（`settings.section`）
+
+- `client.js` 新增 `SettingsSection` 组件并通过 `ctx.slots.inject('settings.section', …)` 注册
+  （`id: expert-team`、`order: 50`、label 走语言 thunk）⇒ 设置出现在 **设置 →「专家团」**，
+  与其它插件的设置同一入口、同一套面板 chrome。
+- **浮层第 5 个「设」页签已移除**：同一份表单不再两处渲染。
+- 样式改由 `ensureCss()` 在 `apply()` 里注入 —— 官方设置菜单**可以在没有会话时打开**，
+  而原实现只在 HeaderButton 渲染路径注入 CSS ⇒ 那种情况下面板是一堆裸控件。
+- 读设置失败改为**显式报错 + 重试按钮**（旧写法把 404 静默变成 null ⇒ 永久停在"正在读取设置…"）。
+- 数据层不变：宿主命名空间 `expert-team`（随插件市场的备份/恢复走；改值后上限/轮次/档位门即时重算）。
+- **诚实边界**：`默认班底`（角色 id 数组）刻意不上宿主 schema（类型表达不可靠），
+  继续由该页里的对应控件与 `$DSH_HOME/expert-team/settings.json` 负责。
+
+### 预设在插件加载时就位（修一次真实事故）
+
+- `apply()` 里 `void ensurePresetInstalled()` / `void ensureSkillInstalled()`：
+  **插件装着 ⇒ 它的 preset 就该在位**（失败只 warn，绝不影响插件加载）。
+- 事故：`/team uninstall` 按设计回收了 `$DSH_HOME/.agent-presets/expert-team`，而铺设此前只发生在
+  `/team <任务>` 时 ⇒ **使用该预设的会话当场丢掉 12 个角色工具**（`subagent_pm`…），
+  选择器里那条也退化成裸 id（只剩标准模式的描述）。现在加载即铺；对带我们版本戳的目录还会
+  **整目录重铺** ⇒ 该状态可自愈；对"无戳且内容不像我们"的同名目录仍**不覆盖**（尊重用户内容）但会出声告警。
+- `/team uninstall` 输出补契约说明：插件仍装着时，下次加载会重新铺一份；真正的卸载是在插件市场移除插件。
+
+### 门禁修复（`scripts/check-sync.mjs`）
+
+- **普通模式崩溃**：`ABSENT_OPTIONAL`（可选映射目标不存在）此前落进读 `onlySrc/onlyDst/differ` 的分支
+  ⇒ `TypeError`；而 skill 是第一个映射，于是整份报告**一行都打不出来**。现在四种状态各有显式出口。
+- `preset` 映射改为**可选**（全新安装、刚 uninstall 都属正常缺席；**存在时照旧逐文件比对**，
+  仍能抓"改了源码没同步"）。
+- `.expert-team-version`（归属标记、不是包内资产）计入忽略项 —— 否则 1.3.0 起每个用户带戳后
+  `gate:sync` 会假红。
+
 ## 1.2.3
 
 **给 lead 工具面收窄加开关**（因为 1.2.2 让一个从未生效的行为突然生效了）
@@ -45,9 +115,12 @@
 ### 设置接进宿主命名空间
 
 - 插件加载时把设置注册为宿主命名空间 `expert-team`（`ctx.inject(['settings'], …)` 作为优雅降级边界）：
-  - 出现在 **设置 → 插件 → 插件配置**，由宿主按我们给的 schema 渲染 —— schema 由
-    `lib/settings.js` 的 `SETTINGS_SPEC` **生成**（字段/范围/默认值都是单一真源，不抄第二份）；
-  - 随插件市场的**备份与恢复**一起走（市场只备份"profile 插件清单 + 设置"，自造 JSON 不在内）；
+  - **数据层已就位**：设置由宿主服务持有，随插件市场的备份/恢复走；schema 由
+    `lib/settings.js` 的 `SETTINGS_SPEC` **生成**（字段/范围/默认值单一真源，不抄第二份）。
+    ⚠️ **更正（2026-09-14 实机核验）**：本节先前写的"出现在 设置 → 插件 → 插件配置"当时**并不成立** ——
+    那张页面渲染的是「宿主服务的命名空间 ∩ 已注册卡片」的交集，我们只交付了数据层。
+    → **已于 1.3.0 解决**：设置页走 `settings.section` 槽，作为 **设置 →「专家团」** 一整页出现
+    （不是 dshmarket 那种"插件配置"卡片），见 1.3.0 段。
   - 改动**即时生效**：`scope.watch()` → 用同一份 `config` 重算容量上限/轮次上限/档位门，不必重启。
 - `base` 用**当前生效设置**填充 ⇒ 面板一打开看到的就是真正在用的值，**不需要任何一次性迁移**；
   优先级不变：`schema 默认 < 我们传的 base < 官方面板用户层`。

package/README.en.md

@@ -54,17 +54,18 @@ The roster is trimmed per task; small jobs start only the roles they need.
   `subagent` tool with personas written into the prompt — nothing breaks, you just lose the
   config-level boundary guarantees.
 
-**Option 1 — plugin market (recommended)**
-
-`dsh web` → **Settings → Plugin market** → search for "专家团" / "expert team" → install → refresh.
-
-**Option 2 — CLI**
+**Option 1 — CLI (recommended)**
 
 ```sh
 dsh plugin --profile web add @yangdcm/dsh-expert-team
 # then restart dsh web so the new bundle joins the composition
 ```
 
+**Option 2 — plugin market** (listing not submitted yet, so it may not be searchable)
+
+If it has been listed: `dsh web` → **Settings → Plugin market** → search for "专家团" / "expert team" → install → refresh.
+```
+
 **Option 3 — from source (development)**
 
 ```sh
@@ -84,18 +85,48 @@ pnpm install && dsh web
 > upgrade instead of silently going stale. `/team uninstall` reclaims the copies this plugin laid down —
 > it only removes directories carrying our stamp, and never touches content you authored yourself.
 >
-> **Where settings live**: on load the plugin registers its settings as the host namespace `expert-team`,
-> so they appear under **Settings → Plugins → Plugin configuration** and take effect immediately (limits,
-> round caps and the tier gate are recomputed in-process — no restart), and they travel with the plugin
-> market's **backup and restore**. **Honest boundary**: the default roster (an array of role ids) is *not*
-> on the official page — its value type cannot be expressed reliably in the host schema, so it stays with
-> the overlay's settings tab and `$DSH_HOME/expert-team/settings.json`. On a host with no settings service
-> every setting falls back to that file.
+> **The preset is laid down when the plugin loads**: after `/team uninstall`, a restart of `dsh web`
+> re-materialises it automatically (no manual rescue needed).
+>
+> **Where settings live**: **Settings →「专家团」** — a full page inside the host's official settings menu
+> (the `settings.section` slot, `id: expert-team`, `order: 50`), sharing the entry point and panel chrome with
+> every other plugin's settings. The data layer is the host namespace `expert-team` (the host owns it, it travels
+> with the plugin market's **backup and restore**, and a changed value recomputes limits, round caps and the tier
+> gate in-process — no restart). The overlay's old "settings" tab has been removed: one form, one place.
+> **Honest boundary**: the default roster (an array of role ids) is deliberately *not* in the host schema (its value
+> type cannot be expressed reliably); it stays with the corresponding control on that page and
+> `$DSH_HOME/expert-team/settings.json`. On a host with no settings service every setting falls back to that file.
 >
 > **The A-line switch**: the "narrow the lead's tool face" gate (`gates.leadToolFace`, default `on`)
 > decides whether execution tools (`bash/write/edit/grep/glob`) are taken away from the lead and given
 > to the role subagents. Turn it off with `config.leadToolFace` or `DSH_EXPERT_TEAM_LEAD_TOOLFACE=off`.
 
+### After installing
+
+1. **Restart `dsh web` once**: on load the plugin lays the 「专家团模式」 preset down into
+   `$DSH_HOME/.agent-presets/expert-team` (version-stamped; upgrades re-lay the whole directory) —
+   **no manual preset creation needed**. After that restart the preset picker lists it, and all 12 role
+   subagent tools are in place (visible under `Settings → Plugins → Plugin list → Session plugins`).
+2. Switch the session to that preset, then run `/team <one-line goal>`.
+3. Change settings under **Settings →「专家团」** (values live in the host namespace `expert-team`, so they
+   travel with the plugin market's backup/restore).
+
+**Troubleshooting**: a missing preset, or a same-id preset squatting on ours, is healed by **one `dsh web`
+restart** (the plugin re-lays on load); running `/team <task>` once does the same. See the
+[Troubleshooting](#troubleshooting) section below for the details — including the easiest trap to fall into:
+**never** create a preset with the id `expert-team`.
+
+### Custom presets (when you want to change expert-team's defaults)
+
+- **Create**: `Settings → Agent presets → create a custom preset with "creation mode"` (its mechanism is
+  "copy an existing preset"; the result lands in `$DSH_HOME/.agent-presets/<id>/`).
+- **To customise expert-team, copy 「专家团模式」 as the source under an id of your own** (e.g. `my-team`): the
+  copy already carries the 12 role tools and their skill directory, and your edits stay inside `my-team/`.
+  **Never edit files under `expert-team/`** — that copy belongs to the plugin and is re-laid wholesale on
+  load/upgrade.
+- A newly created preset **may only appear in the picker after a `dsh web` restart** (the host reads its roster
+  at startup).
+
 ## Quick start
 
 ```
@@ -145,6 +176,25 @@ npm run check:name      # verify no placeholder package name is left behind
 `$DSH_HOME`, and `gate:preset` borrows the Config schemas shipped inside your local dsh install
 (the dsh path is auto-detected; override with `DSH_INSTALL`). Neither runs in CI.
 
+## Troubleshooting
+
+**No「专家团」page in the settings menu?** Make sure you are on 1.3.0 or newer
+(`dsh plugin --profile web add @yangdcm/dsh-expert-team` to upgrade) and then **restart `dsh web`** — the page
+did not exist before 1.3.0.
+
+**The「专家团模式」preset shows as the bare id (`expert-team`) and sessions have none of the 12 role tools?**
+That means `$DSH_HOME/.agent-presets/expert-team/` does not hold our preset (it was deleted, or a same-named
+preset took the id). Fix it in this order:
+
+1. Run `/team <any small task>` once — the plugin re-lays a version-stamped copy from the package (simplest; from
+   1.3.0 it also does this automatically on load);
+2. Or copy over it: `cp -f <package>/presets/expert-team/{agent.cordis.yml,preset.yml} ~/.dsh/.agent-presets/expert-team/`;
+3. Do **not** "create preset" with the same id in Settings → Agent presets — that only gives you a composition of
+   the *source* you picked (e.g. standard mode), not ours.
+
+Afterwards **restart `dsh web`** (the preset roster is fixed at startup; a page refresh is not enough) and open a
+**new session** (a session's preset is fixed when it is created).
+
 ## Known limitations
 
 - **The local routes are guarded, but that is not authentication**: all 11 overlay routes now check

package/README.md

@@ -51,17 +51,18 @@
 - 会话使用 **「专家团模式」** preset 时，12 个角色工具（`subagent_pm` / `subagent_architect` / …）才可用；
   否则自动退回通用 `subagent`（角色人设写进 prompt），功能不丢、只是少了配置层的边界保证
 
-**方式一：插件市场（推荐）**
-
-`dsh web` → **设置 → 插件市场** → 搜索「专家团」→ 一键安装 → 刷新页面。
-
-**方式二：命令行**
+**方式一：命令行（推荐）**
 
 ```sh
 dsh plugin --profile web add @yangdcm/dsh-expert-team
 # 然后重启 dsh web，使新 bundle 进入组合
 ```
 
+**方式二：插件市场**（收录尚未提交 ⇒ 目前可能搜不到）
+
+若已被收录：`dsh web` → **设置 → 插件市场** → 搜索「专家团」→ 一键安装 → 刷新页面。
+```
+
 **方式三：从源码（开发/未发布时）**
 
 ```sh
@@ -79,16 +80,37 @@ pnpm install && dsh web
 > API），但带版本戳：升级后整目录重铺，不会静默停在旧版本。用 `/team uninstall` 可回收本插件
 > 铺下的副本（只删带我们版本戳的目录，用户自己写的同名内容一律保留）。
 >
-> **设置在哪改**：插件加载时把设置注册成宿主命名空间 `expert-team` ⇒ 出现在
-> **设置 → 插件 → 插件配置**，改动**即时生效**（上限/轮次/档位门在进程内重算，不必重启），
-> 并且随插件市场的**备份与恢复**一起走。**诚实边界**：`默认班底`（角色 id 数组）不在官方页面里
-> —— 它的取值类型在宿主 schema 里表达不可靠，继续由浮层设置页签与
+> **插件加载时就把 preset 铺到位**：`/team uninstall` 回收之后，重启 `dsh web` 即会**自愈重铺**（不需要手工救）。
+>
+> **设置在哪改**：**设置 →「专家团」** —— 官方设置菜单里的一整页（`settings.section` 槽，
+> `id: expert-team`、`order: 50`），与其它插件的设置同一入口、同一套面板 chrome。数据层是宿主命名空间
+> `expert-team`（宿主持有、随插件市场的**备份与恢复**一起走；改值后上限/轮次/档位门在进程内**即时重算**，
+> 不必重启）。浮层里原来的「设」页签已移除 —— 同一份表单只在一处渲染。
+> **诚实边界**：`默认班底`（角色 id 数组）刻意不上宿主 schema（类型表达不可靠），由该页里的对应控件与
 > `$DSH_HOME/expert-team/settings.json` 负责；宿主没有 settings 服务时，全部设置退回该文件。
 >
 > **A 线开关**：设置里的「门禁 → 收窄 lead 工具面」（`gates.leadToolFace`，默认 `on`）决定
 > 是否把执行类工具（`bash/write/edit/grep/glob`）从 lead 手上拿走、交给角色子代理。
 > 也可用 `config.leadToolFace` 或环境变量 `DSH_EXPERT_TEAM_LEAD_TOOLFACE=off` 关闭。
 
+### 装上之后怎么用
+
+1. 装完**重启一次 `dsh web`**：插件加载时会把「专家团模式」预设自动铺到 `$DSH_HOME/.agent-presets/expert-team`
+   （带版本戳，升级会整目录重铺）—— **不需要手工创建预设**。重启后预设选择器里就有「专家团模式」，
+   12 个角色化专家 subagent 工具也全部就位（可在 `设置 → 插件 → 插件列表 → 会话插件` 看到它们）。
+2. 会话切到「专家团模式」，再 `/team <一句话目标>`。
+3. 改设置走 **设置 →「专家团」**（值存在宿主命名空间 `expert-team`，随插件市场的备份/恢复一起走）。
+
+**排障**：预设丢了、或被同名预设占住 —— **重启一次 `dsh web` 即自愈**（插件加载会重铺），也可跑一次 `/team <任务>`。
+细节见下面「排障」一节，其中包含那条最容易踩的坑：**不要**用 `expert-team` 这个 id 去「创建 preset」。
+
+### 自定义预设（想改专家团默认行为时）
+
+- **创建**：`设置 → Agent 预设 → 用「创造模式」创作自定义预设`（其机制是"复制一份既有预设"，产出落在 `$DSH_HOME/.agent-presets/<id>/`）。
+- **要定制专家团，请以「专家团模式」为源、换一个你自己的 id**（例如 `my-team`）：复制出来的目录天然带上 12 个角色工具与它的 skill 目录，
+  你的改动只写在 `my-team/` 里。**永远不要改 `expert-team/` 里的文件** —— 那份是插件所有的，加载/升级会整目录重铺覆盖。
+- 新建的预设**可能要重启 `dsh web` 后**才出现在选择器里（宿主名册在启动时读取）。
+
 ## 快速上手
 
 ```
@@ -137,6 +159,21 @@ npm run check:name      # 检查占位包名残留
 是**开发机专用**门禁：`gate:sync` 比对本机 `$DSH_HOME` 下的自举副本，`gate:preset` 借用本机
 dsh 安装里插件自带的 Config schema（dsh 路径自动探测，可用 `DSH_INSTALL` 覆盖），因此**不在 CI 里跑**。
 
+## 排障
+
+**设置菜单里找不到「专家团」那一页？** 确认版本 ≥ 1.3.0（`dsh plugin --profile web add @yangdcm/dsh-expert-team`
+升级，或 `npm view @yangdcm/dsh-expert-team version` 看线上版本），然后**重启 `dsh web`** —— 1.3.0 之前没有这一页。
+
+**「专家团模式」显示成裸 id（`expert-team`）、会话里没有 12 个角色工具？** 说明
+`$DSH_HOME/.agent-presets/expert-team/` 里不是我们那份（被删过，或被一份同名预设占了）。按优先级修：
+
+1. 跑一次 `/team <任意小任务>` —— 插件会用包内资产重铺一份带版本戳的（最省事；1.3.0 起插件加载时也会自动铺）；
+2. 或从包内覆盖：`cp -f <包路径>/presets/expert-team/{agent.cordis.yml,preset.yml} ~/.dsh/.agent-presets/expert-team/`；
+3. **不要**用同一个 id 在「设置 → Agent 预设」里「创建 preset」——那只会得到你选的**源**的组合（例如标准模式），
+   不是我们这份。
+
+改完**重启 `dsh web`**（预设名册在启动时固化，刷新页面不够），再开**新会话**（预设只在会话创建时固定）。
+
 ## 已知限制
 
 - **本机来源守卫已就位，但不是鉴权**：11 条浮层路由现在统一校验 Host（挡 DNS rebinding）、

package/client.js

@@ -199,6 +199,20 @@ window.__ModuleLoader__.load({
       '.exp-preview{margin-top:10px;padding:10px 12px;border:1px solid var(--dsw-alias-border-l2,var(--border,#d0d7de));border-radius:9px;background:var(--dsw-alias-bg-layer-1,var(--bg,#fff));font-size:12px;line-height:1.6;white-space:pre-wrap;word-wrap:break-word;max-height:330px;overflow:auto}' +
       '.exp-empty{color:var(--dsw-alias-label-secondary,var(--text,#57606a));font-size:12px;padding:8px 0}' +
       '.exp-err{color:#b3291e;font-size:12px;padding:8px 0}' +
+      // ── 设置表单（官方「设置」面板的专家团分节；浮层里已不再有「设」页签）──
+      // 这些类以前**没有任何 CSS**（只有 JS 里的 className），在浮层里靠浏览器默认样式勉强能看；
+      // 搬进官方设置面板后需要一个真正的表单布局：左标签、中控件、右说明。
+      '.exp-settings{font-size:12.5px;color:var(--dsw-alias-label-primary,var(--text,#1f2328));max-width:760px}' +
+      '.exp-settings-head{margin:0 0 4px;font-size:11.5px;line-height:1.6;color:var(--dsw-alias-label-secondary,var(--text,#57606a))}' +
+      '.exp-settings-group{margin:16px 0 2px;font-size:11.5px;font-weight:700;letter-spacing:.02em;color:var(--dsw-alias-label-secondary,var(--text,#57606a))}' +
+      '.exp-settings-row{display:flex;align-items:flex-start;gap:10px;padding:7px 0;border-top:1px solid var(--dsw-alias-border-l1,var(--border,#eef1f5))}' +
+      '.exp-settings-label{flex:0 0 188px;max-width:188px;font-size:12.5px;line-height:1.5}' +
+      '.exp-settings-ctl{flex:none;display:flex;align-items:center;min-height:20px}' +
+      '.exp-settings-note{flex:1;min-width:0;font-size:11px;line-height:1.5;color:var(--dsw-alias-label-secondary,var(--text,#57606a))}' +
+      '.exp-settings-msg{margin-top:10px;padding:6px 0;font-size:11.5px;font-weight:700;color:#1a7f5a}' +
+      '.exp-settings-msg.bad{color:#b3291e;font-weight:600}' +
+      '.exp-settings-retry{margin-top:10px;padding:4px 12px;border:1px solid var(--dsw-alias-border-l2,var(--border,#d0d7de));border-radius:8px;background:var(--dsw-alias-bg-layer-3,var(--bg,#fff));color:inherit;cursor:pointer;font-size:12px}' +
+      '.exp-settings-retry:hover{background:var(--dsw-alias-bg-layer-2,var(--bg-subtle,#f6f8fa))}' +
       '.exp-viol{color:#fff;background:linear-gradient(90deg,#c62828,#e53935);font-size:12px;font-weight:600;padding:7px 10px;border-radius:8px;margin:0 0 8px;cursor:pointer;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}' +
       '.exp-decision{margin:8px 0;padding:12px 14px;border:1px solid var(--dsw-alias-state-business-primary,#0969da);border-radius:10px;background:linear-gradient(180deg,#f6f9ff,var(--dsw-alias-bg-layer-1,#fff))}' +
       '.exp-decision-title{font-weight:700;font-size:13px;color:var(--dsw-alias-state-business-primary,#0969da)}' +
@@ -257,6 +271,20 @@ window.__ModuleLoader__.load({
       + '.etv-g-node.lead{stroke:var(--etv-lead);stroke-width:1.6}'
       + '.etv-link{position:relative;height:16px;margin-left:var(--etv-indent)}.etv-link i{position:absolute;left:6px;top:0;bottom:0;width:2px;background:var(--etv-line)}.etv-link b{position:absolute;left:1.5px;bottom:-2px;font-size:9px;line-height:1;color:var(--dsw-alias-label-tertiary)}.etv-list{position:relative;margin:2px 0 6px var(--etv-indent);padding-left:16px}.etv-list-i{position:absolute;left:0;top:0;bottom:14px;width:2px;background:var(--etv-line)}.etv-row{position:relative;margin:0 0 10px}.etv-row::before{content:"";position:absolute;left:-16px;top:28px;width:14px;height:2px;background:var(--etv-line)}.etv-row::after{content:"";position:absolute;left:-19px;top:25px;width:6px;height:6px;border-radius:50%;background:var(--etv-line)}'
     // ── session store (mirrors dsh-md-preview) ──
+    /**
+     * 注入本插件的样式表（幂等）。**必须由任何会渲染本插件 UI 的入口调用** ——
+     * 原来只有 HeaderButton 在渲染时注入，于是「会话还没建/首屏打开官方设置面板」时
+     * 设置表单是一堆无样式控件。
+     */
+    function ensureCss() {
+      try {
+        if (typeof document === 'undefined' || document.querySelector('style[data-et-css]')) return
+        var stEl = document.createElement('style')
+        stEl.setAttribute('data-et-css', '1')
+        stEl.textContent = CSS
+        document.head.appendChild(stEl)
+      } catch (e) {}
+    }
     var currentSessionId = null
     var open = false // default collapsed so the panel never auto-blocks the workspace; open via the「专家团」header button
     var listeners = new Set()
@@ -1032,21 +1060,42 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * 设置页签：**只做三件事** —— 读（GET /settings）、渲染（照 schema）、存（POST，自动保存）。
-     * 失败一律照实显示（400 的错误列表 / 网络错误），**并把控件回滚到服务端的值** ——
+     * 设置页：**只做四件事** —— 读（GET /settings）、渲染（照 schema）、存（POST，自动保存）、
+     * **读失败要照实说**。
+     *
+     * 为什么读失败必须显式报错：旧实现是 `r.ok ? r.json() : null` —— 非 200 被静默丢成 null，
+     * 于是永远停在「（正在读取设置…）」，既不报错也不超时。实测运行中的 `dsh web` 若启动早于
+     * 本功能（宿主路由只在插件加载时注册），`GET /settings` 就是 **404**，用户看到的就是无限加载。
+     *
+     * 保存失败（400 的错误列表）与读失败分开渲染：读失败整页显示 +「重试」；保存失败只在表单
+     * 下方出红字，**不把已经填好的表单整页换掉**，控件始终回滚到服务端的值 ——
      * "界面显示 A、服务端是 B"是最难排查的状态，宁可回滚也不装作成功。
      */
-    function SettingsTab() {
+    function SettingsSection() {
       var sS = useState(null); var data = sS[0], setData = sS[1]
       var mS = useState(''); var msg = mS[0], setMsg = mS[1]
       var eS = useState(''); var err = eS[0], setErr = eS[1]
+      var lS = useState(''); var loadErr = lS[0], setLoadErr = lS[1]
+      var rS = useState(0); var retry = rS[0], setRetry = rS[1]
+      var loadingS = useState(true); var loading = loadingS[0], setLoading = loadingS[1]
       useEffect(function () {
         var alive = true
-        fetch('/plugins/dsh-expert-team/settings').then(function (r) { return r.ok ? r.json() : null }).then(function (d) {
-          if (alive && d && d.ok) setData(d)
-        }).catch(function (e) { if (alive) setErr(String(e && e.message ? e.message : e)) })
+        setLoading(true); setLoadErr('')
+        fetch('/plugins/dsh-expert-team/settings').then(function (r) {
+          return r.json().catch(function () { return null }).then(function (d) { return { ok: r.ok, status: r.status, d: d } })
+        }).then(function (res) {
+          if (!alive) return
+          setLoading(false)
+          if (res.ok && res.d && res.d.ok && res.d.schema) { setData(res.d); return }
+          var detail = (res.d && (res.d.error || (res.d.errors || []).join('；'))) || ''
+          setLoadErr(t('读取设置失败：HTTP ', 'Reading settings failed: HTTP ') + res.status + (detail ? ' ' + t('（', '(') + detail + t('）', ')') : ''))
+        }).catch(function (e) {
+          if (!alive) return
+          setLoading(false)
+          setLoadErr(t('读取设置失败：', 'Reading settings failed: ') + String(e && e.message ? e.message : e))
+        })
         return function () { alive = false }
-      }, [])
+      }, [retry])
       function save(patch) {
         setErr(''); setMsg('保存中…')
         fetch('/plugins/dsh-expert-team/settings', {
@@ -1061,8 +1110,14 @@ window.__ModuleLoader__.load({
           setMsg(res.d.needsRestart ? '已保存 —— **重启 dsh web 后生效**' : '已保存')
         }).catch(function (e) { setErr(String(e && e.message ? e.message : e)); setMsg('') })
       }
-      if (err) return h('div', { className: 'exp-settings' }, h('div', { style: { color: '#c0392b' } }, '✗ ' + esc(err)))
-      if (!data || !data.schema) return h('div', { className: 'exp-empty' }, t('（正在读取设置…）', '(loading settings…)'))
+      if (loading) return h('div', { className: 'exp-settings' }, h('div', { className: 'exp-empty' }, t('（正在读取设置…）', '(loading settings…)')))
+      if (loadErr) return h('div', { className: 'exp-settings' },
+        h('div', { className: 'exp-err' }, '✗ ' + esc(loadErr)),
+        h('div', { className: 'exp-settings-note' },
+          esc(t('若是 404：运行中的 dsh web 启动早于本功能 —— 宿主的 /settings 路由在插件加载时才注册，重启 dsh web 后点「重试」即可。',
+            'On a 404: the running dsh web started before this feature — the host /settings route registers at plugin load. Restart dsh web, then retry.'))),
+        h('button', { className: 'exp-settings-retry', onClick: function () { setRetry(retry + 1) } }, esc(t('重试', 'Retry'))))
+      if (!data || !data.schema) return h('div', { className: 'exp-settings' }, h('div', { className: 'exp-empty' }, t('（正在读取设置…）', '(loading settings…)')))
       var model = settingsFormModel(data.schema, data.settings)
       var rows = []
       model.forEach(function (g) {
@@ -1074,22 +1129,30 @@ window.__ModuleLoader__.load({
           } else if (r.type === 'bool') {
             ctl = h('input', { type: 'checkbox', checked: !!r.value, onChange: function (e) { save({ [r.path]: e.target.checked }) } })
           } else if (r.type === 'int') {
-            ctl = h('input', { type: 'number', value: String(r.value), min: r.min === null ? undefined : r.min, max: r.max === null ? undefined : r.max, style: { width: 72 },
+            ctl = h('input', { type: 'number', value: String(r.value), min: r.min === null ? undefined : r.min, max: r.max === null ? undefined : r.max, style: { width: 84 },
               onChange: function (e) { var v = e.target.value; if (v !== '' && /^-?\d+$/.test(v)) save({ [r.path]: Number(v) }) } })
           } else if (r.type === 'enum') {
             ctl = h('select', { value: String(r.value), onChange: function (e) { save({ [r.path]: e.target.value }) } },
               (r.values || []).map(function (v) { return h('option', { key: v, value: v }, esc(v)) }))
           } else {
-            ctl = h('input', { type: 'text', value: String(r.value), placeholder: t('留空 = 按档位默认', 'empty = tier default'), style: { width: 150 },
+            ctl = h('input', { type: 'text', value: String(r.value), placeholder: t('留空 = 按档位默认', 'empty = tier default'), style: { width: 168 },
               onBlur: function (e) { var v = e.target.value.trim(); save({ [r.path]: v === '' ? null : v.split(',').map(function (x) { return x.trim() }).filter(Boolean) }) } })
           }
           rows.push(h('div', { key: r.path, className: 'exp-settings-row' },
             h('span', { className: 'exp-settings-label', title: r.hint }, esc(r.label)),
-            ctl,
-            r.hint ? h('span', { className: 'exp-muted', style: { marginLeft: 6 } }, esc(r.hint)) : null))
+            h('span', { className: 'exp-settings-ctl' }, ctl),
+            h('span', { className: 'exp-settings-note', title: r.hint }, r.hint ? esc(r.hint) : null)))
         })
       })
-      return h('div', { className: 'exp-settings' }, rows, h('div', { className: 'exp-muted', style: { marginTop: 6 } }, esc(msg || '')))
+      return h('div', { className: 'exp-settings' },
+        // 这句必须按**事实**说：宿主设置可用时（默认，也就是官方面板与浮层都在写的那个真源）
+        // 写入会经 `watch` → `reapplySettingsDerived()` 在**进程内即时重算**上限与档位门
+        // （`lib/command.js:5476` 的保存回执原文就是"无需重启"）；只有**回退到 settings.json**
+        // 时才有"重启后生效"的保守提示，且那条由每次保存的回执逐次给出（`needsRestart`）。
+        // 所以这里既不写"两类需重启"（在默认形态下是假的），也不写"永远不用重启"（回退路径会假）。
+        h('div', { className: 'exp-settings-head' }, esc(t('改动即保存。宿主设置可用时（默认）上限与档位门在进程内即时重算，无需重启；若保存提示"重启后生效"，按提示操作。', 'Saved on change. With host settings available (the default), caps and the tier gate are recomputed in-process — no restart needed; if a save says "applies after restart", follow that.'))),
+        rows,
+        h('div', { className: 'exp-settings-msg' + (err ? ' bad' : '') }, esc(err ? '✗ ' + err : (msg || ''))))
     }
 
     function DecisionCard(props) {
@@ -1944,9 +2007,13 @@ window.__ModuleLoader__.load({
       var headCls = 'exp-head' + (docked || viewMode ? '' : ' exp-grab')
 
       try {
-        var TAB_ZH = { team: '人', tasks: '事', info: '料', board: '盘', settings: '设' }
+        // 「设」页签已移除：设置页搬进**官方「设置」菜单**（`settings.section` 槽，见 apply()）。
+        // 为什么改：浮层页签是一个只有打开浮层才够得着的第二入口，且它依赖一个「读取设置」的
+        // 自建请求路径 —— 一旦宿主路由没注册就永远停在「正在读取设置…」。搬进官方菜单后与
+        // 其它插件的设置同一入口、同一套面板 chrome。
+        var TAB_ZH = { team: '人', tasks: '事', info: '料', board: '盘' }
         var tabBar = h('div', { className: 'exp-tabs' },
-          ['team', 'tasks', 'info', 'board', 'settings'].map(function (tb) {
+          ['team', 'tasks', 'info', 'board'].map(function (tb) {
             return h('span', { key: tb, className: 'exp-tab' + (tab === tb ? ' on' : ''), onClick: function () { setTab(tb) } },
               esc((langNow === 'en' ? TAB_ZH[tb] : TAB_ZH[tb])) + (tb === 'tasks' ? ' ' + tasks.length : ''))
           }),
@@ -2189,7 +2256,7 @@ window.__ModuleLoader__.load({
             h('ol', { className: 'exp-path' }, stepper),
             (data.pendingDecision && data.pendingDecision.options && data.pendingDecision.options.length) ? h(DecisionCard, { decision: data.pendingDecision, onChoose: function (id, label) { decide({ choice: label || id }) } }) : null,
             tabBar,
-            tab === 'team' ? teamTab : (tab === 'tasks' ? tasksTab : (tab === 'board' ? boardTab : (tab === 'settings' ? h(SettingsTab, null) : infoTab)))
+            tab === 'team' ? teamTab : (tab === 'tasks' ? tasksTab : (tab === 'board' ? boardTab : infoTab))
           ] : null))
       } catch (e) {
         return h('div', { className: 'exp-preview' }, 'PANEL ERR: ' + esc(String(e && e.stack ? e.stack : e)).slice(0, 800))
@@ -2253,14 +2320,7 @@ window.__ModuleLoader__.load({
       function toggle() { if (!isOpen) { dockState = true; saveLS('et-dock', true); notify(); setOpen() } else setOpen() }
       // CSS must exist for the HEADER button too — the panel's own <style> is
       // only in the DOM while the panel is open. Inject once, globally.
-      try {
-        if (typeof document !== 'undefined' && !document.querySelector('style[data-et-css]')) {
-          var stEl = document.createElement('style')
-          stEl.setAttribute('data-et-css', '1')
-          stEl.textContent = CSS
-          document.head.appendChild(stEl)
-        }
-      } catch (e) {}
+      ensureCss()
       var badge = teamBadge(live)
       var tip = '专家团 · ' + badge.title + '｜点击' + (isOpen ? '收起' : '打开') + '并排面板（全屏画布：切到上方「🧑‍🔬 专家团」标签）'
       return h('button', { className: 'exp-open exp-live-badge' + (badge.cls || ''), title: tip, onClick: toggle },
@@ -2397,6 +2457,22 @@ window.__ModuleLoader__.load({
         exports._syncPending = syncPending
         exports._resolvePending = resolvePending
 
+        // CSS 必须在这里就注入：官方「设置」面板可以在**没有会话**（新会话/首屏）时打开，
+        // 而原来这份 CSS 只挂在 HeaderButton 的渲染里 —— 那样设置面板会是一堆无样式的裸控件。
+        ensureCss()
+
+        // 设置页进**官方设置菜单**（`settings.section` 是宿主 ui-settings-general 声明、其它
+        // 插件（agent-preset / models / plugins）同样在用的槽）。`ctx.slots.inject` 等的是**声明**
+        // 而不是包顺序：宿主没声明该槽时这条贡献不会挂上，插件其余部分照常工作。
+        ctx.slots.inject('settings.section', function () {
+          return ctx.slots.register({
+            name: 'settings.section',
+            id: 'expert-team',
+            order: 50,
+            label: function () { return t('专家团', 'Expert team') }
+          }, wrap(SettingsSection))
+        })
+
         ctx.slots.inject('conversation.session.header.actions', function () {
           return ctx.slots.register({ name: 'conversation.session.header.actions', id: 'expert-team-open', order: 900, inject: function (sessionId) { return sessionId ? { sessionId: sessionId } : {} } }, wrap(HeaderButton))
         })

package/lib/command.js

@@ -886,10 +886,40 @@ async function uninstallInstalled() {
     '说明：skill 现在默认走**运行时注册**，本来就不写盘；这里回收的是历史版本留下的副本，',
     '或宿主没有 skill 注册表时的回退副本。',
     '本命令不碰工作区里的 `team/` 运行目录，也不碰插件包本身（那由插件市场卸载）。',
+    // 契约要写清：`$DSH_HOME/expert-team/` 下既有"安装副本"（installed.json，会被删），
+    // 也有**用户数据**（跨项目经验与会话→run 记忆）。后者不是安装产物，卸载命令无权处置。
+    '状态文件（`$DSH_HOME/expert-team/` 下的 `LEARNINGS.md`、`session-runs.json`、`workspaces.json`）**保留**',
+    '—— 它们是跨项目经验与会话→run 记忆，属于你的数据，不是安装副本。',
+    // 2026-09-15 事故后补的契约：本命令只清"当前那份副本"，插件只要还装着，下次加载就会重新铺。
+    '注意：只要插件**仍安装着**，下次加载会重新铺一份「专家团模式」preset（带版本戳）——',
+    '本命令清的是当前副本，真正的卸载是在插件市场里移除插件本身。',
   );
   return { kind: 'success', text: lines.join('\n') };
 }
 
+/**
+ * 后台铺一份运行时资产（preset / skill 回退副本），**失败绝不影响插件加载**。
+ *
+ * 为什么用 fire-and-forget：`apply()` 是同步契约，绝不能为了铺盘把插件挂载拖住或拖挂。
+ * 为什么只警告一次：铺失败通常意味着 `$DSH_HOME` 不可写（只读盘/权限），每次加载都刷同样的 warn
+ * 会把"响亮"变成噪声，而噪声的代价是所有告警一起被降权。
+ */
+const INSTALL_FAILURE_WARNED = new Set();
+function warnInstallFailureOnce(kind) {
+  if (INSTALL_FAILURE_WARNED.has(kind)) return;
+  INSTALL_FAILURE_WARNED.add(kind);
+  console.warn(`[expert-team] 未能铺下 ${kind} 副本（插件其余功能不受影响）：$DSH_HOME 可能不可写`);
+}
+function installInBackground(kind, run) {
+  try {
+    Promise.resolve(run())
+      .then((target) => { if (!target) warnInstallFailureOnce(kind); })
+      .catch(() => warnInstallFailureOnce(kind));
+  } catch {
+    warnInstallFailureOnce(kind);
+  }
+}
+
 async function ensureSkillInstalled() {
   // 运行时注册成功 ⇒ 一个文件都不写（默认路径；也是"卸载即干净"的前提）
   if (RUNTIME_SKILL_REGISTERED) return SKILL_DIR;
@@ -4478,6 +4508,16 @@ export function apply(ctx, config) {
     base: currentSettings(),
     onResolved: () => reapplySettingsDerived(),
   });
+  // ── 插件装着 ⇒ 它的 preset 就该在位 ─────────────────────────────────────────
+  // 为什么必须在**加载时**铺、而不是等首次 `/team <任务>`：preset 是**会话创建时**读取的，
+  // 中途缺失会让正在使用它的会话直接丢掉角色工具（2026-09-15 真实事故：用户跑 `/team uninstall`
+  // 之后「专家团模式」消失，会话里 `subagent_pm/researcher/...` 12 个角色工具全部消失）。
+  // 契约因此是「**插件装着 ⇒ preset 在位**」：`/team uninstall` 只清"当前那份副本"，
+  // 插件只要还装着，下次加载就重新铺；真正的卸载是在插件市场里移除插件本身。
+  // 用 fire-and-forget：铺不上（$DSH_HOME 不可写等）绝不能让插件挂不上。
+  installInBackground('preset', () => ensurePresetInstalled());
+  // skill 已有运行时注册时这里立即返回（零成本）；只有宿主没有 skill 注册表时才真复制。
+  installInBackground('skill', () => ensureSkillInstalled());
   void loadSessionRuns(); // session→run memory for overlay auto-select
   ctx.commands.register({
     name: 'team',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yangdcm/dsh-expert-team",
-  "version": "1.2.3",
+  "version": "1.3.1",
   "description": "dsh「专家团」bundle：一句自然语言自动组建/持久化一支 12 角色多智能体团队，共享工作区协议 + 阶段门控编排 + 结构化交接 + 质量门禁/自动调度，实现者直接改代码并产出持久工件；带 live 团队浮层（质量门禁/覆盖率/工件预览）。 · Role-based multi-agent expert team for DeepSeek Harness: one sentence in, a staged and gated team delivery out.",
   "type": "module",
   "license": "MIT",
@@ -49,7 +49,8 @@
       "platform": "web",
       "inject": [
         "@deepseek-ai/dsh-client-ui-layout",
-        "@deepseek-ai/dsh-client-ui-conversation"
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-settings-general"
       ]
     },
     "compatibility": {