dsh-messager 0.3.0 → 0.3.3

package/lib/client.js

@@ -5,7 +5,7 @@ window.__ModuleLoader__.load({
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 		let react_jsx_runtime = require("react/jsx-runtime");
-		//#region node_modules/.pnpm/@deepseek-ai+cosmokit@1.8.3/node_modules/@deepseek-ai/cosmokit/lib/index.js
+		//#region node_modules/.pnpm/@deepseek-ai+cosmokit@1.8.4/node_modules/@deepseek-ai/cosmokit/lib/index.js
 		/** Return true when a value is `null` or `undefined`. */
 		function isNullable(value) {
 			return value === null || value === void 0;
@@ -29,6 +29,43 @@ window.__ModuleLoader__.load({
 			for (const key of keys) if (forced || source[key] !== void 0) result[key] = source[key];
 			return result;
 		}
+		/** Shared config references used by schema validators and plugin runtimes. */
+		const write = Symbol.for("cosmokit.volatile.write");
+		function snapshot(value, ancestors = /* @__PURE__ */ new Set()) {
+			if (typeof value === "function") throw new TypeError("volatile config cannot contain functions");
+			if (value === null || typeof value !== "object") return value;
+			if (ancestors.has(value)) throw new TypeError("volatile config cannot contain cycles");
+			ancestors.add(value);
+			try {
+				if (Array.isArray(value)) return Object.freeze(value.map((item) => snapshot(item, ancestors)));
+				if (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null) throw new TypeError("volatile config objects must be plain objects or arrays");
+				return Object.freeze(Object.fromEntries(Object.entries(value).map(([key, item]) => [key, snapshot(item, ancestors)])));
+			} finally {
+				ancestors.delete(value);
+			}
+		}
+		/**
+		* Create a detached reference containing an immutable copy of the supplied data.
+		* @param value - validated config data; class instances and functions are unsupported.
+		* @returns a reference whose value is updated only by its owning runtime.
+		*/
+		function createVolatile(value) {
+			let current = snapshot(value);
+			return Object.freeze({
+				get: () => current,
+				[write]: (value) => {
+					current = value;
+				}
+			});
+		}
+		/**
+		* Identify references across ESM/CJS copies of the shared library.
+		* @param value - a parsed config value.
+		* @returns whether the value implements the shared reference protocol.
+		*/
+		function isVolatile(value) {
+			return typeof value === "object" && value !== null && write in value;
+		}
 		/** Test values using `instanceof` with a `toStringTag` fallback. */
 		function is(type, value) {
 			if (arguments.length === 1) return (value) => is(type, value);
@@ -109,26 +146,47 @@ window.__ModuleLoader__.load({
 			}
 			return result;
 		}
-		/** Deeply compare arrays, dates, regexps, buffers, and plain object fields. */
+		/**
+		* Compare values recursively, treating two volatile references as equal regardless of value.
+		* Strict comparison distinguishes null/undefined, treats opaque objects by identity,
+		* compares URLs by normalized href, treats array holes as undefined, and considers distinct cyclic structures unequal.
+		* @param a - first value.
+		* @param b - second value.
+		* @param strict - whether to require strict data equality outside volatile references.
+		* @returns whether the values compare equal.
+		*/
 		function deepEqual(a, b, strict) {
-			if (a === b) return true;
-			if (!strict && isNullable(a) && isNullable(b)) return true;
-			if (typeof a !== typeof b) return false;
-			if (typeof a !== "object") return false;
-			if (!a || !b) return false;
-			function check(test, then) {
-				return test(a) ? test(b) ? then(a, b) : false : test(b) ? false : void 0;
-			}
-			return check(Array.isArray, (a, b) => a.length === b.length && a.every((item, index) => deepEqual(item, b[index]))) ?? check(is("Date"), (a, b) => a.valueOf() === b.valueOf()) ?? check(is("RegExp"), (a, b) => a.source === b.source && a.flags === b.flags) ?? check(isArrayBufferLike, (a, b) => {
-				if (a.byteLength !== b.byteLength) return false;
-				const viewA = new Uint8Array(a);
-				const viewB = new Uint8Array(b);
-				for (let i = 0; i < viewA.length; i++) if (viewA[i] !== viewB[i]) return false;
-				return true;
-			}) ?? Object.keys({
-				...a,
-				...b
-			}).every((key) => deepEqual(a[key], b[key], strict));
+			const ancestors = /* @__PURE__ */ new Set();
+			function compare(a, b) {
+				if (a === b) return true;
+				if (isVolatile(a) || isVolatile(b)) return isVolatile(a) && isVolatile(b);
+				if (!strict && isNullable(a) && isNullable(b)) return true;
+				if (typeof a !== typeof b || typeof a !== "object" || !a || !b) return false;
+				if (ancestors.has(a)) return false;
+				function check(test, then) {
+					return test(a) ? test(b) ? then(a, b) : false : test(b) ? false : void 0;
+				}
+				ancestors.add(a);
+				try {
+					return check(Array.isArray, (a, b) => {
+						if (a.length !== b.length) return false;
+						for (let index = 0; index < a.length; index++) if (!compare(a[index], b[index])) return false;
+						return true;
+					}) ?? check(is("Date"), (a, b) => a.valueOf() === b.valueOf()) ?? check(is("URL"), (a, b) => a.href === b.href) ?? check(is("RegExp"), (a, b) => a.source === b.source && a.flags === b.flags) ?? check(isArrayBufferLike, (a, b) => {
+						if (a.byteLength !== b.byteLength) return false;
+						const viewA = new Uint8Array(a);
+						const viewB = new Uint8Array(b);
+						for (let i = 0; i < viewA.length; i++) if (viewA[i] !== viewB[i]) return false;
+						return true;
+					}) ?? ((!strict || [a, b].every((value) => Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null)) && Object.keys({
+						...a,
+						...b
+					}).every((key) => compare(a[key], b[key])));
+				} finally {
+					ancestors.delete(a);
+				}
+			}
+			return compare(a, b);
 		}
 		/** Time constants plus parsing and formatting helpers. */
 		var Time;
@@ -201,7 +259,7 @@ window.__ModuleLoader__.load({
 			Time.template = template;
 		})(Time || (Time = {}));
 		//#endregion
-		//#region node_modules/.pnpm/@deepseek-ai+schemastery@3.18.2/node_modules/@deepseek-ai/schemastery/lib/index.mjs
+		//#region node_modules/.pnpm/@deepseek-ai+schemastery@3.18.3/node_modules/@deepseek-ai/schemastery/lib/index.mjs
 		const kSchema = Symbol.for("schemastery");
 		const kValidationError = Symbol.for("ValidationError");
 		globalThis.__schemastery_index__ ??= 0;
@@ -377,6 +435,7 @@ window.__ModuleLoader__.load({
 			return schema;
 		};
 		Schema.prototype.simplify = function simplify(value) {
+			if (isVolatile(value)) value = value.get();
 			if (deepEqual(value, this.meta.default, this.type === "dict")) return null;
 			if (isNullable(value)) return value;
 			if (this.type === "object" || this.type === "dict") {
@@ -433,12 +492,49 @@ window.__ModuleLoader__.load({
 			};
 			return schema;
 		} });
+		Schema.prototype.volatile = function volatile() {
+			if (this.meta.volatile) throw new TypeError("volatile schema is already wrapped");
+			return this.extra("volatile", true);
+		};
 		const resolvers = {};
+		const checkedVolatile = Symbol("checked-volatile-schema");
+		function validateVolatileSchema(schema, path = [], blocked = false, seen = /* @__PURE__ */ new Map()) {
+			const states = seen.get(schema) ?? /* @__PURE__ */ new Set();
+			if (states.has(blocked)) return;
+			states.add(blocked);
+			seen.set(schema, states);
+			if (schema.meta?.volatile && blocked) throw new ValidationError("volatile fields require a fixed object path without an enclosing volatile field", { path });
+			const nested = blocked || !!schema.meta?.volatile;
+			if (schema.dict) for (const [key, child] of Object.entries(schema.dict)) validateVolatileSchema(child, [...path, key], nested, seen);
+			if (schema.sKey) validateVolatileSchema(schema.sKey, [...path, "<key>"], true, seen);
+			if (schema.inner && (schema.type !== "lazy" || schema.inner[kSchema])) validateVolatileSchema(schema.inner, [...path, "*"], true, seen);
+			if (schema.list) for (let index = 0; index < schema.list.length; index++) validateVolatileSchema(schema.list[index], [...path, String(index)], true, seen);
+		}
 		Schema.extend = function extend(type, resolve) {
 			resolvers[type] = resolve;
 		};
 		Schema.resolve = function resolve(data, schema, options = {}, strict = false) {
 			if (!schema) return [data];
+			if (!options[checkedVolatile]) {
+				validateVolatileSchema(schema, options.path);
+				options = {
+					...options,
+					[checkedVolatile]: true
+				};
+			}
+			if (schema.meta?.volatile) {
+				const inner = Schema(schema);
+				inner.meta = {
+					...schema.meta,
+					volatile: false
+				};
+				const [value, adapted] = Schema.resolve(data, inner, options, strict);
+				try {
+					return [createVolatile(value), adapted];
+				} catch (error) {
+					throw new ValidationError(error instanceof Error ? error.message : String(error), options);
+				}
+			}
 			if (options.ignore?.(data, schema)) return [data];
 			if (isNullable(data) && schema.type !== "lazy") {
 				if (schema.meta.required) throw new ValidationError(`missing required value`, options);
@@ -541,6 +637,7 @@ window.__ModuleLoader__.load({
 					...schema.meta,
 					...schema.inner.meta
 				};
+				validateVolatileSchema(schema.inner, options.path, true);
 			}
 			return Schema.resolve(data, schema.inner, options, strict);
 		});
@@ -640,7 +737,7 @@ window.__ModuleLoader__.load({
 			} catch (e) {
 				if (!options?.autofix) throw e;
 				delete data[key];
-				return schema.meta.default;
+				return schema.meta.volatile ? createVolatile(schema.meta.default) : schema.meta.default;
 			}
 		}
 		Schema.extend("array", (data, { inner, meta }, options) => {
@@ -799,12 +896,18 @@ window.__ModuleLoader__.load({
 		/**
 		* dsh-messager 配置模型。
 		*
-		* 本 schema 同时承担两个角色：
-		* - host 端的 Loader config（cordis.yml 中该插件行的 `config:`，成为 settings 命名空间的 base 层）；
-		* - `ctx.settings.register('messager', Config, { base })` 的命名空间 schema，
-		*   因此 Web 设置页会自动渲染配置表单，用户层可覆盖 base。
+		* DSH 0.1.7 起，本 schema 由 **Loader 自动接管**：插件模块导出的 `Config` 即
+		* settings 表单的 schema，命名空间 = profile 中该插件条目的 id（本仓库的
+		* `cordis.patch.yml` / `cordis.yml` 都声明为 `messager`）。
+		* 因此**不再有** `ctx.settings.register(...)` 这一步。
 		*
-		* 有效值优先级：schema 默认值 → base（cordis.yml）→ 用户层（设置页）。
+		* ⚠️ 所有可编辑字段必须标记 `.volatile()`：DSH 用 `isVolatilePath` 门控写入，
+		* 非 volatile 路径一律被 `settings.mutate` 拒绝（"Config field ... is not volatile"），
+		* 且没有任何 volatile 字段时整个命名空间会被 `volatileForm` 判为不可配置
+		* （"Plugin entry ... has no volatile fields"），设置页直接报废。
+		* 这是 0.1.7 的硬契约，不是可选项。
+		*
+		* 有效值优先级：schema 默认值 → base（Loader config）→ 用户层（设置页）。
 		*/
 		const verbosity = Schema.union([
 			"minimal",
@@ -813,72 +916,87 @@ window.__ModuleLoader__.load({
 		]);
 		const Config = Schema.object({
 			triggers: Schema.object({
-				interaction: Schema.boolean().default(true),
-				completed: Schema.boolean().default(true),
-				error: Schema.boolean().default(true)
+				interaction: Schema.boolean().default(true).volatile(),
+				completed: Schema.boolean().default(true).volatile(),
+				error: Schema.boolean().default(true).volatile()
 			}),
 			system: Schema.object({
-				enabled: Schema.boolean().default(true),
-				icon: Schema.string(),
-				verbosity: verbosity.default("normal")
+				enabled: Schema.boolean().default(true).volatile(),
+				icon: Schema.string().volatile(),
+				verbosity: verbosity.default("normal").volatile()
 			}),
 			browser: Schema.object({
-				enabled: Schema.boolean().default(true),
-				icon: Schema.string(),
-				onlyWhenHidden: Schema.boolean().default(true),
-				verbosity: verbosity.default("normal")
+				enabled: Schema.boolean().default(true).volatile(),
+				icon: Schema.string().volatile(),
+				onlyWhenHidden: Schema.boolean().default(true).volatile(),
+				verbosity: verbosity.default("normal").volatile()
 			}),
 			feishu: Schema.object({
-				enabled: Schema.boolean().default(false),
-				webhookUrl: Schema.string(),
-				secret: Schema.string().role("secret"),
-				timeoutMs: Schema.number().default(5e3),
-				verbosity: verbosity.default("normal")
+				enabled: Schema.boolean().default(false).volatile(),
+				webhookUrl: Schema.string().volatile(),
+				secret: Schema.string().role("secret").volatile(),
+				timeoutMs: Schema.number().default(5e3).volatile(),
+				verbosity: verbosity.default("normal").volatile()
 			}),
 			wecom: Schema.object({
-				enabled: Schema.boolean().default(false),
-				webhookUrl: Schema.string(),
-				secret: Schema.string().role("secret"),
-				timeoutMs: Schema.number().default(5e3),
-				verbosity: verbosity.default("normal")
+				enabled: Schema.boolean().default(false).volatile(),
+				webhookUrl: Schema.string().volatile(),
+				secret: Schema.string().role("secret").volatile(),
+				timeoutMs: Schema.number().default(5e3).volatile(),
+				verbosity: verbosity.default("normal").volatile()
 			}),
 			discord: Schema.object({
-				enabled: Schema.boolean().default(false),
-				webhookUrl: Schema.string(),
-				timeoutMs: Schema.number().default(5e3),
-				verbosity: verbosity.default("normal")
+				enabled: Schema.boolean().default(false).volatile(),
+				webhookUrl: Schema.string().volatile(),
+				timeoutMs: Schema.number().default(5e3).volatile(),
+				verbosity: verbosity.default("normal").volatile()
 			}),
 			dingtalk: Schema.object({
-				enabled: Schema.boolean().default(false),
-				webhookUrl: Schema.string(),
-				secret: Schema.string().role("secret"),
-				timeoutMs: Schema.number().default(5e3),
-				verbosity: verbosity.default("normal")
+				enabled: Schema.boolean().default(false).volatile(),
+				webhookUrl: Schema.string().volatile(),
+				secret: Schema.string().role("secret").volatile(),
+				timeoutMs: Schema.number().default(5e3).volatile(),
+				verbosity: verbosity.default("normal").volatile()
 			}),
 			telegram: Schema.object({
-				enabled: Schema.boolean().default(false),
-				botToken: Schema.string().role("secret"),
-				chatId: Schema.string(),
-				timeoutMs: Schema.number().default(5e3),
-				verbosity: verbosity.default("normal")
+				enabled: Schema.boolean().default(false).volatile(),
+				botToken: Schema.string().role("secret").volatile(),
+				chatId: Schema.string().volatile(),
+				timeoutMs: Schema.number().default(5e3).volatile(),
+				verbosity: verbosity.default("normal").volatile()
 			}),
 			dedup: Schema.object({
-				interactionCooldownMs: Schema.number().default(1e4),
-				completedDebounceMs: Schema.number().default(1e3),
-				perChannelPerMinute: Schema.number().default(20)
+				interactionCooldownMs: Schema.number().default(1e4).volatile(),
+				completedDebounceMs: Schema.number().default(1e3).volatile(),
+				perChannelPerMinute: Schema.number().default(20).volatile()
 			}),
 			message: Schema.object({
-				titlePrefix: Schema.string(),
-				includeSessionTitle: Schema.boolean().default(true),
-				guiUrl: Schema.string().default("http://127.0.0.1:3080")
+				titlePrefix: Schema.string().volatile(),
+				includeSessionTitle: Schema.boolean().default(true).volatile(),
+				guiUrl: Schema.string().default("http://127.0.0.1:3080").volatile()
 			})
 		});
 		/**
+		* 递归解开 volatile 引用，得到纯值。
+		*
+		* volatile 引用在配置热更新时**原地变更**（这正是无需重挂载的原因），
+		* 所以引用本身要保留；本插件的内部逻辑（通道构建/调度/模板）只需要某一时刻的
+		* 纯值，因此在边界处统一取值。
+		*/
+		function unwrapVolatile(value) {
+			if (isVolatile(value)) return unwrapVolatile(value.get());
+			if (Array.isArray(value)) return value.map(unwrapVolatile);
+			if (value !== null && typeof value === "object") return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, unwrapVolatile(child)]));
+			return value;
+		}
+		/**
 		* 用 schema 默认值解析一份配置（输入可省略任意字段）。
-		* 与 cordis Loader 的校验同源，保证“默认值 → base → 用户层”的解析一致。
+		*
+		* 输入既可以是纯值（Loader config / settings 视图），也可以是 Loader 传入的
+		* volatile 形态 —— 两者都先解包再校验，保证「默认值 → base → 用户层」解析一致。
 		*/
 		function resolveConfig(input = {}) {
-			return Config(input);
+			return unwrapVolatile(Config(unwrapVolatile(input)));
 		}
 		//#endregion
 		//#region src/config-shared.ts
@@ -893,10 +1011,19 @@ window.__ModuleLoader__.load({
 		/**
 		* 客户端配置读取：经 host 配置路由（GET /dsh-messager/config）拉取 messager
 		* 命名空间有效值，并通过 `settings/document-updated` 失效后重拉。
-		* 路由不受 Web 设置白名单门控，发行版同样可用；拉取失败回退 schema 默认值。
+		* 路由不受 Web 设置白名单门控，发行版同样可用。
+		*
+		* ⚠️ 拉取失败时的兜底值必须**关闭**通知（见 FAIL_SAFE），不能用 schema 默认值：
+		* `browser.enabled` 的 schema 默认值是 `true`，用它兜底意味着任何一次拉取失败
+		* 都会在用户已关闭通知的情况下静默开启推送 —— 表现为「我明明关了还弹」。
 		*/
+		/**
+		* 拉取成功前的失效安全值：**显式关闭浏览器通知**。
+		* 通知类插件的正确取向是「宁可漏报，不可误报」：未确认用户意愿前一律不推。
+		*/
+		const FAIL_SAFE = resolveConfig({ browser: { enabled: false } });
 		var ClientConfig = class {
-			current = resolveConfig({});
+			current = FAIL_SAFE;
 			listeners = /* @__PURE__ */ new Set();
 			get() {
 				return this.current;
@@ -907,7 +1034,12 @@ window.__ModuleLoader__.load({
 					this.listeners.delete(listener);
 				};
 			}
-			/** 拉取 host 配置视图（首次与收到 document-updated 后调用）。 */
+			/**
+			* 拉取 host 配置视图。
+			*
+			* 失败（路由未挂载 / 网络问题 / 视图非 ready）时**保持上一次的已知值**；
+			* 若从未成功过，则保持 FAIL_SAFE（通知关闭）。
+			*/
 			async refresh() {
 				try {
 					const response = await fetch(CONFIG_PATH, { headers: { accept: "application/json" } });
@@ -922,20 +1054,16 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/diff.ts
 		/**
-		* 对比两次列表快照。
-		* 首次出现的会话只建立基线、不通知；被移除的会话不通知。
-		* @param previous - 上一次快照的 byId。
-		* @param next - 本次快照的 byId。
-		* @param current - 本次快照的当前选中会话（选中会话的完成不打扰）。
+		* 对比两次列表快照。首次出现的会话只建立基线、不通知；被移除的会话不通知。
 		*/
-		function diffSessionSummaries(previous, next, current) {
+		function diffSessionSummaries(previous, next) {
 			const notices = [];
 			for (const id of Object.keys(next)) {
 				const summary = next[id];
 				if (summary === void 0) continue;
 				const before = previous[id];
 				if (before === void 0) continue;
-				if (before.running && !summary.running && id !== current) notices.push({
+				if (before.running && !summary.running && (summary.retainedBy.mainView ?? 0) === 0) notices.push({
 					kind: "completed",
 					sessionId: id,
 					title: summary.displayTitle
@@ -953,13 +1081,20 @@ window.__ModuleLoader__.load({
 			}
 		}
 		/**
-		* 对比两次 uiSession 待交互快照。
-		* 仅从无到有时通知；首次订阅由调用方把当前快照设为 previous，因此不会补发历史通知。
+		* 触发开关门控：与 host 端 `triggers` 语义对齐。
+		*
+		* 此前浏览器通道完全没有这层判断，导致「关闭某类触发」对浏览器通知无效 ——
+		* 用户关掉后仍会收到（Windows 把浏览器通知渲染成系统 toast，难以分辨来源）。
 		*/
+		function triggerAllows(notice, triggers) {
+			return notice.kind === "interaction" ? triggers.interaction : triggers.completed;
+		}
+		/** 对比两次 uiSession 统一状态快照。 */
 		function diffPendingInteractions(previous, next, summaries) {
 			const notices = [];
-			for (const [sessionId, pending] of next) {
-				if (previous.has(sessionId)) continue;
+			for (const [sessionId, status] of next) {
+				const pending = status.pendingInteraction;
+				if (previous.get(sessionId)?.pendingInteraction !== void 0 || pending === void 0) continue;
 				const interaction = clientInteractionKindOf(pending.kind);
 				if (interaction === void 0) continue;
 				const title = summaries[sessionId]?.displayTitle;
@@ -1092,8 +1227,9 @@ window.__ModuleLoader__.load({
 					status: snapshot.status,
 					mode: snapshot.mode ?? "",
 					writable: snapshot.writable,
-					dirty: plan.length > 0,
-					invalid: plan.some((item) => item.run === void 0),
+					dirty: plan.ops.length > 0 || plan.invalid,
+					dirtyCount: plan.ops.length,
+					invalid: plan.invalid,
 					saving: this.saving,
 					failed: this.failed,
 					fields
@@ -1154,7 +1290,11 @@ window.__ModuleLoader__.load({
 						continue;
 					}
 					const desired = parseDraft(spec, staged.text);
-					if (desired === void 0) return [{ run: void 0 }];
+					if (desired === void 0) return {
+						ops: [],
+						run: void 0,
+						invalid: true
+					};
 					if (spec.secret !== true && deepEqualJson(desired, this.effectiveValue(spec))) continue;
 					ops.push({
 						op: "set",
@@ -1162,11 +1302,19 @@ window.__ModuleLoader__.load({
 						value: desired
 					});
 				}
-				if (ops.length === 0) return [];
+				if (ops.length === 0) return {
+					ops: [],
+					run: void 0,
+					invalid: false
+				};
 				const scope = this.scope;
-				return [{ run: async () => {
-					return await scope.writeOps(ops);
-				} }];
+				return {
+					ops,
+					invalid: false,
+					run: async () => {
+						return await scope.writeOps(ops);
+					}
+				};
 			}
 			/**
 			* 门控判断：hiddenUnless 指定的开关字段当前（含草稿覆盖）不为 true 时，
@@ -1185,15 +1333,11 @@ window.__ModuleLoader__.load({
 			}
 			async save() {
 				const plan = this.plan();
-				if (plan.length === 0 || this.saving || plan.some((item) => item.run === void 0)) return;
+				if (plan.ops.length === 0 || this.saving || plan.run === void 0) return;
 				this.saving = true;
 				this.failed = false;
 				this.invalidate();
-				let landed = true;
-				for (const item of plan) {
-					if (item.run === void 0) continue;
-					landed = await item.run() && landed;
-				}
+				const landed = await plan.run();
 				if (landed) this.staged.clear();
 				this.saving = false;
 				this.failed = !landed;
@@ -1752,9 +1896,32 @@ window.__ModuleLoader__.load({
 			alignItems: "center",
 			justifyContent: "flex-end",
 			gap: 8,
-			padding: "12px 0 4px",
+			padding: "12px 0",
 			borderTop: "1px solid var(--dsw-alias-border-l2)",
-			marginTop: 12
+			marginTop: 12,
+			position: "sticky",
+			bottom: 0,
+			zIndex: 1,
+			background: "var(--dsw-alias-bg-layer-2)"
+		};
+		/** 顶部「有未保存的修改」提示条（滚到顶部时可见，与底部粘性操作栏互补）。 */
+		const UNSAVED_BAR_STYLE = {
+			display: "flex",
+			alignItems: "center",
+			justifyContent: "space-between",
+			gap: 12,
+			margin: "12px 0 0",
+			padding: "8px 12px",
+			border: "1px solid var(--dsw-alias-border-l2)",
+			borderRadius: 8,
+			background: "var(--dsw-alias-bg-module-platform)"
+		};
+		const UNSAVED_TEXT_STYLE = {
+			margin: 0,
+			fontSize: 13,
+			lineHeight: 1.5,
+			fontWeight: 500,
+			color: "var(--dsw-alias-label-primary)"
 		};
 		const FAILED_STYLE = {
 			flex: 1,
@@ -1952,6 +2119,26 @@ window.__ModuleLoader__.load({
 					role: "status",
 					children: t("status.readOnly")
 				}),
+				state.dirty && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					style: UNSAVED_BAR_STYLE,
+					role: "status",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+						style: UNSAVED_TEXT_STYLE,
+						children: [state.invalid ? t("status.invalidInput") : t("status.unsaved"), !state.invalid && state.dirtyCount > 0 ? ` (${state.dirtyCount})` : ""]
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						style: {
+							...SAVE_STYLE,
+							...state.invalid || state.saving ? {
+								opacity: .4,
+								cursor: "default"
+							} : {}
+						},
+						disabled: state.invalid || state.saving,
+						onClick: actions.save,
+						children: state.saving ? t("action.saving") : t("action.save")
+					})]
+				}),
 				groups.map((group) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 					style: GROUP_HEADING_STYLE,
 					children: t(GROUP_TITLE_KEYS[group] ?? group)
@@ -1981,6 +2168,14 @@ window.__ModuleLoader__.load({
 							role: "status",
 							children: t("status.invalidInput")
 						}),
+						state.dirty && !state.failed && !state.invalid && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+							style: {
+								...UNSAVED_TEXT_STYLE,
+								flex: 1
+							},
+							role: "status",
+							children: [t("status.unsaved"), state.dirtyCount > 0 ? ` (${state.dirtyCount})` : ""]
+						}),
 						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 							type: "button",
 							style: {
@@ -2128,6 +2323,7 @@ window.__ModuleLoader__.load({
 			"action.discard": "放弃修改",
 			"action.reset": "重置",
 			"badge.overridden": "已覆盖",
+			"status.unsaved": "有未保存的修改",
 			"status.readOnly": "设置文档当前为只读。",
 			"status.saveFailed": "保存失败，请重试。",
 			"status.invalidInput": "存在无效输入，请修正后再保存。",
@@ -2191,6 +2387,7 @@ window.__ModuleLoader__.load({
 			"action.discard": "Discard",
 			"action.reset": "Reset",
 			"badge.overridden": "Overridden",
+			"status.unsaved": "Unsaved changes",
 			"status.readOnly": "The settings document is read-only.",
 			"status.saveFailed": "Save failed, please retry.",
 			"status.invalidInput": "There are invalid inputs, fix them before saving.",
@@ -2225,9 +2422,9 @@ window.__ModuleLoader__.load({
 			}
 			/** 列表快照变化 → 通知。 */
 			onListChange(previous, next) {
-				this.onNotices(diffSessionSummaries(previous.byId, next.byId, next.current));
+				this.onNotices(diffSessionSummaries(previous.byId, next.byId));
 			}
-			/** 待交互快照变化 → 通知。 */
+			/** 待交互状态变化 → 通知。 */
 			onPendingChange(previous, next, sessions) {
 				this.onNotices(diffPendingInteractions(previous, next, sessions.byId));
 			}
@@ -2238,6 +2435,7 @@ window.__ModuleLoader__.load({
 				if (Notification.permission !== "granted") return;
 				if (config.browser.onlyWhenHidden && document.visibilityState !== "hidden") return;
 				for (const notice of notices) {
+					if (!triggerAllows(notice, config.triggers)) continue;
 					if (!this.allow(notice, config)) continue;
 					this.show(notice, config);
 				}
@@ -2320,6 +2518,13 @@ window.__ModuleLoader__.load({
 				fetchScope.refresh();
 			});
 			ctx.effect(() => () => offRemote?.(), "dsh-messager: settings invalidation");
+			const onVisibilityChange = () => {
+				if (document.visibilityState !== "visible") return;
+				config.refresh();
+				fetchScope.refresh();
+			};
+			document.addEventListener("visibilitychange", onVisibilityChange);
+			ctx.effect(() => () => document.removeEventListener("visibilitychange", onVisibilityChange), "dsh-messager: visibility refresh");
 			const notifier = new BrowserNotifier(config);
 			ctx.effect(() => () => notifier.dispose(), "dsh-messager: browser notifier");
 			let previous = ctx.sessions.list.getSnapshot();
@@ -2329,13 +2534,13 @@ window.__ModuleLoader__.load({
 				previous = next;
 			});
 			ctx.effect(() => () => offList(), "dsh-messager: sessions subscription");
-			let previousPending = ctx.uiSession.pendingInteractions.getSnapshot();
-			const offPending = ctx.uiSession.pendingInteractions.subscribe(() => {
-				const next = ctx.uiSession.pendingInteractions.getSnapshot();
-				notifier.onPendingChange(previousPending, next, ctx.sessions.list.getSnapshot());
-				previousPending = next;
+			let previousStatus = ctx.uiSession.sessionStatus.getSnapshot();
+			const offStatus = ctx.uiSession.sessionStatus.subscribe(() => {
+				const next = ctx.uiSession.sessionStatus.getSnapshot();
+				notifier.onPendingChange(previousStatus, next, ctx.sessions.list.getSnapshot());
+				previousStatus = next;
 			});
-			ctx.effect(() => () => offPending(), "dsh-messager: pending interactions subscription");
+			ctx.effect(() => () => offStatus(), "dsh-messager: session status subscription");
 			const controller = new MessagerCardController(fetchScope.scope, CARD_FIELDS);
 			ctx.effect(() => ctx.locale.register(LOCALE_NS, {
 				zh,