dsh-group-status 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -6,6 +6,63 @@
 
 ## 未发布
 
+## 0.5.0 — 2026-10-22
+
+- **fix** 宿主契约漂移**从此有人看着了**：`pendingInteraction.kind` 是开放集合
+  （`SessionPendingInteractionMap` 靠声明合并扩展，任何宿主包都能贡献自己的 kind），而本仓库的
+  `src/client/tree.ts` 是宿主 workspace 投影的 fork。宿主新增一种 kind 时本插件**不会**自动跟上，
+  于是宿主侧栏与折叠徽标会**一起不显示**它 —— 两边口径一致所以不是"谁错了"，但用户只会觉得
+  "这俩对不上"。而"宿主换了代"本来该由 `scripts/check-upstream.ts` 提醒，**那个脚本从来没有工作过**：
+  它比对的 `src/vendor/src` 目录早就不存在了（vendored 的上游源码直接摊在 `src/` 下），上游发布包里
+  也没有 `src/`（只有 `lib/`），于是它一跑就 `ENOENT: scandir 'src/vendor/src'`；而 `docs/upgrading.md`
+  还让人照着它 rebase —— 一条指着不存在目录的命令比没有更糟：它让人以为"没红就是没漂移"。
+  现在：同一份比对实现（`src/host-contract.ts`）被两处调用 —— `npm test` 里的
+  `tests/host-pending-kinds.node.test.mjs`（离线，读锁定版宿主的实现，CI 会跑）与
+  `pnpm check-upstream`（人看的；`--latest` 还能查 npm 上**已发布的最高版**，注意该包的 `latest`
+  标签是旧的、还指着 0.0.1-rc.1，不能直接用 `npm view <pkg> version`）。守卫覆盖三件事：我们认的
+  kind 集合必须与宿主一致、宿主不能把我们要读的两个状态事实改名、以及"守卫自己不是摆设"（拿真实
+  bundle 的改造副本当反例）。另加类型层一道：`Rows.tsx` 的 `assertNever` 让"新增 kind 却没给行内
+  表现"直接编译不过。
+
+- **breaking** 删除设置项 `showScheduledInBadge` 与 `showWaitingReviewInBadge`：**外部来源的显隐不再由本插件管**。
+  这两个字段把别人家的域名（定时任务 / 等待评审）、来源名（dsh-later / dsh-gitea-dispatch）连图标形状
+  （"时钟" / "沙漏"）全都写死在**消费方**的 `Config`、设置卡片与文案里，与本插件「不认识任何具体来源」的
+  立身之本直接矛盾 —— facet 协议把适配方向翻正了，配置面却没跟着翻。而且它**已经是错的**：dsh-gitea-dispatch
+  自其 #60 起让徽标跟随自己的 `waitingIconStyle`，三档里两档不是沙漏，卡片却仍在承诺"沙漏"；对方没装时，
+  那句"关闭后不再画"更是空话。
+  现在的规则只有一条：**登记即显示，不注册即不显示**。要给用户一个"关掉它"的开关，请加在**你自己的**
+  配置卡片里。协议成员 `settingKey` 同时废弃（v1 仍接受、不报错，但本插件不再读取）。
+  **升级影响**：profile 里残留的这两个旧值不再被读取，等同回到默认「显示」（默认全开，最坏情况是某个来源
+  重新出现，不会留下坏数据）。曾考虑的另一种收口（消费方保留 `disabledFacets: string[]` + 卡片遍历登记面）
+  只是把来源名从文案换成 id，机制仍长在消费方身上，故未采用；取舍过程写进 `docs/facet-protocol.md`。
+- **refactor** 徽标设置卡片的开关顺序改为**与徽标画点一致**（待审批 → 进行中 → 已完成）。此前是
+  进行中 → 待审批 → 已完成，而徽标与悬停明细都是待审批在前；用户的操作场景恰是"我看到徽标第 N 个图标，
+  想关掉它"。同一族毛病 #25① 已在点行与明细之间修过一次，卡片是当时漏掉的第三个面。单一事实来源是
+  `badge-field.ts` 的 `ALL_BADGE_FIELDS`，并由 `tests/badge-settings-card.client.spec.tsx` 钉住
+  （含"卡片文案里不得出现任何提供方名字与形状词"）。
+- **refactor** 删除 `facetVisibleBySettings` 与 `facet-visibility.ts`；`useVisibleFacets` 更名
+  `useRegisteredFacets`（它不再筛任何东西，只负责"订阅 + 读登记面"，见下一条目为何必须收进一个 hook）。
+
+- **fix** 提供方**晚于首渲染**注册的状态源永远进不了折叠徽标：`WorkspaceBrowser` 订阅了
+  facet 存储，却把 `useSyncExternalStore` 的返回值丢掉，`useMemo` 的依赖里只有设置项——
+  于是登记面变化只换来一次重渲染，渲染算的仍是**上一次**的登记面。表现是「徽标少一家、
+  无任何报错、刷新页面就好了」，而刷新只是碰巧让注册赶在了首渲染之前。宿主不保证插件
+  `apply` 与侧栏挂载的先后，所以这条按加载时序随机命中。修法是把订阅 + 读表 + 按设置筛
+  收进 `use-visible-facets.ts` 一个 hook，让"只用信号、不用值"在结构上写不出来。这条接缝
+  此前测不到（能渲染整条路径的 `tests/workspace-browser.client.spec.tsx` 在本仓库是跳过的），
+  新增 `tests/use-visible-facets.client.spec.tsx` 5 例覆盖，并用变异测试验过非空洞性：把依赖
+  里的版本号拿掉，「晚到的注册」与「晚到的注销」两条会红。
+- **fix** 登记面从**模块级**单例改为挂在 `globalThis` 上的**进程级**共享表。宿主热替换只
+  换代被替换的那个模块（`dsh-client-modules` 的 `invalidate()` 不级联到依赖方，也不重跑
+  别人的 `apply`），于是本插件一旦被换成新实例就持有一张**空表**：提供方那一次性登记留在
+  被丢弃的旧表上，徽标从此少一家，且只有刷新页面才好。开发环境用 `link:` 装插件、反复
+  重建 `lib/`，这条几乎必然发生。现在换代只是"再拿一次同一张表"；`registerGroupStatusFacet`
+  也改为**现取**当前那张表，而不是用模块加载时抄下的引用。那把全局键同时是现场诊断入口：
+  `globalThis.__dshGroupStatusFacetRegistry__.list()` 一眼看出注册到底落没落，判据写进
+  `docs/facet-protocol.md` 新增的「登记面的生命周期」一节。
+- **test** `tests/facets.node.test.mjs` 补 3 例：共享表重复取不新建、模块级 `registry` 常量
+  就是那张共享表、换代后新注册只落新表不落被丢弃的旧表。
+
 ## 0.4.0 — 2026-10-20
 
 - **upgrade** 依赖基线从 DSH `0.2.0-rc.2` 升到 `0.2.1-rc.2`：Cordis peer 改为 `~4.0.5`，Schemastery 与全部 `@deepseek-ai/dsh-*` 开发依赖升到对应版本；客户端 `dsh.client.inject` 加入 `@deepseek-ai/dsh-api-remote-access`。`tsc`、`tsdown`、27 个 Node 用例与 165 个 Vitest 用例全绿。

