dsh-session-tg-notify 0.1.5 → 0.1.6

package/README.md

@@ -183,6 +183,29 @@ Telegram 的 bot **不能主动给人发消息** —— 它只能回复一个已
 | `POST /session-notify/telegram-check` | 校验 Bot Token 并返回 bot 身份 |
 
 
+## 排查收不到通知
+
+先看宿主记录，它会直接告诉你**有没有下发过帧、给了谁、下的是什么帧**：
+
+```sh
+curl -s http://127.0.0.1:3080/session-notify/state | python3 -m json.tool
+```
+
+看 `recentFrames`（最近 20 次下发）与 `presence`：
+
+| 现象 | 含义 |
+|---|---|
+| `recentFrames` 为空 | 事件没走到投递环节。检查日志里有没有「被时长过滤丢弃」 |
+| 有记录、事件是 `toast` | 判定为前台，走页面内提示（APP 在前台时这是预期行为） |
+| 有记录、事件是 `webnotify` 但没弹 | 帧已下发，是系统层面没显示 → 查系统通知权限 |
+| `channel` 是 `dropped` | 写 SSE 失败，连接已断（页面重载/被系统回收） |
+| `presence` 是 `offline` | 没有任何客户端在线 → 改走 Telegram，桌面通道不适用 |
+
+两个曾经导致「收不到」的坑，已在 0.1.6 修掉：
+
+- **同 tag 静默替换**：早期通知 `tag` 只用事件类型，macOS 会把同类型的新通知**静默替换**通知中心里还挂着的那条（不弹横幅、不响铃）。现在 `tag` 拼上 `sessionId + 事件类型 + 宿主时间戳 + 客户端序号`，每条都是独立条目。
+- **短 turn 被静默丢弃**：`minDuration` 早先默认 10 秒且**静默 return**，导致「发个『你好』这种几秒结束的 turn」既收不到通知、也没有任何日志，看起来像插件坏了。现在默认 0（不过滤）、过滤时打日志、设置面板可调。
+
 ## 已知限制
 
 - macOS 系统通知依赖浏览器通知权限；未授权时后台通知退化为页面内 toast（不会静默丢失）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-session-tg-notify",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "DSH 会话通知插件：监控会话事件（完成 / 审批 / 提问 / 受阻 / 出错），按浏览器前后台与锁屏状态路由到页面内 toast、系统通知或 Telegram，点击通知直达对应会话。",
   "type": "module",
   "main": "src/index.js",

package/src/client.js

@@ -295,6 +295,10 @@ window.__ModuleLoader__.load({
 				return function () { style.remove(); };
 			}, "dsh-session-tg-notify: styles");
 
