dsh-notice-center 1.3.1 → 1.4.0

package/CHANGELOG.md

@@ -0,0 +1,100 @@
+# 更新记录
+
+每个**已发布**版本的改动都记在这里；本文件随包一起发布（`files` 里已包含），
+发版流程见 [README → 发版](./README.md#发版)。最上面一条就是 npm 上的当前版本。
+
+约定：正式版发到 `latest`，`-rc.N` 只发 `next`（不动 `latest`）；括号里的短哈希是那次改动的提交。
+
+## 1.4.0 — 2026-09-27
+
+> **兼容性**：`engines.dsh` 要求 `>=0.1.7-rc.2 <0.2.0-0`。设置表单改用 0.1.7 的
+> `runtime.Config` 派生，**宿主 0.1.6 及更早请继续用 1.3.1**。
+
+### 修复
+
+- **浅色系统上标签页状态灯永远不显色**（`981e8cd`）
+  宿主 `index.html` 挂了两枚 `<link rel="icon">`（`favicon-dark.svg` / `favicon.svg`，
+  靠 `media="(prefers-color-scheme: …)"` 区分），浏览器按系统主题只渲染其中一枚；旧代码
+  `querySelector("link[rel~=icon]")` 只拿到第一枚，而浅色主题下渲染的恰恰是第二枚 ——
+  琥珀、绿、默认色全画在没人用的那枚上，标签页看着一直是默认图标。现在改**全部** icon，
+  逐枚记住各自原始 `href`（还原时对号入座），页面上一枚都没有时自建一枚再上色。
+
+- **音量滑杆「改了没反应、还回弹」**（`2cfc6b4`）
+  每笔 `set` 都要重写整份 profile 的 `cordis.patch.yml` 并热重载插件条目（实测约 1s/笔），
+  而原生滑杆每挪一格就发一次 `input`，一次拖动几十笔全排进写队列，回显被拖到几秒之后，
+  受控滑杆又被旧快照拽回 —— 表现为「点一下固定差 5%，右滑也是下降」。现在按**手势合并写**：
+  首笔立即写（点一下就生效），拖动中只攒最新值，静默 150ms 后补最后一笔（一次手势 1–2 笔），
+  同时当帧画回显草稿，写入最终没落盘才回滚。
+
+- **点「↺ 恢复默认」/ 取色后，预览鲸鱼要等一会儿才变色**（`c49231d`）
+  与上一条同源：预览和取色器都只读快照。现在颜色也有当帧草稿，写入落定后交还快照、失败回滚；
+  取色同样按手势合并（原生取色器拖动时会连发 `input`）；复位是整笔覆盖，先丢掉排队中的取色值
+  再立即 `unset`。
+
+### 变更
+
+- 设置页迁移到 DSH 0.1.7 的设置 API：改读 `ctx.configForms.get("notice-center")`，`loading`
+  不渲染，`unavailable` / 只读时给一行说明；宿主半只声明 Config schema，旧 `settings.yaml`
+  由 `dsh-settings` 按同名条目 id 迁移。
+- 宿主半每个字段补 `.volatile()`（`volatileForm` 只投影「最近的可变祖先」下的字段，漏标一个
+  那项就会在设置页整条消失），`schemastery` 升到 `^3.18.4`；保留 `/notice-center-sounds`
+  音效路由。
+- 修正图标名：`…Outline14` → `…OutlineRegular`。宿主静态模块表里没有 `…14` 那套导出，
+  `jsx(undefined)` 会被插槽错误边界吞掉，整个设置页会变成空白（配置项一条都不显示）。
+- 导航图标换成自定义铃铛（`viewBox 0 0 1024 1024`）：铃身 + 底座合并成一条 `currentColor`
+  路径跟随主题，高光保留 `#3399FF`；官方回退齿轮的 path 不够用时只追加克隆节点（不删 React
+  管的节点），幂等跳过避免 rAF 死循环。
+- `engines` / `peerDependencies` 收到 `>=0.1.7-rc.2 <0.2.0-0`。
+
+### 测试与工程
+
+- 新增 `test/compat-range.smoke.mjs`：0.1.4 ~ 0.2.0 宿主兼容区间，`npm test` 一并跑。
+- `primitives` 桩改成导出白名单（名单外的名字直接抛错，原来的 Proxy 对任何名字都造得出假组件）；
+  `rAF` 桩改为入队 + 手动 flush，对齐真浏览器时序；新增导航图标 9 条断言。
+- 浏览器半冒烟补：两枚 favicon 都换色 / 各自还原 / 一枚都没有时自建一枚；音量手势合并写与
+  回显草稿；颜色当帧回显与合并写（第 17–19 节）。
+
+## 1.3.1 — 2026-09-24
+
+- fix: 「自动隐藏」的提示文案只讲了关闭侧，改为两侧都写清楚（`92b0dae`）
+- feat: 设置页页脚（插件名 + 版本号，点击开仓库）（`ce8109e`）
+- test: 补「同一会话连续完成两次 → 弹两次」回归用例，把去重语义写精确 —— 管的是
+  「同一次完成」，不是「同一会话」（`d44ae93`、`cd8f2f2`）
+- docs: README 重构为「使用 / 开发」两部分并加目录导航，补齐中英文主图与真实设置页截图
+
+## 1.3.0 — 2026-09-19
+
+- fix: 状态灯改为**待处理优先**，与官方 `sessionStatuses` 一致（`735007f`）
+- feat: 完成通知附本轮总用时；待处理通知按交互类型细化；新增「前台提醒」开关；调完音量试听
+  完成提示音；设置页分组行整行可点（不必去够最右边的箭头）
+- test: 新增设置页渲染测试（记录型桩，零新依赖）（`ed7acd6`）
+- docs: 新增英文 README（`README.en.md`）
+
+## 1.3.0-rc.1 — 2026-09-19
+
+- ci: 新增 tag 触发的 OIDC 发布工作流（npm Trusted Publishing，无令牌 + 自动 provenance），
+  并加幂等保护：该版本已在 registry 上就跳过（`a8a2f38`、`de49005`）
+- 首次实测 OIDC 发布链路
+
+## 1.2.0 — 2026-09-19
+
+- feat: 提示音可选 —— 45 个 opencode 内置音效，下拉里悬浮即试听（`40521ef`）
+- docs: README 重写（功能 / 使用 / 截图）
+
+## 1.1.0 — 2026-09-18
+
+- test: 补浏览器半冒烟测试并接入 CI（`d388890`）
+- feat: 通知标题改为会话名、正文改为通知类型（`9a541e9`）；新增「自动隐藏」开关，关闭则常驻
+- fix: 通知去掉 `tag`、前台判定纳入窗口焦点 —— 修「同一对话只有第一条会弹」（`8b75353`）
+
+## 0.2.2 — 2026-08-22
+
+- 设置页与「选中会话」信号灯的修复版（`f278787`）
+
+## 0.1.0 — 2026-08-16
+
+- 首个正式版：标签页鲸鱼状态灯 + 浏览器系统通知（`83a2860`）
+
+---
+
+> 0.1.0 – 1.1.0 是改名 / 独立收敛之前的产物；npm 上的 `dsh-notice-center` 从 1.2.0 开始。

package/README.en.md

@@ -36,6 +36,7 @@
 - [Local development](#local-development)
 - [Tests](#tests)
 - [Releasing](#releasing)
+- [Changelog](./CHANGELOG.md)
 - [Design constraints](#design-constraints)
 
 ## Why you need it
@@ -116,7 +117,9 @@ Finished and pending each have their own dropdown, **47 entries** in total: 2 bu
 
 ### Requirements
 
-- **Official DeepSeek Harness** (supported range `0.1.2-rc.1+`; verified here on `0.1.5-rc.1` with client packages `0.1.5-rc.2`)
+- **Official DeepSeek Harness**: `1.4.0` requires **`0.1.7-rc.2+`**; `1.3.x` supports `0.1.2-rc.1+`
+  - The range is declared in `engines.dsh` and the `@deepseek-ai/dsh-*` peers, guarded by `test/compat-range.smoke.mjs`. The two lines split by host version: **the Market never offers 1.4.0 to an older host, and the DSH core refuses to load it** — older hosts simply stay on `1.3.x` with no update prompt.
+  - The version gate only compares version strings and cannot detect a removed API (0.1.7 dropped `settings.register` while the old declaration still passed), so never treat it as a compatibility guarantee on its own.
 - System notifications need a **secure context** — `http://127.0.0.1:3080` or `localhost` works; over a **LAN IP** the browser's Notification API is unavailable (a browser restriction, not a plugin issue)
 
 ### Option 1: from npm (recommended)
@@ -221,23 +224,30 @@ The plugin has **two halves** running in different processes, exchanging configu
 
 | Part | File | Runs in | Responsibility |
 |---|---|---|---|
-| **Host half** | `lib/index.mjs` (128 lines) | Harness main process (Node) | ① Register the `notice-center` settings namespace schema; ② serve `/notice-center-sounds/<id>.mp3` |
-| **Browser half** | `lib/client.cjs` (1344 lines) | Browser (plugin bundle) | favicon state machine + notification state machine + sound library + settings page |
-| **Bundle patch** | `cordis.patch.yml` | Loader layer | Insert one row `id: notice-center` into the plugin tree |
+| **Host half** | `lib/index.mjs` | Harness main process (Node) | ① Declare the `Config` schema (settings form, write validation and the legacy `settings.yaml` import all derive from it); ② serve `/notice-center-sounds/<id>.mp3` |
+| **Browser half** | `lib/client.cjs` | Browser (plugin bundle) | favicon state machine + notification state machine + sound library + settings page |
+| **Bundle patch** | `cordis.patch.yml` | Loader layer | Insert one row `id: notice-center` into the plugin tree (that id IS the settings namespace) |
 
 **The host half's two optional channels**:
 
-- `ctx.inject(["settings"], …)` — registers the schema; a success line is logged to the console as proof
+- `ctx.inject(["settings"], …)` — declares "this plugin ships its own page": `settings.configure({ auto: false }, ctx.fiber)`. The owner must be the plugin's own fiber (`describe()` looks the policy up by `entry.fiber`, and the `inject` child is a different fiber)
 - `ctx.inject(["webServer"], …)` — mounts the sound route. When the service is absent the route is not mounted and the browser half falls back to the built-in chime
 
-**Why the host half does not import `@deepseek-ai/dsh-settings`**: since `0.1.2-rc.1` that package no longer exports `settingsNamespace()`, and `register` validates the kebab-case string itself, so passing a plain string is enough. **That keeps the host half's only runtime dependency at `@deepseek-ai/schemastery`** — and because profiles default to `autoInstallPeers: false`, resolving any `@deepseek-ai` peer would actually fail on a version mismatch and break loading. This is what makes a clean registry install possible.
+**The settings contract (since 0.1.7 — the easiest thing to break silently here)**:
+
+- The form is derived from the **plugin's own Config**: dsh-settings' `describe()` reads the entry fiber's `runtime.Config`, and the entry id is the namespace — the plugin **no longer registers a namespace** (the old `settings.register(ns, schema)` was removed in 0.1.7).
+- **Every field must be `.volatile()`**: `volatileForm()` only projects fields under the nearest volatile ancestor, so one unmarked field disappears from the settings page entirely (`test/host-half.smoke.mjs` asserts this field by field). `.volatile()` requires **schemastery ≥ 3.18.4**.
+- Existing users need no manual migration: at startup dsh-settings reads `<DSH_HOME>/settings.yaml`, writes each section into the entry carrying the **same id**, then renames the file to `settings.yaml.imported`. Our section name equals the entry id (`notice-center`).
+
+**Why the host half does not import `@deepseek-ai/dsh-settings`**: it keeps the host half's only runtime dependency at `@deepseek-ai/schemastery` — and because profiles default to `autoInstallPeers: false`, resolving any `@deepseek-ai` peer would actually fail on a version mismatch and break loading. This is what makes a clean registry install possible.
 
 **Where the browser half gets its data** (all official client services; the plugin holds no state of its own):
 
 | Service | Provided by | Used for |
 |---|---|---|
-| `sessions` | `@deepseek-ai/dsh-api-session-controller/client` | Session list snapshot: `completed` / `origin` / `running` / `current` |
-| `uiSession` | `@deepseek-ai/dsh-client-ui-session` | `pendingInteractions`: `Map<sessionId, { kind, … }>` |
+| `configForms` | `@deepseek-ai/dsh-client-ui-settings` | `configForms.get(entryId)` reads and writes settings (the old `settingsScope` was removed in 0.1.7); the snapshot carries `status` / `writable` |
+| `sessions` | `@deepseek-ai/dsh-api-session-controller/client` | Session list snapshot: `origin` / `running` / `displayTitle` |
+| `uiSession` | `@deepseek-ai/dsh-client-ui-session` | `sessionStatus`: `Map<sessionId, { running, pendingInteraction, completionUnread }>` — 0.1.7 removed both the row fields `completed` / `pendingInteraction` and the `pendingInteractions` store; the official workspace session rows use the same mapping (`completed` ≡ `completionUnread`) |
 
 The sound route is deliberately narrow: only `^[a-z0-9-]+\.mp3$` filenames are served (no path traversal), and because the audio is a package constant it is cached `immutable`.
 
@@ -333,6 +343,8 @@ The workflow has **three gates**; failing any one blocks the release:
 
 The publish step is also **idempotent**: if that version already exists on the registry it is skipped, so re-tagging or re-running never fails the build.
 
+Before tagging, add this release to [`CHANGELOG.md`](./CHANGELOG.md) (user-visible changes plus compatibility notes) — it is the source of the release notes shown on the npm page and the GitHub Release.
+
 ### One-time setup: npm Trusted Publishing (OIDC)
 
 Publishing needs no npm token at all (so there is nothing to expire or leak). Open the package page → **Publishing Access** → *Trusted publishers* → **Add a trusted publisher** → choose **GitHub Actions**:

package/README.md

@@ -36,6 +36,7 @@
 - [本地开发](#本地开发)
 - [测试](#测试)
 - [发版](#发版)
+- [更新记录](./CHANGELOG.md)
 - [设计约束](#设计约束)
 
 ## 为什么需要它
@@ -115,7 +116,9 @@
 
 ### 前置要求
 
-- **官方版本的 DeepSeek Harness**（适配范围 `0.1.2-rc.1+`；本机实测 `0.1.5-rc.1` + 客户端包 `0.1.5-rc.2`）
+- **官方版本的 DeepSeek Harness**：`1.4.0` 起要求 **`0.1.7-rc.2+`**；`1.3.x` 支持 `0.1.2-rc.1+`
+  - 兼容范围写在 `engines.dsh` 与 `@deepseek-ai/dsh-*` peer 上，由 `test/compat-range.smoke.mjs` 守护。两条线按宿主版本自动分流：**插件市场不会把 1.4.0 推给旧宿主，DSH 核心在加载前也会拒绝它**——旧宿主原地留在 `1.3.x`，不会收到更新提示。
+  - 版本闸门只比版本号，查不出 API 被删（0.1.7 删掉了 `settings.register`，旧声明在那上面照样 PASS），所以别只靠它当兼容性保障。
 - 系统通知需要**安全上下文**——`http://127.0.0.1:3080` 或 `localhost` 可用；用**局域网 IP** 访问时浏览器的 Notification API 不可用（这是浏览器限制，不是插件问题）
 
 ### 方式一：从 npm 安装（推荐）
@@ -220,23 +223,30 @@ dsh plugin --profile web remove dsh-notice-center
 
 | 组成 | 文件 | 跑在哪 | 职责 |
 |---|---|---|---|
-| **宿主半** | `lib/index.mjs`（128 行） | Harness 主进程（Node） | ① 注册 `notice-center` 设置命名空间 schema；② 挂载 `/notice-center-sounds/<id>.mp3` 静态音效路由 |
-| **浏览器半** | `lib/client.cjs`（1344 行） | 浏览器（插件 bundle） | favicon 状态机 + 通知状态机 + 音效库 + 设置页 |
-| **bundle patch** | `cordis.patch.yml` | Loader 层 | 往插件树里插入一行 `id: notice-center` |
+| **宿主半** | `lib/index.mjs` | Harness 主进程（Node） | ① 声明 `Config` schema（设置表单、写入校验、旧 `settings.yaml` 迁移都由它派生）；② 挂载 `/notice-center-sounds/<id>.mp3` 静态音效路由 |
+| **浏览器半** | `lib/client.cjs` | 浏览器（插件 bundle） | favicon 状态机 + 通知状态机 + 音效库 + 设置页 |
+| **bundle patch** | `cordis.patch.yml` | Loader 层 | 往插件树里插入一行 `id: notice-center`（这个 id 就是设置命名空间） |
 
 **宿主半的两个「可选通道」**：
 
-- `ctx.inject(["settings"], …)` —— 注册 schema。注册成功会在控制台留一行自证日志
+- `ctx.inject(["settings"], …)` —— 声明「本插件自带设置页」：`settings.configure({ auto: false }, ctx.fiber)`。owner 必须是插件自身的 fiber（`describe()` 按 `entry.fiber` 查这份策略，而 `inject` 子 fiber 是另一个 fiber）
 - `ctx.inject(["webServer"], …)` —— 挂载音效路由。服务缺席时不挂载，浏览器半自动回退到内置合成音
 
-**为什么宿主半不 import `@deepseek-ai/dsh-settings`**：自 `0.1.2-rc.1` 起该包不再导出 `settingsNamespace()`，注册处自己按 kebab-case 校验字符串，因此直接传纯字符串即可。**这样宿主半的运行时依赖只剩 `@deepseek-ai/schemastery`**——而 profile 默认 `autoInstallPeers: false`，真去解析任何 `@deepseek-ai` peer 反而会因 npm 上的版本不匹配而加载失败。这是「能从 registry 干净安装」的关键。
+**设置契约（0.1.7 起，这是本插件最容易静默踩坏的地方）**：
+
+- 表单由**插件自己的 Config** 派生：dsh-settings 的 `describe()` 读入口 fiber 的 `runtime.Config`，条目 id 就是命名空间 —— 插件**不再注册命名空间**（旧的 `settings.register(ns, schema)` 在 0.1.7 已删除）。
+- **每个字段都要 `.volatile()`**：`volatileForm()` 只投影「最近的可变祖先」下的字段，漏标一个就等于那个设置项在设置页里整条消失（`test/host-half.smoke.mjs` 为此逐字段断言）。`.volatile()` 需要 **schemastery ≥ 3.18.4**。
+- 老用户设置无需手工迁移：dsh-settings 启动时会读 `<DSH_HOME>/settings.yaml`，把每个 section 按名字写进**同 id** 的条目，再把原文件改名为 `settings.yaml.imported`。我们的段名正好等于条目 id（`notice-center`）。
+
+**为什么宿主半不 import `@deepseek-ai/dsh-settings`**：宿主半的运行时依赖只剩 `@deepseek-ai/schemastery`——而 profile 默认 `autoInstallPeers: false`，真去解析任何 `@deepseek-ai` peer 反而会因 npm 上的版本不匹配而加载失败。这是「能从 registry 干净安装」的关键。
 
 **浏览器半的数据来源**（都是官方客户端服务，插件不自持状态）：
 
 | 服务 | 提供包 | 用途 |
 |---|---|---|
-| `sessions` | `@deepseek-ai/dsh-api-session-controller/client` | 会话列表快照：`completed` / `origin` / `running` / `current` |
-| `uiSession` | `@deepseek-ai/dsh-client-ui-session` | `pendingInteractions`：`Map<sessionId, { kind, … }>` |
+| `configForms` | `@deepseek-ai/dsh-client-ui-settings` | `configForms.get(entryId)` 读写设置（旧的 `settingsScope` 在 0.1.7 已删除）；快照带 `status` / `writable` |
+| `sessions` | `@deepseek-ai/dsh-api-session-controller/client` | 会话列表快照：`origin` / `running` / `displayTitle` |
+| `uiSession` | `@deepseek-ai/dsh-client-ui-session` | `sessionStatus`：`Map<sessionId, { running, pendingInteraction, completionUnread }>` —— 0.1.7 的 `completed` / `pendingInteraction` 行字段与 `pendingInteractions` store 都已删除，官方 workspace 的会话行用的是同一套映射（`completed` ≡ `completionUnread`） |
 
 音效路由的安全约束：只放行 `^[a-z0-9-]+\.mp3$` 的文件名（杜绝路径穿越），音频是随包常量故用 `immutable` 长缓存。
 
@@ -332,6 +342,9 @@ npm run test:client # 只跑浏览器半
 
 另外发布步骤**幂等**：该版本已在 registry 上就跳过，重复打 tag / 重跑工作流不会红。
 
+发版前先在本仓库 [`CHANGELOG.md`](./CHANGELOG.md) 补上这一版（用户可见改动 + 兼容性）再打 tag ——
+它是 npm 包页与 GitHub Release 上那份「更新说明」的来源。
+
 ### 一次性配置：npm Trusted Publishing (OIDC)
 
 发布不需要任何 npm 令牌（也就没有令牌过期 / 泄漏问题）。打开包管理页 → **Publishing Access** → *Trusted publishers* → **Add a trusted publisher** → 选 **GitHub Actions**：

package/lib/client.cjs

@@ -22,7 +22,7 @@ window.__ModuleLoader__.load({
 		*  这份 bundle 是预构建产物，运行时读不到 package.json，漂移由宿主半冒烟测试
 		*  （test/host-half.smoke.mjs）守护，别在发版流程之外单独改这里。 */
 		const PLUGIN_NAME = "dsh-notice-center";
-		const PLUGIN_VERSION = "1.3.1";
+		const PLUGIN_VERSION = "1.4.0";
 		/** 插件仓库：页脚点击后在新标签页打开。 */
 		const PLUGIN_REPO = "https://github.com/SCP-QQ/dsh-notice-center";
 		/** 官方侧边栏状态点颜色（静态色板，明暗主题同值）。 */
@@ -365,7 +365,7 @@ function playSound(id, volume, kind) {
 								},
 								children: names[value] ?? value
 							}),
-							(0, react_jsx_runtime.jsx)(primitives.IconChevronDownOutline14, { style: { flex: "none" } })
+							(0, react_jsx_runtime.jsx)(primitives.IconChevronDownOutlineRegular, { style: { flex: "none" } })
 						]
 					}),
 					open ? (0, react_jsx_runtime.jsxs)("div", {
@@ -424,6 +424,137 @@ function playSound(id, volume, kind) {
 		//#endregion
 		//#region src/settings-section.tsx
 		/**
+		* 写入辅助：0.1.7 的 set/unset 返回 Promise<boolean> —— Host 业务拒绝给 false
+		* （含 revision 冲突，控制器会自己重读镜像），传输/宿主故障则 reject。
+		* 设置页是即时生效的（没有暂存/保存按钮），UI 不回滚。
+		*
+		* 但「只 warn 不重试」会把瞬时失败变成静默 bug：宿主 dsh-config-editor.edit 在
+		* 条目正在 reload、fiber 不是 ACTIVE、文件锁被占时抛错，revision 冲突则回 false
+		* —— 这些都是**瞬时**的，而 set/unset 是幂等的标量赋值，重试安全。失败时滑杆
+		* 会因受控 value 回弹，看着像「点了没反应」，实际是压根没写进 profile
+		* （2026-09-26 用户反馈：音量点击有时生效有时不生效）。
+		*
+		* 200ms / 600ms 各重试一次；同字段被更新的写入取代就放弃旧重试，免得旧值盖回新值。
+		* 首次尝试是同步发起的（调用点紧跟着的断言/交互反馈不被推迟到微任务）。
+		* 定义在模块级：设置页组件不在 apply 的作用域内，scope 由槽位注入。
+		*
+		* 返回值（供音量滑杆判断「这一笔到底落盘没有」）：true = 宿主已接受；false = 用尽重试
+		* 被拒，或已被同一字段的更新写入接管（此时真值归新写入，调用方按值比对决定是否回滚）。
+		* @param perform - 执行一次写入，返回 Promise<boolean>。
+		* @param label - 字段名：日志定位 + 同字段重试的去重键。
+		* @returns Promise<boolean> —— true 表示已落盘。
+		*/
+		const WRITE_RETRY_DELAYS = [200, 600];
+		const writeEpochs = /* @__PURE__ */ new Map();
+		const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+		/**
+		* 作废同字段更早发起、还没落地的重试（新值已经接管）。
+		* 只影响 retry 判定，正在途中的那次 perform 不受干扰。
+		* @param label - 字段名（与 submit 的去重键同一个）。
+		*/
+		const supersede = (label) => {
+			writeEpochs.set(label, (writeEpochs.get(label) ?? 0) + 1);
+		};
+		const submit = (perform, label = "settings") => {
+			const epoch = (writeEpochs.get(label) ?? 0) + 1;
+			writeEpochs.set(label, epoch);
+			const run = async (attempt) => {
+				if (attempt > 0 && writeEpochs.get(label) !== epoch) return false;
+				let accepted;
+				try {
+					accepted = await perform();
+				} catch (error) {
+					if (attempt >= WRITE_RETRY_DELAYS.length) {
+						console.warn(`dsh-notice-center: settings write failed (${label}, 第 ${attempt + 1} 次)`, error);
+						return false;
+					}
+					await wait(WRITE_RETRY_DELAYS[attempt]);
+					return run(attempt + 1);
+				}
+				if (accepted !== false) return true;
+				if (attempt >= WRITE_RETRY_DELAYS.length) {
+					console.warn(`dsh-notice-center: settings write was not accepted (${label}, 第 ${attempt + 1} 次)`);
+					return false;
+				}
+				await wait(WRITE_RETRY_DELAYS[attempt]);
+				return run(attempt + 1);
+			};
+			return run(0);
+		};
+		/**
+		* 手势静默窗口：多久没再动过，就把攒下的最新值写出去（并结束这个手势）。
+		*
+		* 为什么必须合并写（2026-09-26 现场取证）：每笔 set/unset 都走 dsh-config-editor.edit
+		* —— 重写整份 profile 的 cordis.patch.yml + Loader 热重载插件条目，实测约 1s/笔；而
+		* 原生滑杆每挪一格、原生取色器每拖一下就发一次 input，一次拖动几十笔全排进写队列，
+		* 回显被拖到好几秒之后，受控 value 又一直被旧快照拽回去 —— 表现就是「改了没反应、等
+		* 半天才变、还一直往回掉」。手势内改值时用 supersede() 作废上一笔还没落地的重试，
+		* 所以再短的窗口也不会让旧值盖回新值。
+		*/
+		const VOLUME_QUIET_MS = 150;
+		/**
+		* 手势合并写（音量滑杆 + 颜色取色器共用）：一次拖动/连点只落「首笔立即 + 静默后补一笔」。
+		*
+		* 拆成模块级工厂而不是每处手写：滑杆那次排查踩过的坑（逐 input 写宿主 → 写队列堆积
+		* → 受控回显被旧快照拽回去）在取色器上一模一样，逻辑只留一份，行为由
+		* test/client-half.smoke.mjs 第 17/18 节钉死。
+		*
+		* @param label - 字段名：日志定位 + 同字段重试去重键（手势内改值会 supersede 旧重试）。
+		* @param commit - 实际写入，返回 Promise<boolean>（宿主是否已接受）。
+		* @param onSettle - 一笔写入落定后的回调：（本次写的值, 是否落盘, 是否还有排队值）。
+		* @returns push / drop / dispose 三个操作。
+		*/
+		const createGestureWriter = (label, commit, onSettle) => {
+			const state = { started: false, inFlight: false, queued: void 0, quiet: void 0 };
+			const armQuiet = () => {
+				if (state.quiet !== void 0) clearTimeout(state.quiet);
+				state.quiet = setTimeout(() => {
+					state.quiet = void 0;
+					if (state.inFlight) return;
+					if (state.queued !== void 0) flush();
+					else state.started = false;
+				}, VOLUME_QUIET_MS);
+			};
+			const flush = () => {
+				const value = state.queued;
+				if (value === void 0) return;
+				state.queued = void 0;
+				state.inFlight = true;
+				submit(() => commit(value), label).then((landed) => {
+					state.inFlight = false;
+					onSettle?.(value, landed, state.queued !== void 0);
+					armQuiet();
+				});
+			};
+			return {
+				/** 手势内的值：首笔立即写（点一下就生效），其后只攒最新值等静默窗口。 */
+				push: (value) => {
+					state.queued = value;
+					if (state.started) {
+						supersede(label);
+						armQuiet();
+						return;
+					}
+					state.started = true;
+					flush();
+				},
+				/** 丢掉排队中的值并作废旧重试 —— 复位按钮这类「整笔覆盖」的直写要用。 */
+				drop: () => {
+					state.queued = void 0;
+					if (state.quiet !== void 0) {
+						clearTimeout(state.quiet);
+						state.quiet = void 0;
+					}
+					supersede(label);
+					state.started = false;
+				},
+				/** 卸载时清计时器。 */
+				dispose: () => {
+					if (state.quiet !== void 0) clearTimeout(state.quiet);
+				}
+			};
+		};
+		/**
 		* 设置页组件 —— 注册进官方设置面板的 `settings.section` 槽。
 		*
 		* 三行颜色（完成/待处理/默认），每行原生 ColorPicker + hex 文本框（约 1/3 宽）
@@ -432,33 +563,125 @@ function playSound(id, volume, kind) {
 		* - 输入非法时提示错误、不写入（拒绝写入并提示）。
 		* 每行恢复按钮只清对应字段：绿/琥珀回官方默认，黑 → 官方原版。
 		*
-		* ⚠️ this 绑定：SettingsScopeController 的方法是类方法（依赖 this.store），
+		* ⚠️ this 绑定：ConfigFormController 的方法是类方法（依赖 this.store），
 		* 直接传裸引用给 useSyncExternalStore 会丢 this 导致渲染崩溃，必须箭头包装。
 		*/
 		function WhaleSettingsSection({ scope, t }) {
 			if (scope === void 0 || t === void 0) return null;
-			const value = (0, react.useSyncExternalStore)((listener) => scope.subscribe(listener), () => scope.getSnapshot(), () => scope.getSnapshot()).value ?? {};
+			/* ⚠️ 所有 hook 必须在这一个函数体里无条件跑完，再进入下面的 status 分支。
+			   提前 return 会让 hook 数量在两次渲染之间变化（loading 时 1 个、ready 时 6 个），
+			   React 直接抛 "Rendered more hooks than during the previous render"，
+			   插槽的错误边界把整页吞成空白 —— 2026-09-26 就这么白过一次。 */
+			const snapshot = (0, react.useSyncExternalStore)((listener) => scope.subscribe(listener), () => scope.getSnapshot(), () => scope.getSnapshot());
 			/** 通知权限的本地态（未授权提示 + 开启通知时自动请求）。 */
 			const [permission, setPermission] = (0, react.useState)(notificationSupport());
 			/** 两个分组的展开态（本地 UI 状态，均默认折叠）。 */
 			const [colorsExpanded, setColorsExpanded] = (0, react.useState)(false);
 			const [notifyExpanded, setNotifyExpanded] = (0, react.useState)(false);
+			/** 音量试听的防抖计时器（拖动过程中不连响，停手后放一遍）。 */
+			const volumeTimer = (0, react.useRef)(void 0);
+			/** 颜色回显草稿（{字段: 色值}）：取色 / 复位当帧就改预览 —— 一次写要重写整份
+			*  profile patch 并热重载条目（约 1s），干等回显的话，预览鲸鱼会先僵在旧色上。 */
+			const colorDraftState = (0, react.useState)(void 0);
+			const colorDraft = colorDraftState[0];
+			const setColorDraft = colorDraftState[1];
+			/** 音量回显草稿：拖动当帧就画出新值，不等宿主往返 —— 受控滑杆干等回显时，
+			*  每次渲染都会被旧快照拽回原位，看着就是「拖了没反应」。 */
+			const volumeDraftState = (0, react.useState)(void 0);
+			const volumeDraft = volumeDraftState[0];
+			const setVolumeDraft = volumeDraftState[1];
+			/** 手势写管道容器（useRef 只保证容器存在，内容由各自 writer 懒建）。 */
+			const volumePipe = (0, react.useRef)(void 0);
+			/** 颜色三个字段各一条管道 —— 三个字段是三次独立手势，不能互相合并。 */
+			const colorPipes = (0, react.useRef)(void 0);
+			(0, react.useEffect)(() => () => {
+				if (volumeTimer.current !== void 0) clearTimeout(volumeTimer.current);
+				volumePipe.current?.dispose();
+				const pipes = colorPipes.current;
+				if (pipes !== void 0) for (const key of Object.keys(pipes)) pipes[key].dispose();
+			}, []);
+			/* 草稿被宿主回显追平 → 交还给快照（两者同值，画面无跳变）。 */
+			(0, react.useEffect)(() => {
+				if (volumeDraft === void 0) return;
+				const current = normalizeVolume((snapshot.value ?? {}).notifyVolume ?? NOTIFY_DEFAULTS.notifyVolume);
+				if (current === volumeDraft) setVolumeDraft(void 0);
+			}, [snapshot, volumeDraft]);
+			/* ===== hook 到此结束，以下才可以按状态分支渲染 ===== */
+			/* 0.1.7 的快照多了 status / writable：unavailable 表示宿主没提供这个条目（或页面是
+			   memory 模式＝非 loopback 访问），此时没有可读写的值 —— 给一句说明，而不是画一堆
+			   写了不生效的控件；loading 期间先不渲染。 */
+			if (snapshot.status === "loading") return null;
+			if (snapshot.status === "unavailable" || snapshot.writable === false) {
+				return (0, react_jsx_runtime.jsx)("p", {
+					style: {
+						color: "var(--dsw-alias-label-tertiary)",
+						fontSize: 13,
+						lineHeight: "20px",
+						margin: 0
+					},
+					children: t(snapshot.status === "unavailable" ? "settingsUnavailable" : "settingsReadOnly")
+				});
+			}
+			const value = snapshot.value ?? {};
 			/** 当前值（未配置回默认）。 */
 			const colorsEnabled = value.colorsEnabled ?? COLORS_ENABLED_DEFAULT;
 			const notifyEnabled = value.notifyEnabled ?? NOTIFY_DEFAULTS.notifyEnabled;
 			const notifySound = value.notifySound ?? NOTIFY_DEFAULTS.notifySound;
+			/** 快照里的音量（宿主真值）。 */
 			const notifyVolume = normalizeVolume(value.notifyVolume ?? NOTIFY_DEFAULTS.notifyVolume);
+			/** 画面用的音量：手上有草稿就用草稿（拖动当帧反馈），否则用快照。 */
+			const shownVolume = volumeDraft === void 0 ? notifyVolume : volumeDraft;
 			const notifyAutoHide = value.notifyAutoHide ?? NOTIFY_DEFAULTS.notifyAutoHide;
 			const notifyForeground = value.notifyForeground ?? NOTIFY_DEFAULTS.notifyForeground;
-			/** 音量试听的防抖计时器（拖动过程中不连响，停手后放一遍）。 */
-			const volumeTimer = (0, react.useRef)(void 0);
-			(0, react.useEffect)(() => () => {
-				if (volumeTimer.current !== void 0) clearTimeout(volumeTimer.current);
-			}, []);
-			/** 改音量后试听当前设置的完成提示音：250ms 防抖，只在停手后按新音量放一次。
-			*  primeChime 必须在 onChange 这个用户手势里调，否则防抖后 resume 可能被自动播放策略拦。 */
+			/** 音量手势写（懒建）：首笔立即 + 静默补笔，落定后决定要不要回滚草稿。 */
+			const volumeWriter = () => {
+				if (volumePipe.current === void 0) {
+					volumePipe.current = createGestureWriter("notifyVolume", (next) => scope.set("notifyVolume", next), (value, landed, hasQueued) => {
+						/* 最终没落盘、且期间没有更新的值排队 → 回滚草稿，别让界面显示一个假值。 */
+						if (landed !== true && !hasQueued) setVolumeDraft((draft) => (draft === value ? void 0 : draft));
+					});
+				}
+				return volumePipe.current;
+			};
+			/** 撤掉某个字段的回显草稿：只有值仍是我们当时写的那个才撤 —— 中途被更新的
+			*  手势接管时撤，会把新草稿一起抹掉。 */
+			const clearColorDraft = (key, expected) => {
+				setColorDraft((draft) => {
+					if (draft === void 0 || draft[key] !== expected) return draft;
+					const next = { ...draft };
+					delete next[key];
+					return Object.keys(next).length > 0 ? next : void 0;
+				});
+			};
+			/** 颜色手势写（三个字段各一条管道，互不合并）。 */
+			const colorWriter = (key) => {
+				if (colorPipes.current === void 0) colorPipes.current = {};
+				return colorPipes.current[key] ?? (colorPipes.current[key] = createGestureWriter(key, (hex) => scope.set(key, hex), (hex, _landed, hasQueued) => {
+					/* 落盘成功 → 快照已是新值，撤草稿无缝；失败 → 回到快照真值，预览不说谎。 */
+					if (!hasQueued) clearColorDraft(key, hex);
+				}));
+			};
+			/** 取色：当帧先改预览，写宿主按手势合并 —— 原生取色器拖动时会连发 input，
+			*  逐帧写就是音量滑杆那次踩过的坑（一次热重载 ≈1s，写队列直接堆爆）。 */
+			const pickColor = (key, hex) => {
+				setColorDraft((draft) => ({ ...(draft ?? {}), [key]: hex }));
+				colorWriter(key).push(hex);
+			};
+			/** 恢复默认：当帧先显示默认色，再 unset —— 整笔覆盖，所以先丢掉排队中的取色值。 */
+			const resetColor = (key) => {
+				const expected = COLOR_DEFAULTS[key];
+				setColorDraft((draft) => ({ ...(draft ?? {}), [key]: expected }));
+				colorWriter(key).drop();
+				submit(() => scope.unset(key), key).finally(() => clearColorDraft(key, expected));
+			};
+			/** 画面用的颜色：草稿优先（当帧反馈），否则快照，再回默认。 */
+			const colorOf = (key) => (colorDraft !== void 0 && colorDraft[key] !== void 0 ? colorDraft[key] : (value[key] ?? COLOR_DEFAULTS[key]));
+			/** 拖动/点按滑杆：当帧先画草稿（回显不再等宿主），写宿主按手势合并 ——
+			*  第一笔立即写（点一下就生效），其后只攒最新值、静默 150ms 后补最后一笔。
+			*  试听照旧 250ms 防抖；primeChime 必须在这个用户手势里调，
+			*  否则防抖后 resume 可能被自动播放策略拦。 */
 			const previewVolume = (next) => {
-				scope.set("notifyVolume", next);
+				setVolumeDraft(next);
 				primeChime();
 				if (volumeTimer.current !== void 0) clearTimeout(volumeTimer.current);
 				volumeTimer.current = setTimeout(() => {
@@ -466,6 +689,7 @@ function playSound(id, volume, kind) {
 					const snapshot = scope.getSnapshot().value ?? {};
 					playSound(snapshot.notifyDoneSound ?? NOTIFY_DEFAULTS.notifyDoneSound, next, "done");
 				}, 250);
+				volumeWriter().push(next);
 			};
 			/** 官方设置行规格（对齐「通用设置 → 权限」字段的 row/title/desc 样式）。 */
 			const rowStyle = {
@@ -562,7 +786,7 @@ function playSound(id, volume, kind) {
 								transform: expanded ? "rotate(180deg)" : "none",
 								transition: "transform 0.2s"
 							},
-							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(primitives.IconChevronDownOutline14, { size: 14 })
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(primitives.IconChevronDownOutlineRegular, { size: 14 })
 						})
 					})
 				]
@@ -613,7 +837,7 @@ function playSound(id, volume, kind) {
 						min: 0,
 						max: 100,
 						step: 5,
-						value: Math.round(notifyVolume * 100),
+						value: Math.round(shownVolume * 100),
 						"aria-label": t("notifyVolume"),
 						onChange: (e) => previewVolume(Number(e.target.value) / 100),
 						style: {
@@ -632,7 +856,7 @@ function playSound(id, volume, kind) {
 							fontSize: 12,
 							lineHeight: "18px"
 						},
-						children: [Math.round(notifyVolume * 100), "%"]
+						children: [Math.round(shownVolume * 100), "%"]
 					})
 				]
 			}, "volume");
@@ -657,10 +881,10 @@ function playSound(id, volume, kind) {
 						value: currentSound,
 						groups: soundLibrary(t),
 						names: soundNames(t),
-						volume: notifyVolume,
+						volume: shownVolume,
 						kind,
 						t,
-						onChange: (next) => scope.set(kind === "done" ? "notifyDoneSound" : "notifyPendingSound", next)
+						onChange: (next) => submit(() => scope.set(soundKey, next), soundKey)
 					})
 				]
 			}, kind);
