dsh-notify-ding 0.1.2 → 0.1.4

package/README.md

@@ -1,6 +1,6 @@
 # dsh·通知叮咚插件
 
-在 DSH 需要你人工回答或一轮对话跑完时，弹出系统通知。
+在 DSH 等待你回复或一轮对话跑完时，弹出系统通知。
 
 纯浏览器端的插件，不替换任何原生界面。
 
@@ -11,7 +11,7 @@
 
 ## 功能
 
-- 某个会话出现新的待人工回答交互时叮咚一次，question、plan-review、approval 都算。
+- 某个会话出现新的等待回复交互时叮咚一次，question、plan-review、approval 都算。
 - 某个会话从执行中落到空闲、也就是一轮对话跑完时叮咚一次。
 - 两种触发都会弹一条浏览器系统通知，提示音由 Windows 通知系统自带。
 - 不判断页面是否聚焦，也不区分是否为当前会话，任何会话有事都会响。
@@ -63,7 +63,7 @@ dsh plugin --profile web remove dsh-notify-ding
 
 ## 工作原理
 
-浏览器半身订阅 `ctx.sessions.list` 与 `ctx.uiSession.pendingInteractions` 两个只读快照，用边沿检测判断该不该响：运行态从真落到假算一轮跑完，出现新 key 的待回答交互算需要人工介入。首帧只建基线不发声，同一待回答请求只响一次，两次响铃之间留至少 800 毫秒并把该时刻写入 localStorage 跨标签页共享。
+浏览器半身订阅 `ctx.sessions.list` 与 `ctx.uiSession.sessionStatus` 两个只读快照，用边沿检测判断该不该响：运行态从真落到假算一轮跑完，出现新 key 的待回答交互算需要人工介入。首帧只建基线不发声，同一待回答请求只响一次，两次响铃之间留至少 800 毫秒并把该时刻写入 localStorage 跨标签页共享。
 
 判定通过时它弹出一条浏览器系统通知。通知按会话记录且不设自动关闭，同一会话只留最新一条；会话被选中、开始新一轮、待回答被解决或从列表移除时会关掉对应通知，点击通知则聚焦窗口、切换过去并关掉该条。完整设计见 [设计说明](docs/design.md)。
 

package/docs/design.md

@@ -12,7 +12,7 @@
 
 | 信号 | 来源 | 触发条件 |
 | --- | --- | --- |
-| 待人工回答 | `ctx.uiSession.pendingInteractions` | 某会话出现新 key 的交互，question、plan-review、approval 都算 |
+| 等待回复 | `ctx.uiSession.sessionStatus` | 某会话出现新 key 的交互，question、plan-review、approval 都算 |
 | 一轮跑完 | `ctx.sessions.list` 的 `byId[].running` | 某会话运行态从真落到假 |
 
 两者都是可订阅的只读快照，插件不修改任何状态，只观察。

package/lib/client.js

