dsh-notify-ding 0.1.0 → 0.1.2

package/README.md

@@ -1,8 +1,8 @@
 # dsh·通知叮咚插件
 
-在 DSH 需要你人工回答或一轮对话跑完时，弹出系统通知，并让宿主播放 Windows 自带的提示音。
+在 DSH 需要你人工回答或一轮对话跑完时，弹出系统通知。
 
-纯浏览器端触发、宿主端发声的双半身插件，不替换任何原生界面。
+纯浏览器端的插件，不替换任何原生界面。
 
 ## 引言
 
@@ -13,8 +13,10 @@
 
 - 某个会话出现新的待人工回答交互时叮咚一次，question、plan-review、approval 都算。
 - 某个会话从执行中落到空闲、也就是一轮对话跑完时叮咚一次。
-- 两种触发都会弹浏览器系统通知，同时请宿主播放 Windows 内置提示音。
+- 两种触发都会弹一条浏览器系统通知，提示音由 Windows 通知系统自带。
 - 不判断页面是否聚焦，也不区分是否为当前会话，任何会话有事都会响。
+- 通知不设自动关闭时间，会一直留在系统通知里，直到对应会话发生操作：会话被选中、该会话开始新一轮、待回答被解决，或会话从列表移除。
+- 每个会话最多保留一条通知，新通知会顶掉同会话的旧通知；点击通知会聚焦窗口并切到该会话。
 - 同一待回答请求只响一次，两次响铃之间至少有 800 毫秒间隔，且该间隔跨标签页共享，多开标签页不会重复响。
 
 ## 使用
@@ -23,11 +25,17 @@
 
 浏览器系统通知需要页面授权。插件在加载时会尝试请求一次，若被浏览器拒绝，会在你下一次点击或按键时再请求一次。所以在第一次看到页面后点一下任意位置，授权弹窗就会出来。
 
-若浏览器通知一直弹不出来，声音仍然会正常响——两条路是独立的。
+### 提示音从哪来
 
-### 声音从哪来
+插件不自行发声，提示音由 Windows 的通知系统在弹通知时自带。提示音的音量与静音都跟着系统通知设置走，和插件本身无关。
 
-浏览器沙箱读不到 `C:\Windows\Media` 下的文件，所以声音必须由宿主进程来播。宿主半身在 web 载体上注册一条精确路由 `POST /dsh-notify-ding/ding`，收到请求就用 PowerShell 的 `System.Media.SoundPlayer` 播放 `Windows Notify System Generic.wav`，响一声。
+### 全屏时通知会被系统静默
+
+Windows 11 的「专注」有一条自动规则「当我在全屏使用应用时」，全屏看视频或玩游戏时会自动进入专注状态，通知横幅不显示、通知音被静音，通知只落进通知中心，看起来就像插件根本没响。这是系统行为，插件感知不到也绕不开。
+
+想在全屏时也看到横幅，去 设置 → 系统 → 通知 → 专注，关闭「自动开启专注会话」里的「当我在全屏使用应用时」。代价是全屏时其他应用的通知也会冒出来。
+
+此时插件没有任何声音提示，因为它不自己发声，提示音就是被一并静音的通知音。
 
 ## 安装
 
@@ -57,13 +65,13 @@ dsh plugin --profile web remove dsh-notify-ding
 
 浏览器半身订阅 `ctx.sessions.list` 与 `ctx.uiSession.pendingInteractions` 两个只读快照，用边沿检测判断该不该响：运行态从真落到假算一轮跑完，出现新 key 的待回答交互算需要人工介入。首帧只建基线不发声，同一待回答请求只响一次，两次响铃之间留至少 800 毫秒并把该时刻写入 localStorage 跨标签页共享。
 