@@ -694,7 +918,7 @@ function playSound(id, volume, kind) {
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								style: {
 									display: "inline-flex",
-									color: value[key] ?? COLOR_DEFAULTS[key]
+									color: colorOf(key)
 								},
 								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
 									viewBox: "0 0 50 50",
@@ -708,8 +932,8 @@ function playSound(id, volume, kind) {
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
 								type: "color",
-								value: value[key] ?? COLOR_DEFAULTS[key],
-								onChange: (e) => scope.set(key, e.target.value),
+								value: colorOf(key),
+								onChange: (e) => pickColor(key, e.target.value),
 								"aria-label": label,
 								style: {
 									position: "absolute",
@@ -730,13 +954,13 @@ function playSound(id, volume, kind) {
 						"aria-label": t("restore"),
 						onClick: onReset,
 						style: iconButtonStyle,
-						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(primitives.IconRefreshOutline14, { size: 14 })
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(primitives.IconRefreshOutlineRegular, { size: 14 })
 					})
 				]
 			}, key);
 			/** 打开通知总开关时：预热音频上下文（用户手势内）并在未授权时请求通知权限。 */
 			const setNotifyEnabled = (next) => {
-				scope.set("notifyEnabled", next);
+				submit(() => scope.set("notifyEnabled", next), "notifyEnabled");
 				if (!next) return;
 				primeChime();
 				if (notificationSupport() !== "default") return;
@@ -761,14 +985,14 @@ function playSound(id, volume, kind) {
 						repo: PLUGIN_REPO,
 						t
 					}),