package/README.en.md

@@ -64,12 +64,14 @@ Rules:
 | `showRunningInBadge` | `true` | Whether the folded badge shows the "running" spinning dot |
 | `showPendingInBadge` | `true` | Whether the folded badge shows the "pending" yellow dot (approval / plan review / waiting for answer) |
 | `showCompletedInBadge` | `true` | Whether the folded badge shows a green "completed" dot |
-| `showScheduledInBadge` | `true` | Whether the folded badge shows the "scheduled" clock icon (data from dsh-later) |
-| `showWaitingReviewInBadge` | `true` | Whether the folded badge shows the "waiting for review" hourglass icon (data from dsh-gitea-dispatch) |
 | `showHoverDetails` | `true` | Whether the hover card shows the aggregated status detail lines |
 | `countThreshold` | `2` | The count is shown on the badge only when the total is >= this value (default 2, i.e. omits the count when it equals 1 — the dots already convey "something is happening"; set to 1 to always show) |
 
-Switching a source off takes it out of the folded row's aggregate entirely — no dot/icon, no contribution to the badge count, no hover detail line, and it no longer keeps the badge alive. **The state dot on a session row itself is unaffected**: that is row-level state, not a folder hint. With `showHoverDetails` off, the hover card shows only the title, path, and creation time.
+Switching a tier off takes it out of the folded row's aggregate entirely — no dot/icon, no contribution to the badge count, no hover detail line, and it no longer keeps the badge alive. **The state dot on a session row itself is unaffected**: that is row-level state, not a folder hint. With `showHoverDetails` off, the hover card shows only the title, path, and creation time.
+
+**External sources (e.g. "waiting for review", "scheduled") have no switch on this page, on purpose.** This plugin knows no concrete source, so its config face must not carry another plugin's domain names or icon shapes either. To silence a source, use **that plugin's own** settings card: when it is off, it simply does not register its facet, and the badge loses that glyph. See "Who owns visibility" in [`docs/facet-protocol.md`](docs/facet-protocol.md).
+
+> ⚠️ As of this change the `showScheduledInBadge` / `showWaitingReviewInBadge` fields are removed (they hard-coded names and icon shapes on behalf of dsh-later / dsh-gitea-dispatch). Values left in the profile are no longer read and behave as the default "show".
 
 Saving applies it live, with no refresh; the Host writes it into the profile patch's `dsh-group-status` entry `config`, so it survives a page reload. When the settings face cannot be read (e.g. the Host serves no settings service), it falls back to the default "show", matching the schema default — failing to read a config is not the user turning it off.
 
