dsh-group-status 0.2.0 → 0.2.2

package/lib/client.js

@@ -5,10 +5,10 @@ window.__ModuleLoader__.load({
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 		let _deepseek_ai_dsh_client_store = require("@deepseek-ai/dsh-client-store");
-		let _deepseek_ai_cordis = require("@deepseek-ai/cordis");
 		let react = require("react");
 		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 		let react_jsx_runtime = require("react/jsx-runtime");
+		let _deepseek_ai_cordis = require("@deepseek-ai/cordis");
 		//#region src/client/contract/slots.ts
 		/**
 		* Bind the row's render occurrence into the entries' `useMenuOpenState` hook:
@@ -223,19 +223,47 @@ window.__ModuleLoader__.load({
 		* 引用——每次都构造新对象会让选择器的 `Object.is` 比较永不成立，触发
 		* 「Maximum update depth exceeded」死循环（React #185），折叠行徽标会整块崩掉。
 		*
-		* 设置面缺席或未就绪时，回落到**默认显示已完成**，与 `Config.showCompletedInBadge` 的
-		* schema 默认值同源：读不到配置不是「关掉」。
+		* 设置面缺席或未就绪时，回落到**默认全部显示**，与 `Config` 各字段的 schema 默认值同源：
+		* 读不到配置不是「关掉」。
 		*/
 		/** Loader 条目 id —— 设置页的寻址键，也是宿主 `describe()` 的 ns。 */
 		const ENTRY_ID = "dsh-group-status";
-		/** 默认值：与 `Config.showCompletedInBadge` 的 schema 默认同源（true）。 */
-		const DEFAULT_BADGE_SETTINGS = Object.freeze({ showCompletedInBadge: true });
-		/** 从原始快照派生：只有**显式 false** 才隐藏，缺失/非法一律显示。 */
+		/** 默认值：与 `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;
+		}
+		/** 从原始快照派生：只有**显式 false** 才隐藏，缺失/非法一律显示（countThreshold 默认 2）。 */
 		function resolveFromSnapshot(snap) {
 			if (snap === void 0 || snap.status !== "ready") return DEFAULT_BADGE_SETTINGS;
 			const value = snap.value;
 			if (value === void 0 || value === null || typeof value !== "object") return DEFAULT_BADGE_SETTINGS;
-			return { showCompletedInBadge: value["showCompletedInBadge"] !== false };
+			const getBool = (field, def) => {
+				const v = value[field];
+				return typeof v === "boolean" ? v : def;
+			};
+			const getNumber = (field, def) => {
+				const v = value[field];
+				return typeof v === "number" && Number.isFinite(v) && v >= 0 ? Math.floor(v) : def;
+			};
+			return {
+				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)
+			};
 		}
 		/**
 		* 建一个恒在、取值稳定的徽标设置源。
@@ -263,13 +291,324 @@ window.__ModuleLoader__.load({
 					seen = snapshot;
 					seenSet = true;
 					const next = resolveFromSnapshot(snapshot);
-					if (next.showCompletedInBadge === resolved.showCompletedInBadge) return;
+					if (settingsEqual(next, resolved)) return;
 					resolved = next;
 					for (const listener of [...listeners]) listener();
 				}
 			};
 		}
 		//#endregion
+		//#region src/client/badge-field.ts
+		/** 卡片字段名（与 `src/index.ts` 的 `Config` 同名同义）。 */
+		const BADGE_FIELDS = {
+			showCompletedInBadge: "showCompletedInBadge",
+			showRunningInBadge: "showRunningInBadge",
+			showPendingInBadge: "showPendingInBadge",
+			showScheduledInBadge: "showScheduledInBadge",
+			showWaitingReviewInBadge: "showWaitingReviewInBadge",
+			showHoverDetails: "showHoverDetails",
+			countThreshold: "countThreshold"
+		};
+		/**
+		* 草稿文本解析成开关状态：与 {@link isFieldEnabled} 不同，这里比较的是模型给的
+		* **文本**，别把字符串喂给上面那个函数（`'false' !== false` 恒真）。
+		*/
+		function isDraftEnabled(text) {
+			return text !== "false";
+		}
+		/**
+		* 构造一个布尔字段的字段转换规格。
+		*
+		* `parse` 只接受 `'true'` / `'false'`：空串、任意其它文本都返回 `undefined`，
+		* 让模型把字段判为 invalid 并拒绝保存（官方模型的既定行为）。
+		*
+		* @param field - 字段名（与 Config 同名）。
+		* @param defaultValue - 缺失值时的默认（true = 默认显示，false = 默认隐藏）。
+		*/
+		function makeBooleanField(field, defaultValue) {
+			return {
+				field,
+				format: (value) => {
+					return (value === void 0 || value === null || typeof value !== "boolean" ? defaultValue : value) ? "true" : "false";
+				},
+				parse: (text) => text === "true" ? {
+					kind: "set",
+					value: true
+				} : text === "false" ? {
+					kind: "set",
+					value: false
+				} : void 0
+			};
+		}
+		/** 所有字段规格（按卡片渲染顺序）。 */
+		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),
+			makeBooleanField(BADGE_FIELDS.showHoverDetails, true),
+			{
+				field: BADGE_FIELDS.countThreshold,
+				format: (value) => {
+					const n = value === void 0 || value === null || typeof value !== "number" || !Number.isFinite(value) ? 2 : Math.floor(value);
+					return String(n < 0 ? 0 : n);
+				},
+				parse: (text) => {
+					const n = Number(text);
+					if (!Number.isFinite(n) || n < 0 || n !== Math.floor(n)) return void 0;
+					return {
+						kind: "set",
+						value: n
+					};
+				}
+			}
+		];
+		//#endregion
+		//#region \0dsh-css:/home/wujue/workspace/dsh-plugins/dsh-group-status/src/client/BadgeSettingsCard.module.css.mjs
+		const css$4 = ".EgC0Ja_section{min-width:0;padding:16px 0}.EgC0Ja_section:last-child{padding-bottom:0}.EgC0Ja_heading{color:var(--dsw-alias-label-primary);margin:0;font-size:13px;font-weight:600;line-height:1.5}.EgC0Ja_badgeField{gap:6px;padding:12px 0;display:grid}.EgC0Ja_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}.EgC0Ja_badgeToggleLabel{flex:1;min-width:0}.EgC0Ja_badgeNumberControl{align-items:center;gap:4px;display:flex}.EgC0Ja_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}.EgC0Ja_badgeNumberButton:hover:not(:disabled){border-color:var(--dsw-alias-border-focus,#0078d4);background:var(--dsw-alias-bg-hover,#3a3a3a)}.EgC0Ja_badgeNumberButton:active:not(:disabled){background:var(--dsw-alias-bg-active,#4a4a4a)}.EgC0Ja_badgeNumberButton:disabled{opacity:.3;cursor:not-allowed}.EgC0Ja_badgeNumberValue{text-align:center;min-width:24px;color:var(--dsw-alias-label-primary);font-size:13px;font-weight:500}.EgC0Ja_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");
+			tag.dataset.plugin = "dsh-group-status";
+			tag.dataset.pluginCss = tagId$4;
+			tag.textContent = css$4;
+			document.head.appendChild(tag);
+		}
+		var BadgeSettingsCard_module_css_default = {
+			"badgeField": "EgC0Ja_badgeField",
+			"badgeNumberButton": "EgC0Ja_badgeNumberButton",
+			"badgeNumberControl": "EgC0Ja_badgeNumberControl",
+			"badgeNumberValue": "EgC0Ja_badgeNumberValue",
+			"badgeToggleLabel": "EgC0Ja_badgeToggleLabel",
+			"badgeToggleRow": "EgC0Ja_badgeToggleRow",
+			"heading": "EgC0Ja_heading",
+			"hint": "EgC0Ja_hint",
+			"section": "EgC0Ja_section"
+		};
+		//#endregion
+		//#region src/client/BadgeSettingsCard.tsx
+		/**
+		* 折叠徽标的设置卡片：插件 → dsh-group-status（bundle 详情页的配置表单）。
+		*
+		* 为什么需要这张卡片：0.2.0 起宿主把插件 `Config`（`src/index.ts`，根节点
+		* `.volatile()`）投影到客户端 `configForms` 服务上，但**不会**自动把表单画进
+		* 「插件」页——插件页只在客户端往 `plugins.bundle.config` 注册了卡片时才渲染
+		* （见 dsh-later / dsh-gitea-dispatch 的同款做法）。没有它，README「设置项」一节
+		* 描述的配置表单在 GUI 里根本不存在。
+		*
+		* 视觉与交互**不自造**，全部交给官方组件（`@deepseek-ai/dsh-client-ui-primitives`）：
+		*  - `SettingsForm`：表单框架——只读提示、不可用提示、保存按钮、失败行、间距；
+		*  - `SettingsFormModel`：分步草稿与保存（revision 围栏、宿主拒绝时不丢草稿）；
+		*  - `Switch`：开关本体。
+		* 官方设置页（设置 → 内置插件 → 子智能体 / 网页搜索）用的就是这三件，本卡片的
+		* 类名与取值也逐条对齐它们的 CSS（见 `BadgeSettingsCard.module.css` 头部）。
+		*
+		* 字段定义在 `badge-field.ts`（纯逻辑，可单测）；这里只管把它们接到模型与槽位上。
+		*/
+		/**
+		* 渲染折叠徽标的设置表单。
+		*
+		* 模型与投影都按 `scope` 记忆：宿主换一份表单（条目重新服务）时整体重建，旧模型
+		* 在 effect 清理里 `dispose()`，不会留下悬挂订阅。
+		* @param props - 宿主设置表单与文案取值器。
+		* @returns 官方表单框架包着本插件的开关字段。
+		*/
+		function BadgeSettingsCard({ scope, t }) {
+			const model = (0, react.useMemo)(() => new _deepseek_ai_dsh_client_ui_primitives.SettingsFormModel(scope, ALL_BADGE_FIELDS), [scope]);
+			(0, react.useEffect)(() => () => {
+				model.dispose();
+			}, [model]);
+			const store = (0, react.useMemo)(() => model.bind(() => ({
+				...model.shell(),
+				fields: ALL_BADGE_FIELDS.map((spec) => ({
+					field: spec.field,
+					text: model.field(spec.field).text
+				}))
+			})), [model]);
+			const state = (0, react.useSyncExternalStore)(store.subscribe, store.getSnapshot);
+			const actions = (0, react.useMemo)(() => model.actions(), [model]);
+			const badgeSectionId = (0, react.useId)();
+			const hoverSectionId = (0, react.useId)();
+			const countSectionId = (0, react.useId)();
+			const labels = {
+				unavailable: t("settings.unavailable"),
+				readOnly: t("settings.readOnly"),
+				saveFailed: t("settings.saveFailed"),
+				save: t("settings.save"),
+				saving: t("settings.saving")
+			};
+			const fieldText = (field) => {
+				return state.fields.find((f) => f.field === field)?.text ?? "true";
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(_deepseek_ai_dsh_client_ui_primitives.SettingsForm, {
+				labels,
+				state,
+				onSave: () => {
+					actions.save();
+				},
+				onDiscard: () => {
+					actions.discard();
+				},
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+						className: BadgeSettingsCard_module_css_default.section,
+						"aria-labelledby": badgeSectionId,
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+								className: BadgeSettingsCard_module_css_default.heading,
+								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
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToggleRow, {
+								field: BADGE_FIELDS.showCompletedInBadge,
+								text: fieldText(BADGE_FIELDS.showCompletedInBadge),
+								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
+							})
+						]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+						className: BadgeSettingsCard_module_css_default.section,
+						"aria-labelledby": hoverSectionId,
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+							className: BadgeSettingsCard_module_css_default.heading,
+							id: hoverSectionId,
+							children: t("settings.hover.section")
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToggleRow, {
+							field: BADGE_FIELDS.showHoverDetails,
+							text: fieldText(BADGE_FIELDS.showHoverDetails),
+							label: t("settings.hover.showDetails"),
+							hint: t("settings.hover.showDetailsHint"),
+							state,
+							actions
+						})]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+						className: BadgeSettingsCard_module_css_default.section,
+						"aria-labelledby": countSectionId,
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+							className: BadgeSettingsCard_module_css_default.heading,
+							id: countSectionId,
+							children: t("settings.count.section")
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NumberRow, {
+							field: BADGE_FIELDS.countThreshold,
+							text: fieldText(BADGE_FIELDS.countThreshold),
+							label: t("settings.count.threshold"),
+							hint: t("settings.count.thresholdHint"),
+							state,
+							actions
+						})]
+					})
+				]
+			});
+		}
+		/** 单行开关：label + Switch + hint。 */
+		function ToggleRow({ field, text, label, hint, state, actions }) {
+			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", {
+						className: BadgeSettingsCard_module_css_default.badgeToggleLabel,
+						children: label
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Switch, {
+						checked: isDraftEnabled(text),
+						label,
+						disabled: !state.writable || state.saving,
+						onChange: (next) => {
+							actions.edit(field, next ? "true" : "false");
+						}
+					})]
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: BadgeSettingsCard_module_css_default.hint,
+					children: hint
+				})]
+			});
+		}
+		/** 单行数字输入：label + 带加减按钮的数字输入 + hint。 */
+		function NumberRow({ field, text, label, hint, state, actions }) {
+			const disabled = !state.writable || state.saving;
+			const currentValue = Number(text) || 0;
+			const decrement = () => {
+				if (!disabled && currentValue > 0) actions.edit(field, String(currentValue - 1));
+			};
+			const increment = () => {
+				if (!disabled) actions.edit(field, String(currentValue + 1));
+			};
+			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", {
+						className: BadgeSettingsCard_module_css_default.badgeToggleLabel,
+						children: label
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: BadgeSettingsCard_module_css_default.badgeNumberControl,
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: BadgeSettingsCard_module_css_default.badgeNumberButton,
+								disabled: disabled || currentValue <= 0,
+								onClick: decrement,
+								"aria-label": "减少",
+								children: "−"
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: BadgeSettingsCard_module_css_default.badgeNumberValue,
+								children: text
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: BadgeSettingsCard_module_css_default.badgeNumberButton,
+								disabled,
+								onClick: increment,
+								"aria-label": "增加",
+								children: "+"
+							})
+						]
+					})]
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: BadgeSettingsCard_module_css_default.hint,
+					children: hint
+				})]
+			});
+		}
+		//#endregion
 		//#region node_modules/.pnpm/@deepseek-ai+dsh-util-values@0.2.0-rc.2_@deepseek-ai+cordis@4.0.4/node_modules/@deepseek-ai/dsh-util-values/lib/index.js
 		/** Duplicate-install-safe JSON and immutable-value helpers. @module @deepseek-ai/dsh-util-values */
 		/**
@@ -318,118 +657,6 @@ window.__ModuleLoader__.load({
 			const separator = Math.max(trimmed.lastIndexOf("/"), trimmed.lastIndexOf("\\"));
 			return trimmed.slice(separator + 1);
 		}
-		//#endregion
-		//#region src/client/group-status.ts
-		/**
-		* Zero-valued sentinel for {@link GroupLiveStatus}.
-		*
-		* Used when a group is expanded (badge is hidden, so aggregation is wasted
-		* work) or when no cross-plugin data is available. Kept as a frozen constant
-		* so the reference is stable across renders — `Object.is` comparisons in
-		* React selectors never trigger spurious re-renders on it.
-		*/
-		const EMPTY_LIVE_STATUS = Object.freeze({
-			running: 0,
-			approval: 0,
-			planReview: 0,
-			question: 0,
-			done: 0,
-			subagents: 0,
-			scheduledSessions: 0,
-			scheduledCount: 0,
-			scheduleState: void 0,
-			waitingReviewCount: 0,
-			waitingReviewState: void 0
-		});
-		/**
-		* Strip the `session-` / `webhook-` prefix from a Session id.
-		*
-		* dsh-gitea-dispatch publishes its waiting map keyed by the host SessionId, but
-		* its HTTP endpoints key by this normalized form. Accepting both here keeps the
-		* badge working across that publisher's conventions without knowing which is in
-		* play.
-		*/
-		function stripSessionPrefix(id) {
-			return id.replace(/^(?:session|webhook)-/, "");
-		}
-		/**
-		* Fold every member row of a group into counts so a collapsed folder can hint at
-		* hidden live sessions. Mirrors the session-row status priority (pending
-		* outranks running outranks completed) at the counting level; labels resolve with
-		* locale at render time.
-		* @param nodes - member rows of the group.
-		* @param sessionIds - the same members' Session ids (schedule and waiting facts are keyed by id).
-		* @param waitingReviewSummary - dsh-gitea-dispatch waiting map, when that plugin is loaded.
-		* @param scheduleSummary - dsh-later schedule map, when that plugin is loaded.
-		*/
-		function summarizeGroupStatus(nodes, sessionIds, waitingReviewSummary, scheduleSummary) {
-			let running = 0;
-			let approval = 0;
-			let planReview = 0;
-			let question = 0;
-			let done = 0;
-			let subagents = 0;
-			for (const n of nodes) {
-				if (n.blank || n.archived) continue;
-				if (n.pendingInteraction === "approval") {
-					approval += 1;
-					continue;
-				}
-				if (n.pendingInteraction === "plan-review") {
-					planReview += 1;
-					continue;
-				}
-				if (n.pendingInteraction === "question") {
-					question += 1;
-					continue;
-				}
-				if (n.running) running += 1;
-				else if (n.completed) done += 1;
-				subagents += n.runningSubagentCount;
-			}
-			let scheduledSessions = 0;
-			let scheduledCount = 0;
-			let scheduleState = void 0;
-			if (scheduleSummary && sessionIds.length > 0) {
-				let totalSessions = 0;
-				let totalCount = 0;
-				let highestPriority = 0;
-				for (const id of sessionIds) {
-					const entry = scheduleSummary.get(id);
-					if (entry) {
-						totalSessions += 1;
-						totalCount += entry.count;
-						const priority = entry.state === "overdue" ? 3 : entry.state === "urgent" ? 2 : 1;
-						if (priority > highestPriority) highestPriority = priority;
-					}
-				}
-				scheduledSessions = totalSessions;
-				scheduledCount = totalCount;
-				scheduleState = highestPriority === 3 ? "overdue" : highestPriority === 2 ? "urgent" : highestPriority === 1 ? "scheduled" : void 0;
-			}
-			let waitingReviewCount = 0;
-			let waitingReviewState = void 0;
-			if (waitingReviewSummary && sessionIds.length > 0) for (const id of sessionIds) {
-				const entry = waitingReviewSummary.get(id) ?? waitingReviewSummary.get(stripSessionPrefix(id));
-				if (entry === void 0) continue;
-				waitingReviewCount += 1;
-				if (entry.state === "overdue") waitingReviewState = "overdue";
-				else if (waitingReviewState === void 0) waitingReviewState = "waiting";
-			}
-			return {
-				running,
-				approval,
-				planReview,
-				question,
-				done,
-				subagents,
-				scheduledSessions,
-				scheduledCount,
-				scheduleState,
-				waitingReviewCount,
-				waitingReviewState
-			};
-		}
 		/**
 		* Resolve the Workspace browser group that owns one Session.
 		* @param workspaces - authoritative Workspace membership.
@@ -666,7 +893,7 @@ window.__ModuleLoader__.load({
 		* @param scheduleSummary - dsh-later schedule map (session id → schedule entry).
 		* @returns group sections in render order.
 		*/