-					sectionRow("colorsEnabled", t("groupColors"), t("colorsHint"), colorsEnabled, (next) => scope.set("colorsEnabled", next), colorsExpanded, () => setColorsExpanded((current) => !current), t("colorsExpand")),
-					colorsExpanded ? colorRow("green", t("greenLabel"), () => scope.unset("green")) : null,
-					colorsExpanded ? colorRow("amber", t("amberLabel"), () => scope.unset("amber")) : null,
-					colorsExpanded ? colorRow("black", t("blackLabel"), () => scope.unset("black")) : null,
+					sectionRow("colorsEnabled", t("groupColors"), t("colorsHint"), colorsEnabled, (next) => submit(() => scope.set("colorsEnabled", next), "colorsEnabled"), colorsExpanded, () => setColorsExpanded((current) => !current), t("colorsExpand")),
+					colorsExpanded ? colorRow("green", t("greenLabel"), () => resetColor("green")) : null,
+					colorsExpanded ? colorRow("amber", t("amberLabel"), () => resetColor("amber")) : null,
+					colorsExpanded ? colorRow("black", t("blackLabel"), () => resetColor("black")) : null,
 					sectionRow("notifyEnabled", t("groupNotify"), t("notifyEnabledHint"), notifyEnabled, setNotifyEnabled, notifyExpanded, () => setNotifyExpanded((current) => !current), t("notifyExpand")),