@@ -100,7 +102,7 @@ const unregister = gs?.registerGroupStatusFacet?.({
   subscribe: store.subscribe,           // an external-store face, not a React hook
   getSnapshot: store.getSnapshot,
   fold: (snapshot, sessionIds, now) => ({ count, tone, pulse, data }),
-  merge, label, renderIcon, settingKey, order,   // all optional
+  merge, label, renderIcon, order,             // all optional
 })
 ctx.effect(() => () => unregister?.(), 'my-plugin: group status facet')
 ```

package/README.md

@@ -66,12 +66,14 @@
 | `showRunningInBadge` | `true` | 折叠徽标是否显示「进行中」转圈 |
 | `showPendingInBadge` | `true` | 折叠徽标是否显示「待审批 / 待评审 / 待回答」黄点 |
 | `showCompletedInBadge` | `true` | 折叠徽标是否显示「已完成」绿点 |
-| `showScheduledInBadge` | `true` | 折叠徽标是否显示「定时任务」时钟图标（数据来自 dsh-later） |
-| `showWaitingReviewInBadge` | `true` | 折叠徽标是否显示「等待评审」沙漏图标（数据来自 dsh-gitea-dispatch） |
 | `showHoverDetails` | `true` | 悬停卡是否显示聚合状态明细行 |
 | `countThreshold` | `2` | 徽标数字显示阈值：数量 >= 此值时才显示数字（默认 2，即 count=1 时省略——点已表达"有东西在发生"；设为 1 则始终显示） |
 
-按状态关掉后，对应的来源完全退出折叠行的聚合提示——不画点/图标、不计入徽标数字、不进悬停明细、不参与「是否显示徽标」的判断。**会话行自身的状态点不受影响**：那是行级状态，不是分组提示。`showHoverDetails` 关闭后，悬停卡只显示标题、路径与创建时间。
+按状态关掉后，对应档位完全退出折叠行的聚合提示——不画点/图标、不计入徽标数字、不进悬停明细、不参与「是否显示徽标」的判断。**会话行自身的状态点不受影响**：那是行级状态，不是分组提示。`showHoverDetails` 关闭后，悬停卡只显示标题、路径与创建时间。
+
+**外部来源（如「等待评审」「定时任务」）在这一页没有开关**，这是有意的：本插件不认识任何具体来源，所以配置面里也不该有别人家的域名与图标形状。要关某个来源，去**那个插件自己**的设置卡片；它关掉时不注册 facet，徽标自然就没有那一格。详见 [`docs/facet-protocol.md`](docs/facet-protocol.md) 的「显隐归谁」。
+
+> ⚠️ 本次起 `showScheduledInBadge` / `showWaitingReviewInBadge` 两个字段已删除（它们曾替 dsh-later / dsh-gitea-dispatch 写死名字与图标形状）。profile 里残留的旧值不再被读取，等同回到默认「显示」。
 
 点「保存」后即时生效，无需刷新；设置由宿主写进 profile patch 的 `dsh-group-status` 条目 `config`，刷新页面后仍在。设置面读不到时（例如宿主未提供设置服务）回落为默认「显示」，与 schema 默认值同源——读不到配置不等于用户关掉了。
 
@@ -102,7 +104,7 @@ const unregister = gs?.registerGroupStatusFacet?.({
   subscribe: store.subscribe,           // 外部存储面，不是 React hook
   getSnapshot: store.getSnapshot,
   fold: (snapshot, sessionIds, now) => ({ count, tone, pulse, data }),
-  merge, label, renderIcon, settingKey, order,   // 全部可选
+  merge, label, renderIcon, order,             // 全部可选
 })
 ctx.effect(() => () => unregister?.(), 'my-plugin: group status facet')
 ```
@@ -188,6 +190,8 @@ dsh plugin --profile web remove dsh-group-status
 
 上游一换代就得按[升级手册](./docs/upgrading.md) rebase 一次；上游改槽位名、组件签名或上下文契约时，本包不会自动跟上。
 
+其中**会静默失效**的那部分（我们认的待处理 kind 集合、我们从宿主读的两个状态事实）有守卫兜着：`tests/host-pending-kinds.node.test.mjs` 直接读锁定版宿主的实现来比对，宿主一改就红；人看的版本是 `pnpm check-upstream`（加 `--latest` 还能查 npm 上已发布的最高版）。
+
 ---
 
 ## 开发

package/lib/client.js

