dsh-expert-group 0.1.4 → 0.1.5

package/README.md

@@ -24,33 +24,27 @@
 - **无内置默认模型**：新安装后所有角色均为空，需在“dsh-expert-group”设置页从 DSH
   已配置的模型中自行选择并保存；未配置模型的角色在调用时会给出明确提示。
 - 模型与思考深度通过 `llm.listProviders/listModels` + `resolveCallConfig` 校验，只接受设置中已添加的模型。
-- **动态 settings 保存能力**：插件不在模块加载期 import `@deepseek-ai/dsh-settings`，package 也不声明该 peer，因此默认安装不会额外下载 settings 包。目标运行时为 `0.2.0-rc.2`；插件通过宿主 settings 服务的 describe/update/mutate 面读写 profile 条目，并由 DEG 自有的 settings-commit 端点完成语义校验与 revision 冲突检测（宿主不再提供 owner validate 钩子）。
+- **动态 settings 保存能力**：插件不在模块加载期 import `@deepseek-ai/dsh-settings`（package 声明的是 `>=0.2.1-rc.1` peer，宿主应提供兼容版本，插件自身不额外加载该包）。目标运行时为 `0.2.1-rc.1` / `0.2.1-rc.2`（即 `>0.2.1-rc.1` 的 RC2 契约宿主线）；插件通过宿主 settings 服务的 describe/update/mutate 面读写 profile 条目，并由 DEG 自有的 settings-commit 端点完成语义校验与 revision 冲突检测（宿主不再提供 owner validate 钩子）。
 - 子代理的 `reasoningEffort` 通过子代理 `agent/request` waterfall 注入，绕开 `dsh-tool-subagent`
   `AgentOptions` 尚未公开该字段的限制。
 
 ## 安装
 
-本插件发布到 npm 公共源，用 DSH 官方 `dsh plugin` CLI 按包名安装（`--profile` 为必填参数，一般填 `web`）：
-
-```powershell
-dsh plugin --profile web add dsh-expert-group
-```
-
-也可以直接用 npm 安装：
+本插件发布到 npm 公共源，可直接用 npm 安装：
 
 ```bash
 npm i dsh-expert-group
 ```
 
-前置条件：DSH Web 可正常运行（`dsh web`）、Node.js ≥ 22，且 PATH 上有 `pnpm`。安装后重启 `dsh web` 使插件生效。
+也可以在 DSH 的「添加插件」页面按包名安装：在输入框中填入 `dsh-expert-group`，按需在右侧切换安装源，然后点击「安装」。
 
-桌面版（Electron 客户端）的 `desktop` profile 由客户端独占管理，PATH 上的 `dsh` CLI 改不动它：先打开 Desktop 完成初始化再完全退出，用安装目录自带的 CLI 执行同一命令。
+![DSH「添加插件」对话框截图：输入框中填写的是 dsh-expert-group，右侧可切换安装源](docs/assets/dsh-plugin-add-dialog.png)
 
-```powershell
-& '<DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add dsh-expert-group
-```
+> 该截图存放在仓库的 `docs/assets/` 下；npm 安装包按 `package.json` 的 `files` 白名单发布、**不包含 `docs/`**，因此从 npm 安装的副本里这张图不会显示，在仓库中阅读一切正常。
+
+前置条件：DSH 版本 ≥ `0.2.1-rc.1`、DSH Web 可正常运行（`dsh web`）、Node.js ≥ 22，且 PATH 上有 `pnpm`。安装后重启 `dsh web` 使插件生效。
 
-安装后重新打开 Desktop 使插件生效。本插件不内置角色默认模型：先在 DSH「设置 → 模型」配置模型，再到「设置 → dsh-expert-group」为各角色选择模型并保存。
+本插件不内置角色默认模型：先在 DSH「设置 → 模型」配置模型，再到「设置 → dsh-expert-group」为各角色选择模型并保存。
 
 ## 界面总览
 

package/client-bundle.js

