dsh-session-tg-notify 0.1.0 → 0.1.1

package/README.md

@@ -30,6 +30,25 @@ dsh plugin --profile web add link:/绝对路径/dsh-session-tg-notify
 
 **点击通知直达会话**：页面内 toast 与 macOS 系统通知都可点击，点后会切回该标签页并打开对应会话（走 DSH 客户端的 `uiWorkspace.openSession`）。会话已归档或已被删除时导航失败会静默忽略。
 
+### 通知文案格式
+
+标题与正文由宿主统一组装，**页面内 toast、macOS 系统通知、Telegram 三处完全一致**：
+
+```
+标题：{emoji} {事件类型}：{会话标题}
+正文：{事件正文} 「{工作区名称}」
+```
+
+例如：
+
+```
+✅ 会话完成：个人开发APP消息推送方案调研
+帮我重构一下（172s） 「finance」
+```
+
+- **会话标题**取自 `@deepseek-ai/dsh-session-title` 的 `TitleService`（`ctx.get('sessionTitle').get(session).title`）。会话还没生成标题时，标题降级为只有事件类型，不会出现悬空的「：」。
+- **工作区名称**取会话 `cwd` 的末段（DSH 的工作区以目录为单位），拿不到时回退为 session id 前 8 位；两者都拿不到时正文不追加这段。
+
 ### 可通知的事件
 
 | 事件 | 触发时机 |

package/package.json

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

package/src/client.js