-					notifyExpanded ? switchRow("notifyAutoHide", t("notifyAutoHide"), t("notifyAutoHideHint"), notifyAutoHide, (next) => scope.set("notifyAutoHide", next)) : null,
-					notifyExpanded ? switchRow("notifyForeground", t("notifyForeground"), t("notifyForegroundHint"), notifyForeground, (next) => scope.set("notifyForeground", next)) : null,
-					notifyExpanded ? switchRow("notifySound", t("notifySound"), void 0, notifySound, (next) => scope.set("notifySound", next)) : null,
+					notifyExpanded ? switchRow("notifyAutoHide", t("notifyAutoHide"), t("notifyAutoHideHint"), notifyAutoHide, (next) => submit(() => scope.set("notifyAutoHide", next), "notifyAutoHide")) : null,
+					notifyExpanded ? switchRow("notifyForeground", t("notifyForeground"), t("notifyForegroundHint"), notifyForeground, (next) => submit(() => scope.set("notifyForeground", next), "notifyForeground")) : null,
+					notifyExpanded ? switchRow("notifySound", t("notifySound"), void 0, notifySound, (next) => submit(() => scope.set("notifySound", next), "notifySound")) : null,
 					notifyExpanded ? volumeRow() : null,
 					notifyExpanded ? soundRow("done", t("notifyDoneSound")) : null,
 					notifyExpanded ? soundRow("pending", t("notifyPendingSound")) : null,