+			// 通知序号：宿主给的是毫秒时间戳，同一毫秒内连续到达的两条事件会撞 tag，
+			// 又会退回「静默替换」。这里用一个单调递增的本地序号兜底。
+			var notifySeq = 0;
+
 			// ---- 通知呈现
 			ctx.effect(function () {
 				tone.attachUnlock();
@@ -316,7 +320,13 @@ window.__ModuleLoader__.load({
 					var note = new Notification(payload.title || "DSH 通知", {
 						body: payload.body || "", 
 						// body 末尾已带「工作区名称」，无需再拼页脚
-						tag: "dsh-session-tg-notify:" + (payload.kind || "event"),
+						//
+						// tag 必须每条唯一。早先只用事件类型做 tag，于是同一类型的
+						// 第二条通知会**静默替换**通知中心里还挂着的那条：macOS 不再弹
+						// 横幅、也不再响铃。表现就是「偶尔收不到」，且很难复现——间隔久了
+						// 旧通知已被清走就又能弹。所以这里拼上会话、事件类型和宿主给的
+						// 唯一 at（毫秒时间戳），保证每条都是独立条目。
+						tag: "dsn:" + (payload.sessionId || "na") + ":" + (payload.kind || "event") + ":" + (payload.at || 0) + ":" + (++notifySeq),
 						// 合成音已播放时抑制系统音；未解锁则让系统出默认声，保证一定有声音
 						silent: played
 					});
@@ -530,6 +540,25 @@ window.__ModuleLoader__.load({
 				head.append(top);
 				body.append(head);
 
+				// ---- 「会话完成」的最短时长阈值
+				// 以前这个阈值只能改配置文件、面板里完全没有入口，于是「发个『你好』
+				// 这种几秒结束的 turn 收不到通知」看起来像插件坏了。
+				var minRow = el("div", "dsn-row");
+				minRow.append(el("span", "dsn-grow", "最短完成时长（秒，0 = 不过滤）"));
+				var minInput = el("input", "dsn-input");
+				minInput.type = "number";
+				minInput.min = "0";
+				minInput.step = "1";
+				minInput.style.width = "80px";
+				minInput.value = String(config.minDuration === undefined ? 0 : config.minDuration);
+				minInput.addEventListener("change", function () {
+					var n = parseInt(minInput.value, 10);
+					if (!isFinite(n) || n < 0) { minInput.value = String(config.minDuration || 0); return; }
+					save({ minDuration: n }, n === 0 ? "已关闭时长过滤" : "已设为 " + n + " 秒");
+				});
+				minRow.append(minInput);
+				body.append(minRow);
+
 				// ---- 逐事件：桌面 / Telegram / 测试
 				var evSec = el("div", "dsn-sec");
 				evSec.append(el("h4", null, "事件与通道"));

package/src/config.js

@@ -41,8 +41,14 @@ export const TONES = Object.freeze(['ding', 'alert', 'chime', 'none']);
 /** 默认配置。 */
 export const DEFAULT_CONFIG = Object.freeze({
 	enabled: true,
-	/** complete 事件的最短 turn 时长（秒），低于此值不通知，避免短任务刷屏。 */
-	minDuration: 10,
+	/**
+	 * complete 事件的最短 turn 时长（秒），低于此值不通知。0 = 不做时长过滤。
+	 *
+	 * 默认 0（全部通知）。早先默认 10，结果「发个『你好』这种几秒就结束的
+	 * turn」被静默丢弃——既不通知也没日志，看起来像插件坏了。想防短任务刷屏
+	 * 请在设置面板里自行调大。
+	 */
+	minDuration: 0,
 	events: Object.freeze({
 		complete: Object.freeze({ desktop: true, telegram: false }),
 		approval: Object.freeze({ desktop: true, telegram: true }),

package/src/index.js

@@ -34,7 +34,7 @@ import { readScreenLocked } from './screenlock.js';
 import { sendTelegram, getTelegramMe, getTelegramChats, getTelegramChat } from './telegram.js';
 
 export const name = 'session-notify';
-export const VERSION = '0.1.5';
+export const VERSION = '0.1.6';
 /** 只消费事件与 webServer，不依赖其他服务。 */
 export const inject = [];
 
@@ -253,8 +253,18 @@ export function apply(ctx, cordisConfig = {}, options = {}) {
 			const complete = classifyTurnEnd(session, turns2.onTurnEnd(session, event));
 			if (!complete) return;
 			const durationMs = complete.detail?.durationMs;
-			// 时长过滤：短于 minDuration 的 turn 不打扰（未知时长按通过处理）。
-			if (typeof durationMs === 'number' && durationMs < config.minDuration * 1000) return;
+			// 时长过滤：短于 minDuration 的 turn 不打扰。
+			//
+			// 这里**必须留日志**：早先直接 return，导致「发个『你好』这种短消息
+			// 收不到通知」既没有任何通知、也没有任何记录，看起来像是插件坏了。
+			// 静默丢弃 + 无痕迹 = 最难排查的一类问题。
+			if (typeof durationMs === 'number' && durationMs < config.minDuration * 1000) {
+				console.log(
+					`[session-notify] ⏱ complete 被时长过滤丢弃（${Math.round(durationMs / 1000)}s < minDuration=${config.minDuration}s）` +
+					`${config.minDuration > 0 ? '，可在设置里调小或设为 0' : ''}`
+				);
+				return;
+			}
 			void deliver(complete, session);
 		}
 	});
@@ -290,6 +300,9 @@ export function apply(ctx, cordisConfig = {}, options = {}) {
 			presence: hub.snapshot(),
 			// 面板的状态行要显示「锁屏推送」是否真的生效，所以这里带上实时锁屏状态
 			screen: lastScreen,
+			// 诊断：最近下发过哪些帧。面板测试能弹但实际事件不弹时，用它区分
+			//「路由选错了帧」与「客户端收到了但没执行」。
+			recentFrames: hub.recentFrames,
 			events: EVENT_META,
 			// configPath 给 curl/运维用；configPathDisplay 是收敛成 ~/... 的版本，
 			// 界面只允许用后者，避免把用户名渲染进 UI。

package/src/presence.js

@@ -107,15 +107,48 @@ export function createPresenceHub(options = {}) {
 		return true;
 	};
 
+	/**
+	 * 最近若干次下发记录（诊断用）。
+	 *
+	 * 为什么需要：`/test` 端点返回 `delivered:true` 只代表「写进了 SSE 连接」，
+	 * 不代表客户端真的执行了。一旦「面板测试能弹、实际事件不弹」，光看宿主日志
+	 * 无法区分是**路由选错了帧**（该发 webnotify 却发了 toast）还是**客户端收到
+	 * 后没执行**。把最近下发的帧记下来就能一眼定位。
+	 *
+	 * 两条下发路径都要记：`sendTo`（真实事件与面板测试都走它）与 `broadcast`
+	 * （`/test` 未指定 clientId 时的回退）。早先只记了 sendTo，导致手测
+	 * `/test` 明明 delivered 却查不到任何记录，一度误判成「插件没加载新代码」。
+	 */
+	let recentFrames = [];
+	const rememberFrame = (channel, event, clientId, data) => {
+		recentFrames.unshift({
+			channel,
+			event,
+			clientId,
+			kind: data?.kind ?? null,
+			title: data?.title ?? null,
+			// body 与 sessionId 也要记：真实事件和面板测试的差别可能藏在正文里
+			// （例如正文为空时某些平台会不弹横幅），只记 title 会漏掉这类线索。
+			body: data?.body ?? null,
+			sessionId: data?.sessionId ?? null,
+			tone: data?.tone ?? null,
+			at: new Date().toISOString()
+		});
+		if (recentFrames.length > 20) recentFrames = recentFrames.slice(0, 20);
+	};
+
 	/** 广播一帧给所有在线客户端。 */
 	const broadcast = (event, data) => {
 		for (const client of clients.values()) writeFrame(client.res, event, data);
+		rememberFrame('broadcast', event, null, data);
 	};
 
 	/** 推给单个客户端（通知类帧用，避免多标签重复弹窗）。 */
 	const sendTo = (clientId, event, data) => {
 		const client = clients.get(clientId);
-		return client ? writeFrame(client.res, event, data) : false;
+		const ok = client ? writeFrame(client.res, event, data) : false;
+		rememberFrame(ok ? 'desktop' : 'dropped', event, clientId, data);
+		return ok;
 	};
 
 	/**
@@ -172,6 +205,10 @@ export function createPresenceHub(options = {}) {
 		sendTo,
 		snapshot,
 		dispose,
+		/** 最近下发记录（诊断用，见 rememberFrame 的说明）。 */
+		get recentFrames() {
+			return recentFrames;
+		},
 		get size() {
 			return clients.size;
 		}