-判定通过时它做两件事：弹浏览器系统通知，以及向宿主发一个 POST。宿主半身只负责后者，它注册的 `/dsh-notify-ding/ding` 路由收到请求就用 PowerShell 播放提示音。完整设计见 [设计说明](docs/design.md)。
+判定通过时它弹出一条浏览器系统通知。通知按会话记录且不设自动关闭，同一会话只留最新一条；会话被选中、开始新一轮、待回答被解决或从列表移除时会关掉对应通知，点击通知则聚焦窗口、切换过去并关掉该条。完整设计见 [设计说明](docs/design.md)。
 
 ## 要求与开发
 
 - 是标准形态的 dsh client 插件，声明 `dsh.client`，导出 `./client`。
 - 同时声明了 `dsh.bundle`，因此也是一个自挂载的 bundle 层插件：用 `dsh plugin --profile <name> add` 从 GitHub 安装后会被自动识别为 profile layer 并挂载，无需手工写组合 entry。
-- 宿主半身依赖 `webServer` 服务，浏览器半身依赖 `uiSession` 与 `sessions`。
+- 浏览器半身依赖 `uiSession` 与 `sessions`；宿主入口没有运行时行为，只为让包能被 Loader 加载。
 - 构建型插件：`src/` 是 TypeScript 源码，`lib/` 是构建产物且不入库，安装或发布前由 `prepare` 构建。
 
 ## 开发
