dsh-notify-ding 0.1.1 → 0.1.2

package/README.md

@@ -1,8 +1,8 @@
 # dsh·通知叮咚插件
 
-在 DSH 需要你人工回答或一轮对话跑完时，弹出系统通知，并让宿主播放 Windows 自带的提示音。
+在 DSH 需要你人工回答或一轮对话跑完时，弹出系统通知。
 
-纯浏览器端触发、宿主端发声的双半身插件，不替换任何原生界面。
+纯浏览器端的插件，不替换任何原生界面。
 
 ## 引言
 
@@ -13,7 +13,7 @@
 
 - 某个会话出现新的待人工回答交互时叮咚一次，question、plan-review、approval 都算。
 - 某个会话从执行中落到空闲、也就是一轮对话跑完时叮咚一次。
-- 两种触发都会弹浏览器系统通知，同时请宿主播放 Windows 内置提示音。
+- 两种触发都会弹一条浏览器系统通知，提示音由 Windows 通知系统自带。
 - 不判断页面是否聚焦，也不区分是否为当前会话，任何会话有事都会响。
 - 通知不设自动关闭时间，会一直留在系统通知里，直到对应会话发生操作：会话被选中、该会话开始新一轮、待回答被解决，或会话从列表移除。
 - 每个会话最多保留一条通知，新通知会顶掉同会话的旧通知；点击通知会聚焦窗口并切到该会话。
@@ -25,11 +25,17 @@
 
 浏览器系统通知需要页面授权。插件在加载时会尝试请求一次，若被浏览器拒绝，会在你下一次点击或按键时再请求一次。所以在第一次看到页面后点一下任意位置，授权弹窗就会出来。
 
-若浏览器通知一直弹不出来，声音仍然会正常响——两条路是独立的。
+### 提示音从哪来
 
-### 声音从哪来
+插件不自行发声，提示音由 Windows 的通知系统在弹通知时自带。提示音的音量与静音都跟着系统通知设置走，和插件本身无关。
 
-浏览器沙箱读不到 `C:\Windows\Media` 下的文件，所以声音必须由宿主进程来播。宿主半身在 web 载体上注册一条精确路由 `POST /dsh-notify-ding/ding`，收到请求就用 PowerShell 的 `System.Media.SoundPlayer` 播放 `Windows Notify System Generic.wav`，响一声。
+### 全屏时通知会被系统静默
+
+Windows 11 的「专注」有一条自动规则「当我在全屏使用应用时」，全屏看视频或玩游戏时会自动进入专注状态，通知横幅不显示、通知音被静音，通知只落进通知中心，看起来就像插件根本没响。这是系统行为，插件感知不到也绕不开。
+
+想在全屏时也看到横幅，去 设置 → 系统 → 通知 → 专注，关闭「自动开启专注会话」里的「当我在全屏使用应用时」。代价是全屏时其他应用的通知也会冒出来。
+
+此时插件没有任何声音提示，因为它不自己发声，提示音就是被一并静音的通知音。
 
 ## 安装
 
@@ -59,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` 构建。
 
 ## 开发
@@ -76,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,6 +1,6 @@
 # dsh-notify-ding bundle patch：把通知插件插进 profile 的 layer stack。
 # 当本 bundle 出现在 profile 的 dsh.profile.bundles 列表里时应用。
-# 主机端半身负责宿主的提示音路由与可选的窗口提示音。
+# 宿主半身没有运行时行为，只让包能被 Loader 加载。
 # 浏览器半身由包的 dsh.client 声明与 exports["./client"] 自动发现。
 
 - insert:

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`。
 
 ## 触发信号
 
@@ -45,18 +42,13 @@
 
 只识别这四种状态信号，因此通知只有在 DSH 里真的对那个会话动了手才会消失；单纯回到浏览器窗口不会关掉它。
 
-## 声音与通知的关系
-
-两者互相独立：浏览器通知弹不出来时声音照响，宿主播音失败时通知照弹。任一侧失败只记一条 `console.warn`，不抛错、不互相阻塞。
-
-## 认证
+## 全屏静默
 
-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,12 +8,30 @@ 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 键。 */
@@ -60,20 +78,6 @@ 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);
@@ -171,16 +175,6 @@ window.__ModuleLoader__.load({
 			window.addEventListener("keydown", onGesture, true);
 		}
 		/**
-		* 发一次「叮咚」：弹系统通知并请宿主播音。
-		* @param sessionId 这条通知所属的会话。
-		* @param title 通知标题。
-		* @param body 通知正文。
-		*/
-		function emit(sessionId, title, body) {
-			showSystemNotification(sessionId, title, body);
-			requestHostDing();
-		}
-		/**
 		* 发一次「叮咚」，并做节流。
 		*
 		* 节流时刻写进 localStorage，多标签页共享，避免多开时同一件事响好几轮。
@@ -197,7 +191,7 @@ window.__ModuleLoader__.load({
 			if (since < 0 || since >= MIN_INTERVAL_MS) {
 				lastDingAt = now;
 				writeSharedLastDing(now);
-				emit(sessionId, title, body);
+				showSystemNotification(sessionId, title, body);
 				return;
 			}
 			deferred = {
@@ -214,7 +208,7 @@ window.__ModuleLoader__.load({
 				const stamp = Date.now();
 				lastDingAt = stamp;
 				writeSharedLastDing(stamp);
-				emit(pending.sessionId, pending.title, pending.body);
+				showSystemNotification(pending.sessionId, pending.title, pending.body);
 			}, MIN_INTERVAL_MS - since);
 		}
 		/** 会话标题，缺失时退回会话 id，保证通知里总有个能认的名字。 */

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