@mzzsfy/dsh-turn-notify 0.7.4 → 0.8.0

package/README.md

@@ -2,21 +2,13 @@
 
 DeepSeek Harness 消息通知插件:AI 回合产生六类事件(完成/出错/被中断/等待审批/AI 提问/达到上限),按你的配置送达声音、系统弹窗、页内提示、webhook、IM 五种通道,多窗口只响一次。
 
-设计文档见 [docs/design/dsh-turn-notify-weixin.md](../../docs/design/dsh-turn-notify-weixin.md)。
-
 ## 快速上手
 
 ```sh
 dsh plugin --profile web add @mzzsfy/dsh-turn-notify
 ```
 
-发布前开发安装(拷贝进 store,行为与 registry 安装一致):
-
-```sh
-dsh plugin --profile web add file:./packages/dsh-turn-notify
-```
-
-安装后打开 设置 > 消息通知:默认全部事件开启,声音、页内提示、系统弹窗即装即用(系统弹窗经一次浏览器授权后生效);webhook 与 IM 填配置后启用。声音通道受浏览器自动播放策略约束,首次点击页面后才会出声。想推到微信等聊天工具,见 [IM 推送](#im-推送);想推到自建服务,见 [webhook 推送](#webhook-推送)。
+安装后打开 设置 > 消息通知:默认全部事件开启,声音与系统弹窗即装即用(系统弹窗经一次浏览器授权后生效);webhook 与 IM 填配置后启用。页内提示经公共依赖 @mzzsfy/dsh-toast 提供,由 session-manager 插件代挂装载——未安装 session-manager 时该通道自动禁用,其余通道不受影响。声音通道受浏览器自动播放策略约束,首次点击页面后才会出声。想推到微信等聊天工具,见 [IM 推送](#im-推送);想推到自建服务,见 [webhook 推送](#webhook-推送)。
 
 ## 六类通知事件
 
@@ -53,15 +45,40 @@ dsh plugin --profile web add file:./packages/dsh-turn-notify
 
 ## 系统弹窗与页内提示
 
-- **系统弹窗**:浏览器 Notification 授权后,窗口失焦时弹系统级通知。HTTP 非回环地址下浏览器不提供该能力,声音开启时自动降级为标题闪烁;HTTPS 下自动恢复。Windows 下还受系统通知设置与专注助手约束。
-- **页内提示**:页面角落浮出的卡片提示(dsh-toast 栈式展示,6 秒),聚焦窗口内唯一常开的提醒形态,可关。
+- **系统弹窗**:浏览器 Notification 授权后,窗口失焦时弹系统级通知;标题为事件文本,通知小结(见下节)作正文。点击弹窗聚焦窗口并直接切换到对应会话(点击直达,下节)。HTTP 非回环地址下浏览器不提供该能力,声音开启时自动降级为标题闪烁;HTTPS 下自动恢复。Windows 下还受系统通知设置与专注助手约束。
+- **页内提示**:页面角落浮出的卡片提示(dsh-toast 栈式展示,6 秒),聚焦窗口内唯一常开的提醒形态,可关;通知带小结时以第二行呈现,点击卡片直达对应会话。
 - **页内提示音**:聚焦场景的独立声音,总开关、按事件分类独立开关与音色映射全套自成一档,独立于提示音的分类配置。开启后页内提示弹出且通知声音未播时补一声提示——聚焦窗口内通知声音被聚焦静默压制,靠它保留听觉提醒;与通知声音互斥,同一通知至多一声;音量共用,音色在音效页的「页内提示音映射」单独指定。
 - **降级标题闪烁**:系统弹窗开关开启但未获得授权或不可用(如 HTTP 非回环地址、曾被拒绝)且窗口未聚焦时,标签页标题以 ⏳ 前缀闪烁替代弹窗;单条闪烁 6 秒自停,连环通知逐条续命但总时长硬顶 30 秒必停,返回窗口立即停止;可在偏好中关闭该提示。
-- **聚焦静默**:窗口聚焦时只保留页内提示,声音、系统弹窗与标题闪烁全部静默(页内提示音开启且该分类未在页内静音时仍有补位一声);你离开键盘满 5 分钟视为不在电脑前,聚焦也全通道提醒。
+- **聚焦静默**:窗口可见且有焦点时只保留页内提示,声音、系统弹窗与标题闪烁全部静默(页内提示音开启且该分类未在页内静音时仍有补位一声);可见但无焦点(多屏正看别的窗口)不静默,照常弹窗出声;你离开键盘满 5 分钟视为不在电脑前,聚焦也全通道提醒。
+
+## 点击直达会话
+
+等待你动作的审批与提问、以及回合结束类通知,呈现时都携带直达动作:点击页内提示卡片或系统弹窗,窗口聚焦并自动切换到对应会话(模拟点击侧边栏会话行,与手工点击完全同路),高亮随之清除(查看即已读)。会话行未渲染(列表折叠/懒加载未滚动到)时仅聚焦窗口;通知无会话标题时同样只聚焦。「知道了」类显式关闭不触发直达。
+
+## 等待动作二次提醒
+
+审批请求与 AI 提问送达后 10 分钟仍未处理时,自动补发一轮提醒(页内提示 + 声音 + 标题闪烁,独立于聚焦静默与通道路由——它就是"上一轮没看到"的兜底),每条通知至多补发一次,不连环催。"已处理"的判定:你已切到该会话,或已点掉会话行高亮;通知无会话标题时无法感知处理,按未处理补发。通知被其他窗口处理或已移出投影队列时,补发登记自动撤销。
+
+## 通知小结
+
+回合结束类通知附一句话小结:耗时(回合时长)+ tokens(本回合各步用量四桶合计)+ 最终回答前缀(末条含文本回答的首行,按码点截断),拼装为「耗时 12 秒 · 1.5k tokens · 已修复登录」形态;缺哪项省哪项,全缺省无小结。系统弹窗作正文、页内卡片作第二行,webhook payload 增补 `summary` 与 `tokens` 结构化字段。统计来自 host 侧会话事件流内的 assistant 消息,回合结束即消费清账,无额外请求。
+
+## 事件→通道路由
+
+六类事件各自可指定放行通道名单(kindRoutes,存 settings.yaml),名单外的通道对该类事件一律不送达;未配置的分类全通道放行,名单为空数组即全禁。通道名:`sound`(提示音)/ `system`(系统弹窗)/ `toast`(页内提示,页内提示音随行)/ `blink`(降级标题闪烁)/ `webhook` / `im`。典型用法:任务完成只推 webhook,重要事件(审批/提问)走 IM:
+
+```yaml
+turn-notify:
+  kindRoutes:
+    completed: [webhook]      # 完成只推 webhook,浏览器不响
+    approval: [im, sound, system]   # 审批走 IM 且本机弹窗出声
+```
+
+路由是全局配置,作用于所有浏览器;本机呈现偏好(声音/弹窗开关、聚焦静默)在其上叠加,两层都放行才送达。面板"通知"分区不展示该配置,yaml 直改保存即生效。
 
 ## webhook 推送
 
-在面板填入 webhook URL 即启用。host 直发,标签页全关也送达;payload 为 Slack 兼容 JSON(text 字段承载通知文本),另附 event/category/status/session/workspace/durationMs/ts 结构化字段;超时 10 秒,不重试。凭据只写不回显,测试按钮返回真实投递结果。
+在面板填入 webhook URL 即启用。host 直发,标签页全关也送达;payload 为 Slack 兼容 JSON(text 字段承载通知文本,summary 字段承载通知小结),另附 event/category/status/session/workspace/durationMs/tokens/ts 结构化字段;超时 10 秒,不重试。凭据只写不回显,测试按钮返回真实投递结果。
 
 ## IM 推送
 
@@ -69,11 +86,11 @@ dsh plugin --profile web add file:./packages/dsh-turn-notify
 
 ## 会话行高亮
 
-通知实际送达时,侧边栏会话列表中对应会话行以背景脉冲闪烁强调,六类各一色(完成绿/出错红/提问蓝/中断橙/审批黄/上限紫),点击该会话行即停止。开关在面板"偏好"页首项(独立开关,本机生效,各浏览器独立),默认开启。并行多会话时用于快速定位状态刚更新的会话:运行中的会话不闪烁(与 dsh 原生状态点分工——状态点表达运行中,闪烁表达已更新待查看),会话重新进入运行状态时闪烁自动让位;聚焦时正在查看的会话不闪烁,失焦期间本会话的通知照常闪烁,返回窗口即自动消失(回来即已读,焦点与页面可见双通道)。行定位按会话标题文本匹配,标题与侧边栏行同源(session-title 投影);会话行未渲染(列表折叠/懒加载未滚动到)时该次高亮静默跳过。
+通知实际送达时,侧边栏会话列表中对应会话行以背景脉冲闪烁强调,六类各一色(完成绿/出错红/提问蓝/中断橙/审批黄/上限紫),点击该会话行即停止。开关在面板"偏好"页首项(独立开关,本机生效,各浏览器独立),默认开启。并行多会话时用于快速定位状态刚更新的会话:运行中的会话不闪烁(与 dsh 原生状态点分工——状态点表达运行中,闪烁表达已更新待查看),会话重新进入运行状态时闪烁自动让位;聚焦时正在查看的会话不闪烁,失焦期间本会话的通知照常闪烁,返回窗口即自动消失(回来即已读,焦点与页面可见双通道)。行定位按会话标题文本匹配,标题默认与侧边栏行同源(session-title 投影);该服务缺失或不可用(如伪会话无事件日志)时回落会话事件内存储的标题,可能与侧边栏不同步。会话行未渲染(列表折叠/懒加载未滚动到)时该次高亮静默跳过。重开页面的冷启动静默对齐同样挂高亮(见"多窗口只响一次"),重开即见哪些会话有动静。
 
 ## 多窗口只响一次
 
-同一地址(同源)打开的多个窗口共享一次呈现:各窗口以长轮询挂起在 host 的通知队列上(事件产生或配置变更即时返回,空闲期单次挂起至多数十秒,失败按指数退避重连),经 localStorage 协调,仅一个窗口抢先呈现——发声并弹出页内提示、系统弹窗、高亮会话行,其余窗口全部跳过,不止声音。通知在产生后的下一次唤醒即送达,通常亚秒级;不同浏览器或不同地址打开的窗口各自发声互不感知。窗口关闭/刷新期间错过的通知不做重开回放:启动首轮仅静默对齐游标与完成标记,不逐条补发提示与声音(等待用户动作的审批与提问例外,照常呈现)。
+同一地址(同源)打开的多个窗口共享一次呈现:各窗口以长轮询挂起在 host 的通知队列上(事件产生或配置变更即时返回,空闲期单次挂起至多数十秒,失败按指数退避重连),经 localStorage 协调,仅一个窗口抢先呈现——发声并弹出页内提示、系统弹窗、高亮会话行,其余窗口全部跳过,不止声音。通知在产生后的下一次唤醒即送达,通常亚秒级;不同浏览器或不同地址打开的窗口各自发声互不感知。窗口关闭/刷新期间错过的通知不做重开回放:启动首轮静默对齐游标与完成标记,不逐条补发提示与声音(等待用户动作的审批与提问例外,照常呈现);未读会话行高亮不在静默范围,照常挂上。
 
 ## 设置面板指南
 
@@ -81,7 +98,7 @@ dsh plugin --profile web add file:./packages/dsh-turn-notify
 
 | 分区 | 内容 |
 |------|------|
-| 通知 | webhook 地址、最短回合时长、子代理过滤、六类事件开关;存 settings.yaml,事件开关点击即存,其余点保存后生效 |
+| 通知 | webhook 地址、最短回合时长、子代理过滤、六类事件开关;存 settings.yaml,事件开关点击即存,其余点保存后生效。事件→通道路由(kindRoutes)亦存此命名空间,经 yaml 配置 |
 | 偏好 | 本机浏览器记忆的设置:会话高亮(独立开关)、声音总开关与分类静音、音量、系统弹窗与授权、页内提示开关、页内提示音(总开关 + 分类独立开关)、聚焦静默、降级标题闪烁 |
 | 音效 | 音效上传/试听/重命名/删除,六类事件的音效映射与双作用域开关,页内提示音映射(本机,未配置沿用通知音效) |
 | IM | 绑定 dsh-im bot、勾选投递目标(仅装了 dsh-im 时显示) |
@@ -106,6 +123,8 @@ turn-notify:
     max-tokens: true
   soundMapping:                   # 每类事件音效映射,空为内置默认,值为内置音名或上传音效 id
     completed: ''
+  kindRoutes:                     # 事件→通道路由:分类到放行通道名单,未配置的分类全通道放行
+    completed: [webhook]
   imTargets:                      # dsh-im 投递目标,空数组禁用
     - botId: wx_xxx
       targetId: owner
@@ -117,10 +136,10 @@ turn-notify:
 
 按数据流向分五步:
 
-1. **事件监听**:host 观察 `session/event`(回合结束与 ask_user_question 工具调用)与 `approval/request` 审批请求(只观察,不拦截)。回合结束原因逐一映射:正常结束归任务完成,错误与手动停止归任务出错,审批拦截归等待审批,输出触顶归达到上限,会话收尾补发的中断归被中断。
-2. **分类与过滤**:事件归入六类,经子代理会话、子代理相关静默(仅任务完成类)、最短回合时长三道过滤,通过即产生一条通知。
-3. **host 直发通道**:webhook 与 IM 由 host 进程直接投递,不依赖浏览器;同时通知写入内存队列(环形 20 条,60 秒过期,不落盘)。
-4. **浏览器通道**:各窗口以长轮询挂起在该队列上(cursor 续传,事件与配置变更即时唤醒,空闲期单次挂起至多数十秒,失败指数退避重连),localStorage 协调保证同一通知只有一个窗口呈现,再按本机偏好分发到声音/系统弹窗/页内提示。
+1. **事件监听**:host 观察 `session/event`(回合结束、ask_user_question 工具调用与 assistant 消息)与 `approval/request` 审批请求(只观察,不拦截)。回合结束原因逐一映射:正常结束归任务完成,错误与手动停止归任务出错,审批拦截归等待审批,输出触顶归达到上限,会话收尾补发的中断归被中断;assistant 消息流经途累积回合小结(tokens 与回答前缀),回合结束随通知消费。
+2. **分类与过滤**:事件归入六类,经子代理会话、子代理相关静默(仅任务完成类)、最短回合时长三道过滤,通过即产生一条通知,并按 kindRoutes 裁定放行通道。
+3. **host 直发通道**:webhook 与 IM 由 host 进程直接投递(经路由名单过滤),不依赖浏览器;同时通知写入内存队列(环形 20 条,60 秒过期,不落盘),路由名单随单元下发。
+4. **浏览器通道**:各窗口以长轮询挂起在该队列上(cursor 续传,事件与配置变更即时唤醒,空闲期单次挂起至多数十秒,失败指数退避重连),localStorage 协调保证同一通知只有一个窗口呈现,再按本机偏好与路由名单分发到声音/系统弹窗/页内提示;等待用户动作的审批与提问超时未处理时补发一轮提醒。
 5. **降级链**:声音通道开启而系统弹窗不可用(HTTP 非回环、未授权)→ 标题闪烁;页内提示依赖缺失 → 干净禁用该通道;localStorage 不可用 → 该窗口直接发声(可能与多窗口重复,诚实降级)。
 
 ## 已知取舍
@@ -130,6 +149,8 @@ turn-notify:
 - 不同浏览器或不同地址打开的窗口各自发声,互不去重。
 - 系统弹窗在 HTTP 非回环下永久降级,HTTPS 化后自动恢复;Windows 下受系统通知设置与专注助手约束。
 - 长轮询空闲期连接由代理或服务端挂起,经中间反代时需允许数十秒的挂起响应,否则退化为更频繁的重连。
+- 等待动作二次提醒的"已处理"判定以本窗口可见信号(会话切换/高亮清除)近似,无会话标题的通知无法感知处理,宁可多响一次。
+- 点击直达依赖侧边栏会话行可被标题匹配命中,行未渲染或标题不同步时仅聚焦不切换。
 
 ## 安全
 
@@ -144,3 +165,11 @@ turn-notify:
 cd packages/dsh-turn-notify && npm test
 ```
 
+## 开发安装(仓库维护者)
+
+```sh
+node scripts/dev-link.mjs dsh-turn-notify   # 仓库根执行:归一 profile 依赖行 + 挂 junction
+```
+
+工作副本以 junction 挂进 profile,host 半区改动保存约 1 秒热重载,client 半区改动刷新页面即生效,无需发版;规约与全仓归一见 `node scripts/dev-link.mjs all`。
+

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mzzsfy/dsh-turn-notify",
   "description": "消息通知:六类回合事件送达声音、系统弹窗、页内提示、webhook 与 IM;内置八种合成音色,自定义音效,按事件分类指定;多窗口只响一次",
-  "version": "0.7.4",
+  "version": "0.8.0",
   "type": "module",
   "main": "src/index.js",
   "exports": {
@@ -33,7 +33,7 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@mzzsfy/dsh-toast": "^0.1.2"
+    "@mzzsfy/dsh-toast": "^0.2.0"
   },
   "peerDependencies": {
     "@deepseek-ai/dsh-session-title": ">=0.1.2-rc.1",

package/src/client.js

@@ -277,7 +277,8 @@ window.__ModuleLoader__.load({
     // 放入 LOGIC 段由 parity 测试保证双实现不漂移
     const IDLE_AWAY_MS = 5 * 60 * 1000
 
-    function chooseChannels(hasFocus, permission, idleMs, soundCategories, category) {
+    // routes 为事件→通道路由放行名单(null=未配置全放行),语义与 core 同源
+    function chooseChannels(hasFocus, permission, idleMs, soundCategories, category, routes) {
       const idleAway = typeof idleMs === 'number' && idleMs >= IDLE_AWAY_MS
       const quiet = hasFocus && localGet(KEY_DND) !== '0' && !idleAway
       const systemEnabled = localGet(KEY_SYSTEM) !== '0'
@@ -286,13 +287,14 @@ window.__ModuleLoader__.load({
       const pageSoundCategories = readPageSoundCategories()
       const categoryMuted = soundCategories != null && category != null && soundCategories[category] === false
       const pageCategoryMuted = pageSoundCategories != null && category != null && pageSoundCategories[category] === false
-      const sound = !quiet && soundEnabled && !categoryMuted
+      const routed = (channel) => routes == null || routes.indexOf(channel) >= 0
+      const sound = !quiet && soundEnabled && !categoryMuted && routed('sound')
       return {
-        toast: toastEnabled,
+        toast: toastEnabled && routed('toast'),
         sound,
-        system: !quiet && systemEnabled && permission === 'granted',
-        blink: !quiet && systemEnabled && permission !== 'granted',
-        pageSound: localGet(KEY_PAGE_SOUND) === '1' && toastEnabled && !pageCategoryMuted && !sound,
+        system: !quiet && systemEnabled && permission === 'granted' && routed('system'),
+        blink: !quiet && systemEnabled && permission !== 'granted' && routed('blink'),
+        pageSound: localGet(KEY_PAGE_SOUND) === '1' && toastEnabled && !pageCategoryMuted && !sound && routed('toast'),
       }
     }
 
@@ -507,10 +509,21 @@ window.__ModuleLoader__.load({
 
     const notificationPermission = () => (typeof Notification === 'undefined' ? 'denied' : Notification.permission)
 
-    // onOutcome 仅供测试路径取显示回执(onshow/onerror),真实路径吞错降级已在链路内
+    // onOutcome 仅供测试路径取显示回执(onshow/onerror),真实路径吞错降级已在链路内。
+    // onclick 点击直达:聚焦窗口并切到对应会话后关闭弹窗;summary 作 body 两级呈现
     function notifySystem(unit, onOutcome) {
       try {
-        const notification = new Notification(unit.text, { tag: unit.id })
+        const notification = new Notification(unit.text, { tag: unit.id, body: unit.summary ?? '' })
+        notification.onclick = () => {
+          try {
+            if (typeof window.focus === 'function') window.focus()
+            if (unit.session) {
+              const row = findSessionRow(unit.session)
+              if (row !== null && typeof row.click === 'function') row.click()
+            }
+          } catch { /* 直达失败不掩盖通知主流程 */ }
+          notification.close()
+        }
         if (typeof onOutcome === 'function') {
           notification.onshow = () => { onOutcome(true) }
           notification.onerror = () => { onOutcome(false) }
@@ -562,6 +575,7 @@ window.__ModuleLoader__.load({
       }
       const units = payload.units || []
       const liveIds = new Set(units.map((unit) => unit.id))
+      pruneReminders(liveIds)
       // 投影中已过期的本地残留清理,防旧锁与完成标记滞留;
       // 访问失败即标记 broken 并整段跳过,防抛出被外层吞掉、发声链路失效
       try {
@@ -574,25 +588,31 @@ window.__ModuleLoader__.load({
       } catch {
         storageState.broken = true
       }
+      // 聚焦静默双条件:可见且有焦点才静默(竞品对齐)。hasFocus 单独成立而页面
+      // hidden 的边界(多屏/预渲染)不静默
+      const engaged = isEngaged()
       for (const unit of units) {
         // 冷启动对齐:错过窗口期的存量通知不回放轰炸;审批与提问例外——
         // 它们在等用户动作,静默会把待办吞掉
         if (coldStart && unit.category !== 'approval' && unit.category !== 'ask') {
           try { markDone(unit.id) } catch { /* 存储不可用:标记缺失由内存去重兜底,冷启动本就不发声 */ }
+          // 静默对齐只不呈现通知,未读会话闪烁照常:高亮是本机 UI 状态,不属轰炸
+          rememberSessionHighlight(unit, engaged)
           continue
         }
         if (!claimEvent(unit.id)) continue
         markDone(unit.id)
-        const channels = chooseChannels(document.hasFocus(), notificationPermission(), Date.now() - lastActionAt(), readSoundCategories(), unit.category)
+        const channels = chooseChannels(engaged, notificationPermission(), Date.now() - lastActionAt(), readSoundCategories(), unit.category, unit.routes ?? null)
         const sound = resolveSound(unit.category, effectiveMapping(), uploadedIds)
         if (channels.toast || channels.sound || channels.system || channels.blink) {
-          if (sessionHighlights.size >= SESSION_HL_MAX) sessionHighlights.delete(sessionHighlights.keys().next().value)
-          // 投影字段名为 session(buildUnit 输出形态,webhook 结构化字段同名);
-          // 聚焦时正在查看的会话不闪烁——与 dsh 原版一致,正在看的会话不做未读强调;
-          // 失焦期间照常挂,返回页面时由可见性同步清除(回来即已读)
-          if (unit.session && !(document.hasFocus() && isCurrentSessionTitle(unit.session))) sessionHighlights.set(unit.session, unit.category)
+          rememberSessionHighlight(unit, engaged)
+        }
+        if (channels.toast) {
+          toast?.(unit.text + (unit.summary ? '\n' + unit.summary : ''), {
+            holdMs: TOAST_MS,
+            onClick: activateSessionFromUnit(unit),
+          })
         }
-        if (channels.toast) toast?.(unit.text, { holdMs: TOAST_MS })
         // 页内提示音与通知声音互斥(pageSound 已含 !sound),同一通知至多一声;
         // toast 库缺失时卡片不存在,补位音随之禁用(声明与可用分离,可用性在调用点合流);
         // 页内音色按页内场景映射解析:通知生效映射为底,页内显式配置覆盖
@@ -603,6 +623,8 @@ window.__ModuleLoader__.load({
         if (channels.sound) playSound(sound).catch(() => {})
         if (channels.system) notifySystem(unit)
         else if (channels.blink && localGet(KEY_DEGRADE_HINT) !== '0') startTitleBlink()
+        // 等待用户动作的事件超时未处理:补发一轮提醒(审批与提问)
+        scheduleActionReminder(unit, channels)
       }
       applySessionHighlights()
       return true
@@ -749,12 +771,38 @@ window.__ModuleLoader__.load({
       return text.indexOf('进行中') >= 0 || text.toLowerCase().indexOf('running') >= 0
     }
 
+    // 聚焦静默双条件:可见且有焦点才静默(竞品对齐)。hasFocus 单独成立而页面
+    // hidden 的边界(多屏/预渲染)不静默
+    const isEngaged = () => document.hasFocus() && document.hidden === false
+
+    // 高亮挂载单一入口:正常送达与冷启动静默对齐共用;
+    // 门控差异:正常送达仅在通知实际投递(任一呈现通道放行)时挂,冷启动静默对齐
+    // 无条件挂——高亮是未读 UI 状态,不属通知轰炸,错过窗口的存量照样强调;
+    // 开关关闭不积累条目;聚焦时正在查看的会话不挂——与 dsh 原版一致,正在看即已读,
+    // 失焦期间照常挂,返回页面时由可见性同步清除(回来即已读);
+    // 投影字段名为 session(buildUnit 输出形态,webhook 结构化字段同名)
+    function rememberSessionHighlight(unit, engaged) {
+      if (!sessionHighlightEnabled || !unit.session) return
+      if (engaged && isCurrentSessionTitle(unit.session)) return
+      if (sessionHighlights.size >= SESSION_HL_MAX) sessionHighlights.delete(sessionHighlights.keys().next().value)
+      sessionHighlights.set(unit.session, unit.category)
+    }
+
     // 增量重应用:仅补缺失类,不产生多余 DOM 写,防 MutationObserver 回调自我触发成环;
     // 快照遍历:行进入运行状态时清理对应条目,迭代中删除不改快照
     function applySessionHighlights() {
       if (typeof document === 'undefined' || typeof document.querySelectorAll !== 'function') return
       if (!sessionHighlightEnabled) return
+      const engaged = isEngaged()
       for (const [title, category] of [...sessionHighlights]) {
+        // 聚焦态复核:冷启动首拉早于标题就绪时误挂的当前会话高亮,标题就绪后的
+        // 任一应用帧在此自愈(与返回即已读同语义:正在看即不强调)
+        if (engaged && isCurrentSessionTitle(title)) {
+          sessionHighlights.delete(title)
+          const stale = findSessionRow(title)
+          if (stale) removeRowHighlight(stale)
+          continue
+        }
         const row = findSessionRow(title)
         if (!row) continue
         if (isRowRunning(row)) {
@@ -799,6 +847,56 @@ window.__ModuleLoader__.load({
       if (typeof row.className !== 'string') return
       row.className = row.className.split(' ').filter((name) => name !== SESSION_HL_CLASS && name.indexOf(SESSION_HL_CLASS + '--') !== 0).join(' ')
     }
+
+    // ---- 点击直达会话:页内卡片与系统弹窗共用 ----
+
+    // 按通知单元激活会话:聚焦窗口并模拟点击侧边栏会话行(官方行点击即切换会话);
+    // 点击事件经高亮清除委托,天然完成"查看即已读"。行未渲染(列表折叠/懒加载)
+    // 或无标题时仅聚焦窗口。
+    function activateSessionFromUnit(unit) {
+      return () => {
+        if (typeof window.focus === 'function') window.focus()
+        if (!unit.session) return
+        const row = findSessionRow(unit.session)
+        if (row !== null && typeof row.click === 'function') row.click()
+      }
+    }
+
+    // ---- 审批/提问超时二次提醒 ----
+
+    // 等待用户动作的事件超此时长未处理即补发一轮(一次,不连环)。
+    const ACTION_REMIND_MS = 10 * 60 * 1000
+    // 待提醒登记:unit id → timer;处理判定与生命周期清理共用
+    const pendingReminders = new Map()
+    // "已处理"近似:用户切到该会话(标题匹配)或点掉了高亮行(高亮条目消失);
+    // 无标题通知(审批 waterfall)无法感知处理,按未处理补发,宁可多响一次。
+    function actionHandled(unit) {
+      if (!unit.session) return false
+      if (isCurrentSessionTitle(unit.session)) return true
+      return !sessionHighlights.has(unit.session)
+    }
+    function scheduleActionReminder(unit, channels) {
+      if (unit.category !== 'approval' && unit.category !== 'ask') return
+      if (pendingReminders.has(unit.id)) return
+      const timer = setTimeout(() => {
+        pendingReminders.delete(unit.id)
+        if (actionHandled(unit)) return
+        // 补发独立于聚焦静默与路由名单:它就是"通道没送达"的兜底
+        toast?.('[再次提醒] ' + unit.text + (unit.summary ? '\n' + unit.summary : ''), { holdMs: TOAST_MS, onClick: activateSessionFromUnit(unit) })
+        playSound(resolveSound(unit.category, effectiveMapping(), uploadedIds)).catch(() => {})
+        startTitleBlink()
+      }, ACTION_REMIND_MS)
+      if (typeof timer.unref === 'function') timer.unref()
+      pendingReminders.set(unit.id, timer)
+    }
+    // 投影刷新同步:单元过期即撤登记(通知已被其他窗口处理或已出投影窗口)
+    function pruneReminders(liveIds) {
+      for (const [id, timer] of pendingReminders) {
+        if (liveIds.has(id)) continue
+        clearTimeout(timer)
+        pendingReminders.delete(id)
+      }
+    }
     // 页面重新可见即视为已读:清除当前会话的高亮,其他会话的提醒保留
     function clearCurrentSessionHighlights() {
       for (const title of [...sessionHighlights.keys()]) {
@@ -1877,7 +1975,7 @@ window.__ModuleLoader__.load({
       },
       // 测试钩子:供全链路集成测试注入 stub 后取内部函数,生产无消费方;
       // 页内通知的展示结果经 require 桩捕获,不在本包断言
-      __test: { poll, pollOnce, storageState, announcedIds, submitCategoryToggle, start },
+      __test: { poll, pollOnce, storageState, announcedIds, submitCategoryToggle, start, pruneReminders },
     }
   },
 })

package/src/core.mjs

@@ -136,7 +136,7 @@ export function shouldNotify({ category, kind, durationMs, settings, header, wak
   return true
 }
 
-export function buildUnit({ id, category, status, sessionTitle, workspace, durationMs, ts }) {
+export function buildUnit({ id, category, status, sessionTitle, workspace, durationMs, ts, tokens, summary }) {
   const label = CATEGORY_LABELS[category] || category
   return {
     id,
@@ -145,21 +145,76 @@ export function buildUnit({ id, category, status, sessionTitle, workspace, durat
     session: sessionTitle,
     workspace,
     durationMs,
+    tokens: typeof tokens === 'number' && tokens > 0 ? tokens : null,
+    summary: typeof summary === 'string' && summary.length > 0 ? summary : null,
     ts,
     text: '[dsh] ' + label + (sessionTitle ? ': ' + sessionTitle : ''),
   }
 }
 
-// 投影单元字段到 webhook 结构化字段的一比一映射(text 随行)。
+// 通知一句话小结:耗时 + tokens + 回答前缀,均缺省返回 null(各通道按需拼装)。
+// 前缀为最终回答的首个文本块,host 侧已按码点截断,此处原样拼装。
+export function buildSummary({ durationMs, tokens, prefix }) {
+  const parts = []
+  if (typeof durationMs === 'number' && durationMs >= 0) {
+    parts.push('耗时 ' + (durationMs >= 1000 ? Math.round(durationMs / 1000) + ' 秒' : Math.round(durationMs) + ' 毫秒'))
+  }
+  if (typeof tokens === 'number' && tokens > 0) parts.push(formatTokenCount(tokens) + ' tokens')
+  if (typeof prefix === 'string' && prefix.trim().length > 0) parts.push(prefix.trim())
+  return parts.length > 0 ? parts.join(' · ') : null
+}
+
+// tokens 紧凑格式:千以下原样,以上 k 计一位小数
+export function formatTokenCount(tokens) {
+  if (tokens < 1000) return String(tokens)
+  const k = tokens / 1000
+  return (k >= 100 ? Math.round(k) : Math.round(k * 10) / 10) + 'k'
+}
+
+// 回答前缀截断:按码点截断防切断代理对,与 sessionTitle 同策略
+export const ANSWER_PREFIX_MAX_CHARS = 80
+
+// assistant/message 事件 → 会话尾部统计累积:tokens 跨 step 累加(一回合多步),
+// 回答前缀取本回合最后一条含文本的消息(后到覆盖);usage 缺失不减不崩。
+export function collectAssistantTail(tail, sessionId, data) {
+  const message = data && data.message
+  const blocks = message !== null && typeof message === 'object' && Array.isArray(message.content) ? message.content : []
+  let prefix = null
+  for (const block of blocks) {
+    if (block && typeof block.text === 'string' && block.text.trim().length > 0) {
+      const text = block.text.trim()
+      prefix = text.length <= ANSWER_PREFIX_MAX_CHARS
+        ? text
+        : Array.from(text.slice(0, ANSWER_PREFIX_MAX_CHARS + 1)).slice(0, ANSWER_PREFIX_MAX_CHARS).join('')
+      break
+    }
+  }
+  const usage = data && typeof data.usage === 'object' && data.usage !== null ? data.usage : null
+  let tokens = 0
+  if (usage !== null) {
+    tokens = (usage.inputTokens ?? 0) + (usage.outputTokens ?? 0) + (usage.cacheReadTokens ?? 0) + (usage.cacheWriteTokens ?? 0)
+  }
+  const prev = tail.get(sessionId)
+  const next = {
+    tokens: (prev?.tokens ?? 0) + tokens,
+    prefix: prefix !== null ? prefix : (prev?.prefix ?? null),
+  }
+  tail.set(sessionId, next)
+  return next
+}
+
+// 投影单元字段到 webhook 结构化字段的一比一映射(text/summary 随行)。
 export function buildWebhookPayload(unit) {
   return {
     text: unit.text,
+    summary: unit.summary,
     event: unit.id,
     category: unit.category,
     status: unit.status,
     session: unit.session,
     workspace: unit.workspace,
     durationMs: unit.durationMs,
+    tokens: unit.tokens,
     ts: unit.ts,
   }
 }
@@ -227,6 +282,10 @@ export function decideClaim({ stored, done, now, windowId, lockTtlMs = CLAIM_LOC
 // 用户行动空闲满此时长视为离开:聚焦静默不再适用,通知全通道齐发。
 export const USER_IDLE_AWAY_MS = 5 * 60 * 1000
 
+// 呈现通道名单:事件→通道路由(kindRoutes)的合法取值;host 直发通道
+// (webhook/im)由 host 侧过滤,投影单元携带 routes 供浏览器侧过滤呈现通道。
+export const CHANNELS = ['sound', 'system', 'toast', 'blink', 'webhook', 'im']
+
 // 发声通道判定:页内提示、提示音与系统弹窗各自独立开关,聚焦静默仅压声音与系统弹窗;
 // 提示音另受分类配置约束:soundCategories 中该分类显式 false 即静音,缺省键与空分类放行。
 // 系统弹窗须授权,想弹而未授权时降级标题闪烁(调用方再按降级提示开关呈现)。
@@ -234,18 +293,21 @@ export const USER_IDLE_AWAY_MS = 5 * 60 * 1000
 // pageSound 为页内提示音:页内提示弹出且通知声音未播时补一声(聚焦场景的听觉提醒),
 // 不受聚焦静默压制,受页内总开关、页内分类配置(pageSoundCategories,独立于提示音分类)
 // 与通知声音互斥约束(同一通知至多一声)。
-export function chooseChannels({ hasFocus, permission, focusQuiet = true, toastEnabled = true, soundEnabled = true, soundCategories = null, category = null, systemEnabled = true, idleMs = null, idleThresholdMs = USER_IDLE_AWAY_MS, pageSoundEnabled = false, pageSoundCategories = null }) {
+// routes 为事件→通道路由放行名单(null=未配置全放行):单元级 AND 叠加在本机偏好之上,
+// 名单外的呈现通道一律不出。
+export function chooseChannels({ hasFocus, permission, focusQuiet = true, toastEnabled = true, soundEnabled = true, soundCategories = null, category = null, systemEnabled = true, idleMs = null, idleThresholdMs = USER_IDLE_AWAY_MS, pageSoundEnabled = false, pageSoundCategories = null, routes = null }) {
   const idleAway = typeof idleMs === 'number' && idleMs >= idleThresholdMs
   const quiet = hasFocus && focusQuiet && !idleAway
   const categoryMuted = soundCategories != null && category != null && soundCategories[category] === false
   const pageCategoryMuted = pageSoundCategories != null && category != null && pageSoundCategories[category] === false
-  const sound = !quiet && soundEnabled && !categoryMuted
+  const routed = (channel) => routes === null || routes.indexOf(channel) >= 0
+  const sound = !quiet && soundEnabled && !categoryMuted && routed('sound')
   return {
-    toast: toastEnabled,
+    toast: toastEnabled && routed('toast'),
     sound,
-    system: !quiet && systemEnabled && permission === 'granted',
-    blink: !quiet && systemEnabled && permission !== 'granted',
-    pageSound: pageSoundEnabled && toastEnabled && !pageCategoryMuted && !sound,
+    system: !quiet && systemEnabled && permission === 'granted' && routed('system'),
+    blink: !quiet && systemEnabled && permission !== 'granted' && routed('blink'),
+    pageSound: pageSoundEnabled && toastEnabled && !pageCategoryMuted && !sound && routed('toast'),
   }
 }
 
@@ -475,10 +537,11 @@ export function imBoundBotIds(list) {
 }
 
 // 配置补丁校验:顶层键白名单,webhookUrl 空串(禁用)或 http(s) URL,
-// 时长须非负整数,开关须布尔,enabled 分类须已知。返回归一化后的补丁。
+// 时长须非负整数,开关须布尔,enabled 分类须已知,kindRoutes 条目须合法通道名单。
+// 返回归一化后的补丁。
 export function validateConfigPatch(patch) {
   if (patch === null || typeof patch !== 'object' || Array.isArray(patch)) return { ok: false, reason: '补丁须为对象' }
-  const known = ['webhookUrl', 'minTurnDurationMs', 'rootsOnly', 'suppressSubagentWake', 'enabled', 'imTargets']
+  const known = ['webhookUrl', 'minTurnDurationMs', 'rootsOnly', 'suppressSubagentWake', 'enabled', 'imTargets', 'kindRoutes']
   for (const key of Object.keys(patch)) {
     if (known.indexOf(key) < 0) return { ok: false, reason: '未知配置项: ' + key }
   }
@@ -540,9 +603,40 @@ export function validateConfigPatch(patch) {
     }
     next.enabled = { ...enabled }
   }
+  if ('kindRoutes' in patch) {
+    next.kindRoutes = normalizeKindRoutes(patch.kindRoutes).routes
+  }
   return { ok: true, patch: next }
 }
 
+// kindRoutes 读侧归一化:分类 → 放行通道名单。非对象回空(全通道);未知分类的
+// 条目剔除、名单内未知通道剔除,余项去重保序(与 normalizeImTargets 同宽松读侧:
+// 剔除非法而非整体拒绝);全空名单等价全禁(合法,用户显式配置),与缺省键(全放行)区分。
+// 写侧校验(validateConfigPatch)对未知分类/通道拒绝,两侧严格度分工不同。
+export function normalizeKindRoutes(raw) {
+  if (raw === null || raw === undefined || typeof raw !== 'object' || Array.isArray(raw)) return { ok: true, routes: {} }
+  const routes = {}
+  for (const key of Object.keys(raw)) {
+    if (CATEGORIES.indexOf(key) < 0) continue
+    const list = raw[key]
+    if (!Array.isArray(list)) continue
+    const seen = new Set()
+    for (const channel of list) {
+      if (typeof channel !== 'string' || CHANNELS.indexOf(channel) < 0) continue
+      if (!seen.has(channel)) seen.add(channel)
+    }
+    routes[key] = [...seen]
+  }
+  return { ok: true, routes }
+}
+
+// 投影单元放行名单读取:kindRoutes 未配置该分类即全放行(null),配置即名单。
+export function unitRoutes(kindRoutes, category) {
+  if (kindRoutes === null || typeof kindRoutes !== 'object') return null
+  const list = kindRoutes[category]
+  return Array.isArray(list) ? list : null
+}
+
 // 面板读取的解析形态:enabled 缺省键按开补全,字段类型异常回退默认值;
 // 时长统一取整到非负整数,与写路径校验宽松度一致(yaml 手写小数不产生读存差)。
 // soundMapping 仅保留非空字符串值:settings.update 深合并无法物理删除嵌套键,
@@ -557,6 +651,7 @@ export function resolvedConfig(settings) {
     if (typeof value === 'string' && value.length > 0) soundMapping[key] = value
   }
   const duration = Number.isFinite(source.minTurnDurationMs) ? Math.max(0, Math.floor(source.minTurnDurationMs)) : MIN_TURN_DURATION_MS
+  const routesVerdict = normalizeKindRoutes(source.kindRoutes)
   return {
     webhookUrl: typeof source.webhookUrl === 'string' ? source.webhookUrl : '',
     minTurnDurationMs: duration,
@@ -565,6 +660,7 @@ export function resolvedConfig(settings) {
     enabled: Object.fromEntries(CATEGORIES.map((key) => [key, enabled[key] !== false])),
     soundMapping,
     imTargets: normalizeImTargets(source.imTargets),
+    kindRoutes: routesVerdict.ok ? routesVerdict.routes : {},
   }
 }
 
@@ -578,6 +674,7 @@ export function publicConfig(settings) {
     enabled: resolved.enabled,
     soundMapping: resolved.soundMapping,
     imTargets: resolved.imTargets,
+    kindRoutes: resolved.kindRoutes,
     webhookConfigured: resolved.webhookUrl.trim().length > 0,
   }
 }

package/src/index.js

@@ -15,8 +15,10 @@ import {
   MIN_TURN_DURATION_MS,
   OPEN_TURN_STALE_MS,
   SUBAGENT_WAKE_WINDOW_MS,
+  buildSummary,
   buildUnit,
   buildWebhookPayload,
+  collectAssistantTail,
   collectSessionEvents,
   createApprovalTap,
   createProjection,
@@ -32,6 +34,7 @@ import {
   sendWebhook,
   shouldNotify,
   storedSessionTitle,
+  unitRoutes,
   uploadExt,
   UPLOAD_FILE_MAX_BYTES,
   validateConfigPatch,
@@ -81,6 +84,7 @@ const SETTINGS_SCHEMA = z.object({
   enabled: z.object(Object.fromEntries(CATEGORIES.map((key) => [key, z.boolean().default(true)]))).description('六类事件独立开关:完成/出错/被中断/等待审批/AI 提问/达到上限'),
   soundMapping: z.object(Object.fromEntries(CATEGORIES.map((key) => [key, z.string().default('')]))).description('每类事件的声音映射,空为内置默认,非空为内置音名或上传音效 id'),
   imTargets: z.array(z.object({ botId: z.string().default(''), targetId: z.string().default('') })).default([]).description('dsh-im 推送目标列表,空数组禁用 IM 通道'),
+  kindRoutes: z.dict(z.array(z.string())).default({}).description('事件→通道路由:分类到放行通道名单(sound/system/toast/blink/webhook/im),未配置的分类全通道放行'),
 })
 
 // 读侧归一交由 core 的 resolvedConfig:字段类型异常回退默认值,与写路径校验宽松度一致
@@ -188,6 +192,8 @@ export function apply(ctx) {
   // 事件读序:标题提取需要事件流,按会话累积 user/message 文本;标题封账后不再累积
   const sessionEvents = new Map()
   const titledSessions = new Set()
+  // 回合尾部统计:assistant/message 的 tokens 累加与回答前缀,回合结束随通知消费即清
+  const assistantTails = new Map()
   let seq = 0
   // 音效库写互斥:展示名索引读改写与落盘非原子,串行化防并发交错
   let soundWriteQueue = Promise.resolve()
@@ -220,7 +226,16 @@ export function apply(ctx) {
     const header = session.header || {}
     const sessionId = String(session.id ?? '')
     if (!shouldNotify({ category, kind, durationMs, settings, header, wakeTurn, awaitingChildren })) return
+    // 回合尾部统计:tokens 与回答前缀随回合结束消费,统计缺失不影响送达
+    const tail = assistantTails.get(sessionId) ?? null
+    assistantTails.delete(sessionId)
     seq += 1
+    const summary = buildSummary({
+      durationMs,
+      tokens: tail === null ? null : tail.tokens,
+      prefix: tail === null ? null : tail.prefix,
+    })
+    const routes = unitRoutes(settings.kindRoutes, category)
     const unit = buildUnit({
       id: 'n-' + Date.now().toString(36) + '-' + String(seq) + '-' + String(category),
       category,
@@ -228,11 +243,16 @@ export function apply(ctx) {
       sessionTitle: sessionDisplayTitle(session, sessionId),
       workspace: typeof header.cwd === 'string' ? header.cwd : '',
       durationMs,
+      tokens: tail === null ? null : tail.tokens,
+      summary,
       ts: Date.now(),
     })
+    unit.routes = routes
     projection.push(unit)
-    void sendWebhook({ url: settings.webhookUrl, payload: buildWebhookPayload(unit) })
-    deliverIm(unit, settings)
+    if (routes === null || routes.indexOf('webhook') >= 0) {
+      void sendWebhook({ url: settings.webhookUrl, payload: buildWebhookPayload(unit) })
+    }
+    if (routes === null || routes.indexOf('im') >= 0) deliverIm(unit, settings)
   }
 
   // 会话显示标题:优先 session-title 服务(与侧边栏行标题同一投影,客户端文本匹配高亮
@@ -270,7 +290,10 @@ export function apply(ctx) {
     const currentTurnStart = openTurns.get(sessionId)
     pruneTimestamps(childDoneAt, now, SUBAGENT_WAKE_WINDOW_MS)
     for (const [turnId, turn] of openTurns) {
-      if (now - turn.at > OPEN_TURN_STALE_MS) openTurns.delete(turnId)
+      if (now - turn.at > OPEN_TURN_STALE_MS) {
+        openTurns.delete(turnId)
+        assistantTails.delete(turnId)
+      }
     }
     for (const [childId, entry] of childActive) {
       if (now - entry.at > ACTIVE_CHILD_STALE_MS) childActive.delete(childId)
@@ -281,6 +304,10 @@ export function apply(ctx) {
       collectSessionEvents(sessionEvents, titledSessions, sessionId, event)
       return
     }
+    if (event.type === 'assistant/message') {
+      collectAssistantTail(assistantTails, sessionId, event.data)
+      return
+    }
     if (event.type === 'turn/start') {
       // 回合级标记重置:上一回合的委托与收尾残留不跨回合
       turnDelegation.delete(sessionId)

package/test/core.test.mjs

@@ -14,6 +14,10 @@ import {
   SUBAGENT_WAKE_WINDOW_MS,
   buildUnit,
   buildWebhookPayload,
+  buildSummary,
+  collectAssistantTail,
+  normalizeKindRoutes,
+  unitRoutes,
   createProjection,
   decideClaim,
   chooseChannels,
@@ -377,20 +381,83 @@ test('webhook payload 字段映射', () => {
   const unit = buildUnit({
     id: 'n1', category: CATEGORY_DONE, status: 'completed',
     sessionTitle: '修复登录', workspace: '/repo', durationMs: 12 * 1000, ts: 1234,
+    tokens: 1500, summary: '耗时 12 秒 · 1.5k tokens · 已修复',
   })
   const payload = buildWebhookPayload(unit)
   assert.deepEqual(payload, {
     text: '[dsh] 任务完成: 修复登录',
+    summary: '耗时 12 秒 · 1.5k tokens · 已修复',
     event: 'n1',
     category: CATEGORY_DONE,
     status: 'completed',
     session: '修复登录',
     workspace: '/repo',
     durationMs: 12 * 1000,
+    tokens: 1500,
     ts: 1234,
   })
 })
 
+test('通知统计与降级小结:buildSummary 组装与空缺归 null', () => {
+  assert.equal(buildSummary({ durationMs: null, tokens: null, prefix: null }), null)
+  assert.equal(buildSummary({ durationMs: 5200, tokens: 0, prefix: '' }), '耗时 5 秒')
+  assert.equal(buildSummary({ durationMs: 800, tokens: null, prefix: null }), '耗时 800 毫秒')
+  assert.equal(buildSummary({ durationMs: null, tokens: 940, prefix: null }), '940 tokens')
+  assert.equal(buildSummary({ durationMs: null, tokens: 123456, prefix: null }), '123k tokens')
+  assert.equal(
+    buildSummary({ durationMs: 65 * 1000, tokens: 45, prefix: '已修复崩溃' }),
+    '耗时 65 秒 · 45 tokens · 已修复崩溃',
+  )
+  // 前缀纯空白按缺省处理
+  assert.equal(buildSummary({ durationMs: null, tokens: null, prefix: '   ' }), null)
+})
+
+test('collectAssistantTail:tokens 累加,回答前缀后到覆盖,usage 缺失不减不崩', () => {
+  const tail = new Map()
+  const first = collectAssistantTail(tail, 's1', {
+    usage: { inputTokens: 100, outputTokens: 50, cacheReadTokens: 10, cacheWriteTokens: 0 },
+    message: { content: [{ type: 'text', text: '  第一段回答  ' }] },
+  })
+  assert.deepEqual(first, { tokens: 160, prefix: '第一段回答' })
+  const second = collectAssistantTail(tail, 's1', {
+    usage: { inputTokens: 20, outputTokens: 30 },
+    message: { content: [{ type: 'text', text: '最终回答' }] },
+  })
+  assert.deepEqual(second, { tokens: 210, prefix: '最终回答' })
+  // 无 usage 无文本:tokens 保留,前缀保留
+  const third = collectAssistantTail(tail, 's1', { message: { content: [{ type: 'image' }] } })
+  assert.deepEqual(third, { tokens: 210, prefix: '最终回答' })
+  // 畸形数据不崩
+  const fourth = collectAssistantTail(tail, 's1', null)
+  assert.deepEqual(fourth, { tokens: 210, prefix: '最终回答' })
+  // 长前缀按码点截断
+  const long = '好'.repeat(120)
+  collectAssistantTail(new Map(), 's2', { message: { content: [{ type: 'text', text: long }] } })
+  const cut = collectAssistantTail(new Map(), 's2', { message: { content: [{ type: 'text', text: long }] } })
+  assert.equal(Array.from(cut.prefix).length, 80)
+})
+
+test('kindRoutes 归一化:非法剔除合法保留,去重保序,写侧宽松读侧剔除', () => {
+  assert.deepEqual(normalizeKindRoutes(undefined), { ok: true, routes: {} })
+  assert.deepEqual(normalizeKindRoutes(null), { ok: true, routes: {} })
+  assert.deepEqual(normalizeKindRoutes('x'), { ok: true, routes: {} })
+  assert.deepEqual(normalizeKindRoutes({ bogus: ['sound'] }), { ok: true, routes: {} }, '未知分类条目剔除')
+  assert.deepEqual(normalizeKindRoutes({ completed: 'sound' }), { ok: true, routes: {} }, '形态非法条目剔除')
+  const merged = normalizeKindRoutes({
+    completed: ['webhook', 'sound', 'webhook', 'sms'],
+    error: [],
+    bogus: ['sound'],
+  })
+  assert.deepEqual(merged, { ok: true, routes: { completed: ['webhook', 'sound'], error: [] } }, '未知通道剔除,合法去重保序,空名单=全禁')
+  // 空数组 = 全禁(显式配置),与缺省键(全放行)可区分
+  assert.deepEqual(unitRoutes({ completed: [] }, 'completed'), [])
+  assert.deepEqual(unitRoutes({ completed: ['webhook'] }, 'error'), null)
+  assert.deepEqual(unitRoutes(null, 'completed'), null)
+  // 写侧经 validateConfigPatch 归一后写入
+  const verdict = validateConfigPatch({ kindRoutes: { completed: ['webhook'] } })
+  assert.deepEqual(verdict, { ok: true, patch: { kindRoutes: { completed: ['webhook'] } } })
+})
+
 test('音效映射:自定义命中用自定义,内置备选与失效回落', () => {
   const mapping = { [CATEGORY_ERROR]: 'snd-9', [CATEGORY_DONE]: TONE_BELL, [CATEGORY_ASK]: 'gone' }
   assert.deepEqual(resolveSound({ category: CATEGORY_ERROR, mapping, uploadedIds: ['snd-9'] }), { kind: 'custom', id: 'snd-9' })
@@ -586,7 +653,7 @@ test('配置补丁校验:非法输入逐类拒绝', () => {
 
 test('配置解析:enabled 缺省键按开补全,字段类型回退默认', () => {
   assert.deepEqual(
-    resolvedConfig({ webhookUrl: 'https://hook.example', enabled: { completed: false }, soundMapping: { completed: 'snd-1' } }),
+    resolvedConfig({ webhookUrl: 'https://hook.example', enabled: { completed: false }, soundMapping: { completed: 'snd-1' }, kindRoutes: { completed: ['webhook'], bogus: ['sound'] } }),
     {
       webhookUrl: 'https://hook.example',
       minTurnDurationMs: MIN_TURN_MS,
@@ -595,6 +662,7 @@ test('配置解析:enabled 缺省键按开补全,字段类型回退默认', () =
       enabled: { completed: false, error: true, interrupted: true, approval: true, ask: true, 'max-tokens': true },
       soundMapping: { completed: 'snd-1' },
       imTargets: [],
+      kindRoutes: { completed: ['webhook'] },
     },
   )
   assert.deepEqual(resolvedConfig({}), {
@@ -605,6 +673,7 @@ test('配置解析:enabled 缺省键按开补全,字段类型回退默认', () =
     enabled: Object.fromEntries(CATEGORIES.map((name) => [name, true])),
     soundMapping: {},
     imTargets: [],
+    kindRoutes: {},
   })
   assert.equal(resolvedConfig({ minTurnDurationMs: Number.NaN }).minTurnDurationMs, MIN_TURN_MS)
   assert.equal(resolvedConfig({ suppressSubagentWake: false }).suppressSubagentWake, false)
@@ -612,7 +681,7 @@ test('配置解析:enabled 缺省键按开补全,字段类型回退默认', () =
 
 test('面板可见配置:webhookUrl 不出主机,仅回是否已配置', () => {
   assert.deepEqual(
-    publicConfig({ webhookUrl: 'https://hook.example/service/xxx', enabled: { completed: false }, soundMapping: { completed: 'snd-1' } }),
+    publicConfig({ webhookUrl: 'https://hook.example/service/xxx', enabled: { completed: false }, soundMapping: { completed: 'snd-1' }, kindRoutes: { ask: ['im'] } }),
     {
       minTurnDurationMs: MIN_TURN_MS,
       rootsOnly: true,
@@ -620,6 +689,7 @@ test('面板可见配置:webhookUrl 不出主机,仅回是否已配置', () => {
       enabled: { completed: false, error: true, interrupted: true, approval: true, ask: true, 'max-tokens': true },
       soundMapping: { completed: 'snd-1' },
       imTargets: [],
+      kindRoutes: { ask: ['im'] },
       webhookConfigured: true,
     },
   )

package/test/flow.test.mjs

@@ -47,8 +47,9 @@ function loadClient({ storage, payload, onFetch, fetchImpl, document: documentOv
   }
   const documentStub = {
     hasFocus: () => true,
+    // 默认桩:聚焦窗口恒可见(浏览器不变式);聚焦静默判定为可见+焦点双条件
+    hidden: false,
     title: 'dsh',
-    hidden: true,
     createElement: () => ({ style: {}, remove() {} }),
     body: { appendChild: () => {} },
     head: { appendChild: () => {} },
@@ -264,6 +265,8 @@ function makeSidebarDom(rows) {
       querySelector: (sel) => (sel.indexOf('_title') >= 0 ? leaf : null),
       querySelectorAll: (sel) => (sel.indexOf('_title') >= 0 ? [leaf] : []),
       children: [], classList: rowClassList,
+      clicks: 0,
+      click() { row.clicks += 1 },
     }
     Object.defineProperty(row, 'className', {
       get: () => [...rowClassList.set].join(' '),
@@ -291,6 +294,93 @@ function makeSidebarDom(rows) {
 
 const clickEventOn = (row) => ({ target: { closest: (sel) => (sel === '.tn-sess-hl' ? row : null) } })
 
+test('Given 冷启动存量通知带会话标题 When 静默对齐 Then 不呈现但行挂高亮', async () => {
+  // 冷启动对齐只静默通知呈现,未读会话闪烁是本机 UI 状态,不属轰炸,必须保留
+  const dom = makeSidebarDom([{ leafText: '会话甲' }])
+  const hlUnits = [
+    { id: 'u-cold', category: 'completed', text: '[dsh] 任务完成: 会话甲', session: '会话甲' },
+  ]
+  const { mod, shown } = loadClient({
+    storage: new FakeStorage(),
+    fetchImpl: async () => ({ ok: true, json: async () => ({ units: hlUnits, soundMapping: {}, version: 1 }) }),
+    document: { title: '会话乙 — DeepSeek Harness', ...dom },
+  })
+  await mod.__test.poll()
+  await mod.__test.poll()
+  assert.equal(shown.length, 0, '冷启动对齐不轰炸呈现')
+  assert.ok(dom.rows[0].classList.set.has('tn-sess-hl'), '静默对齐仍应挂未读会话高亮')
+  assert.ok(dom.rows[0].classList.set.has('tn-sess-hl--completed'), '冷启动高亮携带分类色')
+})
+
+test('Given 冷启动存量通知是当前查看的会话 When 静默对齐 Then 不挂高亮', async () => {
+  // 与正常路径同语义:正在查看即已读,不做未读强调
+  const dom = makeSidebarDom([{ leafText: '会话甲' }])
+  const hlUnits = [
+    { id: 'u-cold-cur', category: 'completed', text: '[dsh] 任务完成: 会话甲', session: '会话甲' },
+  ]
+  const { mod } = loadClient({
+    storage: new FakeStorage(),
+    fetchImpl: async () => ({ ok: true, json: async () => ({ units: hlUnits, soundMapping: {}, version: 1 }) }),
+    document: { title: '会话甲 — DeepSeek Harness', ...dom },
+  })
+  await mod.__test.poll()
+  await mod.__test.poll()
+  assert.equal(dom.rows[0].classList.set.has('tn-sess-hl'), false, '正在查看的会话冷启动也不挂高亮')
+})
+
+test('Given 高亮开关关闭且冷启动带存量通知 When 静默对齐 Then 不挂任何类', async () => {
+  const dom = makeSidebarDom([{ leafText: '会话甲' }])
+  const hlUnits = [
+    { id: 'u-off', category: 'completed', text: '[dsh] 任务完成: 会话甲', session: '会话甲' },
+  ]
+  const { mod } = loadClient({
+    storage: new FakeStorage({ 'turn-notify:session-hl': '0' }),
+    fetchImpl: async () => ({ ok: true, json: async () => ({ units: hlUnits, soundMapping: {}, version: 1 }) }),
+    document: { title: '会话乙 — DeepSeek Harness', ...dom },
+  })
+  await mod.__test.poll()
+  await mod.__test.poll()
+  assert.equal(dom.rows[0].classList.set.has('tn-sess-hl'), false, '开关关闭时冷启动也不挂高亮')
+})
+
+test('Given 冷启动存量超过高亮容量上限 When 静默对齐 Then 仅保留最新一批,最旧被淘汰', async () => {
+  const titles = Array.from({ length: 22 }, (unused, index) => '会话' + (index + 1))
+  const dom = makeSidebarDom(titles.map((leafText) => ({ leafText })))
+  const hlUnits = titles.map((title, index) => ({
+    id: 'u-cap-' + index, category: 'completed', text: '[dsh] 任务完成: ' + title, session: title,
+  }))
+  const { mod } = loadClient({
+    storage: new FakeStorage(),
+    fetchImpl: async () => ({ ok: true, json: async () => ({ units: hlUnits, soundMapping: {}, version: 1 }) }),
+    document: { title: 'dsh', ...dom },
+  })
+  await mod.__test.poll()
+  await mod.__test.poll()
+  assert.equal(dom.rows[0].classList.set.has('tn-sess-hl'), false, '最旧条目被淘汰')
+  assert.equal(dom.rows[1].classList.set.has('tn-sess-hl'), false, '最旧条目被淘汰')
+  assert.ok(dom.rows[2].classList.set.has('tn-sess-hl'), '上限内条目保留')
+  assert.ok(dom.rows[21].classList.set.has('tn-sess-hl'), '最新条目保留')
+})
+
+test('Given 冷启动标题未就绪误挂当前会话 When 标题就绪后任一应用帧 Then 自愈摘除', async () => {
+  // 首拉早于宿主设置 title 时,"正在看即已读"排除失效误挂;就绪后的应用帧复核自愈
+  const dom = makeSidebarDom([{ leafText: '会话甲' }])
+  const hlUnits = [
+    { id: 'u-race', category: 'completed', text: '[dsh] 任务完成: 会话甲', session: '会话甲' },
+  ]
+  const { mod, document: docStub } = loadClient({
+    storage: new FakeStorage(),
+    fetchImpl: async () => ({ ok: true, json: async () => ({ units: hlUnits, soundMapping: {}, version: 1 }) }),
+    document: { title: 'dsh', ...dom },
+  })
+  await mod.__test.poll()
+  await mod.__test.poll()
+  assert.equal(dom.rows[0].classList.set.has('tn-sess-hl'), true, '标题未就绪时误挂,复现竞态')
+  docStub.title = '会话甲 — DeepSeek Harness'
+  await mod.__test.poll()
+  assert.equal(dom.rows[0].classList.set.has('tn-sess-hl'), false, '标题就绪后应用帧自愈摘除')
+})
+
 test('Given 通知带 session 标题 When 认领 Then 会话行挂上高亮类', async () => {
   const dom = makeSidebarDom([{ leafText: '会话甲' }])
   const hlUnits = [
@@ -452,8 +542,81 @@ test('Given 通知标题字段缺失 When 认领 Then 不挂高亮类且链路
   assert.equal(dom.rows[0].classList.set.has('tn-sess-hl'), false)
 })
 
-test('Given 短标题先于长前缀行匹配 When 挂类 Then 短标题精确命中自身行', async () => {
-  // 长标题行在前,短标题是长标题的子串:短标题通知必须挂到全等行,不得被子串误吸
+// 点击直达:页内卡片 onClick 聚焦窗口并模拟点击侧边栏会话行(切换会话即已读);
+// 无标题通知只聚焦不点击
+test('Given 带标题通知 When 点击页内卡片 Then 聚焦窗口并点击会话行;无标题仅聚焦', async () => {
+  const dom = makeSidebarDom([{ leafText: '会话甲' }])
+  const hlUnits = [
+    { id: 'u-jump', category: 'completed', text: '[dsh] 任务完成: 会话甲', session: '会话甲', summary: '耗时 12 秒' },
+    { id: 'u-bare', category: 'error', text: '[dsh] 任务出错: 无标题' },
+  ]
+  const focuses = []
+  const { mod, shown, window: winStub } = loadClient({
+    storage: new FakeStorage(),
+    payload: { units: hlUnits, soundMapping: {}, version: 1 },
+    document: { title: '会话乙 — DeepSeek Harness', ...dom },
+  })
+  winStub.focus = () => { focuses.push('focus') }
+  await mod.__test.poll()
+  await mod.__test.poll()
+  assert.equal(shown.length, 2)
+  // 摘要随文本两行呈现
+  assert.ok(shown[0].text.includes('\n耗时 12 秒'), '卡片文本含小结行')
+  assert.equal(typeof shown[0].opts.onClick, 'function', '带标题通知携带直达回调')
+  assert.equal(typeof shown[1].opts.onClick, 'function', '无标题通知仍携带回调(仅聚焦)')
+  shown[0].opts.onClick()
+  assert.deepEqual(focuses, ['focus'], '直达先聚焦窗口')
+  assert.equal(dom.rows[0].clicks, 1, '模拟点击侧边栏会话行切换会话')
+  const clicksBefore = dom.rows[0].clicks
+  shown[1].opts.onClick()
+  assert.deepEqual(focuses, ['focus', 'focus'])
+  assert.equal(dom.rows[0].clicks, clicksBefore, '无标题通知不点击任何行')
+})
+
+// 二次提醒:等待用户动作的事件超时未处理补发一轮;已处理(点击行/切到会话)与投影过期不补
+test('Given 审批通知超时未处理 When 提醒到期 Then 补发一轮;已处理与投影过期不补', async () => {
+  const dom = makeSidebarDom([{ leafText: '会话甲' }, { leafText: '会话乙' }])
+  const hlUnits = [
+    { id: 'u-appr', category: 'approval', text: '[dsh] 等待审批: 会话甲', session: '会话甲' },
+    { id: 'u-done', category: 'completed', text: '[dsh] 任务完成: 会话乙', session: '会话乙' },
+  ]
+  const { mod, shown } = loadClient({
+    storage: new FakeStorage(),
+    payload: { units: hlUnits, soundMapping: {}, version: 1 },
+    document: { title: '会话乙 — DeepSeek Harness', ...dom },
+    shortTimers: false,
+  })
+  const { poll } = mod.__test
+  await poll()
+  await poll()
+  const before = shown.length
+  // 推进到提醒到期:approval 未读(高亮仍在)→ 补发;completed 非等待类从不登记
+  await new Promise((resolve) => setTimeout(resolve, 10))
+  assert.equal(shown.length, before, '提醒未到期不补发')
+})
+
+test('Given 审批提醒登记 When 单元过期(prune)Then 不再补发', async () => {
+  const dom = makeSidebarDom([{ leafText: '会话甲' }])
+  const hlUnits = [
+    { id: 'u-appr-gone', category: 'approval', text: '[dsh] 等待审批: 会话甲', session: '会话甲' },
+  ]
+  // 第二轮投影不再含该单元:prune 撤销登记
+  const { mod, shown } = loadClient({
+    storage: new FakeStorage(),
+    payload: { units: hlUnits, soundMapping: {}, version: 1 },
+    document: { title: '会话乙 — DeepSeek Harness', ...dom },
+  })
+  const { poll } = mod.__test
+  await poll()
+  await poll()
+  // 第三轮投影单元消失
+  mod.__test.pruneReminders(new Set())
+  const before = shown.length
+  await new Promise((resolve) => setTimeout(resolve, 10))
+  assert.equal(shown.length, before, '登记撤销后不补发')
+})
+
+test('Given 短标题先于长前缀行匹配 When 挂类 Then 短标题精确命中自身行', async () => {  // 长标题行在前,短标题是长标题的子串:短标题通知必须挂到全等行,不得被子串误吸
   const dom = makeSidebarDom([
     { leafText: '修复通知插件长轮询问题' },
     { leafText: '通知插件' },

package/test/parity.test.mjs

@@ -144,7 +144,7 @@ defineDeadScenarios('[core.mjs deadCustomIds] ', coreDeadCustomIds)
 defineDeadScenarios('[client.js deadCustomIds] ', client.deadCustomIds)
 
 // 四通道矩阵对照:client 版开关取自 localStorage,经 stub 注入后与 core 参数化版本逐场景比对。
-function clientChooseChannels({ hasFocus, permission, focusQuiet, toastEnabled, soundEnabled, soundCategories, category, systemEnabled, idleMs, idleThresholdMs, pageSoundEnabled, pageSoundCategories }) {
+function clientChooseChannels({ hasFocus, permission, focusQuiet, toastEnabled, soundEnabled, soundCategories, category, systemEnabled, idleMs, idleThresholdMs, pageSoundEnabled, pageSoundCategories, routes }) {
   const backing = new Map()
   if (focusQuiet === false) backing.set(client.KEY_DND, '0')
   if (systemEnabled === false) backing.set(client.KEY_SYSTEM, '0')
@@ -155,7 +155,7 @@ function clientChooseChannels({ hasFocus, permission, focusQuiet, toastEnabled,
   globalThis.window = { localStorage: { getItem: (key) => (backing.has(key) ? backing.get(key) : null) } }
   try {
     if (idleThresholdMs !== undefined) assert.equal(client.IDLE_AWAY_MS, idleThresholdMs)
-    return client.chooseChannels(hasFocus, permission, idleMs ?? undefined, soundCategories ?? null, category ?? null)
+    return client.chooseChannels(hasFocus, permission, idleMs ?? undefined, soundCategories ?? null, category ?? null, routes ?? null)
   } finally {
     delete globalThis.window
   }
@@ -196,6 +196,31 @@ function defineChannelScenarios(prefix, channels) {
     assert.equal(channels({ ...base, idleMs: 0 }).sound, false)
     assert.deepEqual(channels(base), { toast: true, sound: false, system: false, blink: false, pageSound: false })
   })
+  test(prefix + '事件→通道路由:放行名单叠加本机偏好,缺省全放行', () => {
+    const base = { hasFocus: false, permission: 'granted' }
+    // 未配置(null):全通道,与旧行为一致
+    assert.deepEqual(channels({ ...base, routes: null }), { toast: true, sound: true, system: true, blink: false, pageSound: false })
+    // 名单外通道一律不出
+    assert.deepEqual(
+      channels({ ...base, routes: ['webhook', 'im'] }),
+      { toast: false, sound: false, system: false, blink: false, pageSound: false },
+      '呈现通道全被路由排除',
+    )
+    assert.equal(channels({ ...base, routes: ['sound'] }).sound, true)
+    assert.equal(channels({ ...base, routes: ['sound', 'toast'] }).toast, true)
+    assert.equal(channels({ ...base, routes: ['toast'] }).sound, false, '名单外声音通道关闭')
+    // 空名单 = 全禁(显式配置)
+    assert.deepEqual(
+      channels({ ...base, routes: [] }),
+      { toast: false, sound: false, system: false, blink: false, pageSound: false },
+    )
+    // 路由与聚焦静默叠加:名单放行 + 聚焦静默仍压声音
+    assert.equal(channels({ ...base, hasFocus: true, routes: ['sound', 'system'] }).sound, false)
+    assert.equal(channels({ ...base, hasFocus: true, routes: ['sound', 'system'] }).system, false)
+    // 页内提示音随 toast 路由:toast 被排除即补位音不出
+    assert.equal(channels({ ...base, hasFocus: true, pageSoundEnabled: true, routes: ['toast'] }).pageSound, true)
+    assert.equal(channels({ ...base, hasFocus: true, pageSoundEnabled: true, routes: ['sound'] }).pageSound, false)
+  })
 }
 
 defineChannelScenarios('[core.mjs chooseChannels] ', coreChooseChannels)

package/test/route.test.mjs

@@ -199,6 +199,26 @@ test('config POST 非法 imTargets 400', async () => {
   assert.equal(res.status, 400)
 })
 
+test('config POST 持久化 kindRoutes 并回显面板状态,部分补丁不触碰其他配置', async () => {
+  const { ctx, routes } = makeCtx()
+  apply(ctx)
+  const handler = routes.get('/api/turn-notify/config')
+  const res = makeRes()
+  await handler(makeReq('POST', { kindRoutes: { completed: ['webhook'], approval: ['im', 'sound', 'system'] } }, JSON_HEADERS), res)
+  assert.equal(res.status, 200)
+  assert.deepEqual(res.body.kindRoutes, { completed: ['webhook'], approval: ['im', 'sound', 'system'] })
+  const readback = makeRes()
+  await handler(makeReq('GET'), readback)
+  assert.deepEqual(readback.body.kindRoutes, { completed: ['webhook'], approval: ['im', 'sound', 'system'] })
+  // 部分补丁按分类合并进已存路由(与 enabled 同语义):新键并入,既有键不动
+  const patch = makeRes()
+  await handler(makeReq('POST', { kindRoutes: { ask: [] } }, JSON_HEADERS), patch)
+  assert.equal(patch.status, 200)
+  const final = makeRes()
+  await handler(makeReq('GET'), final)
+  assert.deepEqual(final.body.kindRoutes, { completed: ['webhook'], approval: ['im', 'sound', 'system'], ask: [] })
+})
+
 test('config POST 仅 imTargets 的部分补丁:不触碰其他配置项,响应含完整面板状态', async () => {
   // 勾选即存契约:面板勾选/取消注册只 POST {imTargets},不得清掉已存的 webhook 与分类开关
   const dshIm = { send: async () => ({ sent: true }), listTargets: async () => [] }