@@ -74,7 +82,7 @@ pnpm run typecheck   # tsc --noEmit 严格类型检查
 pnpm run build       # tsdown，产出 lib/index.js 与 lib/client.js
 ```
 
-- `src/index.ts`：宿主半身，注册播音路由。
+- `src/index.ts`：宿主入口，无运行时行为，只用于让包被 Loader 加载。
 - `src/client/index.ts`：浏览器半身，边沿检测与通知。
 - 构建用 tsdown，client 产物是 `window.__ModuleLoader__.load({ id, factory })` 的注册式模块，`@deepseek-ai/cordis` 保持外部依赖。
 

package/cordis.patch.yml

@@ -1,9 +1,7 @@
-# dsh-notify-ding bundle patch: mount the notification plugin.
-#
-# Applied when this bundle appears in a profile's dsh.profile.bundles list.
-# The node half (package root) owns the host-side sound route and the optional
-# window sound; the browser half (dsh.client) is discovered automatically
-# through the package's dsh.client declaration + exports["./client"].
+# dsh-notify-ding bundle patch：把通知插件插进 profile 的 layer stack。
+# 当本 bundle 出现在 profile 的 dsh.profile.bundles 列表里时应用。
+# 宿主半身没有运行时行为，只让包能被 Loader 加载。
+# 浏览器半身由包的 dsh.client 声明与 exports["./client"] 自动发现。
 
 - insert:
     - id: dsh-notify-ding

package/docs/design.md

@@ -1,13 +1,10 @@
 # 设计说明
 
-## 为什么是双半身
+## 为什么只剩浏览器半身
 
-浏览器沙箱读不到 `C:\Windows\Media` 下的音频文件，所以「Windows 本家音色」这件事只能由宿主进程完成。插件因此拆成两半：
+插件原先让宿主进程用 PowerShell 播放 `C:\Windows\Media` 下的 wav。实测下来，实际听到的提示音是系统通知自带的音效，宿主那一侧没有可感知的效果，因此整条宿主播音链路已删除，插件只保留浏览器半身。
 
-- **宿主半身** 只负责发声：在 web 载体上注册一条精确路由，收到请求就用 PowerShell 的 `System.Media.SoundPlayer` 播放 wav。
-- **浏览器半身** 只负责判断：盯住会话状态，判断什么时刻该响，然后同时弹系统通知并请求宿主播音。
-
-宿主半身不参与任何触发判断，浏览器半身不碰任何文件路径，职责边界清楚。
+宿主入口文件仍然存在，但没有任何运行时行为。客户端模块系统按 Loader entry 扫描 `dsh.client` 声明，entry 指向的宿主模块必须存在，浏览器半身才会被加载，因此 `src/index.ts` 只导出插件名和一个空的 `apply`。
 
 ## 触发信号
 
@@ -28,17 +25,30 @@
 2. **同一待回答请求只响一次**：按交互的稳定 key 记忆，消失后清理记录但不发声。
 3. **滚动最小间隔 800 毫秒**：两次响铃之间至少间隔这么久。窗口内到达的请求不丢弃，而是挂到窗口边界的定时器上补发，保证不漏报。该时刻写入 localStorage 跨标签页共享，多开标签页时同一件事只响一轮。
 
-## 声音与通知的关系
+## 通知的存活与关闭
+
+浏览器系统通知不再设自动关闭时间，并且带上 `requireInteraction`，会一直留在系统通知里，直到对应会话发生操作。插件按会话 id 记录当前挂着的通知，每个会话最多一条，新的先关掉旧的。
+
+以下任一情况出现，就算对应会话得到了一次操作，插件会关掉它的通知：
+
+1. **会话被选中**：`sessions.list.current` 变成了该会话。
+2. **开始新一轮**：该会话的运行态从假升到真，说明用户回到了这里。
+3. **待回答被解决**：该会话的待回答交互 key 消失；被新 key 顶掉也算，替换场景下先关旧通知再响新的一条，不会误关。
+4. **会话被移除**：该会话从列表消失。
+
+选中信号有两处细节。`current` 短暂变成 `undefined` 是 DSH 的 masked gap，选中会话暂时不在列表时就会出现，不算一次操作，也不覆盖上一个有效选中。选中变化先于响铃处理，因此同一帧里既跑完又刚被选中的会话，通知不会被建立后立刻关掉。
+
+点击通知会先聚焦窗口，再经 `ctx.sessions.open(sessionId)` 切到该会话，然后关掉这条通知；会话已不在列表时只聚焦、不切换。插件卸载时会把还挂着的通知全部关掉。
 
-两者互相独立：浏览器通知弹不出来时声音照响，宿主播音失败时通知照弹。任一侧失败只记一条 `console.warn`，不抛错、不互相阻塞。
+只识别这四种状态信号，因此通知只有在 DSH 里真的对那个会话动了手才会消失；单纯回到浏览器窗口不会关掉它。
 
-## 认证
+## 全屏静默
 
-dsh web 由 connection 插件提供认证边界：根路径带 token 打开后铸出浏览器 cookie，后续同源请求自动带上。插件走同源 fetch 且带 `credentials: 'same-origin'`，因此沿用同一套 cookie，不需要自己处理 token。
+Windows 11 的「专注」有一条自动规则「当我在全屏使用应用时」，全屏看视频或玩游戏时会自动进入专注状态，通知横幅不显示、通知音被静音，通知只落进通知中心。插件不自己发声，提示音就是系统通知自带的音效，所以这种场合没有任何声音提示。
 
 ## 已知边界
 
-- 宿主半身依赖 `webServer` 服务，浏览器半身依赖 `uiSession` 与 `sessions`，缺任一则不激活。
-- 播音走 PowerShell 进程，单次开销约是一百毫秒级，慢但不阻塞响应。
+- 浏览器半身依赖 `uiSession` 与 `sessions`，缺任一则不激活。
 - 「一轮跑完」只覆盖正常结束与被打断这两种空闲落点，插件不区分具体结束原因。
-- Windows 聚焦助手开启时系统通知可能被静音，但宿主播音不受影响。
+- 系统通知被静默时横幅和声音一起消失，插件察觉不到，也没有补偿手段。
+- 页面被关掉后，浏览器通知可能仍留在系统通知中心，此时插件已不在运行，无法再收回，只能手动清掉。

package/lib/client.js

@@ -8,18 +8,42 @@ window.__ModuleLoader__.load({
 			[Symbol.toStringTag]: { value: "Module" }
 		});
 		//#region src/client/index.ts
+		/**
+		* dsh-notify-ding 的浏览器半身。
+		*
+		* 只做两件事：判断「该响了」，然后弹一条浏览器系统通知。
+		* 提示音由系统通知自带，插件不另外发声，全屏专注时通知音会被系统一并静音。
+		*
+		* 触发条件有两个：
+		* 1. 某个会话出现了新的待人工回答交互，question / plan-review / approval 都算；
+		* 2. 某个会话从「执行中」落到「空闲」，即一轮对话跑完。
+		*
+		* 按用户选择，两种都响，且不判断页面是否聚焦、不区分是否为当前会话。
+		* 重复靠两道闸门挡：同一待回答请求的 key 只响一次，以及跨标签页共享
+		* 的最小间隔，避免多开标签页时同一件事响好几轮。
+		*
+		* 通知不设自动关闭时间，会一直挂在系统通知里，直到对应会话发生操作：
+		* 会话被选中、该会话开始新一轮、待回答被解决，或会话从列表移除。每个会话
+		* 最多只保留最新一条，新通知会顶掉旧的；点击通知会聚焦窗口并切到该会话。
+		*
+		* @module dsh-notify-ding/client
+		*/
 		/** 插件名，同时也是配置项 id。 */
 		const name = "dsh-notify-ding";
 		/** 本插件需要的客户端服务。 */
 		const inject = ["uiSession", "sessions"];
-		/** 宿主播音路由，与宿主半身注册的路径一致。 */
-		const DING_PATH = "/dsh-notify-ding/ding";
 		/** 两次响铃之间的最小间隔，窗口内的合并成一次。 */
 		const MIN_INTERVAL_MS = 800;
 		/** 跨标签页共享「上次响铃时刻」的 localStorage 键。 */
 		const LAST_DING_KEY = "dsh-notify-ding.lastDingAt";
-		/** 系统通知自动关闭的延时。 */
-		const NOTIFICATION_TTL_MS = 1e4;
+		/** 当前挂在系统通知里、按会话索引的通知，新通知会顶掉同会话的旧通知。 */
+		const liveNotifications = /* @__PURE__ */ new Map();
+		/** 打开会话的入口，由 apply 从 ctx.sessions 注入；缺失时点击通知只关通知。 */
+		let sessionOpener;
+		/** 会话列表快照源，点击通知切会话前用它确认会话还在。 */
+		let listSourceRef;
+		/** 上一帧被选中的会话，用来识别「用户选中了某个会话」这个操作信号。 */
+		let lastCurrent;
 		/** 记录各会话上一帧状态，用来做边沿检测。 */
 		const tracks = /* @__PURE__ */ new Map();
 		/** 本页面上次响铃的时间戳，兜住同一帧内的重复触发。 */
@@ -54,43 +78,69 @@ window.__ModuleLoader__.load({
 				console.warn("[dsh-notify-ding] 写入共享响铃时刻失败：" + String(error));
 			}
 		}
-		/**
-		* 请求宿主播放提示音。
-		*
-		* 声音本身与系统通知互相独立：通知弹不出来时声音照样响，反之亦然。
-		* 这里不阻塞调用方，播音失败只记一条警告。
-		*/
-		function requestHostDing() {
-			fetch(DING_PATH, {
-				method: "POST",
-				credentials: "same-origin"
-			}).catch((error) => {
-				console.warn("[dsh-notify-ding] 请求宿主播音失败：" + String(error));
-			});
+		/** 关掉某会话的通知；没有或已关就当无操作。 */
+		function closeNotification(sessionId) {
+			const notification = liveNotifications.get(sessionId);
+			if (!notification) return;
+			liveNotifications.delete(sessionId);
+			try {
+				notification.close();
+			} catch (error) {
+				console.warn("[dsh-notify-ding] 关闭系统通知失败：" + String(error));
+			}
+		}
+		/** 关掉当前挂着的全部通知，插件卸载时收尾。 */
+		function closeAllNotifications() {
+			for (const sessionId of Array.from(liveNotifications.keys())) closeNotification(sessionId);
+		}
+		/** 聚焦窗口并切到目标会话；缺少入口或会话已不在列表时只聚焦。 */
+		function openSessionInUi(sessionId) {
+			try {
+				window.focus();
+			} catch (error) {
+				console.warn("[dsh-notify-ding] 聚焦窗口失败：" + String(error));
+			}
+			const open = sessionOpener;
+			const source = listSourceRef;
+			if (!open || !source) return;
+			try {
+				if (source.getSnapshot().byId[sessionId] === void 0) return;
+				open(sessionId);
+			} catch (error) {
+				console.warn("[dsh-notify-ding] 打开会话失败：" + String(error));
+			}
 		}
 		/**
-		* 弹一条浏览器系统通知。
+		* 弹一条浏览器系统通知，并挂在对应会话名下。
+		*
+		* 通知不设自动关闭时间，会一直挂在系统通知里，直到对应会话发生操作。
+		* 每个会话最多保留一条，新的会先关掉同会话的旧的。
+		* 点击通知会聚焦窗口并切到该会话，同时关掉这条通知。
 		*
 		* 浏览器未授权时不强行索要权限，而是记下需要补授权，等到用户下一次
 		* 与页面交互时再请求——权限请求必须由用户手势触发。
 		*
+		* @param sessionId 这条通知所属的会话。
 		* @param title 通知标题。
 		* @param body 通知正文。
 		*/
-		function showSystemNotification(title, body) {
+		function showSystemNotification(sessionId, title, body) {
 			if (typeof Notification === "undefined") return;
 			const present = () => {
+				closeNotification(sessionId);
 				try {
-					const notification = new Notification(title, { body });
+					const notification = new Notification(title, {
+						body,
+						requireInteraction: true
+					});
 					notification.onclick = () => {
-						try {
-							window.focus();
-						} catch (error) {
-							console.warn("[dsh-notify-ding] 聚焦窗口失败：" + String(error));
-						}
-						notification.close();
+						openSessionInUi(sessionId);
+						closeNotification(sessionId);
+					};
+					notification.onclose = () => {
+						if (liveNotifications.get(sessionId) === notification) liveNotifications.delete(sessionId);
 					};
-					window.setTimeout(() => notification.close(), NOTIFICATION_TTL_MS);
+					liveNotifications.set(sessionId, notification);
 				} catch (error) {
 					console.warn("[dsh-notify-ding] 弹出系统通知失败：" + String(error));
 				}
@@ -125,34 +175,27 @@ window.__ModuleLoader__.load({
 			window.addEventListener("keydown", onGesture, true);
 		}
 		/**
-		* 发一次「叮咚」：弹系统通知并请宿主播音。
-		* @param title 通知标题。
-		* @param body 通知正文。
-		*/
-		function emit(title, body) {
-			showSystemNotification(title, body);
-			requestHostDing();
-		}
-		/**
 		* 发一次「叮咚」，并做节流。
 		*
 		* 节流时刻写进 localStorage，多标签页共享，避免多开时同一件事响好几轮。
 		* 被节流压下的请求不会直接丢弃，而是挂到窗口边界的定时器上补发，
 		* 这样连续两次状态变化仍然各响一次，只是间隔被拉开，不会出现漏报。
 		*
+		* @param sessionId 这条通知所属的会话。
 		* @param title 通知标题。
 		* @param body 通知正文。
 		*/
-		function ding(title, body) {
+		function ding(sessionId, title, body) {
 			const now = Date.now();
 			const since = now - Math.max(lastDingAt, readSharedLastDing());
 			if (since < 0 || since >= MIN_INTERVAL_MS) {
 				lastDingAt = now;
 				writeSharedLastDing(now);
-				emit(title, body);
+				showSystemNotification(sessionId, title, body);
 				return;
 			}
 			deferred = {
+				sessionId,
 				title,
 				body
 			};
@@ -165,7 +208,7 @@ window.__ModuleLoader__.load({
 				const stamp = Date.now();
 				lastDingAt = stamp;
 				writeSharedLastDing(stamp);
-				emit(pending.title, pending.body);
+				showSystemNotification(pending.sessionId, pending.title, pending.body);
 			}, MIN_INTERVAL_MS - since);
 		}
 		/** 会话标题，缺失时退回会话 id，保证通知里总有个能认的名字。 */
@@ -177,10 +220,22 @@ window.__ModuleLoader__.load({
 		* 用一帧会话列表快照做边沿检测：新出现的待回答交互响一次，运行态从真落到假响一次。
 		*
 		* 首帧只建基线不响，否则每次刷新页面都会把既有状态补报一轮。
+		* 同时识别「会话被操作」的信号，把对应会话还挂着的通知关掉：
+		* 运行态从假升到真说明已回到该会话开始新一轮，会话被选中，
+		* 以及会话从列表消失，都算一次操作。
+		*
+		* 选中变化先于响铃处理，否则同一帧里既跑完又刚被选中的会话，通知会建立后
+		* 立刻被关掉。current 短暂变空是 DSH 的 masked gap，选中会话暂时不在列表时
+		* 就会出现，不算一次操作，也不该把上一个有效选中抹掉。
 		*
 		* @param state 当前会话列表快照。
+		* @param baseline 是否首帧，首帧只建基线。
 		*/
 		function scanSessions(state, baseline) {
+			if (state.current !== void 0) {
+				if (!baseline && state.current !== lastCurrent) closeNotification(state.current);
+				lastCurrent = state.current;
+			}
 			const seen = /* @__PURE__ */ new Set();
 			for (const id of Object.keys(state.byId)) {
 				const summary = state.byId[id];
@@ -194,27 +249,41 @@ window.__ModuleLoader__.load({
 					};
 					tracks.set(id, track);
 				}
-				if (!baseline && track.running && !summary.running) ding("DSH 完成了一轮", titleOf(summary, id) + " 已空闲");
+				if (!baseline) {
+					if (track.running && !summary.running) ding(id, "DSH 完成了一轮", titleOf(summary, id) + " 已空闲");
+					if (!track.running && summary.running) closeNotification(id);
+				}
 				track.running = summary.running;
 			}
-			for (const id of Array.from(tracks.keys())) if (!seen.has(id)) tracks.delete(id);
+			for (const id of Array.from(tracks.keys())) if (!seen.has(id)) {
+				closeNotification(id);
+				tracks.delete(id);
+			}
 		}
 		/**
 		* 用一帧待回答交互快照做边沿检测：某会话冒出新的 key 时响一次。
 		*
-		* 消失的 key 只清理记录，不触发任何声音。
+		* 先处理「旧 key 失效」：被解决或被新 key 顶掉时关掉该会话的通知；
+		* 再处理「新 key 出现」并叮咚，因此替换场景下新通知不会被误关。
 		*
 		* @param pending 当前按会话索引的待回答交互快照。
 		* @param state 与本次快照同时读到的会话列表，用来取标题。
+		* @param baseline 是否首帧，首帧只建基线。
 		*/
 		function scanPending(pending, state, baseline) {
+			if (!baseline) for (const [id, track] of tracks) {
+				if (track.pendingKeys.size === 0) continue;
+				const currentKey = pending.get(id)?.key;
+				if (currentKey !== void 0 && track.pendingKeys.has(currentKey)) continue;
+				closeNotification(id);
+			}
 			for (const [id, interaction] of pending) {
 				const track = tracks.get(id);
 				if (!track) continue;
 				if (track.pendingKeys.has(interaction.key)) continue;
 				track.pendingKeys.add(interaction.key);
 				if (baseline) continue;
-				ding("DSH 需要你回答", titleOf(state.byId[id], id) + " 正在等你");
+				ding(id, "DSH 需要你回答", titleOf(state.byId[id], id) + " 正在等你");
 			}
 			for (const [id, track] of tracks) {
 				if (track.pendingKeys.size === 0) continue;
@@ -235,6 +304,9 @@ window.__ModuleLoader__.load({
 			if (typeof Notification !== "undefined" && Notification.permission === "default") armPermissionGesture();
 			const pendingSource = ctx.uiSession.pendingInteractions;
 			const listSource = ctx.sessions.list;
+			const open = ctx.sessions.open;
+			sessionOpener = typeof open === "function" ? open.bind(ctx.sessions) : void 0;
+			listSourceRef = listSource;
 			/** 是否已经用首帧快照建立过基线；首帧只记录不发声。 */
 			let initialized = false;
 			/** 读两个源并各扫一遍，保证两处看到的是同一帧会话列表。 */
@@ -266,6 +338,10 @@ window.__ModuleLoader__.load({
 					deferredTimer = 0;
 				}
 				deferred = null;
+				closeAllNotifications();
+				sessionOpener = void 0;
+				listSourceRef = void 0;
+				lastCurrent = void 0;
 				tracks.clear();
 			});
 		}

package/lib/index.d.ts

@@ -1,17 +1,15 @@
-import { Context } from "@deepseek-ai/cordis";
 //#region src/index.d.ts
-/** 插件名，同时也是配置项 id。 */
-export declare const name = "dsh-notify-ding";
-/** 依赖宿主 web 载体的具名路由注册能力。没有 web 载体时本插件不激活。 */
-export declare const inject: string[];
-/** Windows 通知音的绝对路径，本家音色。 */
-export declare const SOUND_FILE = "C:\\Windows\\Media\\Windows Notify System Generic.wav";
-/** 一次「叮咚」播放的次数，一声即可，重复反而显得吵。 */
-export declare const BEEP_COUNT = 1;
 /**
- * 挂载播音路由。
+ * dsh-notify-ding 的宿主入口。
+ *
+ * 提示音交给系统通知自带，插件不再自行发声，因此本入口没有运行时行为。
+ * 之所以还留一个入口文件，是因为客户端模块系统按 Loader entry 扫描
+ * dsh.client 声明：entry 指向的宿主模块必须存在，浏览器半身才会被加载。
  *
- * @param ctx 宿主上下文，webServer 服务已就绪。
+ * @module dsh-notify-ding
  */
-export declare function apply(ctx: Context): void;
+/** 插件名，同时也是配置项 id。 */
+export declare const name = "dsh-notify-ding";
+/** 无宿主行为，仅作为可挂载的宿主入口存在。 */
+export declare function apply(): void;
 //#endregion

package/lib/index.js

@@ -1,114 +1,16 @@
-import { spawn } from "node:child_process";
 //#region src/index.ts
 /**
-* dsh-notify-ding 的宿主半身。
+* dsh-notify-ding 的宿主入口。
 *
-* 职责只有一件：在 dsh 的 web 载体上注册一条精确路由 POST /dsh-notify-ding/ding，
-* 收到请求就用 PowerShell 的 System.Media.SoundPlayer 播放 Windows 自带的提示音。
-* 之所以要绕宿主这一圈，是因为浏览器沙箱读不到 C:\Windows\Media 下的文件，
-* 而 Windows 本家音色只有读得到那些 wav 的宿主进程才播得出来。
-*
-* 浏览器半身负责判断「该响了」；本半身不参与任何触发判断，只负责发声。
+* 提示音交给系统通知自带，插件不再自行发声，因此本入口没有运行时行为。
+* 之所以还留一个入口文件，是因为客户端模块系统按 Loader entry 扫描
+* dsh.client 声明：entry 指向的宿主模块必须存在，浏览器半身才会被加载。
 *
 * @module dsh-notify-ding
 */
 /** 插件名，同时也是配置项 id。 */
 const name = "dsh-notify-ding";
-/** 依赖宿主 web 载体的具名路由注册能力。没有 web 载体时本插件不激活。 */
-const inject = ["webServer"];
-/** 播音路由的绝对路径。 */
-const ROUTE_PATH = "/dsh-notify-ding/ding";
-/** Windows 通知音的绝对路径，本家音色。 */
-const SOUND_FILE = "C:\\Windows\\Media\\Windows Notify System Generic.wav";
-/** 一次「叮咚」播放的次数，一声即可，重复反而显得吵。 */
-const BEEP_COUNT = 1;
-/**
-* 组装播音用的 PowerShell 脚本。
-*
-* 路径经单引号转义后拼进脚本字面量，避免文件名里的特殊字符被当成命令解析。
-* 播放次数写进脚本，因此一次进程启动就能响完整段声音，不必每声各起一个进程。
-*
-* @returns 一段自包含的 PowerShell 脚本。
-*/
-function buildPlayScript() {
-	return [
-		"$ErrorActionPreference = 'Stop'",
-		"$ProgressPreference = 'SilentlyContinue'",
-		"$player = New-Object System.Media.SoundPlayer '" + SOUND_FILE.replace(/'/g, "''") + "'",
-		"for ($i = 0; $i -lt 1; $i++) {",
-		"  $player.PlaySync()",
-		"}"
-	].join("\n");
-}
-/**
-* 把播音请求交给一个脱离宿主事件循环的 PowerShell 进程。
-*
-* 用 detached 启动，因此响铃不会被 dsh 的生命周期或响应结束打断；
-* stderr 仍要接住，否则播放失败时宿主会留下无人消费的管道数据。
-*
-*/
-function spawnPlayer() {
-	const script = buildPlayScript();
-	const encoded = Buffer.from(script, "utf16le").toString("base64");
-	const child = spawn("powershell.exe", [
-		"-NoLogo",
-		"-NoProfile",
-		"-NonInteractive",
-		"-EncodedCommand",
-		encoded
-	], {
-		detached: true,
-		stdio: [
-			"ignore",
-			"ignore",
-			"pipe"
-		],
-		windowsHide: true
-	});
-	child.stderr?.on("data", (chunk) => {
-		const text = chunk.toString("utf8").trim();
-		if (text) console.warn("[dsh-notify-ding] 播音进程报错：" + text);
-	});
-	child.on("error", (error) => {
-		console.warn("[dsh-notify-ding] 播音进程启动失败：" + error.message);
-	});
-	child.on("close", (code) => {
-		if (code !== 0 && code !== null) console.warn("[dsh-notify-ding] 播音进程退出码：" + String(code));
-	});
-	child.unref();
-}
-/**
-* 挂载播音路由。
-*
-* @param ctx 宿主上下文，webServer 服务已就绪。
-*/
-function apply(ctx) {
-	const webServer = ctx.get("webServer");
-	if (!webServer) {
-		console.warn("[dsh-notify-ding] 未找到 webServer 服务，播音路由不注册。");
-		return;
-	}
-	webServer.register({
-		kind: "exact",
-		path: ROUTE_PATH,
-		handler: (req, res) => {
-			if (req.method !== "POST") {
-				res.statusCode = 405;
-				res.end("method not allowed");
-				return;
-			}
-			try {
-				spawnPlayer();
-			} catch (error) {
-				console.warn("[dsh-notify-ding] 播音调用失败：" + error.message);
-				res.statusCode = 500;
-				res.end("spawn failed");
-				return;
-			}
-			res.statusCode = 200;
-			res.end("ding");
-		}
-	});
-}
+/** 无宿主行为，仅作为可挂载的宿主入口存在。 */
+function apply() {}
 //#endregion
-export { BEEP_COUNT, SOUND_FILE, apply, inject, name };
+export { apply, name };

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "dsh-notify-ding",
-  "version": "0.1.0",
-  "description": "在 DSH 需要人工回答或一轮对话跑完时，弹出系统通知并让宿主播放 Windows 内置提示音。标准可安装的 dsh 客户端插件。",
+  "version": "0.1.2",
+  "description": "在 DSH 需要人工回答或一轮对话跑完时弹出系统通知。标准可安装的 dsh 客户端插件。",
   "keywords": [
     "deepseek-harness",
     "dsh",
     "dsh-plugin",
     "notification",
-    "sound",
     "notify"
   ],
   "repository": {