@@ -848,7 +1072,7 @@ function playSound(id, volume, kind) {
 			"sessions",
 			"slots",
 			"locale",
-			"settingsScope"
+			"configForms"
 		];
 		/**
 		* 本轮用时文案（格式照官方 formatRunDuration：满 60 秒进位到分，秒补零）。
@@ -868,16 +1092,21 @@ function playSound(id, volume, kind) {
 		}
 		function apply(ctx) {
 			const list = ctx.sessions.list;
-			/** 绑定 `notice-center` 命名空间：读快照 + 写用户配置（宿主 schema 校验）。 */
-			const scope = ctx.settingsScope.bind({ namespace: SETTINGS_NAMESPACE });
 			/**
-			* 待处理交互信号（0.1.2-rc.1+）：官方把「有待处理交互」从会话行字段迁到
-			* dsh-client-ui-session 的 uiSession.pendingInteractions 独立 store
-			* （Map<sessionId, interaction>，提问/审批处理完自动移除）。
-			* 早于 0.1.2-rc.1 的版本没有该服务，因此下面用 ctx.inject 做**可选通道**：
-			* 服务缺席时该子 fiber 不加载，琥珀判定自动回退到旧版行字段。
+			* 绑定本体设置条目。0.1.7 起旧的 `settingsScope` 服务已删除，改用
+			* `configForms.get(条目 id)` —— 这个 id 就是 SETTINGS_NAMESPACE，也是
+			* cordis.patch.yml 插入的 Loader 条目 id（`id: notice-center`）。
+			* 快照多出 status / writable / revision：status 为 unavailable 表示宿主没有
+			* 这个条目（或页面是 memory 模式＝非 loopback），此时读写都不生效。
+			*/
+			const scope = ctx.configForms.get(SETTINGS_NAMESPACE);
+			/**
+			* 官方会话状态（0.1.7 的 uiSession.sessionStatus）：Map<会话 id,
+			* {running, pendingInteraction, completionUnread}>。旧的行字段 completed /
+			* pendingInteraction 与 uiSession.pendingInteractions store 都已删除 ——
+			* 官方 workspace 的会话行用同一套映射（completed = completionUnread）。
 			*/
-			let pendingStore;
+			let statusMap = new Map();
 			/** 已完成/待处理通知的去重键（sessionId 加冒号加 kind）。 */
 			const notified = new Set();
 			/** 聚合队列与窗口：同一批状态跃迁合并成一条通知，避免刷屏。 */