@@ -227,17 +227,14 @@ window.__ModuleLoader__.load({
 					el.className = "dsn-toast";
 					var head = document.createElement("div");
 					head.className = "dsn-toast-t";
-					head.textContent = (payload.emoji ? payload.emoji + " " : "") + (payload.title || "通知");
+					// 宿主已把标题组装成「{emoji} {事件类型}：{会话标题}」，这里原样渲染
+					head.textContent = payload.title || "通知";
+					head.style.whiteSpace = "normal";
 					var body = document.createElement("div");
 					body.className = "dsn-toast-b";
 					body.textContent = payload.body || "";
 					el.append(head, body);
-					if (payload.sessionLabel) {
-						var foot = document.createElement("div");
-						foot.className = "dsn-toast-f";
-						foot.textContent = payload.sessionLabel;
-						el.append(foot);
-					}
+					// 工作区已经作为「工作区名称」附在正文末尾，不再单起页脚
 					var timer = setTimeout(function () {
 						if (el.parentNode) el.parentNode.removeChild(el);
 					}, TOAST_MS);
@@ -316,8 +313,9 @@ window.__ModuleLoader__.load({
 				}
 				var played = tone.play(payload.tone);
 				try {
-					var note = new Notification((payload.emoji ? payload.emoji + " " : "") + (payload.title || "DSH 通知"), {
-						body: [payload.body, payload.sessionLabel].filter(Boolean).join("\n"),
+					var note = new Notification(payload.title || "DSH 通知", {
+						body: payload.body || "", 
+						// body 末尾已带「工作区名称」，无需再拼页脚
 						tag: "dsh-session-tg-notify:" + (payload.kind || "event"),
 						// 合成音已播放时抑制系统音；未解锁则让系统出默认声，保证一定有声音
 						silent: played

package/src/events.js

@@ -27,8 +27,11 @@ export function isMainSession(session) {
 
 const isValidTurn = (turn) => Number.isSafeInteger(turn) && turn > 0;
 
-/** 会话的可读短标签：优先 cwd 的末段，其次 session id 前 8 位。 */
-export function sessionLabel(session) {
+/**
+ * 工作区名称：取会话 cwd 的末段（DSH 的工作区就是以目录为单位），
+ * 拿不到时退回 session id 前 8 位，保证通知里总有东西可显示。
+ */
+export function workspaceName(session) {
 	const cwd = session?.header?.cwd;
 	if (typeof cwd === 'string' && cwd.length > 0) {
 		const parts = cwd.replace(/\/+$/, '').split('/');
@@ -36,7 +39,26 @@ export function sessionLabel(session) {
 		if (last) return last;
 	}
 	const id = session?.id;
-	return typeof id === 'string' && id.length > 0 ? id.slice(0, 8) : 'session';
+	return typeof id === 'string' && id.length > 0 ? id.slice(0, 8) : '';
+}
+
+/**
+ * 读会话标题（用于通知标题的「：」之后那一段）。
+ *
+ * 标题由 `@deepseek-ai/dsh-session-title` 的 TitleService 提供（ctx 键
+ * `sessionTitle`），`get(session)` 返回 `{ title, ... }`；会话还没有标题事件
+ * 时返回 undefined。标题读不到绝不能影响通知本身，所以这里吞掉所有异常。
+ */
+export function readSessionTitle(service, session) {
+	if (!service || typeof service.get !== 'function' || !session) return null;
+	try {
+		const value = service.get(session);
+		if (typeof value === 'string' && value.length > 0) return value;
+		if (value && typeof value.title === 'string' && value.title.length > 0) return value.title;
+	} catch {
+		// 标题服务不可用/会话已销毁：降级为「没有标题」，不影响通知
+	}
+	return null;
 }
 
 /** 截断为单行，避免通知正文过长。 */
@@ -188,7 +210,6 @@ export function classifyApproval(session, event) {
 	return {
 		kind: 'approval',
 		sessionId,
-		title: '需要审批',
 		body: oneLine(reason === null ? toolName : `${toolName} — ${reason}`),
 		detail: { toolName, reason },
 		dedupeKey: `approval:${sessionId}:${id}`
@@ -220,7 +241,6 @@ export function classifyQuestion(session, event) {
 	return {
 		kind: 'question',
 		sessionId,
-		title: '需要回答',
 		body: oneLine(text === null ? '(Agent 提问)' : text) + suffix,
 		detail: { questionText: text, optionsCount, questionCount: questions.length },
 		dedupeKey: `question:${sessionId}:${data.callId ?? 'unknown'}`
@@ -236,7 +256,6 @@ export function classifyGoalChange(change) {
 	return {
 		kind: 'block',
 		sessionId: null,
-		title: '目标受阻',
 		body: oneLine(objective ?? '(未提供目标描述)'),
 		detail: { objective },
 		dedupeKey: ref ? `goal:${ref.id}@${ref.revision}` : `goal:block:${goal?.id ?? 'unknown'}`
@@ -251,7 +270,6 @@ export function classifyAgentError(payload) {
 	return {
 		kind: 'error',
 		sessionId: typeof agent?.id === 'string' && agent.id.length > 0 ? agent.id : null,
-		title: '运行出错',
 		body: oneLine(message),
 		detail: { message, turn: Number.isFinite(turn) ? turn : null, step: Number.isFinite(step) ? step : null },
 		dedupeKey: `error:${agent?.id ?? 'unknown'}@${turn ?? '-'}@${step ?? '-'}`
@@ -266,7 +284,6 @@ export function classifyTurnEnd(session, complete) {
 	return {
 		kind: 'complete',
 		sessionId,
-		title: '会话完成',
 		body: oneLine(complete.summary ?? `第 ${complete.turn} 轮`) + durationText,
 		detail: { turn: complete.turn, durationMs: complete.durationMs, summary: complete.summary },
 		dedupeKey: `complete:${sessionId}:${complete.turn}`

package/src/index.js

@@ -26,7 +26,8 @@ import {
 	classifyTurnEnd,
 	classifyGoalChange,
 	classifyAgentError,
-	sessionLabel,
+	workspaceName,
+	readSessionTitle,
 	oneLine
 } from './events.js';
 import { createPresenceHub } from './presence.js';
@@ -34,7 +35,7 @@ import { readScreenLocked } from './screenlock.js';
 import { sendTelegram, getTelegramMe, getTelegramChats, getTelegramChat } from './telegram.js';
 
 export const name = 'session-notify';
-export const VERSION = '0.1.0';
+export const VERSION = '0.1.1';
 /** 只消费事件与 webServer，不依赖其他服务。 */
 export const inject = [];
 
@@ -106,6 +107,37 @@ export function apply(ctx, cordisConfig = {}, options = {}) {
 		}
 	};
 
+	/**
+	 * 会话标题（通知标题里「：」之后那一段）。
+	 * 服务缺失、或该会话还没生成标题时返回 null —— 通知降级为只有事件类型。
+	 */
+	const sessionTitleOf = (session) => {
+		if (!session) return null;
+		try {
+			return readSessionTitle(typeof ctx.get === 'function' ? ctx.get('sessionTitle') : null, session);
+		} catch {
+			return null;
+		}
+	};
+
+	/**
+	 * 组装最终通知文案（两个通道共用，保证 toast / 系统通知 / Telegram 完全一致）：
+	 *   标题 = `{emoji} {事件类型}：{会话标题}`，标题缺失时省去「：…」
+	 *   正文 = `{事件正文} 「{工作区名称}」`
+	 */
+	const compose = (kind, body, session) => {
+		const emoji = EVENT_EMOJI[kind] ?? '';
+		const label = EVENT_LABELS[kind] ?? kind;
+		const head = `${emoji} ${label}`.trim();
+		const sessionTitle = sessionTitleOf(session);
+		const workspace = session ? workspaceName(session) : '';
+		const text = typeof body === 'string' ? body : '';
+		return {
+			title: sessionTitle ? `${head}：${sessionTitle}` : head,
+			body: workspace.length > 0 ? `${text} 「${workspace}」`.trim() : text
+		};
+	};
+
 	/**
 	 * Telegram 通道未就绪的原因（就绪返回 null）。
 	 * 「行内勾选 TG」表达的是**订阅**，通道是否真的能用由启用开关 + 凭据决定。
@@ -136,14 +168,19 @@ export function apply(ctx, cordisConfig = {}, options = {}) {
 		return true;
 	};
 
-	/** 路由并投递一次通知。 */
-	const deliver = async (notification) => {
+	/**
+	 * 路由并投递一次通知。
+	 * @param notification - 分类器输出（kind / body / sessionId / dedupeKey / detail）。
+	 * @param session - 对应会话；goal/error 这类没有会话上下文的事件传 null。
+	 */
+	const deliver = async (notification, session = null) => {
 		if (!notification) return;
 		const eventConfig = config.events[notification.kind];
 		if (!config.enabled || !eventConfig) return;
 		if (!dedupe.admit(notification.sessionId, notification.dedupeKey)) return;
 		// 两个通道都没勾 → 用户明确不想被这个事件打扰。
 		if (!eventConfig.desktop && !eventConfig.telegram) return;
+		const composed = compose(notification.kind, notification.body, session);
 
 		const presence = hub.snapshot();
 		// 只有「后台 + 开了锁屏推送」这一种组合需要真的去问系统锁没锁，
@@ -151,12 +188,11 @@ export function apply(ctx, cordisConfig = {}, options = {}) {
 		const needsLockProbe = presence.state === 'background' && eventConfig.telegram === true && config.telegram.notifyWhenLocked === true;
 		const screen = needsLockProbe ? await probeScreenLocked() : null;
 
+		// title 已含 emoji 与事件类型，body 末尾已带「工作区」——两端渲染时原样使用。
 		const payload = {
 			kind: notification.kind,
-			title: notification.title,
-			body: notification.body,
-			emoji: EVENT_EMOJI[notification.kind] ?? '',
-			sessionLabel: notification.sessionLabel ?? '',
+			title: composed.title,
+			body: composed.body,
 			// 供页面内 toast / 系统通知点击后直达对应会话
 			sessionId: notification.sessionId ?? null,
 			at: Date.now()
@@ -195,12 +231,12 @@ export function apply(ctx, cordisConfig = {}, options = {}) {
 
 		const approval = classifyApproval(session, event);
 		if (approval) {
-			void deliver({ ...approval, sessionLabel: sessionLabel(session), emoji: EVENT_EMOJI.approval });
+			void deliver(approval, session);
 			return;
 		}
 		const question = classifyQuestion(session, event);
 		if (question) {
-			void deliver({ ...question, sessionLabel: sessionLabel(session), emoji: EVENT_EMOJI.question });
+			void deliver(question, session);
 			return;
 		}
 
@@ -222,18 +258,18 @@ export function apply(ctx, cordisConfig = {}, options = {}) {
 			const durationMs = complete.detail?.durationMs;
 			// 时长过滤：短于 minDuration 的 turn 不打扰（未知时长按通过处理）。
 			if (typeof durationMs === 'number' && durationMs < config.minDuration * 1000) return;
-			void deliver({ ...complete, sessionLabel: sessionLabel(session), emoji: EVENT_EMOJI.complete });
+			void deliver(complete, session);
 		}
 	});
 
 	ctx.on('goal/changed', ({ change }) => {
 		const block = classifyGoalChange(change);
-		if (block) void deliver({ ...block, sessionLabel: '', emoji: EVENT_EMOJI.block });
+		if (block) void deliver(block);
 	});
 
 	ctx.on('agent/error', (payload) => {
 		const error = classifyAgentError(payload);
-		if (error) void deliver({ ...error, sessionLabel: '', emoji: EVENT_EMOJI.error });
+		if (error) void deliver(error);
 	});
 
 	ctx.on('session/disposed', (session) => {
@@ -338,12 +374,11 @@ export function apply(ctx, cordisConfig = {}, options = {}) {
 						const kind = typeof body.kind === 'string' ? body.kind : '';
 						const channel = body.channel === 'telegram' ? 'telegram' : 'desktop';
 						if (!EVENT_LABELS[kind]) return json(res, 400, { ok: false, error: `unknown event kind: ${kind}` });
+						// 用与真实通知相同的文案形状，测试才代表实际观感
 						const sample = {
 							kind,
-							title: EVENT_LABELS[kind],
-							body: `这是一条来自 dsh-session-tg-notify 的测试通知（${EVENT_LABELS[kind]}）`,
-							emoji: EVENT_EMOJI[kind] ?? '',
-							sessionLabel: 'settings-test',
+							title: `${EVENT_EMOJI[kind] ?? ''} ${EVENT_LABELS[kind]}：测试会话`,
+							body: `这是一条测试通知 「settings-test」`,
 							at: Date.now()
 						};
 						if (channel === 'telegram') {

package/src/telegram.js

@@ -6,14 +6,18 @@
  * 通知失败绝不能影响 DSH 会话本身。
  */
 
-/** 把通知内容渲染成 Telegram 消息文本（HTML 模式，需转义）。 */
+/**
+ * 把通知内容渲染成 Telegram 消息文本（HTML 模式，需转义）。
+ *
+ * title 已由宿主组装成「{emoji} {事件类型}：{会话标题}」，body 末尾已带
+ * 「工作区名称」，所以这里只做转义与换行，不再自己拼接片段 —— 保证
+ * Telegram 与页面内 toast / 系统通知三处文案完全一致。
+ */
 export function renderTelegramText(notification) {
-	const emoji = notification.emoji ?? '';
 	const title = notification.title ?? 'DSH 通知';
 	const body = notification.body ?? '';
-	const lines = [`${emoji} <b>${escapeHtml(title)}</b>`];
+	const lines = [`<b>${escapeHtml(title)}</b>`];
 	if (body) lines.push(escapeHtml(body));
-	if (notification.sessionLabel) lines.push(`<i>${escapeHtml(notification.sessionLabel)}</i>`);
 	return lines.join('\n');
 }