-		function deriveGroups(list, workspaces, rowState, statuses, view, waitingReviewSummary, scheduleSummary) {
+		function deriveGroups(list, workspaces, rowState, statuses, view) {
 			const archived = new Set(rowState.archivedSessionIds);
 			const pinned = new Set(rowState.pinnedSessionIds);
 			const expandedGroups = new Set(view.expandedGroups);
@@ -676,7 +903,6 @@ window.__ModuleLoader__.load({
 			for (const g of groupByWorkspace(list, workspaces, archived, rowState.archivedFilter, view.ungroupedOrder)) {
 				const expanded = expandedGroups.has(g.key);
 				const members = sectionMembers(g.sessions, pinned, archived).map((session) => sessionNode(session, list, statuses, pinned, archived));
-				const memberIds = members.map((m) => m.id);
 				groups.push({
 					key: g.key,
 					workspaceId: g.workspaceId,
@@ -686,8 +912,7 @@ window.__ModuleLoader__.load({
 					sessionCount: g.sessions.length,
 					expanded,
 					containsCurrent: g.key === currentGroup,
-					liveStatus: expanded ? EMPTY_LIVE_STATUS : summarizeGroupStatus(members, memberIds, waitingReviewSummary, scheduleSummary),
-					sessions: expanded ? members : []
+					sessions: members
 				});
 			}
 			return groups;
@@ -1245,6 +1470,209 @@ window.__ModuleLoader__.load({
 			return title === "default-workspace" ? localizedDefault : title;
 		}
 		//#endregion
+		//#region src/client/group-status.ts
+		/**
+		* Zero-valued sentinel for {@link GroupLiveStatus}.
+		*
+		* Used when a group is expanded (badge is hidden, so aggregation is wasted
+		* work) or when no cross-plugin data is available. Kept as a frozen constant
+		* so the reference is stable across renders — `Object.is` comparisons in
+		* React selectors never trigger spurious re-renders on it.
+		*/
+		const EMPTY_LIVE_STATUS = Object.freeze({
+			running: 0,
+			approval: 0,
+			planReview: 0,
+			question: 0,
+			done: 0,
+			subagents: 0,
+			scheduledSessions: 0,
+			scheduledCount: 0,
+			scheduleState: void 0,
+			waitingReviewCount: 0,
+			waitingReviewState: void 0
+		});
+		/**
+		* Merge two {@link GroupLiveStatus} objects by summing counters and taking the
+		* highest-priority state (overdue > urgent > scheduled for schedule; overdue > waiting
+		* for waiting-review).
+		*
+		* Used for multi-level aggregation: when a parent group is collapsed, its badge
+		* must reflect all descendant sessions, not just direct members.
+		*/
+		function mergeLiveStatus(a, b) {
+			const priorityOf = (s) => s === "overdue" ? 3 : s === "urgent" ? 2 : s === "scheduled" ? 1 : 0;
+			const scheduleState = priorityOf(a.scheduleState) >= priorityOf(b.scheduleState) ? a.scheduleState : b.scheduleState;
+			const waitingReviewState = (a.waitingReviewState === "overdue" ? 2 : a.waitingReviewState === "waiting" ? 1 : 0) >= (b.waitingReviewState === "overdue" ? 2 : b.waitingReviewState === "waiting" ? 1 : 0) ? a.waitingReviewState : b.waitingReviewState;
+			return {
+				running: a.running + b.running,
+				approval: a.approval + b.approval,
+				planReview: a.planReview + b.planReview,
+				question: a.question + b.question,
+				done: a.done + b.done,
+				subagents: a.subagents + b.subagents,
+				scheduledSessions: a.scheduledSessions + b.scheduledSessions,
+				scheduledCount: a.scheduledCount + b.scheduledCount,
+				scheduleState,
+				waitingReviewCount: a.waitingReviewCount + b.waitingReviewCount,
+				waitingReviewState
+			};
+		}
+		/**
+		* Strip the `session-` / `webhook-` prefix from a Session id.
+		*
+		* dsh-gitea-dispatch publishes its waiting map keyed by the host SessionId, but
+		* its HTTP endpoints key by this normalized form. Accepting both here keeps the
+		* badge working across that publisher's conventions without knowing which is in
+		* play.
+		*/
+		function stripSessionPrefix(id) {
+			return id.replace(/^(?:session|webhook)-/, "");
+		}
+		/**
+		* Fold every member row of a group into counts so a collapsed folder can hint at
+		* hidden live sessions. Mirrors the session-row status priority (pending
+		* outranks running outranks completed) at the counting level; labels resolve with
+		* locale at render time.
+		* @param nodes - member rows of the group.
+		* @param sessionIds - the same members' Session ids (schedule and waiting facts are keyed by id).
+		* @param waitingReviewSummary - dsh-gitea-dispatch waiting map, when that plugin is loaded.
+		* @param scheduleSummary - dsh-later schedule map, when that plugin is loaded.
+		*/
+		function summarizeGroupStatus(nodes, sessionIds, waitingReviewSummary, scheduleSummary) {
+			let running = 0;
+			let approval = 0;
+			let planReview = 0;
+			let question = 0;
+			let done = 0;
+			let subagents = 0;
+			for (const n of nodes) {
+				if (n.blank || n.archived) continue;
+				if (n.pendingInteraction === "approval") {
+					approval += 1;
+					continue;
+				}
+				if (n.pendingInteraction === "plan-review") {
+					planReview += 1;
+					continue;
+				}
+				if (n.pendingInteraction === "question") {
+					question += 1;
+					continue;
+				}
+				if (n.running) running += 1;
+				else if (n.completed) done += 1;
+				subagents += n.runningSubagentCount;
+			}
+			let scheduledSessions = 0;
+			let scheduledCount = 0;
+			let scheduleState = void 0;
+			if (scheduleSummary && sessionIds.length > 0) {
+				let totalSessions = 0;
+				let totalCount = 0;
+				let highestPriority = 0;
+				for (const id of sessionIds) {
+					const entry = scheduleSummary.get(id);
+					if (entry) {
+						totalSessions += 1;
+						totalCount += entry.count;
+						const priority = entry.state === "overdue" ? 3 : entry.state === "urgent" ? 2 : 1;
+						if (priority > highestPriority) highestPriority = priority;
+					}
+				}
+				scheduledSessions = totalSessions;
+				scheduledCount = totalCount;
+				scheduleState = highestPriority === 3 ? "overdue" : highestPriority === 2 ? "urgent" : highestPriority === 1 ? "scheduled" : void 0;
+			}
+			let waitingReviewCount = 0;
+			let waitingReviewState = void 0;
+			if (waitingReviewSummary && sessionIds.length > 0) for (const id of sessionIds) {
+				const entry = waitingReviewSummary.get(id) ?? waitingReviewSummary.get(stripSessionPrefix(id));
+				if (entry === void 0) continue;
+				waitingReviewCount += 1;
+				if (entry.state === "overdue") waitingReviewState = "overdue";
+				else if (waitingReviewState === void 0) waitingReviewState = "waiting";
+			}
+			return {
+				running,
+				approval,
+				planReview,
+				question,
+				done,
+				subagents,
+				scheduledSessions,
+				scheduledCount,
+				scheduleState,
+				waitingReviewCount,
+				waitingReviewState
+			};
+		}
+		/**
+		* Measure each group's own members, as the input to {@link aggregateGroupStatuses}.
+		*
+		* Every group is measured, expanded ones included. A folder row shows no badge while
+		* it is expanded, but its sessions still need attention and a collapsed ancestor must
+		* keep counting them — so expansion is a rendering fact, never an input to the
+		* aggregation. Short-circuiting expanded groups to `EMPTY_LIVE_STATUS` (the shape this
+		* had before the tree-wide aggregator existed, harmless while nothing aggregated) makes
+		* every collapsed parent undercount by the size of its expanded descendants.
+		*
+		* @param groups - derived groups, each with its member rows already populated.
+		* @param waitingReviewSummary - dsh-gitea-dispatch waiting map, when that plugin is loaded.
+		* @param scheduleSummary - dsh-later schedule map, when that plugin is loaded.
+		*/
+		function directStatusesForGroups(groups, waitingReviewSummary, scheduleSummary) {
+			const map = /* @__PURE__ */ new Map();
+			for (const group of groups) map.set(group.key, summarizeGroupStatus(group.sessions, group.sessions.map((s) => s.id), waitingReviewSummary, scheduleSummary));
+			return map;
+		}
+		/**
+		* Fold every group's DIRECT status up the workspace tree, so a collapsed folder
+		* counts every descendant session. A group's own row shows no badge while it is
+		* expanded, but its sessions still need attention and its collapsed ancestor must
+		* keep counting them — so the walk never depends on a group's expanded state.
+		*
+		* @param direct - each group's own-member status, keyed by group key.
+		* @param childrenByParent - the rendered tree: parent key (`undefined` = roots) → children.
+		* @returns aggregated status per group key: own members plus the whole subtree.
+		*/
+		function aggregateGroupStatuses(direct, childrenByParent) {
+			const aggregated = /* @__PURE__ */ new Map();
+			const visiting = /* @__PURE__ */ new Set();
+			const fold = (key) => {
+				const cached = aggregated.get(key);
+				if (cached !== void 0) return cached;
+				if (visiting.has(key)) return direct.get(key) ?? EMPTY_LIVE_STATUS;
+				visiting.add(key);
+				let total = direct.get(key) ?? EMPTY_LIVE_STATUS;
+				for (const child of childrenByParent.get(key) ?? []) total = mergeLiveStatus(total, fold(child.key));
+				visiting.delete(key);
+				aggregated.set(key, total);
+				return total;
+			};
+			for (const children of childrenByParent.values()) for (const child of children) fold(child.key);
+			return aggregated;
+		}
+		/**
+		* Attach each group's subtree-wide status, in derivation order. This is the producer
+		* the sidebar renders from.
+		*
+		* Expanded groups carry their status too: their own row draws no badge (a decision
+		* inside `groupLiveBadge`), but a collapsed ancestor still has to count them, so
+		* expansion never suppresses the measurement.
+		*
+		* @param groups - derived rows, in the order they render.
+		* @param direct - each group's own-member status, from {@link directStatusesForGroups}.
+		* @param childrenByParent - the rendered tree: parent key (`undefined` = roots) → children.
+		*/
+		function withAggregatedStatus(groups, direct, childrenByParent) {
+			const aggregated = aggregateGroupStatuses(direct, childrenByParent);
+			return groups.map((group) => ({
+				...group,
+				liveStatus: aggregated.get(group.key) ?? EMPTY_LIVE_STATUS
+			}));
+		}
+		//#endregion
 		//#region \0dsh-css:/home/wujue/workspace/dsh-plugins/dsh-group-status/src/client/rows/Rows.module.css.mjs
 		const css$3 = ".eCE9Ta_projectRow,.eCE9Ta_sessionRow{border-radius:var(--dsw-radius-md);padding:0 8px;cursor:pointer;user-select:none;color:var(--dsw-alias-label-primary);align-items:center;gap:6px;padding-inline-start:calc(8px + var(--dsh-workspace-indent,0px));display:flex}.eCE9Ta_projectRow:hover,.eCE9Ta_sessionRow:hover,.eCE9Ta_sessionRow.eCE9Ta_selected{background:var(--dsw-alias-interactive-bg-hover)}.eCE9Ta_searchResultRow{box-sizing:border-box;border-radius:var(--dsw-radius-lg);cursor:pointer;text-align:left;width:100%;min-height:48px;color:var(--dsw-alias-label-primary);background:0 0;border:none;flex-direction:column;align-items:stretch;padding:4px 8px;display:flex}.eCE9Ta_searchResultRow:hover,.eCE9Ta_searchResultRow.eCE9Ta_selected{background:var(--dsw-alias-interactive-bg-hover)}.eCE9Ta_searchResultHeading{align-items:center;min-width:0;display:flex}.eCE9Ta_searchResultTitle{text-overflow:ellipsis;white-space:nowrap;flex:0 auto;min-width:0;margin-left:4px;font-size:14px;line-height:20px;overflow:hidden}.eCE9Ta_searchResultMeta{align-items:center;gap:6px;min-width:0;margin-left:20px;display:flex}.eCE9Ta_searchResultWorkspace,.eCE9Ta_searchResultSnippet{text-overflow:ellipsis;white-space:nowrap;font-size:12px;line-height:17px;overflow:hidden}.eCE9Ta_searchResultWorkspace{max-width:40%;color:var(--dsw-alias-label-tertiary);flex:none}.eCE9Ta_searchResultWorkspace:only-child{max-width:100%}.eCE9Ta_searchResultSnippet{min-width:0;color:var(--dsw-alias-label-secondary);flex:1}.eCE9Ta_projectRow{box-sizing:border-box;align-items:center;height:34px}.eCE9Ta_projectRow .eCE9Ta_rowActions{height:20px}.eCE9Ta_sessionRow{gap:0;height:32px}.eCE9Ta_sessionRow .eCE9Ta_title{margin:0 6px 0 4px}.eCE9Ta_slot{width:16px;height:20px;color:var(--dsw-alias-label-tertiary);flex:none;justify-content:center;align-items:center;display:inline-flex}.eCE9Ta_visuallyHidden{clip:rect(0 0 0 0);white-space:nowrap;width:1px;height:1px;position:absolute;overflow:hidden}.eCE9Ta_folderActive{color:var(--dsw-alias-state-business-primary)}.eCE9Ta_projectRow .eCE9Ta_chevron{display:none}.eCE9Ta_projectRow:hover .eCE9Ta_chevron{display:inline-flex}.eCE9Ta_projectRow:hover .eCE9Ta_folder{display:none}.eCE9Ta_arrow{transition:transform .15s var(--ds-ease-in-out)}.eCE9Ta_arrowOpen{transform:rotate(90deg)}.eCE9Ta_projectText{flex-direction:column;flex:1;gap:2px;min-width:0;display:flex}.eCE9Ta_title{text-overflow:ellipsis;white-space:nowrap;min-width:0;font-size:14px;line-height:20px;overflow:hidden}.eCE9Ta_renameInput{border:.5px solid var(--dsw-alias-border-l4);border-radius:var(--dsw-radius-sm);background:var(--dsw-alias-button-elevated-fill);min-width:0;color:inherit;outline:none;padding:0 2px;font-size:14px;line-height:20px}.eCE9Ta_sessionRow .eCE9Ta_title{flex:1}.eCE9Ta_sessionRow .eCE9Ta_title[data-scrolled]{mask-image:linear-gradient(90deg,#0000,#000 12px)}.eCE9Ta_sessionRow .eCE9Ta_title[data-clipped]{mask-image:linear-gradient(270deg,#0000,#000 12px)}.eCE9Ta_sessionRow .eCE9Ta_title[data-scrolled][data-clipped]{mask-image:linear-gradient(90deg,#0000,#000 12px calc(100% - 12px),#0000)}.eCE9Ta_meta{text-overflow:ellipsis;white-space:nowrap;color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:20px;overflow:hidden}.eCE9Ta_time{color:var(--dsw-alias-label-tertiary);flex:none;font-size:10px;line-height:16px}.eCE9Ta_pinIndicator{width:16px;height:20px;color:var(--dsw-alias-label-caption);flex:none;justify-content:center;align-items:center;margin-left:6px;display:inline-flex}.eCE9Ta_sessionRow.eCE9Ta_archived .eCE9Ta_title,.eCE9Ta_searchResultRow.eCE9Ta_archived .eCE9Ta_searchResultTitle,.eCE9Ta_searchResultRow.eCE9Ta_archived .eCE9Ta_searchResultWorkspace,.eCE9Ta_searchResultRow.eCE9Ta_archived .eCE9Ta_searchResultSnippet{color:var(--dsw-alias-label-caption)}.eCE9Ta_dot{flex:none}.eCE9Ta_rowActions{flex:none;align-items:center;gap:10px;display:none}.eCE9Ta_projectRow:hover .eCE9Ta_rowActions,.eCE9Ta_sessionRow:hover .eCE9Ta_rowActions,.eCE9Ta_searchResultRow:hover .eCE9Ta_rowActions,.eCE9Ta_projectRow.eCE9Ta_menuOpen .eCE9Ta_rowActions,.eCE9Ta_sessionRow.eCE9Ta_menuOpen .eCE9Ta_rowActions{display:inline-flex}.eCE9Ta_searchResultHeading .eCE9Ta_rowActions{margin-left:auto}.eCE9Ta_sessionRow:hover .eCE9Ta_time,.eCE9Ta_sessionRow.eCE9Ta_menuOpen .eCE9Ta_time,.eCE9Ta_sessionRow:hover .eCE9Ta_pinIndicator,.eCE9Ta_sessionRow.eCE9Ta_menuOpen .eCE9Ta_pinIndicator{display:none}@media (hover:hover){.eCE9Ta_sessionRow:hover .eCE9Ta_title,.eCE9Ta_sessionRow.eCE9Ta_menuOpen .eCE9Ta_title{text-overflow:clip}}.eCE9Ta_projectRow.eCE9Ta_menuOpen,.eCE9Ta_sessionRow.eCE9Ta_menuOpen{background:var(--dsw-alias-interactive-bg-hover)}.eCE9Ta_sessionRow.eCE9Ta_dropBefore,.eCE9Ta_sessionRow.eCE9Ta_dropAfter{position:relative}.eCE9Ta_sessionRow.eCE9Ta_dropBefore:before,.eCE9Ta_sessionRow.eCE9Ta_dropAfter:after{content:\"\";z-index:1;background:linear-gradient(55deg, transparent calc(50% - 1px), var(--dsw-alias-state-business-primary) calc(50% - 1px) calc(50% + 1px), transparent calc(50% + 1px)) 0 0 / 5px 7px no-repeat, linear-gradient(125deg, transparent calc(50% - 1px), var(--dsw-alias-state-business-primary) calc(50% - 1px) calc(50% + 1px), transparent calc(50% + 1px)) 0 5px / 5px 7px no-repeat, linear-gradient(var(--dsw-alias-state-business-primary) 0 0) 4px 5px / calc(100% - 4px) 2px no-repeat;pointer-events:none;height:12px;position:absolute;left:0;right:4px}.eCE9Ta_sessionRow.eCE9Ta_dropBefore:before{top:-7px}.eCE9Ta_sessionRow.eCE9Ta_dropAfter:after{bottom:-7px}.eCE9Ta_hoverContent{flex-direction:column;gap:8px;display:flex}.eCE9Ta_hoverTitle{color:var(--dsw-alias-label-primary);overflow-wrap:break-word;font-size:14px;line-height:20px}.eCE9Ta_hoverPath{color:var(--dsw-alias-label-secondary);word-break:break-all;font-size:12px;line-height:16px}.eCE9Ta_hoverTime{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:16px}.eCE9Ta_hoverStatus{color:var(--dsw-alias-label-tertiary);align-items:center;gap:8px;font-size:12px;line-height:20px;display:flex}.eCE9Ta_groupBadge{flex:none;align-items:center;gap:3px;margin-inline-start:4px;display:inline-flex}.eCE9Ta_groupBadgeCount{color:var(--dsw-alias-label-tertiary);border:1px solid;border-radius:6px;padding:0 3px;font-size:9px;line-height:12px}@keyframes eCE9Ta_groupBadgePulse{0%,to{opacity:1}50%{opacity:.6}}.eCE9Ta_groupBadgeUrgent{animation:2s ease-in-out infinite eCE9Ta_groupBadgePulse}.eCE9Ta_hoverArchived svg{flex-shrink:0;margin:0 -4px}.eCE9Ta_iconButton{border-radius:var(--dsw-radius-xs);cursor:pointer;width:16px;height:16px;color:var(--dsw-alias-label-tertiary);background:0 0;border:none;flex:none;justify-content:center;align-items:center;padding:0;display:inline-flex}.eCE9Ta_iconButton:hover{color:var(--dsw-alias-label-primary)}.eCE9Ta_chevron{color:var(--dsw-alias-label-caption)}@media (prefers-reduced-motion:reduce){.eCE9Ta_arrow{transition:none;animation:none}}";
 		const tagId$3 = "dsh-group-status/Rows.module.css";
@@ -1301,17 +1729,23 @@ window.__ModuleLoader__.load({
 		/**
 		* Accessible label for a folded group's aggregated status, reusing the
 		* session-row locale keys so both surfaces read identically.
+		*
+		* 按设置过滤：关掉的来源不出现在标签里（aria-label 与徽标视觉一致）。
 		*/
-		function groupLiveLabel(s, t) {
+		function groupLiveLabel(s, t, settings) {
 			const parts = [];
-			if (s.approval > 0) parts.push(`${s.approval} ${t("status.waitingApproval")}`);
-			if (s.planReview > 0) parts.push(`${s.planReview} ${t("status.planReview")}`);
-			if (s.question > 0) parts.push(`${s.question} ${t("status.waitingAnswer")}`);
-			if (s.running > 0) parts.push(`${s.running} ${t("status.running")}`);
-			if (s.subagents > 0) parts.push(t(s.subagents === 1 ? "status.subagentsRunning.one" : "status.subagentsRunning.other", { n: s.subagents }));
-			if (s.waitingReviewCount > 0) parts.push(`${s.waitingReviewCount} ${t("status.waitingReview")}`);
-			if (s.scheduledSessions > 0) parts.push(`${s.scheduledSessions} ${t("status.scheduled")}`);
-			if (s.done > 0) parts.push(`${s.done} ${t("status.completed")}`);
+			if (settings.showPendingInBadge) {
+				if (s.approval > 0) parts.push(`${s.approval} ${t("status.waitingApproval")}`);
+				if (s.planReview > 0) parts.push(`${s.planReview} ${t("status.planReview")}`);
+				if (s.question > 0) parts.push(`${s.question} ${t("status.waitingAnswer")}`);
+			}
+			if (settings.showRunningInBadge) {
+				if (s.running > 0) parts.push(`${s.running} ${t("status.running")}`);
+				if (s.subagents > 0) parts.push(t(s.subagents === 1 ? "status.subagentsRunning.one" : "status.subagentsRunning.other", { n: s.subagents }));
+			}
+			if (settings.showWaitingReviewInBadge && s.waitingReviewCount > 0) parts.push(`${s.waitingReviewCount} ${t("status.waitingReview")}`);
+			if (settings.showScheduledInBadge && s.scheduledSessions > 0) parts.push(`${s.scheduledSessions} ${t("status.scheduled")}`);
+			if (settings.showCompletedInBadge && s.done > 0) parts.push(`${s.done} ${t("status.completed")}`);
 			return parts.join(" · ");
 		}
 		/**
@@ -1321,20 +1755,19 @@ window.__ModuleLoader__.load({
 		*
 		* Count matches the dots: pending + active + completed + waiting-review + scheduled sessions.
 		*
-		* `showCompleted` (设置项 `showCompletedInBadge`) 关闭时，`done` 完全退出这个聚合
-		* 提示——不画绿点、不计入数字、不参与「是否显示徽标」的判断，等价于旧行为。会话行
-		* 自身的绿点不受影响：那是行级状态，不是分组提示。
+		* `settings` 按来源过滤：关掉的来源不画点、不计数、不进 aria-label、不参与「是否显示徽标」
+		* 的判断。会话行自身的状态不受影响：那是行级状态，不是分组提示。
 		*/
-		function groupLiveBadge(group, t, showCompleted) {
+		function groupLiveBadge(group, t, settings) {
 			const s = group.liveStatus;
 			if (group.expanded || s === void 0) return null;
-			const pending = s.approval + s.planReview + s.question;
-			const active = s.running + s.subagents;
-			const scheduled = s.scheduledSessions;
-			const hasWaitingReview = s.waitingReviewCount > 0;
-			const completed = showCompleted ? s.done : 0;
+			const pending = settings.showPendingInBadge ? s.approval + s.planReview + s.question : 0;
+			const active = settings.showRunningInBadge ? s.running + s.subagents : 0;
+			const scheduled = settings.showScheduledInBadge ? s.scheduledSessions : 0;
+			const hasWaitingReview = settings.showWaitingReviewInBadge && s.waitingReviewCount > 0;
+			const completed = settings.showCompletedInBadge ? s.done : 0;
 			if (pending === 0 && active === 0 && completed === 0 && scheduled === 0 && !hasWaitingReview) return null;
-			const label = groupLiveLabel(s, t);
+			const label = groupLiveLabel(s, t, settings);
 			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"));
@@ -1361,8 +1794,8 @@ window.__ModuleLoader__.load({
 					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconListPenOutlineRegular, { size: 14 })
 				}, "waiting-review"));
 			}
-			const count = pending + active + completed + scheduled + s.waitingReviewCount;
-			const countLabel = count > 99 ? "99+" : count > 1 ? String(count) : "";
+			const count = pending + active + completed + scheduled + (hasWaitingReview ? s.waitingReviewCount : 0);
+			const countLabel = count > 99 ? "99+" : count >= settings.countThreshold ? String(count) : "";
 			const badgeClass = s.scheduleState === "overdue" || s.scheduleState === "urgent" || s.waitingReviewState === "overdue" ? `${Rows_module_css_default.groupBadge} ${Rows_module_css_default.groupBadgeUrgent}` : Rows_module_css_default.groupBadge;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 				className: badgeClass,
@@ -1380,39 +1813,45 @@ window.__ModuleLoader__.load({
 		*
 		* Extracted so `WorkspaceHoverContent` in `Rows.tsx` only needs to map the
 		* returned array — the fork-specific status→line logic lives here.
+		*
+		* 按设置过滤：关掉的来源不出现在明细行里；`showHoverDetails=false` 时整段返回空。
 		*/
-		function hoverStatusLines(status, t) {
+		function hoverStatusLines(status, t, settings) {
 			const lines = [];
-			if (status === void 0) return lines;
-			if (status.approval > 0) lines.push({
-				state: "warning",
-				text: `${status.approval} ${t("status.waitingApproval")}`
-			});
-			if (status.planReview > 0) lines.push({
-				state: "warning",
-				text: `${status.planReview} ${t("status.planReview")}`
-			});
-			if (status.question > 0) lines.push({
-				state: "warning",
-				text: `${status.question} ${t("status.waitingAnswer")}`
-			});
-			if (status.running > 0) lines.push({
-				state: "ongoing",
-				text: `${status.running} ${t("status.running")}`
-			});
-			if (status.subagents > 0) lines.push({
-				state: "ongoing",
-				text: t(status.subagents === 1 ? "status.subagentsRunning.one" : "status.subagentsRunning.other", { n: status.subagents })
-			});
-			if (status.waitingReviewCount > 0) lines.push({
+			if (status === void 0 || !settings.showHoverDetails) return lines;
+			if (settings.showPendingInBadge) {
+				if (status.approval > 0) lines.push({
+					state: "warning",
+					text: `${status.approval} ${t("status.waitingApproval")}`
+				});
+				if (status.planReview > 0) lines.push({
+					state: "warning",
+					text: `${status.planReview} ${t("status.planReview")}`
+				});
+				if (status.question > 0) lines.push({
+					state: "warning",
+					text: `${status.question} ${t("status.waitingAnswer")}`
+				});
+			}
+			if (settings.showRunningInBadge) {
+				if (status.running > 0) lines.push({
+					state: "ongoing",
+					text: `${status.running} ${t("status.running")}`
+				});
+				if (status.subagents > 0) lines.push({
+					state: "ongoing",
+					text: t(status.subagents === 1 ? "status.subagentsRunning.one" : "status.subagentsRunning.other", { n: status.subagents })
+				});
+			}
+			if (settings.showWaitingReviewInBadge && status.waitingReviewCount > 0) lines.push({
 				state: "warning",
 				text: `${status.waitingReviewCount} ${t("status.waitingReview")}`
 			});
-			if (status.scheduledSessions > 0) lines.push({
+			if (settings.showScheduledInBadge && status.scheduledSessions > 0) lines.push({
 				state: "warning",
 				text: `${status.scheduledSessions} ${t("status.scheduled")}`
 			});
-			if (status.done > 0) lines.push({
+			if (settings.showCompletedInBadge && status.done > 0) lines.push({
 				state: "done",
 				text: `${status.done} ${t("status.completed")}`
 			});
@@ -1543,8 +1982,8 @@ window.__ModuleLoader__.load({
 			})} ${pad2(d.getHours())}:${pad2(d.getMinutes())}` });
 		}
 		/** Hover-card body: workspace title, display directory path, absolute creation time. */
-		function WorkspaceHoverContent({ label, cwd, createdAt, status, t }) {
-			const lines = hoverStatusLines(status, t);
+		function WorkspaceHoverContent({ label, cwd, createdAt, status, settings, t }) {
+			const lines = hoverStatusLines(status, t, settings);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: Rows_module_css_default.hoverContent,
 				children: [
@@ -1586,7 +2025,7 @@ window.__ModuleLoader__.load({
 		* @param props.t - the browser root's locale seat.
 		* @returns the row element.
 		*/
-		function ProjectRowItem({ group, containsCurrentDescendant = false, onToggle, onCreate, actions, drag, home, newShortcut, showCompleted = true, t }) {
+		function ProjectRowItem({ group, containsCurrentDescendant = false, onToggle, onCreate, actions, drag, home, newShortcut, settings, t }) {
 			const row = group;
 			const label = row.workspaceId === void 0 ? t("group.ungrouped") : row.label;
 			const active = containsCurrentDescendant || group.expanded && group.containsCurrent;
@@ -1630,7 +2069,7 @@ window.__ModuleLoader__.load({
 							children: label
 						})
 					}),
-					groupLiveBadge(row, t, showCompleted),
+					groupLiveBadge(group, t, settings),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 						className: Rows_module_css_default.rowActions,
 						children: [actions !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Menu, {
@@ -1687,6 +2126,7 @@ window.__ModuleLoader__.load({
 					cwd: row.cwd === void 0 ? void 0 : abbreviateHomePath(row.cwd, home),
 					createdAt: row.createdAt,
 					status: row.expanded ? void 0 : row.liveStatus,
+					settings,
 					t
 				}),
 				openDelayMs: 800,
@@ -2645,7 +3085,7 @@ window.__ModuleLoader__.load({
 		/** The scrolling session tree; unmounting drops the sessions subscription and local row limits. */
 		function SessionTree({ list, useSessionStatus, startSession, open, workspaces, ungroupedSessionIds, rowState, onLeaveArchivedOnly, workspaceReady, animationResetKey, usePanelInfo, onRenameRequest, onDeleteRequest, onSessionRenameRequest, renderSlot, insertWorkspaceBefore, nestWorkspaces, groupExpansion, setGroupExpanded, setSessionOrder, home, t, revealSessionId, onSessionRevealed, shortcuts, useBadgeSettings }) {
 			const panelActive = usePanelInfo((info) => info.activePanelId !== null);
-			const showCompleted = useBadgeSettings((settings) => settings.showCompletedInBadge);
+			const badgeSettings = useBadgeSettings((settings) => settings);
 			const statuses = useSessionStatus((s) => s);
 			const scheduleSummary = useScheduleSummaryHook?.();
 			const waitingReviewSummary = useWaitingSummaryHook?.();
@@ -2690,20 +3130,16 @@ window.__ModuleLoader__.load({
 				parents,
 				workspaces
 			]);
-			const allGroupsExpanded = expandedGroups.length >= workspaces.length + 1 && workspaces.every((w) => expandedGroups.includes(w.workspaceId)) && expandedGroups.includes("");
 			const groups = (0, react.useMemo)(() => deriveGroups(list, workspaces, rowState, statuses, {
 				expandedGroups,
 				ungroupedOrder: ungroupedSessionIds
-			}, allGroupsExpanded ? void 0 : waitingReviewSummary, allGroupsExpanded ? void 0 : scheduleSummary), [
+			}), [
 				list,
 				workspaces,
 				rowState,
 				statuses,
 				expandedGroups,
-				ungroupedSessionIds,
-				scheduleSummary,
-				waitingReviewSummary,
-				allGroupsExpanded
+				ungroupedSessionIds
 			]);
 			(0, react.useEffect)(() => {
 				for (let key = revealGroup; key !== void 0; key = parents.get(key)) if (groupExpansion[key] === false || key === revealGroup && groupExpansion[key] !== true) setGroupExpanded(key, true);
@@ -2758,7 +3194,7 @@ window.__ModuleLoader__.load({
 					console.warn("workspace reorder rejected:", reason);
 				});
 			};
-			const childrenByParent = (0, react.useMemo)(() => {
+			const childrenByParentForAggregation = (0, react.useMemo)(() => {
 				const rendered = new Set(groups.map((group) => group.key));
 				const children = /* @__PURE__ */ new Map();
 				for (const group of groups) {
@@ -2770,9 +3206,31 @@ window.__ModuleLoader__.load({
 				}
 				return children;
 			}, [groups, parents]);
+			const directStatusByGroup = (0, react.useMemo)(() => directStatusesForGroups(groups, waitingReviewSummary, scheduleSummary), [
+				groups,
+				waitingReviewSummary,
+				scheduleSummary
+			]);
+			const groupsWithAggregatedStatus = (0, react.useMemo)(() => withAggregatedStatus(groups, directStatusByGroup, childrenByParentForAggregation), [
+				groups,
+				directStatusByGroup,
+				childrenByParentForAggregation
+			]);
+			const childrenByParent = (0, react.useMemo)(() => {
+				const rendered = new Set(groupsWithAggregatedStatus.map((group) => group.key));
+				const children = /* @__PURE__ */ new Map();
+				for (const group of groupsWithAggregatedStatus) {
+					let parent = parents.get(group.key);
+					while (parent !== void 0 && !rendered.has(parent)) parent = parents.get(parent);
+					const siblings = children.get(parent);
+					if (siblings === void 0) children.set(parent, [group]);
+					else siblings.push(group);
+				}
+				return children;
+			}, [groupsWithAggregatedStatus, parents]);
 			const rootGroups = childrenByParent.get(void 0) ?? [];
 			const workspaceDropAtListStart = rootGroups[0]?.workspaceId !== void 0 && workspaceDrag?.over?.id === rootGroups[0].workspaceId && workspaceDrag.over.half === "before";
-			const rowKeys = groups.length === 0 ? ["empty"] : [];
+			const rowKeys = groupsWithAggregatedStatus.length === 0 ? ["empty"] : [];
 			const renderGroup = (group, depth) => {
 				const workspaceId = group.workspaceId;
 				const children = childrenByParent.get(group.key) ?? [];
@@ -2848,7 +3306,7 @@ window.__ModuleLoader__.load({
 							group,
 							containsCurrentDescendant: currentAncestors.has(group.key),
 							home,
-							showCompleted,
+							settings: badgeSettings,
 							t,
 							onToggle: () => {
 								if (group.expanded) setSessionLimits((limits) => ({
@@ -2879,7 +3337,7 @@ window.__ModuleLoader__.load({
 							role: "group",
 							children: childRows
 						}),
-						sessions.map((node) => {
+						group.expanded && sessions.map((node) => {
 							const sameGroupDrag = drag !== null && drag.accountKey === group.key;
 							const compatibleTarget = sameGroupDrag && drag.pinned === node.pinned;
 							const normalizeHalf = (half) => node.blank ? "after" : half;
@@ -2933,7 +3391,7 @@ window.__ModuleLoader__.load({
 								t
 							}, node.id);
 						}),
-						collapsed.hiddenCount > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						group.expanded && collapsed.hiddenCount > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 							type: "button",
 							className: WorkspaceBrowser_module_css_default.sessionOverflowButton,
 							"data-row-key": `overflow:${group.key}`,
@@ -2962,8 +3420,8 @@ window.__ModuleLoader__.load({
 						label: t("section.sessions"),
 						rowKeys,
 						ready: list.phase === "ready" && workspaceReady && !nativeDragActive,
-						resetKey: JSON.stringify([animationResetKey, sessionLimits]),
-						children: [groups.length === 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(EmptySessions, {
+						resetKey: animationResetKey,
+						children: [groupsWithAggregatedStatus.length === 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(EmptySessions, {
 							rowState,
 							onLeaveArchivedOnly,
 							t
@@ -4319,7 +4777,29 @@ window.__ModuleLoader__.load({
 			"time.days": "{n}天",
 			"time.months": "{n}个月",
 			"time.years": "{n}年",
-			"time.ago": "{t}前"
+			"time.ago": "{t}前",
+			"settings.badge.section": "折叠徽标",
+			"settings.badge.showRunning": "显示「进行中」转圈",
+			"settings.badge.showRunningHint": "关闭后，进行中的会话（含子智能体）不再画转圈，也不再计入折叠徽标的数字与悬停明细。",
+			"settings.badge.showPending": "显示「待审批」黄点",
+			"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": "关闭后，悬停卡只显示工作区标题、路径和创建时间——不再显示聚合状态明细行。",
+			"settings.count.section": "数字显示",
+			"settings.count.threshold": "数字显示阈值",
+			"settings.count.thresholdHint": "数量 >= 此值时才在徽标上显示数字。默认 2（即 count=1 时省略，因为状态点已表达\"有东西\"）。设为 1 则始终显示。",
+			"settings.save": "保存",
+			"settings.saving": "保存中…",
+			"settings.saveFailed": "本部署没有接受这些值，已保留供你修改。",
+			"settings.readOnly": "本部署的设置为只读。",
+			"settings.unavailable": "该插件当前未加载，暂时无法配置。"
 		};
 		/** English dictionary, checked complete against the zh key set. */
 		const en = {
@@ -4436,12 +4916,41 @@ window.__ModuleLoader__.load({
 			"time.days": "{n}d",
 			"time.months": "{n}mo",
 			"time.years": "{n}y",
-			"time.ago": "{t} ago"
+			"time.ago": "{t} ago",
+			"settings.badge.section": "Collapsed badge",
+			"settings.badge.showRunning": "Show the running dot",
+			"settings.badge.showRunningHint": "When off, running Sessions (and subagents) stop drawing the spinning dot and drop out of the collapsed badge count and its hover details.",
+			"settings.badge.showPending": "Show the pending dot",
+			"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 list-pen 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.",
+			"settings.count.section": "Count display",
+			"settings.count.threshold": "Count display threshold",
+			"settings.count.thresholdHint": "The count is shown on the badge only when the total is >= this value. Default 2 (omits the count when it equals 1 — the dots already convey \"something is happening\"). Set to 1 to always show.",
+			"settings.save": "Save",
+			"settings.saving": "Saving…",
+			"settings.saveFailed": "The deployment did not accept these values; they were left for you to correct.",
+			"settings.readOnly": "This deployment stores settings read-only.",
+			"settings.unavailable": "This plugin is not loaded, so it cannot be configured right now."
 		};
 		//#endregion
 		//#region src/client/index.ts
 		/** Dictionary namespace owned by this plugin. */
 		const NS = "workspace";
+		/** 插件详情页配置表单的槽位名（按包名寻址；契约见 `plugin-manager-slot.d.ts`）。 */
+		const CONFIG_CARD_SLOT = "plugins.bundle.config";
+		/**
+		* 插件管理器分发 `plugins.bundle.config` 用的键 = **包名**（不是条目 id）。
+		* 本包的补丁把行 id 也写成同名，但两者是不同概念，别改成 ENTRY_ID 的引用。
+		*/
+		const CONFIG_CARD_KEY = "dsh-group-status";
 		/**
 		* Required services (cordis fiber inject). The target slots are declared by
 		* the ui-sidebar / ui-conversation applies, whose activation order relative
@@ -4494,12 +5003,21 @@ window.__ModuleLoader__.load({
 			ctx.slots.provideRoot({ hooks: { badgeSettings } });
 			ctx.inject(["configForms"], (configCtx) => {
 				const forms = configCtx.get("configForms");
-				const scope = forms !== void 0 && typeof forms.get === "function" ? forms.get(ENTRY_ID) : void 0;
+				if (forms === void 0 || typeof forms.get !== "function") return;
+				const scope = forms.get(ENTRY_ID);
 				if (scope === void 0) return;
 				badgeSettings.publish(scope.getSnapshot());
 				configCtx.effect(() => scope.subscribe(() => {
 					badgeSettings.publish(scope.getSnapshot());
 				}), "dsh-group-status: badge settings");
+				const whileServed = forms.whileServed?.bind(forms);
+				if (whileServed === void 0) return;
+				configCtx.effect(() => whileServed([ENTRY_ID], () => ctx.slots.inject(CONFIG_CARD_SLOT, () => ctx.slots.register({
+					name: CONFIG_CARD_SLOT,
+					key: CONFIG_CARD_KEY,
+					locale: NS,
+					inject: () => ({ scope })
+				}, BadgeSettingsCard))), "dsh-group-status: plugins-page card");
 			});
 			const searchSessions = async (query, signal) => {
 				const result = await sessions.search(query, signal);