@menghuan1918/dsh-apollo 0.6.4 → 0.6.5

package/README.md

@@ -90,13 +90,13 @@ flowchart TB
 
 ```sh
 # npm 安装（发布后）
-dsh plugin --profile <profile> add @menghuan1918/dsh-apollo@0.6.4
+dsh plugin --profile <profile> add @menghuan1918/dsh-apollo@0.6.5
 
 # 或从 GitHub main 源码安装（备选）
 dsh plugin --profile <profile> add github:Menghuan1918/dsh-apollo
 ```
 
-> **发布状态**：Apollo `0.6.4` 与 `dsh-better-ask-user@0.1.6` 已发布；`dsh-better-ptc@0.1.0` 已发布。提交的 manifest 使用精确 npm 版本，**没有** `file:` / `link:` / Git 说明符。发布顺序见[发布顺序](#发布顺序)。
+> **发布状态**：Apollo `0.6.5` 与 `dsh-better-ask-user@0.1.7` 的本地修复与隔离安装验证已完成，npm 发布待确认；`dsh-better-ptc@0.1.0` 已发布。提交的 manifest 使用精确 npm 版本，**没有** `file:` / `link:` / Git 说明符。发布顺序见[发布顺序](#发布顺序)。
 
 安装、升级或换包都会改变运行的代码，必须重启对应 profile 的 DSH 进程；只刷新网页不够。目标行、子代理行、压缩行、共享 PTC 行与 ask-user 行由 Apollo 的 bundle patch 插入，不需要再单独 `add` 五个子包。
 
@@ -106,7 +106,7 @@ dsh plugin --profile <profile> add github:Menghuan1918/dsh-apollo
 
 ```sh
 dsh plugin --profile <profile> remove dsh-apollo
-dsh plugin --profile <profile> add @menghuan1918/dsh-apollo@0.6.4
+dsh plugin --profile <profile> add @menghuan1918/dsh-apollo@0.6.5
 ```
 
 > `dsh-apollo` 只是旧入口名；unscoped 的 `dsh-apollo` 已被其他项目占用，不要从 npm 安装它。
@@ -180,7 +180,7 @@ dsh plugin --profile <profile> add @menghuan1918/dsh-better-subagent@0.1.0
 dsh plugin --profile <profile> add dsh-better-compact@0.1.1
 
 # 只装提问增强（同时需要共享 PTC 行）
-dash plugin --profile <profile> add dsh-better-ask-user@0.1.6 dsh-better-ptc@0.1.0
+dash plugin --profile <profile> add dsh-better-ask-user@0.1.7 dsh-better-ptc@0.1.0
 ```
 
 独立安装时的行、页面和提示词与 Apollo 集成完全相同；行 id/name 也是同一组稳定值。区别只在**由谁插入这些行**：Apollo 的 bundle patch 自己携带同样的行，因为 DSH 不会自动应用传递依赖的 bundle patch。
@@ -235,7 +235,7 @@ dsh plugin --profile <profile> remove dsh-better-compact
 - `package.json` 的 `files` 只列入 `docs/DEVELOPMENT.md`，并额外用 [.npmignore](.npmignore) 排除 `docs/specs/`；
 - `tests/packaging.test.mjs` 直接运行 `npm pack --dry-run --json`，断言发布清单没有 Specs、测试、脚本、快照或 tarball。
 
-发布顺序：**先发布并验证五个独立包（`dsh-better-ask-user@0.1.6`、`dsh-better-ptc@0.1.0`、`@menghuan1918/dsh-better-subagent@0.2.0`、`dsh-better-goal@0.2.1`、`dsh-better-compact@0.1.2`），再发布 Apollo 0.6.4**。Apollo 的精确依赖指向尚不存在的版本时，`npm install` 会失败；不要用开发 `file:`/`link:` 依赖发布。各子仓各自有 trusted publishing workflow；Apollo 的 [release workflow](.github/workflows/release.yml) 只发布本包。
+发布顺序：**先发布并验证五个独立包（`dsh-better-ask-user@0.1.7`、`dsh-better-ptc@0.1.0`、`@menghuan1918/dsh-better-subagent@0.2.0`、`dsh-better-goal@0.2.1`、`dsh-better-compact@0.1.2`），再发布 Apollo 0.6.5**。Apollo 的精确依赖指向尚不存在的版本时，`npm install` 会失败；不要用开发 `file:`/`link:` 依赖发布。各子仓各自有 trusted publishing workflow；Apollo 的 [release workflow](.github/workflows/release.yml) 只发布本包。
 
 ## 验证状态（诚实记录）
 
@@ -248,7 +248,7 @@ dsh plugin --profile <profile> remove dsh-better-compact
 
 **未验证 / 明确限制**：
 
-- 五个独立包与 Apollo 的 0.6.4 配套版本均已发布；临时 profile 验证通过。
+- 0.6.5 与 ask-user 0.1.7 的本地修复及隔离安装验证通过；实际 npm 发布待确认。
 - 未修改或重启用户当前运行的 profile，未验证当前 GUI（`http://127.0.0.1:3384`）的设置页/卡片；S3 视觉设置页的 GUI 验收归 S3/最终宿主验收。
 - 未运行真实 Codex/Claude CLI 的真实模型回合（那属于两个子包自己的验证；Apollo 侧本轮只用脚本化适配器）。
 - 真实模型摘要保真、缓存命中率与跨版本预设漂移仍需按实际环境复验。

package/docs/DEVELOPMENT.md

@@ -2,7 +2,7 @@
 
 面向维护者、集成者和需要排查装配问题的用户。用户安装与配置请看 [README](../README.md)；本文保留 DSH 插件的实现细节、旧配置迁移、组合安装边界与验证方法。
 
-当前实现版本：`0.6.4`；npm 包名是 `@menghuan1918/dsh-apollo`。纯 ESM，无构建步骤；宿主浏览器半边是直接加载的闭包工厂。
+当前实现版本：`0.6.5`；npm 包名是 `@menghuan1918/dsh-apollo`。纯 ESM，无构建步骤；宿主浏览器半边是直接加载的闭包工厂。
 
 ## 目录
 
@@ -36,7 +36,7 @@
 | `dsh-better-goal` | `0.2.1` | 目标域（`questionTimeoutSeconds` 已弃用、仅保留读取） |
 | `@menghuan1918/dsh-better-subagent` | `0.2.0` | 子代理 CLI/等待/child guard/分档/设置页；注册 `wait_subagent` PTC 豁免 |
 | `dsh-better-compact` | `0.1.2` | 压缩 companion + engine + 设置页/诊断 |
-| `dsh-better-ask-user` | `0.1.6` | 官方 `ask_user_question` 入参/返回 + 插件超时等待 + 历史预览行；注册 PTC 豁免；旧 goal 等待迁移 |
+| `dsh-better-ask-user` | `0.1.7` | 官方 `ask_user_question` 入参/返回 + 插件超时等待 + 历史预览行；注册 PTC 豁免；旧 goal 等待迁移 |
 | `dsh-better-ptc` | `0.1.0` | 单例 PTC deadline 豁免服务 |
 | `@deepseek-ai/schemastery` | `~3.18.4` | Apollo 行 Config |
 | `react` | peer | 宿主提供 |
@@ -318,10 +318,10 @@ DSH_PACKAGE_ROOT="/…/node_modules/@deepseek-ai/dsh" npm run prompts
 ### npm 安装
 
 ```sh
-dsh plugin --profile <profile> add @menghuan1918/dsh-apollo@0.6.4
+dsh plugin --profile <profile> add @menghuan1918/dsh-apollo@0.6.5
 ```
 
-包发布后即可用此命令安装，并带入五个精确依赖、应用三份 bundle patch。安装后需要重启对应 profile 的 DSH 进程。0.6.4 与 ask-user 0.1.6 已发布，临时 profile 验证通过。
+包发布后即可用此命令安装，并带入五个精确依赖、应用三份 bundle patch。安装后需要重启对应 profile 的 DSH 进程。0.6.5 与 ask-user 0.1.7 的本地修复及隔离安装验证通过；实际 npm 发布待确认。
 
 ### GitHub 源码安装
 
@@ -376,9 +376,9 @@ dsh plugin --profile <profile> remove @menghuan1918/dsh-apollo
 
 两个子仓和 Apollo 都用 GitHub Release 触发 `.github/workflows/release.yml`，通过 npm trusted publishing（OIDC）发布，仓库里不存 npm token。tag 必须是 `v<package.json 的 version>`，CI 会先校验再跑测试和 `npm publish --provenance`。
 
-1. 先发布 `dsh-better-ptc@0.1.0`、`dsh-better-ask-user@0.1.6`、`@menghuan1918/dsh-better-subagent@0.2.0`、`dsh-better-goal@0.2.1`、`dsh-better-compact@0.1.2`（各自仓库的 Release）；
+1. 先发布 `dsh-better-ptc@0.1.0`、`dsh-better-ask-user@0.1.7`、`@menghuan1918/dsh-better-subagent@0.2.0`、`dsh-better-goal@0.2.1`、`dsh-better-compact@0.1.2`（各自仓库的 Release）；
 2. 在官方 registry（`https://registry.npmjs.org/`）确认五个版本可取得、可安装；
-3. 再把 Apollo 的精确依赖指向已发布版本，推 main 并发布 Apollo Release（本轮为 `v0.6.4`）；
+3. 再把 Apollo 的精确依赖指向已发布版本，推 main 并发布 Apollo Release（本轮为 `v0.6.5`）；
 4. 子包版本可取得前，不要把指向它们的精确依赖推到 Apollo main，否则 `npm install` / GitHub 源码安装会 404。
 
 ## 测试与冒烟

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@menghuan1918/dsh-apollo",
-  "version": "0.6.4",
+  "version": "0.6.5",
   "description": "DSH plugin bundle: workflow skills, engineering presets, independent better-goal / better-subagent / better-compact / better-ask-user integration, and a minimal job exit guard. Pure ESM, no build step.",
   "license": "GPL-3.0-or-later",
   "repository": {
@@ -55,7 +55,7 @@
   "dependencies": {
     "@deepseek-ai/schemastery": "~3.18.4",
     "@menghuan1918/dsh-better-subagent": "0.2.0",
-    "dsh-better-ask-user": "0.1.6",
+    "dsh-better-ask-user": "0.1.7",
     "dsh-better-compact": "0.1.2",
     "dsh-better-goal": "0.2.1",
     "dsh-better-ptc": "0.1.0"

package/src/client.js

@@ -1,17 +1,23 @@
 /**
- * dsh-apollo (npm: @menghuan1918/dsh-apollo) — 浏览器半边：官方 Plugins 页的最小行配置页。
+ * dsh-apollo (npm: @menghuan1918/dsh-apollo) — 浏览器半边。
  *
- * 0.5.0 起 Apollo 只保留两件事需要网页入口：
- *   - `exitGuard`：运行中**后台 job** 的退出守卫开关（volatile，保存即生效）；
- *   - 迁移/弃用说明：CLI 子代理、模型分档、运行中子代理守卫与压缩设置分别由
- *     `@menghuan1918/dsh-better-subagent` 与 `dsh-better-compact` 的行拥有。
- *     Apollo 的旧字段仍能装载（供一次性迁移读取），但不再作为可编辑的子代理设置。
+ * 两块 UI：
  *
- * 本文件注册 `plugins.row.config`（键 `<npm 包名>#apollo-skills`，与
- * src/config.js 的 ROW_CONFIG_KEY/LEGACY_ROW_CONFIG_KEY 同步），自画紧凑表单并只在
- * 保存时一次提交全部改动。零构建：closure factory，只 require('react')，不 import
- * 任何 DSH client 包；样式随组件树内一个 <style> 渲染（不写 DOM）。注册 id 必须等于
- * npm 包名（client closure id）。不注册新插件的页面键——那些由各自的包拥有。
+ * 1. **行配置页**（`plugins.row.config`，键 `<包名>#apollo-skills`）：后台任务
+ *    `exitGuard` 开关 + 迁移/弃用说明。保存即生效（volatile），写入当前
+ *    profile 的行配置（cordis.patch.yml）。
+ *
+ * 2. **集成设置弹窗**（`plugins.detail.actions` 的 "Apollo 集成设置" 按钮，
+ *    只在 subject 为 Apollo bundle 详情页时渲染）：弹窗左 nav + 右内容，聚合
+ *    渲染各子插件自己注册到 `plugins.row.config` 的设置组件——entry 组件经
+ *    `ctx.slots.entriesOfSlot` 按 `#<rowId>` 键后缀找到，`form` 用
+ *    `ctx.configForms.get(rowId)` 复刻官方 `formFor`（`{state,mutate}`），
+ *    `t` 用 `ctx.locale.bind(entry.locale)` 补齐。子插件页面永远是单一事实
+ *    源，本文件不复制任何字段定义。
+ *
+ * 主题：#3388BB（`--cfg-accent`），其余全部走 --dsw-alias-* 中性令牌。
+ * 零构建：closure factory，只 require('react') + 可选 ui-primitives（Modal
+ * 兜底为自绘 overlay）；不 fetch、不直接写 DOM。
  */
 
 window.__ModuleLoader__.load({
@@ -19,19 +25,43 @@ window.__ModuleLoader__.load({
 	factory: (require) => {
 		var module = { exports: {} };
 		var exports = module.exports;
-		const { createElement: h, useState } = require('react');
+		const React = require('react');
+		const { createElement: h, useEffect, useMemo, useState, useSyncExternalStore } = React;
+
+		/** ui-primitives 是可选依赖：拿不到时弹窗退化为自绘 overlay。 */
+		let Primitives = null;
+		try {
+			Primitives = require('@deepseek-ai/dsh-client-ui-primitives');
+		} catch {
+			Primitives = null;
+		}
+		const Modal = Primitives?.Modal ?? null;
 
 		const NS = 'apollo';
+		const PACKAGE_NAME = '@menghuan1918/dsh-apollo';
+		const LEGACY_PACKAGE_NAME = 'dsh-apollo';
 		// 新键是 Plugins 页按“bundle 依赖名 + 行 id”算出的（= npm 包名 + #apollo-skills）；
 		// 旧键并排注册，只为仍把依赖槽记成旧 unscoped 名的 profile 保留配置入口。
 		const ROW_KEYS = ['@menghuan1918/dsh-apollo#apollo-skills', 'dsh-apollo#apollo-skills'];
+		const DETAIL_ACTIONS_SLOT = 'plugins.detail.actions';
+		const ROW_CONFIG_SLOT = 'plugins.row.config';
+		const HUB_ENTRY_ID = 'apollo-settings-hub';
+
+		/** 聚合弹窗展示的设置命名空间（= 行 id），按 nav 顺序排列。 */
+		const HUB_ROWS = [
+			{ rowId: 'apollo-skills', titleKey: 'pluginApollo' },
+			{ rowId: 'dsh-better-subagent', titleKey: 'pluginSubagent' },
+			{ rowId: 'dsh-better-compact', titleKey: 'pluginCompact' },
+			{ rowId: 'dsh-better-goal', titleKey: 'pluginGoal' },
+			{ rowId: 'dsh-better-ask-user', titleKey: 'pluginAskUser' },
+		];
 
 		const zh = {
 			summary: 'Apollo 集成设置：后台任务退出守卫与迁移说明',
 			title: 'Apollo 集成设置',
 			intro: 'Apollo 负责技能、工程预设和独立插件的装配。这里只保留后台任务退出守卫；保存后即时生效，配置写入当前 profile 的行配置（cordis.patch.yml）。',
 			migratedTitle: '已迁移的能力',
-			migratedBody: 'CLI 子代理、wait_subagent、运行中子代理守卫、模型分档与子代理设置页由 @menghuan1918/dsh-better-subagent 拥有；压缩模式与预算由 dsh-better-compact 拥有。请到 Plugins 中对应的行配置。',
+			migratedBody: 'CLI 子代理、wait_subagent、运行中子代理守卫、模型分档与子代理设置页由 @menghuan1918/dsh-better-subagent 拥有；压缩模式与预算由 dsh-better-compact 拥有。请到 Plugins 中对应的行配置，或使用包详情页的集成设置弹窗。',
 			deprecatedBody: '旧 Apollo 行里的 tiers / subagents / trustedHosts 只为迁移旧 profile 保留，运行时不再生效；迁移在启动后自动补齐新插件的缺失值，目标行已有显式设置时不会被覆盖。',
 			reloadBody: '从 0.4.x 升级、或同时显式选中了独立 bundle 时，行可能显示为只读/不可寻址；请只保留一个显式入口并重载 profile。压缩设置的保存需要重载 profile 才会被引擎采用。',
 			loading: '正在读取配置…',
@@ -49,6 +79,18 @@ window.__ModuleLoader__.load({
 			saveFailed: '保存失败：',
 			readonlyNote: '只读：当前无法写入宿主配置。',
 			unavailableNote: '不可写：当前连接下该配置不可用。',
+			hubButton: '集成设置',
+			hubTitle: 'Apollo 集成设置',
+			hubIntro: '统一查看和修改 Apollo 及各子插件的设置；各页面与各插件行配置共用同一份表单。',
+			hubEmpty: '暂无可用的子插件设置：子插件客户端尚未注册设置页，或本部署未组合设置服务。',
+			done: '完成',
+			close: '关闭',
+			entryError: '此设置区加载失败：',
+			pluginApollo: 'Apollo 核心',
+			pluginSubagent: 'Better Subagent',
+			pluginCompact: 'Better Compact',
+			pluginGoal: 'Better Goal',
+			pluginAskUser: 'Better Ask User',
 		};
 
 		const en = {
@@ -56,7 +98,7 @@ window.__ModuleLoader__.load({
 			title: 'Apollo integration settings',
 			intro: 'Apollo owns the skills, the engineering presets and the assembly of the independent plugins. Only the background-job exit guard remains here; saving applies immediately and persists in the active profile row config (cordis.patch.yml).',
 			migratedTitle: 'Migrated capabilities',
-			migratedBody: 'CLI subagents, wait_subagent, the running-child guard, model tiers and the subagent settings page are owned by @menghuan1918/dsh-better-subagent; compaction modes and budgets are owned by dsh-better-compact. Use their rows under Plugins.',
+			migratedBody: 'CLI subagents, wait_subagent, the running-child guard, model tiers and the subagent settings page are owned by @menghuan1918/dsh-better-subagent; compaction modes and budgets are owned by dsh-better-compact. Configure their rows under Plugins, or use the integrated settings dialog on the package page.',
 			deprecatedBody: 'The old Apollo tiers / subagents / trustedHosts fields are kept only so 0.4.x profiles load; they are inert at runtime. After boot the migration fills the new plugins’ missing values and never overwrites an explicit target setting.',
 			reloadBody: 'Upgrading from 0.4.x, or selecting both the standalone and Apollo bundles explicitly, can make the row read-only/unaddressable: keep a single explicit entry and reload the profile. Saved compaction settings take effect only after the profile reloads.',
 			loading: 'Loading configuration…',
@@ -74,6 +116,18 @@ window.__ModuleLoader__.load({
 			saveFailed: 'Save failed: ',
 			readonlyNote: 'Read-only: host configuration cannot be written.',
 			unavailableNote: 'Not writable: this configuration is unavailable on the current connection.',
+			hubButton: 'Integrated settings',
+			hubTitle: 'Apollo integrated settings',
+			hubIntro: 'Review and edit Apollo and every sub-plugin’s settings in one place; each pane shares the same form as that plugin’s row configuration page.',
+			hubEmpty: 'No sub-plugin settings are available yet: the sub-plugin clients have not registered their pages, or this deployment does not compose the settings service.',
+			done: 'Done',
+			close: 'Close',
+			entryError: 'This settings pane failed to load: ',
+			pluginApollo: 'Apollo core',
+			pluginSubagent: 'Better Subagent',
+			pluginCompact: 'Better Compact',
+			pluginGoal: 'Better Goal',
+			pluginAskUser: 'Better Ask User',
 		};
 
 		function interpolate(text, params) {
@@ -85,37 +139,83 @@ window.__ModuleLoader__.load({
 
 		const STYLE_ID = '@menghuan1918/dsh-apollo/settings.css';
 		const CSS = [
-			'.apollo-cfg{display:flex;flex-direction:column;gap:12px;max-width:760px;font-size:13px;line-height:20px;color:var(--dsw-alias-label-primary)}',
-			'.apollo-note{margin:0;padding:8px 10px;border-radius:var(--dsw-radius-md);font-size:12.5px;line-height:18px;background:var(--dsw-alias-bg-layer-3);color:var(--dsw-alias-label-secondary)}',
-			'.apollo-note[data-tone=error]{background:color-mix(in srgb, var(--dsw-alias-state-error-primary) 10%, transparent);color:var(--dsw-alias-state-error-primary)}',
+			/* 主题：#3388BB accent；其余全部中性 --dsw-alias-* 令牌。 */
+			'.apollo-cfg,.apollo-root{--cfg-accent:#3388BB;--cfg-accent-hover:#2e7aa8;--cfg-accent-fg:#fff}',
+			'.apollo-cfg{display:flex;flex-direction:column;gap:16px;max-width:760px;font-size:13px;line-height:20px;color:var(--dsw-alias-label-primary)}',
+			'.apollo-intro{margin:0;padding:0 2px;font-size:13px;line-height:20px;color:var(--dsw-alias-label-tertiary)}',
+			'.apollo-note{margin:0;padding:10px 12px;border:1px solid var(--dsw-alias-border-l2);border-radius:10px;font-size:12px;line-height:18px;background:var(--dsw-alias-bg-layer-3);color:var(--dsw-alias-label-secondary)}',
+			'.apollo-note[data-tone=error]{background:color-mix(in srgb, var(--dsw-alias-state-error-primary) 8%, transparent);border-color:color-mix(in srgb, var(--dsw-alias-state-error-primary) 30%, transparent);color:var(--dsw-alias-state-error-primary)}',
 			'.apollo-note[data-tone=warn]{background:var(--dsw-alias-state-warn-tertiary);color:var(--dsw-alias-label-secondary)}',
 			'.apollo-pulse{animation:apollo-pulse 2s cubic-bezier(.36,0,.64,1) infinite}',
 			'@keyframes apollo-pulse{0%{opacity:1}40%{opacity:.6}80%,to{opacity:1}}',
 			'@media (prefers-reduced-motion:reduce){.apollo-pulse{animation:none}}',
-			'.apollo-title{margin:0;font-size:14px;font-weight:500;line-height:22px}',
-			'.apollo-hint{margin:0;font-size:12px;line-height:16px;color:var(--dsw-alias-label-tertiary)}',
-			'.apollo-intro{margin:0;font-size:12.5px;line-height:18px;color:var(--dsw-alias-label-secondary)}',
-			'.apollo-section{display:flex;flex-direction:column;gap:2px;padding-top:12px;border-top:.5px solid var(--dsw-alias-border-l2)}',
-			'.apollo-sectionHead{display:flex;flex-direction:column;gap:2px;padding-bottom:4px}',
-			'.apollo-switchRow{display:flex;align-items:flex-start;gap:12px;padding:6px 0}',
-			'.apollo-switchMain{display:flex;flex-direction:column;gap:2px;flex:1;min-width:0}',
-			'.apollo-switchLabel{font-size:13px;font-weight:500}',
-			'.apollo-switch{box-sizing:border-box;position:relative;flex:none;width:36px;height:20px;margin:2px 0 0;padding:2px;border:0;border-radius:999px;background:var(--dsw-alias-border-l3);cursor:pointer;appearance:none}',
-			'.apollo-switch[aria-checked=true]{background:var(--dsw-alias-brand-primary,var(--dsw-alias-state-business-primary))}',
+			/* 分组容器卡：1px hairline + 16px 圆角 + layer-3 底。 */
+			'.apollo-group{display:flex;flex-direction:column;gap:6px;padding:16px 18px;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);border-radius:16px;background:var(--dsw-alias-bg-layer-3)}',
+			'.apollo-groupHead{display:flex;align-items:baseline;gap:7px;padding:0 2px 8px;font-size:13px;line-height:20px;font-weight:600;color:var(--dsw-alias-label-primary)}',
+			'.apollo-count{padding:1px 8px;border-radius:999px;background:color-mix(in srgb, var(--cfg-accent) 10%, transparent);font-size:11px;line-height:16px;font-weight:500;color:var(--dsw-alias-label-secondary);font-variant-numeric:tabular-nums}',
+			'.apollo-title{margin:0;font-size:14px;font-weight:600;line-height:22px;color:var(--dsw-alias-label-primary)}',
+			'.apollo-hint{margin:0;font-size:12px;line-height:17px;color:var(--dsw-alias-label-tertiary)}',
+			/* 设置行：标题/描述居左，控件居右，行间 hairline。 */
+			'.apollo-row{display:flex;align-items:center;justify-content:space-between;gap:16px;padding:11px 2px;border-bottom:1px solid var(--dsw-alias-border-l2)}',
+			'.apollo-row:last-child{border-bottom:none}',
+			'.apollo-rowText{display:flex;flex-direction:column;gap:3px;min-width:0;flex:1}',
+			'.apollo-rowTitle{font-size:13.5px;line-height:20px;font-weight:500;color:var(--dsw-alias-label-primary)}',
+			'.apollo-rowDesc{font-size:12px;line-height:17px;color:var(--dsw-alias-label-tertiary)}',
+			/* Switch：36x20 track，accent 实心 + 白点滑动。 */
+			'.apollo-switch{box-sizing:border-box;position:relative;flex:none;width:36px;height:20px;margin:2px 0 0;padding:2px;border:1px solid var(--dsw-alias-border-l2);border-radius:10px;background:var(--dsw-alias-bg-layer-2);cursor:pointer;appearance:none;transition:background 150ms ease,border-color 150ms ease}',
+			'.apollo-switch:hover{border-color:var(--dsw-alias-label-dimmed)}',
+			'.apollo-switch[aria-checked=true]{border-color:var(--cfg-accent);background:var(--cfg-accent)}',
 			'.apollo-switch:disabled{opacity:.4;cursor:not-allowed}',
-			'.apollo-switchThumb{display:block;width:16px;height:16px;border-radius:50%;background:var(--dsw-alias-label-primary-foreground);transition:transform 120ms ease}',
-			'.apollo-switch[aria-checked=true] .apollo-switchThumb{transform:translateX(16px)}',
-			'@media (prefers-reduced-motion:reduce){.apollo-switchThumb{transition:none}}',
-			'.apollo-button{box-sizing:border-box;display:inline-flex;align-items:center;justify-content:center;gap:4px;height:28px;padding:0 10px;border:0;border-radius:var(--dsw-radius-sm);font:inherit;font-size:12px;line-height:18px;color:var(--dsw-alias-label-primary);background:transparent;cursor:pointer}',
+			'.apollo-switchThumb{display:block;width:14px;height:14px;border-radius:50%;background:var(--dsw-alias-label-tertiary);transition:transform 150ms ease,background 150ms ease}',
+			'.apollo-switch[aria-checked=true] .apollo-switchThumb{transform:translateX(16px);background:var(--cfg-accent-fg)}',
+			'.apollo-switch:focus-visible{outline:2px solid var(--cfg-accent);outline-offset:2px}',
+			'@media (prefers-reduced-motion:reduce){.apollo-switch,.apollo-switchThumb{transition:none}}',
+			/* 按钮：primary=accent 实心白字；outline=1px 边；hover 走中性填充。 */
+			'.apollo-button{box-sizing:border-box;display:inline-flex;align-items:center;justify-content:center;gap:6px;height:30px;padding:0 14px;border:1px solid transparent;border-radius:8px;font:inherit;font-size:12.5px;line-height:18px;font-weight:500;color:var(--dsw-alias-label-primary);background:transparent;cursor:pointer;transition:background 120ms ease,border-color 120ms ease,color 120ms ease}',
 			'.apollo-button:disabled{opacity:.4;cursor:not-allowed}',
-			'.apollo-button[data-variant=primary]{background:var(--dsw-alias-button-primary-fill,var(--dsw-alias-label-primary));color:var(--dsw-alias-label-primary-foreground,var(--dsw-alias-bg-layer-3))}',
-			'.apollo-button[data-variant=outline]{border:.5px solid var(--dsw-alias-border-l3)}',
-			'.apollo-button:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}',
-			'.apollo-footer{display:flex;align-items:center;gap:8px;padding-top:12px;border-top:.5px solid var(--dsw-alias-border-l2)}',
+			'.apollo-button[data-variant=primary]{background:var(--cfg-accent);color:var(--cfg-accent-fg)}',
+			'.apollo-button[data-variant=primary]:hover:not(:disabled){background:var(--cfg-accent-hover)}',
+			'.apollo-button[data-variant=outline]{border-color:var(--dsw-alias-border-l3)}',
+			'.apollo-button[data-variant=outline]:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}',
+			'.apollo-button[data-variant=ghost]:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}',
+			'.apollo-button:focus-visible{outline:2px solid var(--cfg-accent);outline-offset:2px}',
+			'.apollo-input,.apollo-select{box-sizing:border-box;min-width:0;height:30px;padding:0 10px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-3);color:var(--dsw-alias-label-primary);font:inherit;font-size:13px;line-height:20px}',
+			'.apollo-input:hover,.apollo-select:hover{border-color:var(--dsw-alias-label-dimmed)}',
+			'.apollo-input:focus,.apollo-select:focus{outline:none;border-color:var(--cfg-accent);box-shadow:0 0 0 2px color-mix(in srgb, var(--cfg-accent) 25%, transparent)}',
+			'.apollo-input:disabled,.apollo-select:disabled{opacity:.4;cursor:not-allowed}',
+			'.apollo-input[aria-invalid=true]{border-color:var(--dsw-alias-state-error-primary)}',
+			'.apollo-select{appearance:none;padding-right:26px;background-image:url("data:image/svg+xml,%3Csvg xmlns=\'http://www.w3.org/2000/svg\' width=\'10\' height=\'6\' viewBox=\'0 0 10 6\'%3E%3Cpath d=\'M1 1l4 4 4-4\' stroke=\'%23999\' stroke-width=\'1.5\' fill=\'none\' stroke-linecap=\'round\'/%3E%3C/svg%3E");background-repeat:no-repeat;background-position:right 9px center}',
+			'.apollo-footer{display:flex;align-items:center;gap:8px;padding-top:14px;border-top:1px solid var(--dsw-alias-border-l2)}',
 			'.apollo-status{flex:1;min-width:0;font-size:12px;line-height:18px;color:var(--dsw-alias-label-tertiary)}',
 			'.apollo-status[data-tone=ok]{color:var(--dsw-alias-state-success-primary)}',
 			'.apollo-status[data-tone=error]{color:var(--dsw-alias-state-error-primary)}',
 			'.apollo-status[data-tone=warn]{color:var(--dsw-alias-state-warn-label,var(--dsw-alias-label-secondary))}',
+			/* ── 集成设置弹窗 ────────────────────────────────────────────── */
+			'.apollo-hubGlyph{flex:none;color:var(--cfg-accent)}',
+			/* ui-primitives Modal 加宽（双类提升优先级，同 better-sidebar 做法）。 */
+			'.apollo-modal.apollo-modal{width:min(880px, calc(100% - 32px))}',
+			'.apollo-hub{display:flex;gap:0;min-height:320px;max-height:60vh;--cfg-accent:#3388BB;--cfg-accent-hover:#2e7aa8;--cfg-accent-fg:#fff}',
+			'.apollo-hubNav{flex:none;width:184px;display:flex;flex-direction:column;gap:2px;padding-right:12px;border-right:1px solid var(--dsw-alias-border-l2);overflow-y:auto;scrollbar-width:thin}',
+			'.apollo-hubNavItem{display:flex;flex-direction:column;gap:1px;padding:8px 10px;border:0;border-radius:8px;background:transparent;font:inherit;text-align:left;cursor:pointer;color:var(--dsw-alias-label-secondary);transition:background 120ms ease,color 120ms ease}',
+			'.apollo-hubNavItem:hover{background:var(--dsw-alias-interactive-bg-hover)}',
+			'.apollo-hubNavItem[data-active]{background:color-mix(in srgb, var(--cfg-accent) 10%, transparent);color:var(--dsw-alias-label-primary)}',
+			'.apollo-hubNavItem:focus-visible{outline:2px solid var(--cfg-accent);outline-offset:1px}',
+			'.apollo-hubNavName{font-size:13px;line-height:18px;font-weight:500;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}',
+			'.apollo-hubNavId{font-size:11px;line-height:15px;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}',
+			'.apollo-hubContent{flex:1;min-width:0;overflow-y:auto;padding-left:18px;scrollbar-width:thin}',
+			'.apollo-hubPane[hidden]{display:none}',
+			'@media (max-width:640px){.apollo-hub{flex-direction:column}.apollo-hubNav{width:auto;flex-direction:row;gap:4px;padding:0 0 10px;border-right:0;border-bottom:1px solid var(--dsw-alias-border-l2);overflow-x:auto}.apollo-hubNavId{display:none}.apollo-hubContent{padding-left:0;padding-top:12px}}',
+			/* 自绘 overlay（ui-primitives 缺失时的兜底弹窗）。 */
+			'.apollo-mask{position:fixed;inset:0;z-index:9999;display:flex;align-items:center;justify-content:center;padding:24px;box-sizing:border-box;background:rgba(0,0,0,.4)}',
+			'.apollo-modalCard{display:flex;flex-direction:column;width:min(880px,100%);max-height:calc(100vh - 64px);box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);border-radius:14px;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);box-shadow:0 12px 48px rgba(0,0,0,.22)}',
+			'.apollo-modalHead{display:flex;flex-direction:column;gap:4px;padding:18px 20px 12px;border-bottom:1px solid var(--dsw-alias-border-l2)}',
+			'.apollo-modalTitleRow{display:flex;align-items:center;justify-content:space-between;gap:12px}',
+			'.apollo-modalTitle{margin:0;font-size:15px;font-weight:600;line-height:22px}',
+			'.apollo-modalDesc{margin:0;font-size:12px;line-height:18px;color:var(--dsw-alias-label-tertiary)}',
+			'.apollo-modalBody{flex:1;min-height:0;overflow:hidden;display:flex;padding:14px 20px}',
+			'.apollo-modalFoot{display:flex;justify-content:flex-end;gap:8px;padding:12px 20px;border-top:1px solid var(--dsw-alias-border-l2)}',
+			'.apollo-iconBtn{display:inline-flex;align-items:center;justify-content:center;width:28px;height:28px;border:0;border-radius:8px;background:transparent;color:var(--dsw-alias-label-tertiary);font-size:16px;line-height:1;cursor:pointer}',
+			'.apollo-iconBtn:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}',
 		].join('\n');
 
 		/** 宿主快照只投影这一个可编辑字段。 */
@@ -125,10 +225,10 @@ window.__ModuleLoader__.load({
 		}
 
 		function SwitchRow({ id, label, hint, checked, disabled, onChange }) {
-			return h('div', { className: 'apollo-switchRow' },
-				h('div', { className: 'apollo-switchMain' },
-					h('label', { className: 'apollo-switchLabel', htmlFor: id }, label),
-					hint === undefined ? null : h('p', { className: 'apollo-hint' }, hint)),
+			return h('div', { className: 'apollo-row' },
+				h('div', { className: 'apollo-rowText' },
+					h('label', { className: 'apollo-rowTitle', htmlFor: id }, label),
+					hint === undefined ? null : h('span', { className: 'apollo-rowDesc' }, hint)),
 				h('button', {
 					type: 'button',
 					id,
@@ -192,13 +292,10 @@ window.__ModuleLoader__.load({
 				: h('span', { className: 'apollo-status', role: 'status' }, writable ? '' : translate('readonlyNote'));
 
 			return h('div', { className: 'apollo-cfg' },
-				h('div', { className: 'apollo-sectionHead' },
-					h('h3', { className: 'apollo-title' }, translate('title')),
-					h('p', { className: 'apollo-intro' }, translate('intro'))),
+				h('p', { className: 'apollo-intro' }, translate('intro')),
 				writable ? null : h('p', { className: 'apollo-note', 'data-tone': 'warn' }, translate('readonly')),
-				h('div', { className: 'apollo-section' },
-					h('div', { className: 'apollo-sectionHead' },
-						h('h3', { className: 'apollo-title' }, translate('exitGuardLabel'))),
+				h('div', { className: 'apollo-group' },
+					h('div', { className: 'apollo-groupHead' }, translate('title')),
 					h(SwitchRow, {
 						id: 'apollo-exit-guard',
 						label: translate('exitGuardLabel'),
@@ -207,9 +304,8 @@ window.__ModuleLoader__.load({
 						disabled: !writable || busy,
 						onChange: (next) => { setDraft({ revision: state.revision, value: { exitGuard: next } }); setNotice(null); },
 					})),
-				h('div', { className: 'apollo-section' },
-					h('div', { className: 'apollo-sectionHead' },
-						h('h3', { className: 'apollo-title' }, translate('migratedTitle'))),
+				h('div', { className: 'apollo-group' },
+					h('div', { className: 'apollo-groupHead' }, translate('migratedTitle')),
 					h('p', { className: 'apollo-note' }, translate('migratedBody')),
 					h('p', { className: 'apollo-note' }, translate('deprecatedBody')),
 					h('p', { className: 'apollo-note', 'data-tone': 'warn' }, translate('reloadBody'))),
@@ -236,12 +332,217 @@ window.__ModuleLoader__.load({
 		 * 样式随组件树内的 <style> 挂载一次（不写 DOM，重复渲染不重复注入）。
 		 */
 		function ApolloPanel(props) {
-			if (props.view === 'summary') return h('span', null, t('summary'));
+			if (props.view === 'summary') return h('span', null, (props.t ?? t)('summary'));
 			return h('div', { className: 'apollo-root' },
 				h('style', { 'data-plugin-css': STYLE_ID }, CSS),
 				h(ApolloConfigPage, { form: props.form, t: props.t ?? t }));
 		}
 
+		// ── 集成设置弹窗 ─────────────────────────────────────────────────
+
+		function gearGlyph() {
+			return h('svg', { width: 13, height: 13, viewBox: '0 0 16 16', fill: 'none', 'aria-hidden': 'true', className: 'apollo-hubGlyph' },
+				h('path', {
+					d: 'M8 10.4a2.4 2.4 0 1 0 0-4.8 2.4 2.4 0 0 0 0 4.8Z',
+					stroke: 'currentColor', strokeWidth: 1.4,
+				}),
+				h('path', {
+					d: 'M13.3 8c0-.4-.1-.8-.2-1.2l1.1-.9-1.2-2-1.3.5c-.6-.5-1.2-.8-1.9-1L9.3 1.7H6.7l-.5 1.7c-.7.2-1.3.5-1.9 1l-1.3-.5-1.2 2 1.1.9a4.9 4.9 0 0 0 0 2.4l-1.1.9 1.2 2 1.3-.5c.6.5 1.2.8 1.9 1l.5 1.7h2.6l.5-1.7c.7-.2 1.3-.5 1.9-1l1.3.5 1.2-2-1.1-.9c.1-.4.2-.8.2-1.2Z',
+					stroke: 'currentColor', strokeWidth: 1.2, strokeLinejoin: 'round',
+				}));
+		}
+
+		/**
+		 * 按 HUB_ROWS 顺序收集已注册的子插件设置组件：entry.options.key 以
+		 * `#<rowId>` 结尾即归该行；同 rowId 多个键（独立/Apollo 两种装配）内容
+		 * 相同，优先取 Apollo bundle 键。
+		 */
+		function collectPluginEntries(ctx) {
+			const read = typeof ctx.slots.entriesOfSlot === 'function'
+				? () => ctx.slots.entriesOfSlot(ROW_CONFIG_SLOT)
+				: () => (typeof ctx.slots.entries === 'function' ? ctx.slots.entries(ROW_CONFIG_SLOT) : []);
+			let entries = [];
+			try {
+				entries = read() ?? [];
+			} catch {
+				entries = [];
+			}
+			const found = new Map();
+			for (const row of HUB_ROWS) {
+				const suffix = '#' + row.rowId;
+				for (const entry of entries) {
+					const key = entry?.options?.key;
+					if (typeof key !== 'string' || !key.endsWith(suffix) || entry.component === undefined || entry.component === null) continue;
+					const score = key.startsWith(PACKAGE_NAME + '#') ? 0 : 1;
+					const prev = found.get(row.rowId);
+					if (prev === undefined || score < prev.score) found.set(row.rowId, { entry });
+				}
+			}
+			const items = [];
+			for (const row of HUB_ROWS) {
+				const hit = found.get(row.rowId);
+				if (hit !== undefined) items.push({ rowId: row.rowId, titleKey: row.titleKey, entry: hit.entry });
+			}
+			return items;
+		}
+
+		/** 复刻官方插件页的 formFor：describe 镜像决定可见性，get() 拿共享表单。 */
+		function formFor(ctx, mirror, rowId) {
+			const namespaces = mirror?.view?.namespaces;
+			if (!Array.isArray(namespaces) || !namespaces.some((view) => view?.ns === rowId)) return undefined;
+			try {
+				const form = ctx.configForms.get(rowId);
+				return { state: form.getSnapshot(), mutate: (ops, revision) => form.mutate(ops, revision) };
+			} catch {
+				return undefined;
+			}
+		}
+
+		/** entry 声明的 locale 命名空间 → t；没有则给 undefined（组件自带兜底）。 */
+		function boundT(ctx, entry) {
+			if (typeof entry?.locale !== 'string' || entry.locale === '') return undefined;
+			try {
+				return typeof ctx.locale?.bind === 'function' ? ctx.locale.bind(entry.locale) : undefined;
+			} catch {
+				return undefined;
+			}
+		}
+
+		function subscribeSlot(ctx, listener) {
+			try {
+				return typeof ctx.slots.subscribe === 'function' ? ctx.slots.subscribe(ROW_CONFIG_SLOT, listener) : () => {};
+			} catch {
+				return () => {};
+			}
+		}
+
+		function slotVersion(ctx) {
+			try {
+				return typeof ctx.slots.getVersion === 'function' ? ctx.slots.getVersion(ROW_CONFIG_SLOT) : 0;
+			} catch {
+				return 0;
+			}
+		}
+
+		/** 单个设置面板崩溃不炸掉整个弹窗。 */
+		class EntryBoundary extends React.Component {
+			constructor(props) {
+				super(props);
+				this.state = { error: null };
+			}
+			static getDerivedStateFromError(error) {
+				return { error };
+			}
+			render() {
+				if (this.state.error !== null) {
+					return h('p', { className: 'apollo-note', 'data-tone': 'error', role: 'alert' },
+						t('entryError') + String(this.state.error?.message ?? this.state.error));
+				}
+				return this.props.children;
+			}
+		}
+
+		/** 弹窗主体：左 nav + 右面板（全部挂载，display:none 保住未存草稿）。 */
+		function HubBody({ ctx }) {
+			const version = useSyncExternalStore((listener) => subscribeSlot(ctx, listener), () => slotVersion(ctx));
+			const items = useMemo(() => collectPluginEntries(ctx), [ctx, version]);
+			const describe = ctx.configForms.describe();
+			const mirror = useSyncExternalStore(
+				(listener) => (typeof describe?.subscribe === 'function' ? describe.subscribe(listener) : () => {}),
+				() => describe?.getSnapshot?.());
+			useEffect(() => { void describe?.ensure?.(); }, [describe]);
+			const [active, setActive] = useState(null);
+			const current = items.find((item) => item.rowId === active) ?? items[0];
+
+			if (items.length === 0) {
+				return h('p', { className: 'apollo-note', role: 'status' }, t('hubEmpty'));
+			}
+			return h('div', { className: 'apollo-hub' },
+				h('div', { className: 'apollo-hubNav', role: 'tablist', 'aria-label': t('hubTitle') },
+					items.map((item) => h('button', {
+						key: item.rowId,
+						type: 'button',
+						role: 'tab',
+						className: 'apollo-hubNavItem',
+						'data-active': item === current ? true : undefined,
+						'aria-selected': item === current,
+						onClick: () => setActive(item.rowId),
+					},
+						h('span', { className: 'apollo-hubNavName' }, t(item.titleKey)),
+						h('span', { className: 'apollo-hubNavId' }, item.rowId)))),
+				h('div', { className: 'apollo-hubContent', role: 'tabpanel' },
+					items.map((item) => h('div', {
+						key: item.rowId,
+						className: 'apollo-hubPane',
+						hidden: item !== current,
+					},
+						h(EntryBoundary, null,
+							h(item.entry.component, {
+								view: 'page',
+								form: formFor(ctx, mirror, item.rowId),
+								t: boundT(ctx, item.entry),
+							}))))));
+		}
+
+		/** 自绘弹窗兜底：fixed mask + card，Esc/遮罩点击关闭（不依赖 ui-primitives）。 */
+		function FallbackModal({ onClose, children }) {
+			useEffect(() => {
+				const doc = globalThis['document'];
+				if (doc === undefined || doc === null) return undefined;
+				const onKey = (event) => { if (event.key === 'Escape') onClose(); };
+				doc.addEventListener('keydown', onKey);
+				return () => doc.removeEventListener('keydown', onKey);
+			}, [onClose]);
+			return h('div', {
+				className: 'apollo-mask',
+				role: 'presentation',
+				onClick: (event) => { if (event.target === event.currentTarget) onClose(); },
+			},
+				h('div', { className: 'apollo-modalCard', role: 'dialog', 'aria-label': t('hubTitle') },
+					h('div', { className: 'apollo-modalHead' },
+						h('div', { className: 'apollo-modalTitleRow' },
+							h('h2', { className: 'apollo-modalTitle' }, t('hubTitle')),
+							h('button', { type: 'button', className: 'apollo-iconBtn', 'aria-label': t('close'), onClick: onClose }, '×')),
+						h('p', { className: 'apollo-modalDesc' }, t('hubIntro'))),
+					h('div', { className: 'apollo-modalBody' }, children),
+					h('div', { className: 'apollo-modalFoot' },
+						h('button', { type: 'button', className: 'apollo-button', 'data-variant': 'primary', onClick: onClose }, t('done')))));
+		}
+
+		function SettingsModal({ ctx, onClose }) {
+			const body = h(HubBody, { ctx });
+			if (Modal === null) return h(FallbackModal, { onClose }, body);
+			return h(Modal, {
+				open: true,
+				onClose,
+				title: t('hubTitle'),
+				description: t('hubIntro'),
+				closeLabel: t('close'),
+				className: 'apollo-modal',
+				contentClassName: 'apollo-hubModalContent',
+				footer: h('button', { type: 'button', className: 'apollo-button', 'data-variant': 'primary', onClick: onClose }, t('done')),
+			}, body);
+		}
+
+		/** `plugins.detail.actions` 入口：仅 Apollo bundle 详情页渲染触发按钮。 */
+		function HubEntry(props) {
+			const subject = props.subject;
+			const isApolloBundle = subject?.kind === 'bundle'
+				&& (subject.pkg?.name === PACKAGE_NAME || subject.pkg?.name === LEGACY_PACKAGE_NAME);
+			const [open, setOpen] = useState(false);
+			if (!isApolloBundle) return null;
+			return h(React.Fragment, null,
+				h('style', { 'data-plugin-css': STYLE_ID + ':hub' }, CSS),
+				h('button', {
+					type: 'button',
+					className: 'apollo-button',
+					'data-variant': 'outline',
+					'data-apollo-hub': 'trigger',
+					onClick: () => setOpen(true),
+				}, gearGlyph(), (props.t ?? t)('hubButton')),
+				open ? h(SettingsModal, { ctx: props.ctx, onClose: () => setOpen(false) }) : null);
+		}
+
 		const inject = ['slots', 'locale'];
 
 		function apply(ctx) {
@@ -252,12 +553,12 @@ window.__ModuleLoader__.load({
 			} catch {
 				// locale 服务缺失时保持中文默认。
 			}
-			ctx.effect(() => ctx.slots.inject('plugins.row.config', () => {
+			ctx.effect(() => ctx.slots.inject(ROW_CONFIG_SLOT, () => {
 				const disposers = [];
 				for (const key of ROW_KEYS) {
 					try {
 						const dispose = ctx.slots.register({
-							name: 'plugins.row.config',
+							name: ROW_CONFIG_SLOT,
 							key,
 							locale: NS,
 						}, ApolloPanel);
@@ -270,6 +571,27 @@ window.__ModuleLoader__.load({
 					for (const dispose of disposers) dispose();
 				};
 			}), '@menghuan1918/dsh-apollo: row config page');
+
+			// 集成设置弹窗依赖 configForms（读取各子插件命名空间的共享表单）；
+			// 服务缺失时仅弹窗缺席，行配置页照常工作。
+			try {
+				ctx.inject(['configForms'], (sctx) => {
+					const register = () => sctx.slots.inject(DETAIL_ACTIONS_SLOT, () =>
+						sctx.slots.register({
+							name: DETAIL_ACTIONS_SLOT,
+							id: HUB_ENTRY_ID,
+							order: 0,
+							locale: NS,
+						}, (props) => h(HubEntry, { ctx: sctx, subject: props.subject, t: props.t ?? t })));
+					if (typeof sctx.effect === 'function') {
+						sctx.effect(register, '@menghuan1918/dsh-apollo: settings hub');
+						return undefined;
+					}
+					return register();
+				});
+			} catch {
+				// 无 configForms 的组合：集成弹窗不注册。
+			}
 		}
 
 		exports.inject = inject;