@@ -15,16 +15,13 @@ window.__ModuleLoader__.load({
 		* 提示音由系统通知自带，插件不另外发声，全屏专注时通知音会被系统一并静音。
 		*
 		* 触发条件有两个：
-		* 1. 某个会话出现了新的待人工回答交互，question / plan-review / approval 都算；
+		* 1. 某个会话出现了新的等待回复交互，question / plan-review / approval 都算；
 		* 2. 某个会话从「执行中」落到「空闲」，即一轮对话跑完。
 		*
 		* 按用户选择，两种都响，且不判断页面是否聚焦、不区分是否为当前会话。
-		* 重复靠两道闸门挡：同一待回答请求的 key 只响一次，以及跨标签页共享
-		* 的最小间隔，避免多开标签页时同一件事响好几轮。
+		* 重复靠两道闸门挡：同一待回答请求的 key 只响一次，以及跨标签页共享的最小间隔，避免多开标签页时同一件事响好几轮。
 		*
-		* 通知不设自动关闭时间，会一直挂在系统通知里，直到对应会话发生操作：
-		* 会话被选中、该会话开始新一轮、待回答被解决，或会话从列表移除。每个会话
-		* 最多只保留最新一条，新通知会顶掉旧的；点击通知会聚焦窗口并切到该会话。
+		* 通知不设自动关闭时间，会一直挂在系统通知里，直到对应会话发生操作：会话被选中、该会话开始新一轮、待回答被解决，或会话从列表移除。每个会话最多只保留最新一条，新通知会顶掉旧的；点击通知会聚焦窗口并切到该会话。
 		*
 		* @module dsh-notify-ding/client
 		*/
@@ -55,8 +52,7 @@ window.__ModuleLoader__.load({
 		/**
 		* 读取跨标签页共享的上次响铃时刻。
 		*
-		* localStorage 可能因隐私模式或禁用存储而抛错，抛错时按 0 处理即可，
-		* 最坏退化成只在单个标签页内节流。
+		* localStorage 可能因隐私模式或禁用存储而抛错，抛错时按 0 处理即可，最坏退化成只在单个标签页内节流。
 		*
 		* @returns 上次响铃的 Unix 毫秒时间戳。
 		*/
@@ -117,8 +113,7 @@ window.__ModuleLoader__.load({
 		* 每个会话最多保留一条，新的会先关掉同会话的旧的。
 		* 点击通知会聚焦窗口并切到该会话，同时关掉这条通知。
 		*
-		* 浏览器未授权时不强行索要权限，而是记下需要补授权，等到用户下一次
-		* 与页面交互时再请求——权限请求必须由用户手势触发。
+		* 浏览器未授权时不强行索要权限，而是记下需要补授权，等到用户下一次与页面交互时再请求——权限请求必须由用户手势触发。
 		*
 		* @param sessionId 这条通知所属的会话。
 		* @param title 通知标题。
@@ -178,8 +173,7 @@ window.__ModuleLoader__.load({
 		* 发一次「叮咚」，并做节流。
 		*
 		* 节流时刻写进 localStorage，多标签页共享，避免多开时同一件事响好几轮。
-		* 被节流压下的请求不会直接丢弃，而是挂到窗口边界的定时器上补发，
-		* 这样连续两次状态变化仍然各响一次，只是间隔被拉开，不会出现漏报。
+		* 被节流压下的请求不会直接丢弃，而是挂到窗口边界的定时器上补发，这样连续两次状态变化仍然各响一次，只是间隔被拉开，不会出现漏报。
 		*
 		* @param sessionId 这条通知所属的会话。
 		* @param title 通知标题。
@@ -220,13 +214,9 @@ window.__ModuleLoader__.load({
 		* 用一帧会话列表快照做边沿检测：新出现的待回答交互响一次，运行态从真落到假响一次。
 		*
 		* 首帧只建基线不响，否则每次刷新页面都会把既有状态补报一轮。
-		* 同时识别「会话被操作」的信号，把对应会话还挂着的通知关掉：
-		* 运行态从假升到真说明已回到该会话开始新一轮，会话被选中，
-		* 以及会话从列表消失，都算一次操作。
+		* 同时识别「会话被操作」的信号，把对应会话还挂着的通知关掉：运行态从假升到真说明已回到该会话开始新一轮，会话被选中，以及会话从列表消失，都算一次操作。
 		*
-		* 选中变化先于响铃处理，否则同一帧里既跑完又刚被选中的会话，通知会建立后
-		* 立刻被关掉。current 短暂变空是 DSH 的 masked gap，选中会话暂时不在列表时
-		* 就会出现，不算一次操作，也不该把上一个有效选中抹掉。
+		* 选中变化先于响铃处理，否则同一帧里既跑完又刚被选中的会话，通知会建立后立刻被关掉。current 短暂变空是 DSH 的 masked gap，选中会话暂时不在列表时就会出现，不算一次操作，也不该把上一个有效选中抹掉。
 		*
 		* @param state 当前会话列表快照。
 		* @param baseline 是否首帧，首帧只建基线。
@@ -295,6 +285,12 @@ window.__ModuleLoader__.load({
 				for (const key of Array.from(track.pendingKeys)) if (key !== stillPending.key) track.pendingKeys.delete(key);
 			}
 		}
+		/** 从会话状态快照里投影出待回答交互，按会话 id 索引。 */
+		function readPending(statusSource) {
+			const projected = /* @__PURE__ */ new Map();
+			for (const [id, row] of statusSource.getSnapshot()) if (row.pendingInteraction) projected.set(id, row.pendingInteraction);
+			return projected;
+		}
 		/**
 		* 同时盯住会话列表与待回答交互两个快照源。
 		*
@@ -302,7 +298,7 @@ window.__ModuleLoader__.load({
 		*/
 		function apply(ctx) {
 			if (typeof Notification !== "undefined" && Notification.permission === "default") armPermissionGesture();
-			const pendingSource = ctx.uiSession.pendingInteractions;
+			const statusSource = ctx.uiSession.sessionStatus;
 			const listSource = ctx.sessions.list;
 			const open = ctx.sessions.open;
 			sessionOpener = typeof open === "function" ? open.bind(ctx.sessions) : void 0;
@@ -322,13 +318,13 @@ window.__ModuleLoader__.load({
 				initialized = true;
 				scanSessions(state, baseline);
 				try {
-					scanPending(pendingSource.getSnapshot(), state, baseline);
+					scanPending(readPending(statusSource), state, baseline);
 				} catch (error) {
 					console.warn("[dsh-notify-ding] 读取待回答交互失败：" + String(error));
 				}
 			};
 			const unsubscribeList = listSource.subscribe(scan);
-			const unsubscribePending = pendingSource.subscribe(scan);
+			const unsubscribePending = statusSource.subscribe(scan);
 			scan();
 			ctx.effect(() => () => {
 				unsubscribeList();

package/lib/index.d.ts

@@ -3,8 +3,7 @@
  * dsh-notify-ding 的宿主入口。
  *
  * 提示音交给系统通知自带，插件不再自行发声，因此本入口没有运行时行为。
- * 之所以还留一个入口文件，是因为客户端模块系统按 Loader entry 扫描
- * dsh.client 声明：entry 指向的宿主模块必须存在，浏览器半身才会被加载。
+ * 之所以还留一个入口文件，是因为客户端模块系统按 Loader entry 扫描 dsh.client 声明：entry 指向的宿主模块必须存在，浏览器半身才会被加载。
  *
  * @module dsh-notify-ding
  */

package/lib/index.js

@@ -3,8 +3,7 @@
 * dsh-notify-ding 的宿主入口。
 *
 * 提示音交给系统通知自带，插件不再自行发声，因此本入口没有运行时行为。
-* 之所以还留一个入口文件，是因为客户端模块系统按 Loader entry 扫描
-* dsh.client 声明：entry 指向的宿主模块必须存在，浏览器半身才会被加载。
+* 之所以还留一个入口文件，是因为客户端模块系统按 Loader entry 扫描 dsh.client 声明：entry 指向的宿主模块必须存在，浏览器半身才会被加载。
 *
 * @module dsh-notify-ding
 */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-notify-ding",
-  "version": "0.1.2",
-  "description": "在 DSH 需要人工回答或一轮对话跑完时弹出系统通知。标准可安装的 dsh 客户端插件。",
+  "version": "0.1.4",
+  "description": "「DSH·通知叮咚」：在 DSH 等待回复或一轮对话跑完时弹出系统通知。标准可安装的 dsh 客户端插件。",
   "keywords": [
     "deepseek-harness",
     "dsh",
@@ -55,6 +55,10 @@
     "build": "tsdown",
     "typecheck": "tsc --noEmit"
   },
+  "peerDependencies": {
+    "@deepseek-ai/dsh": "^0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-session": "^0.2.0-rc.2"
+  },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
     "@types/node": "^22.20.1",