@@ -1002,7 +1231,7 @@ function playSound(id, volume, kind) {
 			* 就这三种），更细的信息在 entry 的 domain 字段上：审批的 toolName、提问的 questions
 			* 批次。这里读这些字段做细化，**全部防御式读取** —— bundle 不 import 那些类型，
 			* 字段缺席、类型不符（第三方域自造 kind）时逐级降级，绝不显示错误的类型名。
-			* @param interaction - pendingInteractions 的 entry；缺席时为 undefined。
+			* @param interaction - sessionStatus 里的 pendingInteraction；缺席时为 undefined。
 			* @returns 正文文案；完全认不出时 undefined，调用方回退「有交互等待处理」。
 			*/
 			function pendingTypeLabel(interaction) {
@@ -1027,44 +1256,91 @@ function playSound(id, volume, kind) {
 				const key = PENDING_KIND_KEYS[kind];
 				return key === void 0 ? void 0 : t(key);
 			}
-			/** 状态跃迁检测：官方 completed 由 false 变 true、以及 pending store 新增会话。 */
+			/**
+			* 0.1.7 的会话行视图：把官方 sessionStatus 合并进 list 的行。
+			* 旧行字段 completed / pendingInteraction 已删，running 也可能缺省，因此三个
+			* 状态字段一律取自官方状态（映射同官方 workspace 的 sessionNode）。
+			* @param state - ctx.sessions.list 的快照。
+			* @returns 扁平化的行数组（id/origin/title/running/completed/pending）。
+			*/
+			function sessionRows(state) {
+				return Object.values(state.byId).map((row) => {
+					const status = statusMap.get(row.id);
+					return {
+						id: row.id,
+						origin: row.origin,
+						title: row.displayTitle ?? row.title ?? row.id,
+						running: status?.running ?? row.running === true,
+						completed: status?.completionUnread === true,
+						pending: status?.pendingInteraction
+					};
+				});
+			}
+			/** 状态跃迁检测：completed 由 false 变 true、以及新出现的待处理会话。 */
 			function detectTransitions(state) {
-				for (const row of Object.values(state.byId)) {
+				const rows = sessionRows(state);
+				for (const row of rows) {
 					if (row.origin === "subagent") continue;
 					const before = prevCompleted.get(row.id);
 					const now = row.completed === true;
-					if (before === false && now) queueNotification("done", row.id, row.displayTitle ?? row.title ?? row.id, void 0, lastRunMs.get(row.id));
+					if (before === false && now) queueNotification("done", row.id, row.title, void 0, lastRunMs.get(row.id));
 					if (!now) notified.delete(row.id + ":done");
 					prevCompleted.set(row.id, now);
 				}
-				for (const id of [...prevCompleted.keys()]) if (!(id in state.byId)) {
+				const alive = new Set(rows.map((row) => row.id));
+				for (const id of [...prevCompleted.keys()]) if (!alive.has(id)) {
 					prevCompleted.delete(id);
 					notified.delete(id + ":done");
 				}
-				const pendingMap = pendingStore?.getSnapshot();
-				const current = new Set(pendingMap === void 0 ? [] : [...pendingMap.keys()]);
+				const pendingNow = new Map(rows.filter((row) => row.pending !== void 0).map((row) => [row.id, row]));
+				const current = new Set(pendingNow.keys());
 				if (pendingSeen) for (const id of current) {
 					if (prevPending.has(id)) continue;
-					const row = state.byId[id];
+					const row = pendingNow.get(id);
 					if (row !== void 0 && row.origin === "subagent") continue;
-					const label = row?.displayTitle ?? row?.title ?? id;
-					queueNotification("pending", id, label, pendingTypeLabel(pendingMap?.get(id)));
+					queueNotification("pending", id, row?.title ?? id, pendingTypeLabel(row?.pending));
 				}
 				for (const id of prevPending) if (!current.has(id)) notified.delete(id + ":pending");
 				prevPending = current;
 				pendingSeen = true;
 			}
-			const iconLink = () => document.head.querySelector("link[rel~=\"icon\"]");
+			/**
+			* 页面里的**全部** favicon link。宿主 index.html 挂了两枚 —— dark / light 各一枚，
+			* 靠 media="(prefers-color-scheme: …)" 区分，浏览器按系统主题挑一枚用。
+			* 早先这里用 querySelector 只拿到**第一枚**（dark 那枚），浅色系统实际渲染的是
+			* 第二枚 —— 于是状态灯改了也看不见：2026-09-26 用户反馈「标签页图标一直默认色」。
+			* 一枚都没有就自建一枚，否则整条改色路径会静默失效（什么也不改，也不报错）。
+			*/
+			const faviconLinks = () => {
+				const found = [...document.head.querySelectorAll("link[rel~=\"icon\"]")];
+				if (found.length > 0) return found;
+				const link = document.createElement("link");
+				link.rel = "icon";
+				link.type = "image/svg+xml";
+				link.href = DEFAULT_HREF;
+				document.head.appendChild(link);
+				return [link];
+			};
 			/**
 			* 导航图标：官方 settings.section 的图标由 shell 按 section id 硬编码（未知 id
-			* 回退默认齿轮），注册选项里没有 icon 字段；这里把「通知中心」导航项的 path
-			* 数据换成官方 IconQueueOutline14 的矢量数据（语义一致：一叠待处理条目）。
-			* 数据取自内核 UI 原语 @deepseek-ai/dsh-client-ui-primitives（viewBox 0 0 14 14，
-			* 单 path，fill=currentColor）。只改属性、不增删 React 管理的节点。
+			* 回退默认齿轮），注册选项里没有 icon 字段；这里把「通知中心」导航项那颗 svg 的
+			* path 数据换成主人指定的铃铛（viewBox 0 0 1024 1024，原图三块 path）。
+			*
+			* 只改属性、不增删 React 管理的节点 —— 节点归 React 所有，插件增删会被下一次渲染
+			* 打回齿轮。官方回退齿轮正好只有 2 个 path，所以把同为 #333333 的两块（铃身 + 底座）
+			* 合并成一条 path、高光单独一条，正好复用这 2 个节点；万一官方给的图标 path 更少，
+			* 只追加克隆节点（绝不删）—— React 插入时引用的是它自己管的节点，不会因此抛错。
+			* 铃身/底座原色 #333333 改成 currentColor 跟随主题（深色主题下 #333333 几乎看不见），
+			* 高光保留原图的 #3399FF；想要原汁原味的深灰，把 fill 改回 "#333333" 即可。
 			*/
-			const NAV_ICON_PATH = "M7.00049 0.199829C3.24488 0.199829 0.199952 3.24408 0.199707 6.99963C0.199707 8.0414 0.434087 9.03061 0.854004 9.91467L1.11279 10.4576L2.19775 9.94202L1.94092 9.39905L1.81787 9.12268C1.5498 8.46885 1.40186 7.75171 1.40186 6.99963C1.4021 3.90808 3.90888 1.40198 7.00049 1.40198C10.0919 1.40219 12.5979 3.90821 12.5981 6.99963C12.5981 10.0913 10.0921 12.5981 7.00049 12.5983C6.36734 12.5983 5.90348 12.5535 5.49268 12.4401C5.08803 12.3283 4.7041 12.1414 4.24463 11.8209C3.57111 11.3511 2.60588 11.1855 1.81006 11.6881L1.79736 11.6959L1.78467 11.7047L1.25537 12.0778L1.65381 13.2672L2.46045 12.6989C2.75029 12.5214 3.18004 12.5442 3.55615 12.8063C4.10063 13.1861 4.60863 13.4423 5.17334 13.5983C5.73194 13.7525 6.31665 13.8004 7.00049 13.8004C10.7561 13.8002 13.8003 10.7553 13.8003 6.99963C13.8 3.24421 10.7559 0.200041 7.00049 0.199829ZM3.81201 7.47327V8.67542H7.11572V7.47327H3.81201ZM3.81201 6.34924H10.2173V5.14709H3.81201V6.34924Z";
+			const NAV_ICON_VIEWBOX = "0 0 1024 1024";
+			const NAV_ICON_PATHS = [
+				{ fill: "currentColor", d: "M921.6 880.64h-819.2A51.2 51.2 0 0 1 51.2 829.44v-66.56A107.7248 107.7248 0 0 1 158.72 655.36a30.72 30.72 0 0 0 30.72-30.72V376.832A319.6928 319.6928 0 0 1 399.36 78.2336a112.0256 112.0256 0 0 1 213.6064 0A319.6928 319.6928 0 0 1 824.32 376.832v247.808a30.72 30.72 0 0 0 30.72 30.72h10.24A107.7248 107.7248 0 0 1 972.8 762.88v66.56a51.2 51.2 0 0 1-51.2 51.2zM112.64 819.2h798.72v-56.32A46.08 46.08 0 0 0 865.28 716.8h-10.24a92.16 92.16 0 0 1-92.16-92.16V376.832a257.8432 257.8432 0 0 0-184.32-245.76l-19.0464-5.7344-2.6624-20.48a50.7904 50.7904 0 0 0-100.7616 0l-2.6624 20.48-19.0464 5.7344a257.8432 257.8432 0 0 0-184.32 245.76v247.808A92.16 92.16 0 0 1 158.72 716.8 46.08 46.08 0 0 0 112.64 762.88z M512 1024a174.2848 174.2848 0 0 1-174.08-174.08h61.44a112.64 112.64 0 0 0 225.28 0h61.44a174.2848 174.2848 0 0 1-174.08 174.08z" },
+				{ fill: "#3399FF", d: "M665.6 353.6896a30.72 30.72 0 0 1-25.6-13.9264A259.4816 259.4816 0 0 0 542.72 251.904a30.72 30.72 0 0 1 28.2624-54.4768 320.9216 320.9216 0 0 1 120.6272 108.7488A30.72 30.72 0 0 1 665.6 353.6896z" }
+			];
 			let navIconScheduled = false;
-			/** 把「通知中心」导航项的图标替换为官方 IconQueueOutline14（幂等）。 */
+			/** 把「通知中心」导航项的图标换成上面的铃铛（幂等：已经画过就整块跳过 —— 
+			*  每次写属性都会再触发 observer，不跳过就是无限 rAF 循环）。 */
 			function applyNavIcon() {
 				const nav = document.querySelector("[role=\"dialog\"] nav");
 				if (nav === null) return;
@@ -1073,18 +1349,33 @@ function playSound(id, volume, kind) {
 					if (cell.textContent === null || !cell.textContent.includes(label)) continue;
 					const svg = cell.querySelector("svg");
 					if (svg === null) continue;
-					const paths = svg.querySelectorAll("path");
+					let paths = [...svg.querySelectorAll("path")];
 					if (paths.length === 0) continue;
-					if (paths[0].getAttribute("d") === NAV_ICON_PATH) continue;
-					svg.setAttribute("viewBox", "0 0 14 14");
+					const drawn = svg.getAttribute("viewBox") === NAV_ICON_VIEWBOX
+						&& paths.length >= NAV_ICON_PATHS.length
+						&& NAV_ICON_PATHS.every((spec, index) => paths[index].getAttribute("d") === spec.d && paths[index].getAttribute("fill") === spec.fill)
+						&& paths.slice(NAV_ICON_PATHS.length).every((path) => (path.getAttribute("d") ?? "") === "");
+					if (drawn) continue;
+					/* 官方图标的 path 不够用时只追加克隆节点（不删 React 管的节点）。 */
+					while (paths.length < NAV_ICON_PATHS.length) {
+						svg.appendChild(paths[paths.length - 1].cloneNode(false));
+						paths = [...svg.querySelectorAll("path")];
+					}
+					svg.setAttribute("viewBox", NAV_ICON_VIEWBOX);
 					svg.setAttribute("width", "16");
 					svg.setAttribute("height", "16");
 					paths.forEach((path, index) => {
-						if (index === 0) {
-							path.setAttribute("d", NAV_ICON_PATH);
-							path.setAttribute("fill", "currentColor");
-							path.removeAttribute("fill-rule");
-						} else path.setAttribute("d", "");
+						const spec = NAV_ICON_PATHS[index];
+						if (spec === void 0) {
+							path.setAttribute("d", "");
+							return;
+						}
+						path.setAttribute("d", spec.d);
+						path.setAttribute("fill", spec.fill);
+						/* 官方图标是 stroke 画法（fill:none + stroke:currentColor），
+						   不去掉 stroke 会在实心轮廓外再描一圈，1024 坐标下会糊成一团。 */
+						path.removeAttribute("stroke");
+						path.removeAttribute("fill-rule");
 					});
 				}
 			}
@@ -1105,21 +1396,31 @@ function playSound(id, volume, kind) {
 				attributeFilter: ["d"]
 			});
 			scheduleNavIcon();
+			/** 每枚 icon 的原始 href —— 还原目标（比硬编码路径更稳，前端改路径也能正确还原）；
+			*  两枚各记各的，dark 还原成 favicon-dark.svg、light 还原成 favicon.svg。 */
+			const faviconOriginals = faviconLinks().map((link) => ({ link, href: link.href }));
+			/** 应用之后才出现的 link（或自建的那枚）补记原始值，别把别人的 href 当我们的还原。 */
+			const rememberFavicon = (link) => {
+				if (!faviconOriginals.some((item) => item.link === link)) faviconOriginals.push({ link, href: link.href });
+			};
 			const setHref = (href) => {
-				const link = iconLink();
-				if (link) link.href = href;
+				for (const link of faviconLinks()) {
+					rememberFavicon(link);
+					link.href = href;
+				}
+			};
+			const restoreHrefs = () => {
+				for (const item of faviconOriginals) item.link.href = item.href;
 			};
-			/** 应用瞬间的原始 href —— 还原目标（比硬编码路径更稳，前端改路径也能正确还原）。 */
-			const originalHref = iconLink()?.href ?? DEFAULT_HREF;
 			/** 我们最后一次设置的 href；null = 官方原样。 */
 			let applied = null;
 			/** 自跟踪：每会话最后观察到的 running 位（镜像官方 prevRunning 语义）。 */
 			const prevRunning = /* @__PURE__ */ new Map();
-			/** 完成时恰好被选中、且当时标签页不在台前的主会话（官方不报的空缺）。 */
+			/** 标签页不在台前时跑完的主会话（官方 completionUnread 之外的本地兜底）。 */
 			const finishedWhileHidden = /* @__PURE__ */ new Set();
 			const restore = () => {
 				if (applied !== null) {
-					setHref(originalHref);
+					restoreHrefs();
 					applied = null;
 				}
 			};
@@ -1133,41 +1434,46 @@ function playSound(id, volume, kind) {
 				};
 			}
 			const uri = (hex) => `data:image/svg+xml,${encodeURIComponent(whaleSvg(hex))}`;
-			/** running true→false 边沿跟踪（只跟踪主会话）：完成时恰好被选中 →
-			*  绿灯记入 finishedWhileHidden（仅当标签页不在台前；台前完成不记，V0-02）；
-			*  通知则无条件入队，由 flush 按「前台也提醒」统一裁决。官方 syncCompletedNotifications
-			*  只报"未选中时完成"（`sessionId !== selected` 才 arm），选中的空缺在这里补齐。
-			*  重新运行、会话移除均清除。 */
+			/** running true→false 边沿跟踪（只跟踪主会话）：标签页不在台前时跑完 →
+			*  绿灯记入 finishedWhileHidden；通知无条件入队，由 flush 按「前台也提醒」统一裁决。
+			*  0.1.7 的 list 行已没有「当前选中会话」字段（state.current 已删），favicon 本来
+			*  就是跨会话聚合，因此对所有主会话一视同仁；completed 的语义也已搬到
+			*  status.completionUnread（官方只标「主视图之外的停顿」），这条运行边沿是
+			*  「选中会话完成也提醒」的来源。重新运行、会话移除均清除。 */
 			function trackEdges(state) {
-				for (const row of Object.values(state.byId)) {
+				const rows = sessionRows(state);
+				for (const row of rows) {
 					if (row.origin === "subagent") continue;
 					const prev = prevRunning.get(row.id);
 					if (prev === void 0) {
 						prevRunning.set(row.id, row.running);
 						continue;
 					}
-					if (!prev && row.running) runStartedAt.set(row.id, Date.now());
+					if (!prev && row.running) {
+						runStartedAt.set(row.id, Date.now());
+						/* 重新开始跑 → 清掉完成去重键，「同一会话连续完成两次」才会弹两次。 */
+						notified.delete(row.id + ":done");
+					}
 					if (prev && !row.running) {
 						const startedAt = runStartedAt.get(row.id);
 						const elapsed = startedAt === void 0 ? void 0 : Date.now() - startedAt;
 						runStartedAt.delete(row.id);
 						if (elapsed !== void 0) lastRunMs.set(row.id, elapsed);
 						/* 绿灯只记「没看着时跑完」；台前完成不记（V0-02）。 */
-						if (row.id === state.current && !isForeground()) finishedWhileHidden.add(row.id);
-						/* 通知另算：选中会话完成时官方不置 completed，这条是它的唯一来源，
-						   因此「前台要不要打扰」交给 flush 按 notifyForeground 统一裁决。 */
-						if (row.id === state.current) queueNotification("done", row.id, row.displayTitle ?? row.title ?? row.id, void 0, elapsed);
+						if (!isForeground()) finishedWhileHidden.add(row.id);
+						queueNotification("done", row.id, row.title, void 0, elapsed);
 					} else if (row.running) finishedWhileHidden.delete(row.id);
 					prevRunning.set(row.id, row.running);
 				}
-				for (const id of [...prevRunning.keys()]) if (!(id in state.byId)) {
+				const alive = new Set(rows.map((row) => row.id));
+				for (const id of [...prevRunning.keys()]) if (!alive.has(id)) {
 					prevRunning.delete(id);
 					finishedWhileHidden.delete(id);
 					runStartedAt.delete(id);
 					lastRunMs.delete(id);
 				}
 			}
-			/** 回到前台（标签页可见且窗口有焦点）→ 选中会话的绿灯熄灭（V0-02）。 */
+			/** 回到前台（标签页可见且窗口有焦点）→ 绿灯熄灭（V0-02）。 */
 			const onForeground = () => {
 				if (!isForeground()) return;
 				if (finishedWhileHidden.size > 0) {
@@ -1181,14 +1487,13 @@ function playSound(id, volume, kind) {
 			function targetOf(state) {
 				if ((scope.getSnapshot().value ?? {}).colorsEnabled === false) return null;
 				const c = colors();
-				const pendingMap = pendingStore?.getSnapshot();
 				let green = false;
 				/* 顺序照官方 sessionStatuses：pending interaction 是首要状态，live activity
 				   压过 completion reminder。favicon 是跨会话聚合，套用同一原则 —— 任意会话
 				   「卡住等你」都压过任意会话「跑完了」，否则审批会被完成提醒整片掩盖。 */
-				for (const row of Object.values(state.byId)) {
+				for (const row of sessionRows(state)) {
 					if (row.origin === "subagent") continue;
-					if (pendingMap?.has(row.id) || row.pendingInteraction !== void 0) return uri(c.amber);
+					if (row.pending !== void 0) return uri(c.amber);
 					if (row.completed === true || finishedWhileHidden.has(row.id)) green = true;
 				}
 				if (green) return uri(c.green);
@@ -1209,23 +1514,30 @@ trackEdges(state);
 			const unsubscribeScope = scope.subscribe(sync);
 			sync();
 			/**
-			* 可选通道：uiSession 服务存在时（0.1.2-rc.1 起）订阅其待处理交互 store。
-			* ctx.inject 声明的是必需服务，服务缺席时该子 fiber 不加载 —— 这正是需要
-			* 的效果：旧版本保持旧行字段语义，新版本拿到官方 pending 信号。
+			* 官方会话状态通道（0.1.7）：uiSession.sessionStatus 是 getSnapshot/subscribe
+			* 一对的只读源。旧的 uiSession.pendingInteractions store 已变成私有实现细节，
+			* 会话行上的 pendingInteraction 也被删了，所有「待处理 / 跑完 / 在跑」都从这里读。
+			* ctx.inject 声明的是必需服务，服务缺席时该子 fiber 不加载（琥珀判定随之失效）。
 			*/
 			ctx.inject(["uiSession"], (uiCtx) => {
-				pendingStore = uiCtx.uiSession.pendingInteractions;
-				const unsubscribe = pendingStore.subscribe(sync);
+				const source = uiCtx.uiSession.sessionStatus;
+				statusMap = source.getSnapshot();
+				const unsubscribe = source.subscribe(() => {
+					statusMap = source.getSnapshot();
+					sync();
+				});
 				sync();
 				return () => {
 					unsubscribe();
-					pendingStore = void 0;
+					statusMap = /* @__PURE__ */ new Map();
 					sync();
 				};
 			});
 			ctx.effect(() => ctx.locale.register(SETTINGS_NAMESPACE, {
 				zh: {
 					nav: "通知中心",
+					settingsUnavailable: "该插件当前未加载，暂时无法配置",
+					settingsReadOnly: "本部署的设置为只读",
 					greenLabel: "完成",
 					amberLabel: "待处理",
 					blackLabel: "默认色",
@@ -1270,6 +1582,8 @@ trackEdges(state);
 				},
 				en: {
 					nav: "Notification center",
+					settingsUnavailable: "This plugin is not loaded, so it cannot be configured right now.",
+					settingsReadOnly: "This deployment stores settings read-only.",
 					greenLabel: "Done",
 					amberLabel: "Pending",
 					blackLabel: "Default color",

package/lib/index.mjs

@@ -6,16 +6,24 @@ import { fileURLToPath } from "node:url";
 /**
 * dsh-notice-center — Host half.
 *
-* 宿主半的唯一职责：向官方 settings 服务（@deepseek-ai/dsh-settings，由
-* dsh-settings-file 持久化到 settings.yaml）注册 `notice-center` 命名空间的
-* schema。浏览器半（src/client.ts）通过 settingsScope 绑定同一命名空间，
-* 读配置、写配置；favicon 状态机消费配置色。
+* 宿主半的唯一职责：**声明本插件的 Config schema**。0.1.7 起设置表单由插件自己的
+* Config 派生（dsh-settings 的 `describe()` 读入口 fiber 的 `runtime.Config`，表单
+* 按 Loader 条目 id 记账 —— 也就是这个命名空间），插件不再注册命名空间。浏览器半
+* （src/client.ts）用 `ctx.configForms.get("notice-center")` 绑定同一条目，读配置、
+* 写配置；favicon 状态机消费配置色。
 *
-* 【不 import dsh-settings】自 0.1.2-rc.1 起 dsh-settings 不再导出
-* `settingsNamespace()`，register 内部自己按 kebab-case 校验字符串，因此这里直接传
-* 纯字符串。这样宿主半的运行时依赖只剩 @deepseek-ai/schemastery（npm 上有对应版本），
-* 插件从 registry 安装时不必解析任何 @deepseek-ai peer —— 而 profile 默认
-* `autoInstallPeers: false`，真去解析反而会因 npm 上的版本不匹配而加载失败。
+* 两个必须守住的点：
+*   1. 每个字段都要 `.volatile()` —— dsh-settings 的 `volatileForm()` 只投影「最近的
+*      可变祖先」下的字段，漏标一个就等于那个设置项在设置页里整条消失。
+*      `.volatile()` 需要 schemastery ≥ 3.18.4（3.18.2 上没有这个方法）。
+*   2. 命名空间必须与 cordis.patch.yml 里的 Loader 条目 id 一致。旧 settings.yaml 的
+*      迁移由 dsh-settings 自己完成（`importLegacyDocument()` 把 `<DSH_HOME>/settings.yaml`
+*      的每个 section 按名字写进同 id 的条目），默认 patch 插入的正是
+*      `id: notice-center`，与 SETTINGS_NAMESPACE 相同，所以老用户设置能原样搬过来。
+*
+* 【不 import dsh-settings】宿主半不 import 任何 @deepseek-ai/dsh-* 运行时包
+* （运行时依赖只剩 @deepseek-ai/schemastery），从 registry 安装时不必解析 dsh peer ——
+* 而 profile 默认 `autoInstallPeers: false`，真去解析反而会因版本不匹配而加载失败。
 *
 * schema 语义（与主人确认的灰区决策一致）：
 *   green/amber 有默认值（官方侧边栏色），用户未覆盖时回默认；
@@ -30,35 +38,33 @@ const DEFAULT_AMBER = "#F59E0B";
 /** hex 色值校验：6 位 #RRGGBB（ColorPicker 输出与手输均为此格式）。 */
 const HEX = /^#[0-9a-fA-F]{6}$/;
 /**
-* 解析注册用的命名空间：直接传 kebab-case 字符串（0.1.2-rc.1+ 的 register 自己校验）。
-* @returns settings.register 接受的命名空间。
+* 命名空间 schema。0.1.7 起它同时是：入口 Config 的校验器、设置表单的投影源
+* （只有标了 `.volatile()` 的字段会出现在表单里）、以及浏览器侧读到的那份值。
 */
-function resolveNamespace() {
-	return SETTINGS_NAMESPACE;
-}
-/** 命名空间 schema；也是浏览器侧 wire 校验依据。 */
 const NoticeSettingsSchema = z.object({
-	green: z.string().pattern(HEX).default(DEFAULT_GREEN),
-	amber: z.string().pattern(HEX).default(DEFAULT_AMBER),
+	green: z.string().pattern(HEX).default(DEFAULT_GREEN).volatile(),
+	amber: z.string().pattern(HEX).default(DEFAULT_AMBER).volatile(),
 	/** 无默认：用户不配置时 black === undefined → 官方原版 favicon。 */
-	black: z.string().pattern(HEX),
+	black: z.string().pattern(HEX).volatile(),
 	/** 颜色状态灯总开关（关闭时保持官方原版图标）。 */
-	colorsEnabled: z.boolean().default(true),
+	colorsEnabled: z.boolean().default(true).volatile(),
 	/** 系统通知总开关（默认关闭；开启时若未授权由设置页发起授权请求）。 */
-	notifyEnabled: z.boolean().default(false),
+	notifyEnabled: z.boolean().default(false).volatile(),
 	/** 通知是否自动隐藏（默认 true＝系统自行收起；false＝常驻，需用户手动关闭）。 */
-	notifyAutoHide: z.boolean().default(true),
+	notifyAutoHide: z.boolean().default(true).volatile(),
 	/** 前台也提醒（默认 false＝沿用原固定策略，页面在前台时保持安静；true＝正在看也弹）。 */
-	notifyForeground: z.boolean().default(false),
+	notifyForeground: z.boolean().default(false).volatile(),
 	/** 通知提示音：完成与待处理为两种不同的预置音。 */
-	notifySound: z.boolean().default(true),
+	notifySound: z.boolean().default(true).volatile(),
 	/** 提示音音量（0–1）。 */
-	notifyVolume: z.number().min(0).max(1).default(0.6),
+	notifyVolume: z.number().min(0).max(1).default(0.6).volatile(),
 	/** 完成提示音 id（见浏览器半音效库；builtin-up = 内置合成音 Chime Up）。 */
-	notifyDoneSound: z.string().default("builtin-up"),
+	notifyDoneSound: z.string().default("builtin-up").volatile(),
 	/** 待处理提示音 id（builtin-down = 内置合成音 Chime Down）。 */
-	notifyPendingSound: z.string().default("builtin-down")
+	notifyPendingSound: z.string().default("builtin-down").volatile()
 });
+/** 具名导出：不同加载路径可能把模块命名空间或 default 当插件对象，两条都提供 Config。 */
+const Config = NoticeSettingsSchema;
 /** 音效静态路由前缀：浏览器半按 `<前缀>/<id>.mp3` 取音频。 */
 const SOUND_ROUTE = "/notice-center-sounds";
 /** 随包分发的音效目录（音源：anomalyco/opencode packages/ui/src/assets/audio，MIT）。 */
@@ -102,13 +108,26 @@ function buildSoundRoutes() {
 }
 var src_default = {
 	name: "dsh-notice-center",
+	/** 入口 Config：0.1.7 的设置表单、旧 settings.yaml 迁移与写入校验都由它派生。 */
+	Config: NoticeSettingsSchema,
 	apply(ctx) {
 		/** 路由注销器（apply 卸载时统一回收）。 */
 		const disposers = [];
 		ctx.inject(["settings"], (settingsCtx) => {
-			settingsCtx.settings.register(resolveNamespace(), NoticeSettingsSchema);
-			/* 启动自证：注册成功会在 Harness 控制台留一行，便于排查命名空间未接上的问题。 */
-			settingsCtx.logger.info("dsh-notice-center: settings namespace \"%s\" registered", SETTINGS_NAMESPACE);
+			/* 本插件自带设置页，声明「不要为我自动生成配置页」。
+			   owner 必须是插件自身的 fiber：describe() 按 entry.fiber 查这份策略，而
+			   inject 子 fiber 是另一个 fiber（实测 childCtx.fiber !== ctx.fiber），
+			   传子 fiber 等于没声明。注册失败只降级成一条日志，不拖垮插件。 */
+			settingsCtx.effect(() => {
+				try {
+					return settingsCtx.settings.configure({ auto: false }, ctx.fiber);
+				} catch (error) {
+					settingsCtx.logger.warn("dsh-notice-center: settings.configure failed: %s", error);
+					return () => {};
+				}
+			}, "dsh-notice-center: settings presentation");
+			/* 启动自证：设置条目能被服务读到会在 Harness 控制台留一行。 */
+			settingsCtx.logger.info("dsh-notice-center: settings entry \"%s\" served from the Config schema", SETTINGS_NAMESPACE);
 		});
 		/* 可选通道：webServer 缺席时音频路由不挂载，浏览器半自动回退到合成音。 */
 		ctx.inject(["webServer"], (webCtx) => {
@@ -125,4 +144,4 @@ var src_default = {
 	}
 };
 //#endregion
-export { DEFAULT_AMBER, DEFAULT_GREEN, SETTINGS_NAMESPACE, SOUND_ROUTE, NoticeSettingsSchema, buildSoundRoutes, src_default as default };
+export { Config, DEFAULT_AMBER, DEFAULT_GREEN, SETTINGS_NAMESPACE, SOUND_ROUTE, NoticeSettingsSchema, buildSoundRoutes, src_default as default };

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "dsh-notice-center",
-  "version": "1.3.1",
+  "version": "1.4.0",
+  "engines": {
+    "dsh": ">=0.1.7-rc.2 <0.2.0-0"
+  },
   "description": "DeepSeek Harness 通知中心：标签页鲸鱼状态灯（绿=跑完 / 琥珀=待处理）+ 浏览器系统通知（完成/待处理提示、45 个 opencode 音效可选、音量可配）。",
   "type": "module",
   "scripts": {
-    "test": "node test/host-half.smoke.mjs && node test/client-half.smoke.mjs",
+    "test": "node test/host-half.smoke.mjs && node test/client-half.smoke.mjs && node test/compat-range.smoke.mjs",
     "test:host": "node test/host-half.smoke.mjs",
     "test:client": "node test/client-half.smoke.mjs",
+    "test:compat": "node test/compat-range.smoke.mjs",
     "prepublishOnly": "npm test"
   },
   "main": "lib/index.mjs",
@@ -27,10 +31,14 @@
     "assets",
     "LICENSE",
     "README.md",
-    "README.en.md"
+    "README.en.md",
+    "CHANGELOG.md"
   ],
   "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.2"
+    "@deepseek-ai/schemastery": "^3.18.4"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cosmokit": "^1.8.5"
   },
   "dsh": {
     "bundle": {
@@ -63,10 +71,10 @@
   ],
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1"
+    "@deepseek-ai/dsh-client-locale": ">=0.1.7-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-session": ">=0.1.7-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-settings": ">=0.1.7-rc.2 <0.2.0-0"
   },
   "license": "MIT"
 }