@@ -4432,7 +4432,13 @@
           // 关闭态：只调用记录里的精确 tabId。绝不根据 active() 当前是谁来决定关哪个 tab。
           if (record !== undefined && closeSidebarResource !== null) {
             let closed = false;
-            try { closeSidebarResource.call(sidebarRight, record.tabId); closed = true; } catch { closed = false; }
+            try {
+              // close() 可异步失败；结算前不能删掉 Auto 来源，否则失败 tab 会被当成手动 tab 而永不重试。
+              await closeSidebarResource.call(sidebarRight, record.tabId);
+              closed = true;
+            } catch {
+              closed = false;
+            }
             if (closed === true) {
               /**
                * 关闭成功后一起收口这个 key 上尚未结算的分栏事务。
@@ -10494,9 +10500,13 @@ window.__ModuleLoader__.load({
       ".deg_settings_title{font-size:20px;font-weight:600;line-height:28px;margin:0}" +
       ".deg_settings_hint{font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary);margin:0}" +
       ".deg_settings_row{display:grid;grid-template-columns:minmax(0,1fr) minmax(180px,280px);align-items:center;gap:20px;padding:14px 0;border-bottom:1px solid var(--dsw-alias-border-l2)}" +
-      ".deg_settings_management_row{grid-template-columns:minmax(0,1fr) auto minmax(180px,280px)}" +
-      ".deg_settings_management_row>.deg_settings_checkbox{white-space:nowrap}" +
-      ".deg_settings_management_row>.deg_settings_control{justify-self:end}" +
+      // 管理行的四个控件按内容宽度排列，并用 space-between 吸收剩余空间，让 599px/760px 容器中的间距均匀。
+      ".deg_settings_management_row{display:flex;align-items:center;justify-content:space-between;column-gap:16px;row-gap:12px;flex-wrap:nowrap;min-width:0}" +
+      // 统一 29px 行高与数字输入框，保证四个控件的 bounding box 顶部对齐，同时保留可用点击高度。
+      ".deg_settings_management_row>.deg_settings_checkbox{flex:0 0 auto;white-space:nowrap;height:29px;box-sizing:border-box}" +
+      ".deg_settings_management_row>.deg_settings_control{flex:0 0 auto;justify-self:auto;min-width:max-content;white-space:nowrap;height:29px;box-sizing:border-box}" +
+      // 520px 以下取消强制单行并左对齐，允许控件按整项换行；固定内容宽度避免标签折行、溢出或输入框被压缩。
+      "@media (max-width:520px){.deg_settings_management_row{flex-wrap:wrap;justify-content:flex-start}}" +
       ".deg_settings_label{font-size:13px;line-height:20px;color:var(--dsw-alias-label-primary)}" +
       ".deg_settings_control{display:flex;align-items:center;gap:10px;min-width:0}" +
       ".deg_settings_control input[type=range]{width:100%;accent-color:var(--dsw-alias-interactive-bg-primary,var(--dsw-alias-label-primary))}" +
@@ -10664,7 +10674,40 @@ window.__ModuleLoader__.load({
        // 隐藏宿主原生 svg（不替换它的内容，React 重渲染会按 fiber 位置回写 path），
        // 并让 DEG 自己插入的 svg 只占图标列（不参与伸缩），label 位置因此不变。
        "[data-deg-settings-nav-native]{display:none}" +
-       "[data-deg-settings-nav-icon]{flex:none}";
+       "[data-deg-settings-nav-icon]{flex:none}" +
+       // ── 插件详情摘要（DSH 插件管理器的组合包页）────────────────────────────
+       // 全部规则都以 deg_pd_ 前缀命名，且只用宿主已有的 CSS 变量，不依赖宿主 CSS module 的哈希类名。
+       ".deg_pd{display:flex;flex-direction:column;gap:12px;width:min(100%,760px);min-width:0;box-sizing:border-box;color:var(--dsw-alias-label-primary)}" +
+       ".deg_pd_title{font-size:14px;line-height:22px;font-weight:600;margin:0}" +
+       ".deg_pd_roles{display:flex;flex-direction:column;gap:0;list-style:none;margin:0;padding:0}" +
+       ".deg_pd_roles_header{display:grid;grid-template-columns:minmax(84px,.7fr) minmax(0,1.6fr) auto;gap:10px;padding:6px 0 2px;border-top:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-tertiary,var(--dsw-alias-label-secondary));font-size:11px;line-height:16px}" +
+       ".deg_pd_roles_header span{min-width:0}" +
+       ".deg_pd_roles_header span:last-child{text-align:right}" +
+       ".deg_pd_role{display:grid;grid-template-columns:minmax(84px,.7fr) minmax(0,1.6fr) auto;align-items:center;gap:10px;min-height:30px;padding:5px 0;border-bottom:1px solid var(--dsw-alias-border-l2)}" +
+       ".deg_pd_role:last-child{border-bottom:0}" +
+       ".deg_pd_role_name{min-width:0;font-size:13px;line-height:20px;color:var(--dsw-alias-label-primary);overflow-wrap:anywhere}" +
+       ".deg_pd_role_value{min-width:0;font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}" +
+       ".deg_pd_role_value[title]{cursor:help}" +
+       ".deg_pd_role_state{font-size:12px;line-height:18px;color:var(--dsw-alias-label-tertiary,var(--dsw-alias-label-secondary));white-space:nowrap;text-align:right}" +
+       ".deg_pd_role[data-deg-role-state=configured] .deg_pd_role_state{color:var(--dsw-alias-state-success-primary,var(--dsw-alias-label-secondary))}" +
+       ".deg_pd_role[data-deg-role-state=disabled] .deg_pd_role_name,.deg_pd_role[data-deg-role-state=disabled] .deg_pd_role_value{color:var(--dsw-alias-label-secondary)}" +
+       // 不完整配置（provider 已选、model 未选）用警示色表达"还没配完"，绝不与已配置同色。
+       ".deg_pd_role[data-deg-role-state=incomplete] .deg_pd_role_state{color:var(--dsw-alias-state-warning-primary,var(--dsw-alias-label-secondary))}" +
+       ".deg_pd_providers{display:flex;align-items:flex-start;gap:10px;min-width:0;flex-wrap:wrap}" +
+       ".deg_pd_label{font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary);flex:0 0 auto}" +
+       ".deg_pd_providers_list{display:flex;align-items:flex-start;gap:6px;flex:1 1 auto;flex-wrap:wrap;min-width:0;max-width:100%}" +
+       ".deg_pd_tag{max-width:100%;box-sizing:border-box;font-size:11px;line-height:16px;padding:1px 6px;border:1px solid var(--dsw-alias-border-l2);border-radius:999px;color:var(--dsw-alias-label-primary);overflow-wrap:anywhere}" +
+       ".deg_pd_tag[data-deg-provider-known=false]{border-style:dashed;color:var(--dsw-alias-label-secondary)}" +
+       ".deg_pd_empty{font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary)}" +
+       ".deg_pd_status{font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary);margin:0;overflow-wrap:anywhere}" +
+       ".deg_pd_actions{display:flex;align-items:flex-start;gap:10px;flex-wrap:wrap;padding-top:2px}" +
+       ".deg_pd_actions .deg_pd_open{flex:0 0 auto;min-width:auto}" +
+       ".deg_pd_actions .deg_pd_open:hover:not(:disabled),.deg_pd_actions .deg_pd_open:focus-visible:not(:disabled){color:var(--dsw-alias-label-on-primary,var(--dsw-alias-bg-layer-1));background:var(--dsw-alias-interactive-bg-primary,var(--dsw-alias-label-primary));border-color:var(--dsw-alias-interactive-bg-primary,var(--dsw-alias-label-primary));filter:brightness(1.08)}" +
+       ".deg_pd_actions .deg_pd_open:focus-visible{outline:2px solid var(--dsw-alias-interactive-bg-primary,var(--dsw-alias-label-primary));outline-offset:2px}" +
+       ".deg_pd_actions .deg_pd_open:disabled{opacity:1;color:var(--dsw-alias-label-tertiary,var(--dsw-alias-label-secondary));background:transparent;border-color:var(--dsw-alias-border-l2)}" +
+       ".deg_pd_note{min-width:0;flex:1 1 220px;font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary);overflow-wrap:anywhere}" +
+       // 窄屏将状态移到 Provider/模型下一行，避免六角色被三列硬挤成不可读的省略号。
+       "@media (max-width:480px){.deg_pd_roles_header,.deg_pd_role{grid-template-columns:minmax(72px,auto) minmax(0,1fr);column-gap:8px}.deg_pd_roles_header{padding-top:5px}.deg_pd_roles_header span:last-child{grid-column:2;text-align:left}.deg_pd_role{align-items:start;row-gap:2px;padding:7px 0}.deg_pd_role_name{grid-row:1 / span 2;align-self:start}.deg_pd_role_value{white-space:normal;overflow-wrap:anywhere;text-overflow:clip}.deg_pd_role_state{grid-column:2;justify-self:start;text-align:left}}";
 
 
     const cssTagId = "dsh-expert-group/settings.module.css";
@@ -17534,6 +17577,476 @@ window.__ModuleLoader__.load({
       };
     }
 
+    // ── 插件详情（DSH 插件管理器的组合包页）上的 DEG 配置摘要 ────────────────
+    /**
+     * 组合包详情页的配置 slot 名与 key。
+     *
+     * DSH 的 ui-plugin-manager 把 `plugins.bundle.config` 声明为 keyed slot，以组合包的
+     * **npm 包名**为 key，并把 `view: 'page'` 渲染在组合包页面的描述与行之间——这正是
+     * 本插件详情摘要的落点。key 与 settings 分区 id 同值（profile 条目 id 就是包名），
+     * 因此复用同一份字面量，不新增第二处硬编码。
+     */
+    const DEG_PLUGIN_DETAIL_SLOT_NAME = "plugins.bundle.config";
+    const DEG_PLUGIN_DETAIL_ENTRY_KEY = DEG_SETTINGS_SECTION_ID;
+    /** 设置 Shell 的侧栏席位：openSection 能力句柄的唯一来源。 */
+    const DEG_SETTINGS_SIDEBAR_SLOT_NAME = "sidebar.settings";
+    /** DEG 自己注册的设置分区所在的 slot。 */
+    const DEG_SETTINGS_SECTION_SLOT_NAME = "settings.section";
+
+    /**
+     * 「打开 DEG 设置」各失败原因的用户可见提示。
+     *
+     * 每条都表达「为什么不能跳转」，且都不包含宿主异常原文（异常只按 open-failed 归类），
+     * 避免把宿主内部信息回显到界面上。
+     */
+    const DEG_SETTINGS_OPEN_FAILURE_TEXT = Object.freeze({
+      "slots-unavailable": "宿主未提供 slot 账本读取面，暂时无法跳转到 DEG 设置",
+      "sidebar-entry-missing": "未找到设置侧栏入口，暂时无法跳转到 DEG 设置",
+      "sidebar-entry-ambiguous": "设置侧栏入口不唯一，已停用跳转",
+      "store-missing": "设置侧栏入口缺少顶层导航 store，已停用跳转",
+      "open-section-missing": "设置侧栏入口缺少 openSection 动作，已停用跳转",
+      "section-missing": "DEG 设置分区尚未注册，暂时无法跳转",
+      "section-ambiguous": "DEG 设置分区注册重复，已停用跳转",
+      // 账本条目上的属性读取（entry/options/store/actions/create/instance.actions 的 getter）抛错：
+      // 归到同一类泛化提示，既不回显宿主异常原文，也不假装能力可用。
+      "ledger-unreadable": "Slot 账本读取异常，已停用跳转",
+      "open-failed": "打开 DEG 设置失败，请手动打开设置页",
+    });
+
+    /** 读一个 slot 的账本；宿主没有该读面或读面抛错时返回 null（调用方 fail-closed）。 */
+    function readSlotLedger(slots, name) {
+      try {
+        if (slots === null || typeof slots !== "object" || typeof slots.entries !== "function") return null;
+        const entries = slots.entries(name);
+        return Array.isArray(entries) ? entries : [];
+      } catch {
+        // 宿主替身 / 代理拒答：按"读不到账本"处理，绝不让摘要或设置页因此崩溃。
+        return null;
+      }
+    }
+
+    /**
+     * 从设置侧栏条目的 store 句柄里解析 openSection。
+     *
+     * DSH 的 ui-settings-general 用 `defineStore` 造 shell store，再以
+     * `{ ...handle, create: () => instance }` 的形式注册到 `sidebar.settings` 席位；DSH
+     * 0.2.0-rc.2 把它投影为条目的**顶层 `store`**（不是 `entry.options.store`）。句柄本身
+     * 没有 actions，实例（`create()` 的返回值，且恒为同一份壳实例）才带 `actions`。
+     * 因此这里按「句柄 → 实例 → actions」解析，并兼容直接把 actions 挂在 store 上的形态。
+     * 只有 `store.create()` 的**调用**在本函数内捕获（返回 null → open-section-missing）；
+     * 属性 getter 抛错（store.actions / store.create / instance.actions / actions.openSection）
+     * 刻意向外抛出，由调用方归到 ledger-unreadable 这一类——两种失败类别不能混为一谈。
+     * 任一环节缺失都不猜、不回退到别的动作。
+     */
+    function resolveSettingsShellOpenSection(store) {
+      if (store === null || typeof store !== "object") return null;
+      const direct = store.actions;
+      if (direct !== null && typeof direct === "object" && typeof direct.openSection === "function") {
+        return direct.openSection.bind(direct);
+      }
+      if (typeof store.create !== "function") return null;
+      let instance = null;
+      try {
+        instance = store.create();
+      } catch {
+        return null;
+      }
+      const actions = instance?.actions;
+      if (actions === null || typeof actions !== "object" || typeof actions.openSection !== "function") return null;
+      return actions.openSection.bind(actions);
+    }
+
+    /**
+     * 「打开 DEG 设置」的严格能力适配器。
+     *
+     * 当前 DSH 不提供公开的设置分区跳转 API，唯一可达的链路是设置 Shell 注册在
+     * `sidebar.settings` 席位上的 store 句柄（**未文档化的宿主内部句柄**，用户已确认接受
+     * 该兼容风险）。本函数是本插件里**唯一**接触该句柄的地方，调用方只拿到一个已经验证过的
+     * openSection 函数。
+     *
+     * 每次调用都重新读取账本（组件每帧渲染、每次点击都会再读一次），因此 HMR 或面板重挂载
+     * 换掉 store 后不会继续调用旧句柄；任何一项校验不过都 fail-closed 并给出原因：
+     * - 宿主缺少 `slots.entries` 读面 / 读面抛错 → slots-unavailable；
+     * - 账本条目属性 getter 抛错（entry.options / **entry.store** / store.actions / store.create /
+     *   instance.actions / actions.openSection）→ ledger-unreadable（同一类泛化提示）；
+     * - `sidebar.settings` 没有条目 → sidebar-entry-missing；多于一条 → sidebar-entry-ambiguous；
+     * - 条目**顶层**缺少 store（entry.store 非对象）→ store-missing；
+     *   store 解不出 openSection → open-section-missing
+     *   （含 `store.create()` 调用抛错这一既有覆盖）；
+     * - DEG 自己的 `settings.section` 注册缺失 → section-missing；重复 → section-ambiguous。
+     * 最后一项保证按钮不会把用户送到一个不存在的分区。
+     *
+     * @param {object} ctx 客户端插件上下文。
+     * @returns {{available: boolean, reason: string|null, message: string|null, openSection: (Function|null)}}
+     */
+    function resolveDegSettingsSectionOpener(ctx) {
+      const unavailable = (reason) => ({
+        available: false,
+        reason,
+        message: DEG_SETTINGS_OPEN_FAILURE_TEXT[reason],
+        openSection: null,
+      });
+      let slots = null;
+      try {
+        slots = ctx?.slots ?? null;
+      } catch {
+        slots = null;
+      }
+      const sectionEntries = readSlotLedger(slots, DEG_SETTINGS_SECTION_SLOT_NAME);
+      const sidebarEntries = readSlotLedger(slots, DEG_SETTINGS_SIDEBAR_SLOT_NAME);
+      if (sectionEntries === null || sidebarEntries === null) return unavailable("slots-unavailable");
+      // 账本读取整段护栏：Host 的账本条目可能是代理对象，甚至 slots.entries 可以返回
+      // Array.isArray 为真的**数组代理**。因此不只是 entry.options / entry.store 的 getter，
+      // 数组自身的 length 与下标读取也可能抛错——它们必须一起归到同一类 fail-closed，
+      // 绝不让一次渲染或一次点击把摘要打崩。
+      let ownSectionCount = 0;
+      let sidebarLength = 0;
+      try {
+        ownSectionCount = sectionEntries.filter((entry) => entry?.options?.id === DEG_SETTINGS_SECTION_ID).length;
+        sidebarLength = sidebarEntries.length;
+      } catch {
+        return unavailable("ledger-unreadable");
+      }
+      if (ownSectionCount === 0) return unavailable("section-missing");
+      if (ownSectionCount > 1) return unavailable("section-ambiguous");
+      if (sidebarLength === 0) return unavailable("sidebar-entry-missing");
+      if (sidebarLength > 1) return unavailable("sidebar-entry-ambiguous");
+      let store = null;
+      let openSection = null;
+      try {
+        // DSH 0.2.0-rc.2 的 StoredEntry 把 store 放在**条目顶层**（entry.store）；
+        // entry.options 只承载 key/order/label/priority，读 options.store 只会拿到 undefined。
+        store = sidebarEntries[0]?.store;
+        if (store !== null && store !== undefined && typeof store === "object") {
+          openSection = resolveSettingsShellOpenSection(store);
+        }
+      } catch {
+        // entry.store / actions / create / instance.actions 的 getter 抛错：与"字段缺失"分开，
+        // 统一报账本读取异常（泛化提示，不回显宿主异常原文）。
+        return unavailable("ledger-unreadable");
+      }
+      if (store === null || store === undefined || typeof store !== "object") return unavailable("store-missing");
+      if (openSection === null) return unavailable("open-section-missing");
+      return { available: true, reason: null, message: null, openSection };
+    }
+
+    /**
+     * 插件详情摘要的角色状态投影（与设置页的 `useEnabledSettingsRoles` **刻意分离**）。
+     *
+     * 设置页在 meta 缺失时回退历史默认五角色是既有行为，摘要不能借它：meta 没读到就不知道谁在跑，
+     * 猜错会把未启用角色的 provider 写进"活跃 Provider"汇总，比留白更糟。因此只在 Host meta
+     * **成功返回且带有效 activeRoles/roles 数组**时才认定启用角色；Observer 仍按 enableObserver
+     * 合并（与设置页同一规则）。返回的 status 只表达"读到/读取中/不可用"三种事实。
+     *
+     * @param {object|null} hostMeta Host meta 响应体（useHostMeta 只在 ok:true 时落值）。
+     * @param {string|null} hostMetaError 读取失败原因；仅用于区分"读取中"与"不可用"，不回显。
+     * @returns {{status: "loading"|"ready"|"unavailable", roles: string[]|null}}
+     */
+    function resolvePluginDetailRoleStatus(hostMeta, hostMetaError) {
+      if (hostMeta === null && hostMetaError === null) return { status: "loading", roles: null };
+      const configured = hostMeta !== null && typeof hostMeta === "object"
+        ? (Array.isArray(hostMeta.activeRoles) ? hostMeta.activeRoles : (Array.isArray(hostMeta.roles) ? hostMeta.roles : null))
+        : null;
+      if (configured === null) return { status: "unavailable", roles: null };
+      const enabled = configured.filter((role) => STATUS_ROLE_IDS.includes(role));
+      if (hostMeta.enableObserver === true && !enabled.includes("observer")) enabled.push("observer");
+      return { status: "ready", roles: enabled.filter((role, index) => enabled.indexOf(role) === index) };
+    }
+
+    /**
+     * 插件详情摘要的纯投影（界面与测试共用同一实现）。
+     *
+     * 输入只有已经读到的快照，不触发任何请求：
+     * @param {object} [input]
+     * @param {"ready"|"loading"|"unavailable"} [input.settingsStatus] 配置表单快照状态。
+     * @param {object} [input.settingsValue] 配置表单值（`defaults[role] = { provider, model }`）。
+     * @param {string} [input.catalogStatus] 模型目录状态（ready 之外的取值一律按"目录不可用"）。
+     * @param {object[]} [input.catalogGroups] 模型目录 groups（`{ id, name }`）。
+     * @param {string[]|null} [input.enabledRoles] 当前启用角色；null 表示角色表尚未读到。
+     * @param {"ready"|"loading"|"unavailable"} [input.roleStatus] 角色表读取结论（见
+     *   resolvePluginDetailRoleStatus）；缺省时按 enabledRoles 是否为数组推断。
+     * @returns {{settingsStatus: string, roleStatus: string, statusText: string|null, roles: object[], activeProviders: object[], providerIds: string[], activeProviderText: string}}
+     *
+     * 角色状态判定顺序（前者优先）：
+     * 1. 配置未就绪 → loading（文案区分"配置不可用"与"读取中"）；
+     * 2. 角色表仍在读取 → loading；
+     * 3. 角色表不可用（meta 失败/缺字段）→ unknown，不猜启用状态；
+     * 4. 角色未启用 → disabled；
+     * 5. 没有 provider 选择 → unconfigured；
+     * 6. provider 已选但 model 为空（不完整配置）→ incomplete，不算"正在使用"；
+     * 7. 其余（provider + model 都非空）→ configured。
+     * 活跃 provider 只取「启用角色且 provider、model 都非空」的集合，按角色顺序去重；目录缺失或
+     * 目录里没有该 id 时保留原始 id 并标记 `known: false`，绝不用目录里的其它 provider 冒充。
+     */
+    function describeDegPluginDetailSummary(input = {}) {
+      const settingsStatus = typeof input.settingsStatus === "string" ? input.settingsStatus : "loading";
+      const settingsValue = input.settingsValue;
+      const catalogReady = input.catalogStatus === "ready";
+      const catalogGroups = catalogReady && Array.isArray(input.catalogGroups) ? input.catalogGroups : [];
+      const enabledRoles = Array.isArray(input.enabledRoles) ? input.enabledRoles : null;
+      const requestedRoleStatus = input.roleStatus === "ready" || input.roleStatus === "unavailable" || input.roleStatus === "loading"
+        ? input.roleStatus
+        : (enabledRoles === null ? "loading" : "ready");
+      // "已读到"却没有角色数组是矛盾输入（调用方读错了面）：按不可用处理，
+      // 绝不当成"全部未启用"——后者会把未确认的默认角色配置从汇总里静默剔除。
+      const roleStatus = requestedRoleStatus === "ready" && enabledRoles === null ? "unavailable" : requestedRoleStatus;
+      const settingsPending = settingsStatus !== "ready";
+      const defaults = settingsValue !== null && typeof settingsValue === "object" ? settingsValue.defaults : null;
+
+      const providerInfoOf = (providerId) => {
+        if (providerId.length === 0) return { label: "", known: false };
+        const group = catalogGroups.find((candidate) => candidate?.id === providerId);
+        const name = typeof group?.name === "string" && group.name.trim().length > 0 ? group.name : "";
+        // 目录拿不到显示名（目录缺失 / 目录不含该 id / name 为空）时保留原始 id 并标注未知。
+        return name.length > 0 ? { label: name, known: true } : { label: providerId, known: false };
+      };
+
+      const roles = [];
+      const activeProviders = [];
+      const seenProviders = new Set();
+      for (const role of STATUS_ROLE_IDS) {
+        const selection = defaults !== null && typeof defaults === "object" ? defaults[role] : null;
+        const provider = typeof selection?.provider === "string" && selection.provider.length > 0 ? selection.provider : "";
+        const model = typeof selection?.model === "string" ? selection.model : "";
+        const { label: providerLabel, known: providerKnown } = providerInfoOf(provider);
+        const enabledKnown = roleStatus === "ready";
+        const enabled = enabledKnown && enabledRoles.includes(role) === true;
+        let state;
+        if (settingsPending || roleStatus === "loading") state = "loading";
+        else if (roleStatus === "unavailable") state = "unknown";
+        else if (enabled !== true) state = "disabled";
+        else if (provider.length === 0) state = "unconfigured";
+        else if (model.length === 0) state = "incomplete";
+        else state = "configured";
+        let stateText;
+        if (state === "loading") stateText = settingsStatus === "unavailable" ? "配置不可用" : "读取中";
+        else if (state === "unknown") stateText = "角色状态未知";
+        else if (state === "disabled") stateText = "未启用";
+        else if (state === "unconfigured") stateText = "未配置";
+        else if (state === "incomplete") stateText = "待选模型";
+        else stateText = "已配置";
+        if (state === "configured" && seenProviders.has(provider) !== true) {
+          seenProviders.add(provider);
+          activeProviders.push({ id: provider, label: providerLabel, known: providerKnown });
+        }
+        roles.push({
+          role,
+          label: STATUS_ROLE_LABELS[role] ?? role,
+          enabled,
+          state,
+          stateText,
+          provider,
+          providerLabel,
+          providerKnown,
+          model,
+          // 角色行的 provider/model 展示面：没有 provider 时留空，由状态文案表达未配置。
+          valueText: provider.length === 0 ? "" : (model.length > 0 ? providerLabel + " / " + model : providerLabel),
+        });
+      }
+      // 卡片级状态行：只表达"读到/读取中/不可用"，绝不回显 Host 或 RPC 的错误原文。
+      const statusText = settingsStatus === "unavailable"
+        ? "配置表单不可用，无法读取角色配置。"
+        : (settingsStatus !== "ready"
+          ? "配置读取中…"
+          : (roleStatus === "loading"
+            ? "角色状态读取中…"
+            : (roleStatus === "unavailable" ? "角色状态不可用，已停用活跃角色判定。" : null)));
+      const providerIds = activeProviders.map((provider) => provider.id);
+      return {
+        settingsStatus,
+        roleStatus,
+        statusText,
+        roles,
+        activeProviders,
+        providerIds,
+        activeProviderText: activeProviders.length === 0
+          ? "无"
+          : activeProviders.map((provider) => provider.label).join("、"),
+      };
+    }
+
+    /**
+     * 插件详情摘要卡片：六角色表 + 活跃 provider + 真实设置跳转入口。
+     *
+     * 数据面全部来自公开 seam：配置表单（只读订阅）、模型目录（显示名），以及 Host meta
+     * （活跃角色，与设置页同一个只读请求）。跳转能力每帧重算（见
+     * resolveDegSettingsSectionOpener），点击时再算一次；调用抛异常时立即翻转成禁用，
+     * 绝不把失败显示成成功，也绝不改成打开组合包详情。
+     */
+    function DegPluginDetailSummary({ settingsForm, modelCatalog, ctx }) {
+      const subscribeSettings = react.useMemo(
+        () => (typeof settingsForm?.subscribe === "function" ? settingsForm.subscribe.bind(settingsForm) : () => () => {}),
+        [settingsForm],
+      );
+      const readSettings = react.useMemo(
+        () => (typeof settingsForm?.getSnapshot === "function" ? settingsForm.getSnapshot.bind(settingsForm) : () => void 0),
+        [settingsForm],
+      );
+      const settingsSnapshot = react.useSyncExternalStore(subscribeSettings, readSettings);
+      const subscribeCatalog = react.useMemo(
+        () => (typeof modelCatalog?.subscribe === "function" ? modelCatalog.subscribe.bind(modelCatalog) : () => () => {}),
+        [modelCatalog],
+      );
+      const readCatalog = react.useMemo(
+        () => (typeof modelCatalog?.getSnapshot === "function" ? modelCatalog.getSnapshot.bind(modelCatalog) : () => void 0),
+        [modelCatalog],
+      );
+      const catalogState = react.useSyncExternalStore(subscribeCatalog, readCatalog);
+      // 只读一次 meta：活跃角色与设置页共用同一个请求，摘要不额外新增 RPC 形状。
+      // 摘要刻意**不用**设置页的 useEnabledSettingsRoles：那条路径在 meta 缺失时会回退历史默认
+      // 五角色（设置页既有行为，保持不变），而摘要一旦跟着回退就会把未确认启用角色的 provider
+      // 写进"活跃 Provider"。这里只认 meta 的成功响应，其余情况显式标未知。
+      const [hostMeta, , hostMetaError] = useHostMeta(ctx);
+      const roleStatus = react.useMemo(
+        () => resolvePluginDetailRoleStatus(hostMeta, hostMetaError),
+        [hostMeta, hostMetaError],
+      );
+      const [failure, setFailure] = react.useState(null);
+      react.useEffect(() => {
+        // 目录调用是幂等的单飞请求，且与设置页共享同一实例：这里只为拿到 provider 显示名。
+        try {
+          void modelCatalog?.load?.();
+        } catch {
+          // 目录读取失败只影响显示名：原始 id 的回退路径照常工作。
+        }
+      }, [modelCatalog]);
+      const model = describeDegPluginDetailSummary({
+        settingsStatus: typeof settingsSnapshot?.status === "string" ? settingsSnapshot.status : "loading",
+        settingsValue: settingsSnapshot?.value,
+        catalogStatus: typeof catalogState?.status === "string" ? catalogState.status : "idle",
+        catalogGroups: catalogState?.groups,
+        roleStatus: roleStatus.status,
+        enabledRoles: roleStatus.roles,
+      });
+      const capability = resolveDegSettingsSectionOpener(ctx);
+      const noteText = failure?.message ?? (capability.available === true ? null : capability.message);
+      const noteReason = failure?.reason ?? (capability.available === true ? null : capability.reason);
+      /**
+       * 点击处理：同步异常与异步拒绝都必须 fail-closed（禁用 + open-failed 提示）。
+       *
+       * 三段路径的边界：
+       * 1. **同步返回**（当前 Host 的真实形态）：调用后立刻清提示并返回 undefined——
+       *    绝不把同步路径包进 `Promise.resolve().then(...)`，那会给非 Promise 返回值平白加一次
+       *    微任务延迟，也让点击的返回类型从 undefined 变成 Promise；
+       * 2. **同步抛错**：按 open-failed 处理；
+       * 3. **thenable（Promise/rejected Promise）**：只有真正的 thenable 才挂结算回调，且**在同一个
+       *    tick 内**挂上 rejection 处理——否则未处理的 rejection 会冒到宿主页面，按钮还会错误地
+       *    停在"看起来可用"的状态。成功结算不清提示：成功路径已经在第 1 步清过，而"后到的拒绝
+       *    覆盖先到的成功"必须保持（fail-closed 只允许更保守，不允许被迟到的成功解锁）。
+       * 任何一步失败都绝不回退到 openBundle 之类的替代动作。
+       */
+      const openSettings = () => {
+        // 点击时重新读取：首帧渲染之后账本可能已经变化（HMR / 面板重挂载）。
+        const current = resolveDegSettingsSectionOpener(ctx);
+        if (current.available !== true) {
+          setFailure({ reason: current.reason, message: current.message });
+          return;
+        }
+        const failClosed = () => {
+          setFailure({ reason: "open-failed", message: DEG_SETTINGS_OPEN_FAILURE_TEXT["open-failed"] });
+        };
+        let result;
+        try {
+          result = current.openSection(DEG_SETTINGS_SECTION_ID);
+        } catch {
+          failClosed();
+          return;
+        }
+        setFailure(null);
+        // 只对对象/函数探 then：原始值（undefined/void 返回值）连属性读取都不需要。
+        if (result === null || (typeof result !== "object" && typeof result !== "function")) return;
+        let then = null;
+        try {
+          then = result.then;
+        } catch {
+          // then 读取本身抛错的畸形 thenable：按调用失败处理，不当成功。
+          failClosed();
+          return;
+        }
+        if (typeof then !== "function") return;
+        try {
+          then.call(result, undefined, failClosed);
+        } catch {
+          failClosed();
+        }
+      };
+      return react.createElement(
+        "section",
+        { className: "deg_pd", "data-deg-plugin-summary": "true", "aria-label": "DEG 配置摘要" },
+        react.createElement("h4", { className: "deg_pd_title" }, "DEG 配置摘要"),
+        react.createElement(
+          "div",
+          { className: "deg_pd_providers" },
+          react.createElement("span", { className: "deg_pd_label" }, "活跃角色使用的 Provider"),
+          react.createElement("span", {
+            className: "deg_pd_providers_list",
+            "data-deg-active-providers": model.providerIds.join("|"),
+          }, model.activeProviders.length === 0
+            ? react.createElement("span", { className: "deg_pd_empty" }, model.activeProviderText)
+            : model.activeProviders.map((provider) => react.createElement("span", {
+              key: provider.id,
+              className: "deg_pd_tag",
+              "data-deg-active-provider": provider.id,
+              "data-deg-provider-known": provider.known ? "true" : "false",
+              // 目录缺失或目录不含该 id 时的状态标注：保留原始 id，并说明为什么没有显示名。
+              title: provider.known ? undefined : "模型目录未提供该 provider 的显示名，显示原始 id",
+              "aria-label": provider.known ? undefined : provider.label + "（未知 Provider）",
+            }, provider.label))),
+        ),
+        react.createElement("div", {
+          className: "deg_pd_roles_header",
+          "aria-hidden": "true",
+        },
+          react.createElement("span", null, "角色"),
+          react.createElement("span", null, "Provider / 模型"),
+          react.createElement("span", null, "状态"),
+        ),
+        react.createElement("ul", {
+          className: "deg_pd_roles",
+          "aria-label": "六个角色的 Provider、模型和配置状态",
+          "data-deg-roles": model.roles.map((role) => role.role).join(","),
+        }, model.roles.map((role) => react.createElement(
+          "li",
+          {
+            key: role.role,
+            className: "deg_pd_role",
+            "data-deg-role": role.role,
+            "data-deg-role-state": role.state,
+            "data-deg-role-provider": role.provider,
+            "data-deg-role-model": role.model,
+          },
+          react.createElement("span", { className: "deg_pd_role_name" }, role.label),
+          react.createElement("span", { className: "deg_pd_role_value", title: role.valueText || undefined }, role.valueText),
+          react.createElement("span", { className: "deg_pd_role_state" }, role.stateText),
+        ))),
+        model.statusText === null ? null : react.createElement("p", {
+          className: "deg_pd_status",
+          role: "status",
+          // 角色状态结论（loading/ready/unavailable）的稳定标记：文案是可读面，这里给测试与自动化。
+          "data-deg-role-status": model.roleStatus,
+        }, model.statusText),
+        react.createElement(
+          "div",
+          { className: "deg_pd_actions" },
+          react.createElement("button", {
+            type: "button",
+            className: "deg_btn deg_btn_primary deg_pd_open",
+            "data-deg-open-settings": "true",
+            disabled: capability.available !== true || failure !== null,
+            "aria-describedby": noteText === null ? undefined : "deg-pd-open-note",
+            onClick: openSettings,
+          }, "打开 DEG 设置"),
+          noteText === null ? null : react.createElement("span", {
+            id: "deg-pd-open-note",
+            className: "deg_pd_note",
+            role: "status",
+            "data-deg-open-note": noteReason,
+          }, noteText),
+        ),
+      );
+    }
+
+
     // ── 插件主体：注册设置页与状态/元数据桥（通知由 Host 投递，客户端不挂载通知组件）。
     function apply(ctx) {
       ctx.effect(() => installImageSubmissionRoute(ctx), "dsh-expert-group: image submission route");
@@ -17604,15 +18117,21 @@ window.__ModuleLoader__.load({
       // describe 面唯一来源是 configForms.describe()；服务缺失时传 null，该区域降级为只读提示。
       const modelConfigHost = createModelConfigHost(ctx, configForms);
       // 独立设置页由插件注册到 Host 的 settings.section ledger，导航和生命周期仍由设置 Shell 管理。
-      slots.inject("settings.section", () => slots.register({
-        name: "settings.section",
+      slots.inject(DEG_SETTINGS_SECTION_SLOT_NAME, () => slots.register({
+        name: DEG_SETTINGS_SECTION_SLOT_NAME,
         id: SETTINGS_ENTRY_ID,
         order: 25,
         label: () => SETTINGS_ENTRY_ID,
         inject: () => ({ settingsForm, modelCatalog, modelConfigHost, ctx }),
       }, DshExpertGroupSettings));
 
-
+      // 插件详情摘要挂在插件管理器的组合包页上：keyed slot，key 必须是组合包的 npm 包名。
+      // 摘要只读（配置表单 + 模型目录 + meta），入口按钮走严格能力适配器真实跳转设置分区。
+      slots.inject(DEG_PLUGIN_DETAIL_SLOT_NAME, () => slots.register({
+        name: DEG_PLUGIN_DETAIL_SLOT_NAME,
+        key: DEG_PLUGIN_DETAIL_ENTRY_KEY,
+        inject: () => ({ settingsForm, modelCatalog, ctx }),
+      }, DegPluginDetailSummary));
 
       // shell.overlay 只保留原生子代理行元数据；
       // fan-out 的可见控制面迁入 Expert Group，避免固定浮层与右侧任务树重复。
@@ -17843,6 +18362,17 @@ window.__ModuleLoader__.load({
      * - isDegSettingsNavRow：导航行的匹配纯逻辑（label 严格相等 + 含 svg）；
      * - installDegSettingsNavIcon：observer 生命周期，apply 用 ctx.effect 绑定它。
      */
+    /**
+     * 插件详情摘要的公开面：
+     * - describeDegPluginDetailSummary：六角色 / 活跃 provider 的纯投影（界面与测试共用同一实现）；
+     * - resolveDegSettingsSectionOpener：唯一一处接触 Host 内部 sidebar.settings store 句柄的
+     *   严格能力适配器（未文档化方案，用户已确认接受兼容风险）；
+     * - DEG_PLUGIN_DETAIL_SLOT_NAME / DEG_PLUGIN_DETAIL_ENTRY_KEY：注册契约常量。
+     */
+    exports.describeDegPluginDetailSummary = describeDegPluginDetailSummary;
+    exports.resolveDegSettingsSectionOpener = resolveDegSettingsSectionOpener;
+    exports.DEG_PLUGIN_DETAIL_SLOT_NAME = DEG_PLUGIN_DETAIL_SLOT_NAME;
+    exports.DEG_PLUGIN_DETAIL_ENTRY_KEY = DEG_PLUGIN_DETAIL_ENTRY_KEY;
     exports.DEG_SETTINGS_NAV_ICON_PATHS = DEG_SETTINGS_NAV_ICON_PATHS;
     exports.DEG_SETTINGS_NAV_ICON_FALLBACK_PATHS = DEG_SETTINGS_NAV_ICON_FALLBACK_PATHS;
     exports.isDegSettingsNavRow = isDegSettingsNavRow;