@@ -211,30 +211,17 @@ window.__ModuleLoader__.load({
 		*/
 		/** Loader 条目 id —— 设置页的寻址键，也是宿主 `describe()` 的 ns。 */
 		const ENTRY_ID = "dsh-group-status";
-		/**
-		* 一个 facet 是否被设置关掉。
-		*
-		* - 没有 `settingKey` → 始终参与（缺省是"显示"，与其余开关的默认值同源）。
-		* - 声明了但不是布尔开关键 → 同样按显示处理：拼错的键不该让一个状态整块消失。
-		*/
-		function facetVisibleBySettings(settings, settingKey) {
-			if (settingKey === void 0) return true;
-			const value = settings[settingKey];
-			return typeof value === "boolean" ? value : true;
-		}
 		/** 默认值：与 `Config` 各字段的 schema 默认同源（全部显示，数字阈值 2 即 count=1 时省略）。 */
 		const DEFAULT_BADGE_SETTINGS = Object.freeze({
 			showCompletedInBadge: true,
 			showRunningInBadge: true,
 			showPendingInBadge: true,
-			showScheduledInBadge: true,
-			showWaitingReviewInBadge: true,
 			showHoverDetails: true,
 			countThreshold: 2
 		});
 		/** 两个设置对象是否逐字段相等（用于发布前比较，避免无谓通知）。 */
 		function settingsEqual(a, b) {
-			return a.showCompletedInBadge === b.showCompletedInBadge && a.showRunningInBadge === b.showRunningInBadge && a.showPendingInBadge === b.showPendingInBadge && a.showScheduledInBadge === b.showScheduledInBadge && a.showWaitingReviewInBadge === b.showWaitingReviewInBadge && a.showHoverDetails === b.showHoverDetails && a.countThreshold === b.countThreshold;
+			return a.showCompletedInBadge === b.showCompletedInBadge && a.showRunningInBadge === b.showRunningInBadge && a.showPendingInBadge === b.showPendingInBadge && a.showHoverDetails === b.showHoverDetails && a.countThreshold === b.countThreshold;
 		}
 		/** 从原始快照派生：只有**显式 false** 才隐藏，缺失/非法一律显示（countThreshold 默认 2）。 */
 		function resolveFromSnapshot(snap) {
@@ -253,8 +240,6 @@ window.__ModuleLoader__.load({
 				showCompletedInBadge: getBool("showCompletedInBadge", true),
 				showRunningInBadge: getBool("showRunningInBadge", true),
 				showPendingInBadge: getBool("showPendingInBadge", true),
-				showScheduledInBadge: getBool("showScheduledInBadge", true),
-				showWaitingReviewInBadge: getBool("showWaitingReviewInBadge", true),
 				showHoverDetails: getBool("showHoverDetails", true),
 				countThreshold: getNumber("countThreshold", 2)
 			};
@@ -434,12 +419,52 @@ window.__ModuleLoader__.load({
 			};
 		}
 		/**
-		* 生产用的模块级单例登记表面。
+		* 挂在 `globalThis` 上的登记表面的键名。
+		*
+		* 它同时是**现场诊断入口**：宿主里可以直接
+		* `globalThis.__dshGroupStatusFacetRegistry__.list().map(e => e.facet.id)` 读出"此刻到底
+		* 有哪些状态源登记上了"——「我注册了为什么没显示」不该只能靠猜（协议文档点名的那类
+		* 不可诊断失败）。
+		*/
+		const SHARED_REGISTRY_KEY = "__dshGroupStatusFacetRegistry__";
+		/**
+		* 取（并首次创建）**进程级**共享的登记表面。
+		*
+		* ## 为什么不能是模块级
+		*
+		* 提供方把 facet 注册进来是一次性的：它在自己的 `apply` 里 `require` 本插件的 client
+		* 入口、登记完就把注销函数挂在 effect 上。而宿主的热替换（HMR、`reload(id, rev)`）
+		* **只换代被替换的那个模块**——`dsh-client-modules` 的 `invalidate()` 只删自己那一行的
+		* factory 与 loadCache，不级联到"谁 require 过它"（依赖方不会重跑 apply）。
+		*
+		* 于是模块级单例在这里必然失效：本插件被换成新实例 → 新实例建一张**空表** → 提供方
+		* 那份注册留在被丢弃的旧表上 → 徽标从此少一家，且**只有刷新页面才好**。开发环境天天
+		* 重建 `lib/`，这条几乎必然发生。
+		*
+		* 挂到 `globalThis` 上之后，换代只是"再拿一次同一张表"：注册跨换代存活，`facetStore()`
+		* 在新实例里 `rewire()` 时照样订阅到那些来源。提供方被换代时按同 id 覆盖登记（见
+		* {@link FacetRegistry.register} 的来源决胜），不会重复计数。
+		*
+		* @returns 全进程唯一的登记表面。
+		*/
+		function sharedFacetRegistry() {
+			const host = globalThis;
+			const existing = host[SHARED_REGISTRY_KEY];
+			if (existing !== void 0) return existing;
+			const created = createFacetRegistry();
+			host[SHARED_REGISTRY_KEY] = created;
+			return created;
+		}
+		/**
+		* 生产用的单例登记表面。
 		*
 		* 与 {@link createFacetRegistry} 分开，是为了让测试能对着一张干净的表断言协议行为，
 		* 而不会被别的用例或别的插件登记的 facet 污染。
+		*
+		* ⚠️ 它只是 {@link sharedFacetRegistry} 在**本模块首次加载时**取到的那份引用；跨模块实例
+		* 存活的是 globalThis 上那一张，所以运行期一律经 {@link sharedFacetRegistry} 现取。
 		*/
-		const registry = createFacetRegistry();
+		const registry = sharedFacetRegistry();
 		/**
 		* 本插件 client 入口对外的登记函数（provider 侧唯一需要认识的符号）。
 		*
@@ -448,13 +473,14 @@ window.__ModuleLoader__.load({
 		*   返回值形状保持稳定，provider 的 dispose 路径不必区分成败。
 		*/
 		function registerGroupStatusFacet(facet) {
-			const result = registry.register(facet);
+			const target = sharedFacetRegistry();
+			const result = target.register(facet);
 			if (!result.ok) {
 				if (!(result.reason === "superseded" && facetOrigin(facet) === "legacy")) reportRejection(result);
 				return () => void 0;
 			}
 			return () => {
-				registry.remove(result.id, facet);
+				target.remove(result.id, facet);
 			};
 		}
 		/**
@@ -575,19 +601,39 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/badge-field.ts
-		/** 卡片字段名（与 `src/index.ts` 的 `Config` 同名同义）。 */
+		/**
+		* 每个开关控制的是徽标上的哪一枚点。
+		*
+		* 单一事实来源：设置卡片里给每行画的**预览点**与折叠徽标实际画的那三枚点，都从这里取。
+		* 两处各写一套的话迟早会漂，而漂了的后果不是"多一个点少一个点"，是**卡片预览与徽标说的
+		* 不是一回事**（同一族毛病：#25① 修过点行与明细的顺序，#37 又发现配置面里混着别人家的语义）。
+		*
+		* 对应关系与 `rows/GroupBadge.tsx` 一致：待审批 = warning 黄点、进行中 = ongoing 转圈、
+		* 已完成 = done 绿点。外部来源的点**不在这里** —— 它们由来源自己画（`renderIcon`），
+		* 也不在本插件的卡片上（显隐归来源自己）。
+		*/
+		const BADGE_FIELD_DOT_STATE = {
+			showPendingInBadge: "warning",
+			showRunningInBadge: "ongoing",
+			showCompletedInBadge: "done"
+		};
+		/**
+		* 卡片字段名（与 `src/index.ts` 的 `Config` 同名同义）。
+		*
+		* ⚠️ 只有本插件自己的语义。曾有 `showScheduledInBadge` / `showWaitingReviewInBadge`
+		* 两个字段替 dsh-later / dsh-gitea-dispatch 写死名字与图标形状，现已删除：外部来源的
+		* 显隐归来源自己（不注册就是不显示）。
+		*/
 		const BADGE_FIELDS = {
 			showCompletedInBadge: "showCompletedInBadge",
 			showRunningInBadge: "showRunningInBadge",
 			showPendingInBadge: "showPendingInBadge",
-			showScheduledInBadge: "showScheduledInBadge",
-			showWaitingReviewInBadge: "showWaitingReviewInBadge",
 			showHoverDetails: "showHoverDetails",
 			countThreshold: "countThreshold"
 		};
 		/**
-		* 草稿文本解析成开关状态：与 {@link isFieldEnabled} 不同，这里比较的是模型给的
-		* **文本**，别把字符串喂给上面那个函数（`'false' !== false` 恒真）。
+		* 草稿文本解析成开关状态：比较的是模型给的**文本**，不是存储值 ——
+		* 别把字符串 `'false'` 当成布尔 `false`（`'false' !== false` 恒真）。
 		*/
 		function isDraftEnabled(text) {
 			return text !== "false";
@@ -616,13 +662,21 @@ window.__ModuleLoader__.load({
 				} : void 0
 			};
 		}
-		/** 所有字段规格（按卡片渲染顺序）。 */
+		/** 各字段的字段转换规格。 */
+		const showCompletedField = makeBooleanField(BADGE_FIELDS.showCompletedInBadge, true);
+		const showRunningField = makeBooleanField(BADGE_FIELDS.showRunningInBadge, true);
+		/**
+		* 所有字段规格。
+		*
+		* ⚠️ 顺序**必须**与徽标画点的顺序一致（`rows/GroupBadge.tsx`：待审批 → 进行中 → 已完成；
+		* 外部来源排在已完成之前，但它们不在本插件的卡片上）。用户操作场景就是"我看到徽标第 N
+		* 个图标，想关掉它"，卡片顺序错位会让人怀疑两处是两套事实 —— 同一族毛病 #25① 已经在
+		* 点行与明细之间修过一次。回归用例：`tests/badge-settings-card.client.spec.tsx`。
+		*/
 		const ALL_BADGE_FIELDS = [
-			makeBooleanField(BADGE_FIELDS.showCompletedInBadge, true),
-			makeBooleanField(BADGE_FIELDS.showRunningInBadge, true),
 			makeBooleanField(BADGE_FIELDS.showPendingInBadge, true),
-			makeBooleanField(BADGE_FIELDS.showScheduledInBadge, true),
-			makeBooleanField(BADGE_FIELDS.showWaitingReviewInBadge, true),
+			showRunningField,
+			showCompletedField,
 			makeBooleanField(BADGE_FIELDS.showHoverDetails, true),
 			{
 				field: BADGE_FIELDS.countThreshold,
@@ -642,7 +696,7 @@ window.__ModuleLoader__.load({
 		];
 		//#endregion
 		//#region \0dsh-css:src/client/BadgeSettingsCard.module.css.mjs
-		const css$4 = ".dhp54G_section{min-width:0;padding:16px 0}.dhp54G_section:last-child{padding-bottom:0}.dhp54G_heading{color:var(--dsw-alias-label-primary);margin:0;font-size:13px;font-weight:600;line-height:1.5}.dhp54G_badgeField{gap:6px;padding:12px 0;display:grid}.dhp54G_badgeToggleRow{color:var(--dsw-alias-label-primary);justify-content:space-between;align-items:flex-start;gap:16px;font-size:13px;line-height:1.5;display:flex}.dhp54G_badgeToggleLabel{flex:1;min-width:0}.dhp54G_badgeNumberControl{align-items:center;gap:4px;display:flex}.dhp54G_badgeNumberButton{width:28px;height:28px;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-elevated,#2a2a2a);border:1px solid var(--dsw-alias-border-primary,#555);cursor:pointer;user-select:none;border-radius:6px;justify-content:center;align-items:center;padding:0;font-size:16px;font-weight:600;line-height:1;display:flex}.dhp54G_badgeNumberButton:hover:not(:disabled){border-color:var(--dsw-alias-border-focus,#0078d4);background:var(--dsw-alias-bg-hover,#3a3a3a)}.dhp54G_badgeNumberButton:active:not(:disabled){background:var(--dsw-alias-bg-active,#4a4a4a)}.dhp54G_badgeNumberButton:disabled{opacity:.3;cursor:not-allowed}.dhp54G_badgeNumberValue{text-align:center;min-width:24px;color:var(--dsw-alias-label-primary);font-size:13px;font-weight:500}.dhp54G_hint{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:1.5}";
+		const css$4 = ".dhp54G_section{min-width:0;padding:16px 0}.dhp54G_section:last-child{padding-bottom:0}.dhp54G_heading{color:var(--dsw-alias-label-primary);margin:0;font-size:13px;font-weight:600;line-height:1.5}.dhp54G_badgeField{gap:6px;padding:12px 0;display:grid}.dhp54G_badgeToggleRow{color:var(--dsw-alias-label-primary);justify-content:space-between;align-items:flex-start;gap:16px;font-size:13px;line-height:1.5;display:flex}.dhp54G_badgeSpecimen{vertical-align:-2px;align-items:center;margin-right:6px;display:inline-flex}.dhp54G_badgeToggleLabel{flex:1;min-width:0}.dhp54G_badgeNumberControl{align-items:center;gap:4px;display:flex}.dhp54G_badgeNumberButton{width:28px;height:28px;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-elevated,#2a2a2a);border:1px solid var(--dsw-alias-border-primary,#555);cursor:pointer;user-select:none;border-radius:6px;justify-content:center;align-items:center;padding:0;font-size:16px;font-weight:600;line-height:1;display:flex}.dhp54G_badgeNumberButton:hover:not(:disabled){border-color:var(--dsw-alias-border-focus,#0078d4);background:var(--dsw-alias-bg-hover,#3a3a3a)}.dhp54G_badgeNumberButton:active:not(:disabled){background:var(--dsw-alias-bg-active,#4a4a4a)}.dhp54G_badgeNumberButton:disabled{opacity:.3;cursor:not-allowed}.dhp54G_badgeNumberValue{text-align:center;min-width:24px;color:var(--dsw-alias-label-primary);font-size:13px;font-weight:500}.dhp54G_hint{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:1.5}";
 		const tagId$4 = "dsh-group-status/BadgeSettingsCard.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$4) + "]") === null) {
 			const tag = document.createElement("style");
@@ -656,6 +710,7 @@ window.__ModuleLoader__.load({
 			"badgeNumberButton": "dhp54G_badgeNumberButton",
 			"badgeNumberControl": "dhp54G_badgeNumberControl",
 			"badgeNumberValue": "dhp54G_badgeNumberValue",
+			"badgeSpecimen": "dhp54G_badgeSpecimen",
 			"badgeToggleLabel": "dhp54G_badgeToggleLabel",
 			"badgeToggleRow": "dhp54G_badgeToggleRow",
 			"heading": "dhp54G_heading",
@@ -736,21 +791,29 @@ window.__ModuleLoader__.load({
 								id: badgeSectionId,
 								children: t("settings.badge.section")
 							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToggleRow, {
-								field: BADGE_FIELDS.showRunningInBadge,
-								text: fieldText(BADGE_FIELDS.showRunningInBadge),
-								label: t("settings.badge.showRunning"),
-								hint: t("settings.badge.showRunningHint"),
-								state,
-								actions
-							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToggleRow, {
 								field: BADGE_FIELDS.showPendingInBadge,
 								text: fieldText(BADGE_FIELDS.showPendingInBadge),
 								label: t("settings.badge.showPending"),
 								hint: t("settings.badge.showPendingHint"),
 								state,
-								actions
+								actions,
+								specimen: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, {
+									state: BADGE_FIELD_DOT_STATE.showPendingInBadge,
+									size: 12
+								})
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToggleRow, {
+								field: BADGE_FIELDS.showRunningInBadge,
+								text: fieldText(BADGE_FIELDS.showRunningInBadge),
+								label: t("settings.badge.showRunning"),
+								hint: t("settings.badge.showRunningHint"),
+								state,
+								actions,
+								specimen: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, {
+									state: BADGE_FIELD_DOT_STATE.showRunningInBadge,
+									size: 12
+								})
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToggleRow, {
 								field: BADGE_FIELDS.showCompletedInBadge,
@@ -758,23 +821,11 @@ window.__ModuleLoader__.load({
 								label: t("settings.badge.showCompleted"),
 								hint: t("settings.badge.showCompletedHint"),
 								state,
-								actions
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToggleRow, {
-								field: BADGE_FIELDS.showScheduledInBadge,
-								text: fieldText(BADGE_FIELDS.showScheduledInBadge),
-								label: t("settings.badge.showScheduled"),
-								hint: t("settings.badge.showScheduledHint"),
-								state,
-								actions
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToggleRow, {
-								field: BADGE_FIELDS.showWaitingReviewInBadge,
-								text: fieldText(BADGE_FIELDS.showWaitingReviewInBadge),
-								label: t("settings.badge.showWaitingReview"),
-								hint: t("settings.badge.showWaitingReviewHint"),
-								state,
-								actions
+								actions,
+								specimen: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, {
+									state: BADGE_FIELD_DOT_STATE.showCompletedInBadge,
+									size: 12
+								})
 							})
 						]
 					}),
@@ -813,15 +864,18 @@ window.__ModuleLoader__.load({
 				]
 			});
 		}
-		/** 单行开关：label + Switch + hint。 */
-		function ToggleRow({ field, text, label, hint, state, actions }) {
+		/** 单行开关：label + Switch + hint。`specimen` 是行首那枚预览点（可选）。 */
+		function ToggleRow({ field, text, label, hint, state, actions, specimen }) {
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: BadgeSettingsCard_module_css_default.badgeField,
 				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 					className: BadgeSettingsCard_module_css_default.badgeToggleRow,
-					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 						className: BadgeSettingsCard_module_css_default.badgeToggleLabel,
-						children: label
+						children: [specimen !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: BadgeSettingsCard_module_css_default.badgeSpecimen,
+							children: specimen
+						}), label]
 					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Switch, {
 						checked: isDraftEnabled(text),
 						label,
@@ -1773,6 +1827,12 @@ window.__ModuleLoader__.load({
 		function owningGroupKey(workspaces, sessionId) {
 			return workspaces.find((workspace) => workspace.sessionIds.includes(sessionId))?.workspaceId ?? "";
 		}
+		/** 宿主认的 kind 集合（查表用）。 */
+		const PENDING_INTERACTION_KIND_SET = /* @__PURE__ */ new Set([
+			"approval",
+			"plan-review",
+			"question"
+		]);
 		function mainSessionId(list) {
 			return Object.values(list.byId).find((session) => (session.retainedBy.mainView ?? 0) > 0)?.id;
 		}
@@ -1956,12 +2016,7 @@ window.__ModuleLoader__.load({
 		}
 		/** Keep navigation presentation independent from domain-owned interaction objects. */
 		function visiblePendingKind(kind) {
-			switch (kind) {
-				case "approval":
-				case "plan-review":
-				case "question": return kind;
-				default: return;
-			}
+			return kind !== void 0 && PENDING_INTERACTION_KIND_SET.has(kind) ? kind : void 0;
 		}
 		function runningChildCount(list, parentId, statuses) {
 			return list.projectionsBySession[parentId]?.values.subagentCatalog?.reduce((count, child) => count + ((statuses.get(child.id)?.running ?? list.byId[child.id]?.running) === true ? 1 : 0), 0) ?? 0;
@@ -2875,22 +2930,50 @@ window.__ModuleLoader__.load({
 			return raised;
 		}
 		//#endregion
-		//#region src/client/facet-visibility.ts
+		//#region src/client/use-registered-facets.ts
 		/**
-		* 按用户设置筛掉不参与折叠的状态来源。
+		* 把登记面读成「这一轮渲染该折哪些来源」的**唯一**一处接线。
+		*
+		* ## 为什么单独成文
 		*
-		* 单独成文是因为它属于**徽标自身**的可见性规则，而不是某个来源的适配：来源只在
-		* `facet.settingKey` 上声明"我受哪个开关管"，开关的语义与过滤时机归本插件。
+		* 这一步此前直接写在 `rows/WorkspaceBrowser.tsx` 里，两行：
+		*
+		* ```ts
+		* useSyncExternalStore(facetsStore.subscribe, facetsStore.getVersion, …)   // 返回值丢掉
+		* const facets = useMemo(() => visibleFacets(facetsStore.list(), settings), [settings])
+		* ```
+		*
+		* 看着没问题——订阅了、也 memo 了。实际是**订阅通知只重渲染、不重算**：
+		* `useSyncExternalStore` 的返回值被丢掉，`useMemo` 的依赖里就没有任何东西随登记面变化，
+		* 于是那次重渲染原样拿回**上一次**的登记面。提供方在自己的 `apply` 里注册，而宿主不保证
+		* `apply` 与本组件首渲染的先后：注册**晚于**首渲染时，facet 明明登记上了，却永远进不了
+		* 徽标——不报错、不红测试（能渲染这条路径的那份上游 spec 在本仓库是跳过的，见
+		* `vitest.config.ts` 的 `MONOREPO_ONLY_SPECS`），只能靠刷新页面碰运气。
+		*
+		* 版本号必须**同时**当两件事用：① 触发重渲染的信号，② memo 的依赖。这里把它收进一个
+		* hook，让「只用①、丢掉②」在结构上写不出来，并且让这条接缝能被 `@testing-library/react`
+		* 直接覆盖（本文件零宿主 import，宿主依赖闭包进不来）。
+		*
+		* ## 为什么现在不再按设置筛
+		*
+		* 旧版本这里会过一道 `visibleFacets(list, settings)`，按 `facet.settingKey` 查本插件的
+		* 布尔开关。那意味着**本插件的配置面里写着别人家的语义**（`showScheduledInBadge` /
+		* `showWaitingReviewInBadge`，连图标形状都替对方写死），与"本插件不认识任何来源"直接
+		* 矛盾。现在外部来源的显隐归**来源自己**：它想被关掉就不注册 facet，登记面即所见。
+		* 本插件的开关只管自己那三档会话状态（见 `badge-settings.ts`）。
+		*
+		* @module dsh-group-status/client/use-registered-facets
+		*/
+		/**
+		* 当前登记的来源，按登记面顺序（已按 `order` 排好）。
 		*
-		* 过滤发生在**折叠之前**而不是渲染阶段：徽标数字、图标、`aria-label`、悬停明细与
-		* "要不要画徽标"因此天然同源。放到渲染阶段会出现"label 里有、计数里没有"，而那正是
-		* 徽标最容易被怀疑撒谎的地方。
+		* 引用在版本号不变时保持稳定：登记面是低频事件，重算成本 = O(facet × 组内会话)。
 		*
-		* @module dsh-group-status/client/facet-visibility
+		* @param store - facet 消费侧存储（`facetStore()` 单例）。
 		*/
-		/** 筛出设置允许显示的登记项；顺序保持登记面的顺序（已按 `order` 排好）。 */
-		function visibleFacets(entries, settings) {
-			return entries.filter((entry) => facetVisibleBySettings(settings, entry.facet.settingKey));
+		function useRegisteredFacets(store) {
+			const version = (0, react.useSyncExternalStore)(store.subscribe, store.getVersion, store.getServerVersion);
+			return (0, react.useMemo)(() => [...store.list()], [version]);
 		}
 		//#endregion
 		//#region src/client/badge-labels.ts
@@ -2933,9 +3016,9 @@ window.__ModuleLoader__.load({
 		* Accessible label for a folded group's aggregated status, reusing the
 		* session-row locale keys so both surfaces read identically.
 		*
-		* 按设置过滤：**关掉的外部来源根本不在折果里**（`WorkspaceBrowser` 折叠前就按
-		* `facet.settingKey` 过滤了登记面），所以这里不必再判设置，`aria-label` 与徽标视觉
-		* 天然一致；宿主的行级状态仍按设置逐项过滤。
+		* 按设置过滤：本插件那三档会话状态按设置逐项过滤；**外部来源不参与过滤** —— 登记了就
+		* 一定出现在这里，没登记就不在折果里，所以 `aria-label` 与徽标视觉天然一致，不必在这里
+		* 再判一次设置（本插件也没有替别人家存的开关）。
 		*/
 		function groupLiveLabel(s, t, settings, now = Date.now()) {
 			const parts = [];
@@ -3115,10 +3198,10 @@ window.__ModuleLoader__.load({
 		*
 		* Count matches the dots: host-side sessions plus every registered facet's own count.
 		*
-		* `settings` 按来源过滤：关掉的来源不画点、不计数、不进 aria-label、不参与「是否显示
-		* 徽标」的判断。会话行自身的状态点不受影响：那是行级状态，不是分组提示。**外部**来源的
-		* 过滤发生在折叠之前（`WorkspaceBrowser` 按 `facet.settingKey` 筛登记面），所以到这里
-		* 的折果已经是"该显示的"，label 与视觉不可能各说一套。
+		* `settings` 只过滤**本插件自己的**三档会话状态：关掉的档位不画点、不计数、不进
+		* aria-label、不参与「是否显示徽标」的判断。会话行自身的状态点不受影响：那是行级状态，
+		* 不是分组提示。**外部来源在这里没有开关可关** —— 它们要么注册了（一定显示），要么没
+		* 注册（根本不在登记面上）。要关某个来源，去那个插件自己的设置卡片：显隐是来源的决定。
 		*
 		* `now` 缺省取渲染时刻（与 `WorkspaceBrowser` 为相对时间读的时钟同一姿态）：文案里的
 		* 剩余时长以此计算，只在提供方 store 通知时随渲染更新。
@@ -3133,8 +3216,8 @@ window.__ModuleLoader__.load({
 			if (pending === 0 && active === 0 && completed === 0 && facetTotal === 0) return null;
 			const label = groupLiveLabel(s, t, settings, now);
 			const dots = [];
-			if (pending > 0) dots.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: "warning" }, "warn"));
-			if (active > 0) dots.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: "ongoing" }, "run"));
+			if (pending > 0) dots.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: BADGE_FIELD_DOT_STATE.showPendingInBadge }, "warn"));
+			if (active > 0) dots.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: BADGE_FIELD_DOT_STATE.showRunningInBadge }, "run"));
 			const urgentClass = Rows_module_css_default.groupBadgeUrgent ?? "";
 			for (const entry of s.facets.values()) {
 				const glyph = facetGlyph(entry, t, now);
@@ -3144,7 +3227,7 @@ window.__ModuleLoader__.load({
 					children: glyph
 				}, entry.facet.id));
 			}
-			if (completed > 0) dots.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: "done" }, "done"));
+			if (completed > 0) dots.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: BADGE_FIELD_DOT_STATE.showCompletedInBadge }, "done"));
 			const count = pending + active + completed + facetTotal;
 			const countLabel = count > 99 ? "99+" : count >= settings.countThreshold ? String(count) : "";
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
@@ -4370,8 +4453,7 @@ window.__ModuleLoader__.load({
 			const panelActive = usePanelInfo((info) => info.activePanelId !== null);
 			const badgeSettings = useBadgeSettings((settings) => settings);
 			const statuses = useSessionStatus((s) => s);
-			(0, react.useSyncExternalStore)(facetsStore.subscribe, facetsStore.getVersion, facetsStore.getServerVersion);
-			const facets = (0, react.useMemo)(() => visibleFacets(facetsStore.list(), badgeSettings), [badgeSettings]);
+			const facets = useRegisteredFacets(facetsStore);
 			const current = panelActive ? void 0 : Object.values(list.byId).find((session) => (session.retainedBy.mainView ?? 0) > 0)?.id;
 			const revealGroup = revealSessionId === void 0 || !workspaceReady ? void 0 : owningGroupKey(workspaces, revealSessionId);
 			const [storedWatermarks, setStoredWatermarks] = (0, react.useState)({});
@@ -6042,10 +6124,6 @@ window.__ModuleLoader__.load({
 			"settings.badge.showPendingHint": "关闭后，等待审批 / 计划评审 / 等待回答的会话不再画黄点，也不再计入折叠徽标的数字与悬停明细。",
 			"settings.badge.showCompleted": "显示「已完成」绿点",
 			"settings.badge.showCompletedHint": "关闭后，「已完成」的会话不再画绿点，也不再计入折叠徽标的数字与悬停明细。会话行自身的绿点不受影响。",
-			"settings.badge.showScheduled": "显示「定时任务」时钟",
-			"settings.badge.showScheduledHint": "关闭后，带定时提醒的会话（来自 dsh-later）不再画时钟图标，也不再计入折叠徽标的数字与悬停明细。",
-			"settings.badge.showWaitingReview": "显示「等待评审」沙漏",
-			"settings.badge.showWaitingReviewHint": "关闭后，等待代码评审的会话（来自 dsh-gitea-dispatch）不再画沙漏图标，也不再计入折叠徽标的数字与悬停明细。",
 			"settings.hover.section": "悬停明细",
 			"settings.hover.showDetails": "显示状态明细行",
 			"settings.hover.showDetailsHint": "关闭后，悬停卡只显示工作区标题、路径和创建时间——不再显示聚合状态明细行。",
@@ -6187,10 +6265,6 @@ window.__ModuleLoader__.load({
 			"settings.badge.showPendingHint": "When off, Sessions waiting for approval / plan review / answer stop drawing the yellow dot and drop out of the collapsed badge count and its hover details.",
 			"settings.badge.showCompleted": "Show the completed dot",
 			"settings.badge.showCompletedHint": "When off, completed Sessions stop drawing the dot and drop out of the collapsed badge count and its hover details. The Session row's own dot is unaffected.",
-			"settings.badge.showScheduled": "Show the scheduled icon",
-			"settings.badge.showScheduledHint": "When off, Sessions with scheduled reminders (from dsh-later) stop drawing the clock icon and drop out of the collapsed badge count and its hover details.",
-			"settings.badge.showWaitingReview": "Show the waiting-for-review icon",
-			"settings.badge.showWaitingReviewHint": "When off, Sessions waiting for code review (from dsh-gitea-dispatch) stop drawing the hourglass icon and drop out of the collapsed badge count and its hover details.",
 			"settings.hover.section": "Hover details",
 			"settings.hover.showDetails": "Show status detail lines",
 			"settings.hover.showDetailsHint": "When off, the hover card shows only the workspace title, path, and creation time — no aggregated status lines.",