@mzzsfy/dsh-turn-notify 0.9.0 → 0.11.0

package/README.md

@@ -1,6 +1,6 @@
 # @mzzsfy/dsh-turn-notify
 
-DeepSeek Harness 消息通知插件:AI 回合产生六类事件(完成/出错/被中断/等待审批/AI 提问/达到上限),按你的配置送达声音、系统弹窗、页内提示、webhook、IM 五种通道,多窗口只响一次。
+DeepSeek Harness 消息通知插件:AI 回合产生六类事件(完成/出错/被中断/等待审批/AI 提问/达到上限),按你的配置送达声音、系统弹窗、页内提示、webhook、IM、宿主桌面通知六种通道,多窗口只响一次。
 
 ## 快速上手
 
@@ -8,7 +8,7 @@ DeepSeek Harness 消息通知插件:AI 回合产生六类事件(完成/出错/
 dsh plugin --profile web add @mzzsfy/dsh-turn-notify
 ```
 
-安装后打开 设置 > 消息通知:默认全部事件开启,声音与系统弹窗即装即用(系统弹窗经一次浏览器授权后生效);webhook 与 IM 填配置后启用。页内提示经公共依赖 @mzzsfy/dsh-toast 提供,由 session-manager 插件代挂装载——未安装 session-manager 时该通道自动禁用,其余通道不受影响。声音通道受浏览器自动播放策略约束,首次点击页面后才会出声。想推到微信等聊天工具,见 [IM 推送](#im-推送);想推到自建服务,见 [webhook 推送](#webhook-推送)。
+安装后打开 设置 > 消息通知:默认全部事件开启,声音与系统弹窗即装即用(系统弹窗经一次浏览器授权后生效);webhook、IM 与宿主桌面通知填配置后启用。页内提示经公共依赖 @mzzsfy/dsh-toast 提供,由 session-manager 插件代挂装载——未安装 session-manager 时该通道自动禁用,其余通道不受影响。声音通道受浏览器自动播放策略约束,首次点击页面后才会出声。想推到微信等聊天工具,见 [IM 推送](#im-推送);想推到自建服务,见 [webhook 推送](#webhook-推送);想在宿主机桌面弹系统通知(浏览器全关也送达),见 [宿主桌面通知](#宿主桌面通知)。
 
 ## 六类通知事件
 
@@ -65,7 +65,7 @@ dsh plugin --profile web add @mzzsfy/dsh-turn-notify
 
 ## 事件→通道路由
 
-六类事件各自可指定放行通道名单(kindRoutes,存 settings.yaml),名单外的通道对该类事件一律不送达;未配置的分类全通道放行,名单为空数组即全禁。通道名:`sound`(提示音)/ `system`(系统弹窗)/ `toast`(页内提示,页内提示音随行)/ `blink`(降级标题闪烁)/ `webhook` / `im`。典型用法:任务完成只推 webhook,重要事件(审批/提问)走 IM:
+六类事件各自可指定放行通道名单(kindRoutes,存 settings.yaml),名单外的通道对该类事件一律不送达;未配置的分类全通道放行,名单为空数组即全禁。通道名:`sound`(提示音)/ `system`(系统弹窗)/ `toast`(页内提示,页内提示音随行)/ `blink`(降级标题闪烁)/ `webhook` / `im` / `host`(宿主桌面通知)。典型用法:任务完成只推 webhook,重要事件(审批/提问)走 IM:
 
 ```yaml
 turn-notify:
@@ -80,6 +80,15 @@ turn-notify:
 
 在面板填入 webhook URL 即启用。host 直发,标签页全关也送达;payload 为 Slack 兼容 JSON(text 字段承载通知文本,summary 字段承载通知小结),另附 event/category/status/session/workspace/durationMs/tokens/ts 结构化字段;超时 10 秒,不重试。URL 原文随配置响应回显、保存即提交输入框内容(清空并保存即禁用),测试按钮返回真实投递结果。
 
+## 宿主桌面通知
+
+开启面板"通知"页的宿主通知开关后,通知触发时由宿主进程直接弹操作系统级桌面通知,零依赖:macOS 走 osascript,Linux 走 notify-send,Windows 走 PowerShell 调 WinRT toast;超时 10 秒,失败即弃不重试,不影响其余通道。去重方向为**浏览器优先**:本机浏览器在场(2 秒内有在途长轮询)时由浏览器呈现,宿主让位,正常路径同机零重复;本机浏览器离场(标签页全关或仅远程浏览器在线)时宿主补位。重复只发生在在场判定的边界情况(认可窗口边界与网络抖动),宁可重复不可漏。两个开关判定一致,任一开启即生效:
+
+- **宿主机弹桌面通知**:启用宿主通知通道(浏览器优先去重内建)。
+- **仅当本机无浏览器接收时补位**:与总开关等效,作为显式的补位语义表达保留。
+
+"本机浏览器在场"按投影长轮询记账:回环来源 + 续传 cursor + 同源形态的 GET 在服务端挂起期间计为在途,断连(标签页关闭/请求中止)经连接关闭事件即时出账,最近活动在 2 秒认可窗口内仍算在场——优雅断连的盲区不超过 2 秒;异常断连(睡眠、强杀、断网)服务端无感知,受长轮询挂起上限约束,最坏约 25 秒后自愈出账。浏览器在场但本机呈现偏好全关(声音/弹窗/页内全关或系统通知未授权)时,宿主同样让位,该事件本机无 OS 级通知(仅剩会话行高亮)。宿主在无桌面的服务器上时 spawn 会静默失败,无害;测试页"测试宿主通知"返回真实结果,可据此验证宿主机桌面环境是否可用。聚焦时宿主通知照弹(宿主无法感知窗口焦点,聚焦静默是浏览器侧偏好)。
+
 ## IM 推送
 
 安装 [@xmanrui/dsh-im](https://www.npmjs.com/package/@xmanrui/dsh-im) 后自动启用,可推送到微信等九种渠道。投递目标的新建与平台测试在 dsh-im 设置页完成,本插件只做选择:从已绑 bot 的目标目录勾选即保存,支持绑定多个 bot。触发逻辑与 webhook 一致,fire-and-forget 不重试;bot 离线时该次通知弃置不补发。
@@ -88,6 +97,10 @@ turn-notify:
 
 通知实际送达时,侧边栏会话列表中对应会话行以背景脉冲闪烁强调,六类各一色(完成绿/出错红/提问蓝/中断橙/审批黄/上限紫),点击该会话行即停止。开关在面板"偏好"页首项(独立开关,本机生效,各浏览器独立),默认开启。并行多会话时用于快速定位状态刚更新的会话:运行中的会话不闪烁(与 dsh 原生状态点分工——状态点表达运行中,闪烁表达已更新待查看),会话重新进入运行状态时闪烁自动让位;聚焦时正在查看的会话不闪烁,失焦期间本会话的通知照常闪烁,返回窗口即自动消失(回来即已读,焦点与页面可见双通道)。行定位按会话标题文本匹配,标题默认与侧边栏行同源(session-title 投影);该服务缺失或不可用(如伪会话无事件日志)时回落会话事件内存储的标题,可能与侧边栏不同步。会话行未渲染(列表折叠/懒加载未滚动到)时该次高亮静默跳过。重开页面的冷启动静默对齐同样挂高亮(见"多窗口只响一次"),重开即见哪些会话有动静。
 
+## 工作区文件夹运行标记
+
+侧边栏会话列表按工作区分组(官方 WorkspaceBrowser 分组模式)时,有运行中会话的工作区文件夹组头显示脉冲运行点并给文件夹图标着色,游离(未归属任何工作区)的可见运行中会话使末位「未分组」组头同样标记——折叠与展开同样生效。归属与运行态一律取服务快照投影,DOM 仅按下标对位官方组容器;组容器数漂移(单列表模式/搜索态/结构变更)即清除标记不误标。图标着色让位官方 folderActive(展开且含当前会话)态。开关在面板"偏好"页"会话列表"卡(存宿主配置,各浏览器共用),默认开启,变更刷新页面生效。
+
 ## 多窗口只响一次
 
 同一地址(同源)打开的多个窗口共享一次呈现:各窗口以长轮询挂起在 host 的通知队列上(事件产生或配置变更即时返回,空闲期单次挂起至多数十秒,失败按指数退避重连),经 localStorage 协调,仅一个窗口抢先呈现——发声并弹出页内提示、系统弹窗、高亮会话行,其余窗口全部跳过,不止声音。通知在产生后的下一次唤醒即送达,通常亚秒级;不同浏览器或不同地址打开的窗口各自发声互不感知。窗口关闭/刷新期间错过的通知不做重开回放:启动首轮静默对齐游标与完成标记,不逐条补发提示与声音(等待用户动作的审批与提问例外,照常呈现);未读会话行高亮不在静默范围,照常挂上。
@@ -98,11 +111,11 @@ turn-notify:
 
 | 分区 | 内容 |
 |------|------|
-| 通知 | webhook 地址、最短回合时长、子代理过滤、六类事件开关;存 settings.yaml,事件开关点击即存,其余点保存后生效。事件→通道路由(kindRoutes)亦存此命名空间,经 yaml 配置 |
+| 通知 | webhook 地址、最短回合时长、子代理过滤、宿主通知(总开关与回退)、六类事件开关;存 settings.yaml,事件开关点击即存,其余点保存后生效。事件→通道路由(kindRoutes)亦存此命名空间,经 yaml 配置 |
 | 偏好 | 本机浏览器记忆的设置:会话高亮(独立开关)、声音总开关与分类静音、音量、系统弹窗与授权、页内提示开关、页内提示音(总开关 + 分类独立开关)、聚焦静默、降级标题闪烁 |
 | 音效 | 音效上传/试听/重命名/删除,六类事件的音效映射与双作用域开关,页内提示音映射(本机,未配置沿用通知音效) |
 | IM | 绑定 dsh-im bot、勾选投递目标(仅装了 dsh-im 时显示) |
-| 测试 | 声音/页内/系统/webhook/IM 逐通道点火,回执即真实结果 |
+| 测试 | 声音/页内/系统/宿主/webhook/IM 逐通道点火,回执即真实结果 |
 
 ## settings.yaml 参考
 
@@ -114,6 +127,8 @@ turn-notify:
   minTurnDurationMs: 5000         # 最短回合时长(毫秒),回合结束类通知短于此不送达
   rootsOnly: true                 # 子代理会话不通知
   suppressSubagentWake: true      # 子代理相关回合不通知:后台委托未收尾或收尾唤醒(仅任务完成类)
+  hostNotify: false               # 宿主机桌面通知总开关;浏览器优先,本机浏览器在场(2 秒内有在途长轮询)时让位
+  hostNotifyFallback: false       # 宿主通知补位:本机浏览器离场(2 秒内无在途长轮询)时弹宿主桌面通知,与总开关判定一致
   enabled:                        # 六类事件独立开关
     completed: true
     error: true
@@ -138,13 +153,14 @@ turn-notify:
 
 1. **事件监听**:host 观察 `session/event`(回合结束、ask_user_question 工具调用与 assistant 消息)与 `approval/request` 审批请求(只观察,不拦截)。回合结束原因逐一映射:正常结束归任务完成,错误与手动停止归任务出错,审批拦截归等待审批,输出触顶归达到上限,会话收尾补发的中断归被中断;assistant 消息流经途累积回合小结(tokens 与回答前缀),回合结束随通知消费。
 2. **分类与过滤**:事件归入六类,经子代理会话、子代理相关静默(仅任务完成类)、最短回合时长三道过滤,通过即产生一条通知,并按 kindRoutes 裁定放行通道。
-3. **host 直发通道**:webhook 与 IM 由 host 进程直接投递(经路由名单过滤),不依赖浏览器;同时通知写入内存队列(环形 20 条,60 秒过期,不落盘),路由名单随单元下发。
+3. **host 直发通道**:webhook、IM 与宿主桌面通知由 host 进程直接投递(经路由名单过滤),不依赖浏览器;宿主通知按本机(回环来源)浏览器在场(在途长轮询)浏览器优先去重,离场补位;同时通知写入内存队列(环形 20 条,60 秒过期,不落盘),路由名单随单元下发。
 4. **浏览器通道**:各窗口以长轮询挂起在该队列上(cursor 续传,事件与配置变更即时唤醒,空闲期单次挂起至多数十秒,失败指数退避重连),localStorage 协调保证同一通知只有一个窗口呈现,再按本机偏好与路由名单分发到声音/系统弹窗/页内提示;等待用户动作的审批与提问超时未处理时补发一轮提醒。
 5. **降级链**:声音通道开启而系统弹窗不可用(HTTP 非回环、未授权)→ 标题闪烁;页内提示依赖缺失 → 干净禁用该通道;localStorage 不可用 → 该窗口直接发声(可能与多窗口重复,诚实降级)。
 
 ## 已知取舍
 
-- 标签页全关时,仅 webhook 与 IM 送达(声音与弹窗的浏览器前提)。
+- 标签页全关时,仅 webhook、IM 与宿主桌面通知(如开启)送达(声音与弹窗的浏览器前提)。
+- 宿主桌面通知为浏览器优先去重:本机浏览器在场(2 秒内有在途长轮询)时宿主让位,边界情况(认可窗口边界、网络抖动、反代致来源恒为回环而恒判在场)宁可不弹不误弹,优雅断连的离场盲区不超过 2 秒,异常断连受长轮询挂起上限约束(最坏约 25 秒);聚焦时宿主通知照弹(宿主无法感知窗口焦点);无桌面的宿主上 spawn 静默失败,无害。在场记账的形态校验(回环 + 续传 cursor + 同源)为启发式,防无意探活误压制与网页伪造在场(DNS rebinding 将域解析至回环的页面同源可过校验,但该页面同时已握有全部写配置 API,通知压制非最大损失面),不构成对抗本机进程的安全边界。
 - IM 依赖 dsh-im 的 bot 在线,离线时该次通知弃置不补发;成功回执仅代表平台受理。
 - 不同浏览器或不同地址打开的窗口各自发声,互不去重。
 - 系统弹窗在 HTTP 非回环下永久降级,HTTPS 化后自动恢复;Windows 下受系统通知设置与专注助手约束。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mzzsfy/dsh-turn-notify",
-  "description": "消息通知:六类回合事件送达声音、系统弹窗、页内提示、webhook 与 IM;内置八种合成音色,自定义音效,按事件分类指定;多窗口只响一次",
-  "version": "0.9.0",
+  "description": "消息通知:六类回合事件送达声音、系统弹窗、页内提示、webhook、IM 与宿主桌面通知;内置八种合成音色,自定义音效,按事件分类指定;多窗口只响一次",
+  "version": "0.11.0",
   "type": "module",
   "main": "src/index.js",
   "exports": {

package/src/client.js

@@ -35,9 +35,9 @@ window.__ModuleLoader__.load({
     // 显示回执等待上限:超时未回执按环境层拦截给出诊断
     const SYSTEM_SHOW_TIMEOUT_MS = 3 * 1000
 
-    // 导航图标声明:交给 dsh-settings-nav-icons 统一渲染(本插件分区 → bell);
-    // 该插件未就绪时入队,由其启动时排空
-    const NAV_ICON = { '消息通知': 'bell' }
+    // 导航图标声明:交给 dsh-settings-nav-icons 统一渲染;双键 = 分区 label + 市场
+    // 短名(发现页收录显示形态);该插件未就绪时入队,由其启动时排空
+    const NAV_ICON = { '消息通知': 'bell', 'dsh-turn-notify': 'bell' }
     if (window.__navicIcons !== undefined) window.__navicIcons.register(NAV_ICON)
     else if (Array.isArray(window.__navicIconQueue)) window.__navicIconQueue.push(NAV_ICON)
     else window.__navicIconQueue = [NAV_ICON]
@@ -277,7 +277,8 @@ window.__ModuleLoader__.load({
     // 放入 LOGIC 段由 parity 测试保证双实现不漂移
     const IDLE_AWAY_MS = 5 * 60 * 1000
 
-    // routes 为事件→通道路由放行名单(null=未配置全放行),语义与 core 同源
+    // 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
@@ -863,6 +864,55 @@ window.__ModuleLoader__.load({
       row.className = row.className.split(' ').filter((name) => name !== SESSION_HL_CLASS && name.indexOf(SESSION_HL_CLASS + '--') !== 0).join(' ')
     }
 
+    // ---- 工作区文件夹运行标记 ----
+
+    // 官方组容器 CSS module 类名后缀(哈希前缀随构建漂移,后缀稳定)与自家标记属性;
+    // 扫描合并窗口覆盖聊天流式输出的高频 DOM mutation
+    const FOLD_SECTION_SELECTOR = 'div[class$="_groupSection"]'
+    const FOLD_RUNNING_FLAG = 'data-tn-folder-running'
+    const FOLD_SCAN_DELAY_MS = 50
+
+    // 运行标记状态:官方 dsh-client-ui-workspace 分组语义的投影——
+    // 归属走 workspace 账本 sessionIds 一级映射(官方 owningGroupKey 同构,无 cwd 回退),
+    // 游离会话入末位未分组桶;可见性镜像官方 sessionVisible(subagent / 已归档 /
+    // 空白且非当前排除),组内任一可见会话 running 即该工作区运行中。
+    // ids 保工作区登记序(官方组渲染序 = 快照 items 序),供 DOM 组容器按下标对位
+    function folderRunningState(sessionsState, workspacesState) {
+      const byId = (sessionsState && sessionsState.byId) || {}
+      const ids = (sessionsState && sessionsState.ids) || []
+      const current = sessionsState ? sessionsState.current : undefined
+      const workspaces = workspacesState && Array.isArray(workspacesState.items) ? workspacesState.items : []
+      const archived = new Set((workspacesState && workspacesState.archivedSessionIds) || [])
+      const visible = (row) => Boolean(row)
+        && row.origin !== 'subagent'
+        && !archived.has(row.id)
+        && (!row.blank || row.id === current)
+      const running = new Set()
+      const accounted = new Set()
+      const workspaceIds = []
+      for (const workspace of workspaces) {
+        // 主键不做防御过滤,与官方 groupByWorkspace 同构:items 长度即组容器对位基准,
+        // 过滤会让 ids 短于容器数,恰差一时错位成「末位未分组桶」对位
+        workspaceIds.push(workspace.workspaceId)
+        const sessionIds = Array.isArray(workspace.sessionIds) ? workspace.sessionIds : []
+        for (const sessionId of sessionIds) {
+          const row = byId[sessionId]
+          if (!row) continue
+          accounted.add(sessionId)
+          if (row.running && visible(row)) running.add(workspace.workspaceId)
+        }
+      }
+      let ungrouped = false
+      for (const sessionId of ids) {
+        if (accounted.has(sessionId)) continue
+        const row = byId[sessionId]
+        if (row && row.running && visible(row)) ungrouped = true
+      }
+      return { ids: workspaceIds, running, ungrouped }
+    }
+
+    const FOLD_SWITCH_TITLE = '侧边栏会话列表按工作区分组时,有运行中会话的文件夹组头显示运行点并给文件夹图标着色,文件夹折叠与展开同样生效;游离会话所在的「未分组」组同样标记;单列表模式下无此标记。停用即全部隐藏,刷新页面生效。'
+
     // ---- 点击直达会话:页内卡片与系统弹窗共用 ----
 
     // 按通知单元激活会话:聚焦窗口并模拟点击侧边栏会话行(官方行点击即切换会话);
@@ -1016,6 +1066,9 @@ window.__ModuleLoader__.load({
       minTurnDurationMs: 5 * 1000,
       rootsOnly: true,
       suppressSubagentWake: true,
+      hostNotify: false,
+      hostNotifyFallback: false,
+      folderRunningEnabled: true,
       enabled: Object.fromEntries(CATEGORIES.map((key) => [key, true])),
       imTargets: [],
     }
@@ -1133,6 +1186,18 @@ window.__ModuleLoader__.load({
       '@media (prefers-reduced-motion: reduce) {',
       '  .tn-sess-hl { animation:none; background-color:color-mix(in srgb, var(--tn-sess-color, #4c8dff) 50%, var(--dsw-alias-bg-base, #202020) 50%); }',
       '}',
+      // 工作区文件夹运行标记:官方组容器自带 position:relative,运行点绝对定位于
+      // 组容器左缘、垂直对齐组头行中线(行高 34px 之半即 top 17px,落于组头行左内边距
+      // 区),零布局位移;图标着色让位官方 folderActive(展开含当前)态;色值取官方
+      // ongoing 运行点的实际色值(--dsh-state-ongoing 在官方仅定义于其状态点组件局部,
+      // 组容器上下文读不到,直接引用其回退源)
+      'div[class$="_groupSection"][data-tn-folder-running] { --tn-fold-running-color: var(--dsw-static-deepseek-450); }',
+      'div[class$="_groupSection"][data-tn-folder-running]::before { content:""; position:absolute; left:0; top:17px; width:5px; height:5px;',
+      '  margin-top:-2.5px; border-radius:999px; background:var(--tn-fold-running-color);',
+      '  animation:tn-fold-running-pulse 1.2s ease-in-out infinite; }',
+      'div[class$="_groupSection"][data-tn-folder-running] span[class$="_folder"]:not([class$="_folderActive"]) { color:var(--tn-fold-running-color); }',
+      '@keyframes tn-fold-running-pulse { 0%, 100% { opacity:1; } 50% { opacity:.35; } }',
+      '@media (prefers-reduced-motion: reduce) { div[class$="_groupSection"][data-tn-folder-running]::before { animation:none; } }',
     ].join('\n')
 
     function h(type, props) {
@@ -1368,7 +1433,7 @@ window.__ModuleLoader__.load({
           if (raw.length === 0) throw new Error('最短回合时长不能为空')
           const trimmedUrl = urlDraft.trim()
           // 所见即所存:输入框即配置值,清空并保存即禁用 webhook 通道
-          const patchBody = { webhookUrl: trimmedUrl, minTurnDurationMs: Number(raw), rootsOnly: config.rootsOnly, suppressSubagentWake: config.suppressSubagentWake }
+          const patchBody = { webhookUrl: trimmedUrl, minTurnDurationMs: Number(raw), rootsOnly: config.rootsOnly, suppressSubagentWake: config.suppressSubagentWake, hostNotify: config.hostNotify, hostNotifyFallback: config.hostNotifyFallback }
           const res = await api('/api/turn-notify/config', { method: 'POST', body: JSON.stringify(patchBody) })
           setConfig({ ...DEFAULT_CONFIG, ...res })
           if (res.soundMapping) setMappingState(res.soundMapping)
@@ -1405,6 +1470,21 @@ window.__ModuleLoader__.load({
         })
       }
 
+      // 文件夹运行标记开关:乐观回填,服务端失败回滚;变更刷新页面生效(标记
+      // 注入在插件激活时按配置装配)
+      async function toggleFolderRunning(checked) {
+        const previous = config.folderRunningEnabled
+        setConfig({ ...config, folderRunningEnabled: checked })
+        try {
+          const res = await api('/api/turn-notify/config', { method: 'POST', body: JSON.stringify({ folderRunningEnabled: checked }) })
+          setConfig({ ...DEFAULT_CONFIG, ...res })
+          patch('工作区文件夹运行标记已' + (res.folderRunningEnabled !== false ? '启用' : '停用') + ',刷新页面后生效')
+        } catch (error) {
+          setConfig((prev) => ({ ...prev, folderRunningEnabled: previous }))
+          patch('切换失败:' + (error && error.message ? error.message : String(error)), 'error')
+        }
+      }
+
       async function requestPermission() {
         try {
           const next = await Notification.requestPermission()
@@ -1465,6 +1545,16 @@ window.__ModuleLoader__.load({
         }, SYSTEM_TEST_DELAY_MS)
       }
 
+      // 宿主桌面通知通道单独测试:等待 spawn 结束,真实结果随响应返回
+      async function testHostNotify() {
+        try {
+          const result = await api('/api/turn-notify/test-host', { method: 'POST' })
+          patch(result.ok ? '宿主通知已触发(' + result.detail + ')' : '宿主通知失败:' + result.detail, result.ok ? 'ok' : 'error')
+        } catch (error) {
+          patch('发送失败:' + (error && error.message ? error.message : String(error)), 'error')
+        }
+      }
+
       async function testWebhook() {
         // 草稿与已保存值不同即存在未保存改动,测试的只能是已保存配置
         if (urlDraft.trim() !== String(config.webhookUrl || '').trim()) {
@@ -1611,7 +1701,7 @@ window.__ModuleLoader__.load({
       return h('div', { className: 'tn-panel' },
         h('div', { className: 'tn-head' },
           h('span', { className: 'tn-head__title' }, '消息通知'),
-          h('span', { className: 'tn-head__hint' }, '保存即生效;标签页全关时仅 webhook 与 IM 送达'),
+          h('span', { className: 'tn-head__hint' }, '保存即生效;标签页全关时仅 webhook、IM 与宿主通知(如开启)送达'),
         ),
         h('div', { className: 'tn-tabs', role: 'tablist' },
           tabs.map((item) => h('button', {
@@ -1664,6 +1754,20 @@ window.__ModuleLoader__.load({
                 }),
                 ' 后台委托未收尾或收尾唤醒的回合不通知(仅完成类)'),
             ]),
+            field('宿主通知', [
+              h('label', { className: 'tn-meta tn-switch', title: '通知触发时由宿主进程弹系统级桌面通知(osascript/notify-send/PowerShell toast);浏览器优先:本机有浏览器窗口在线(2 秒内有在途长轮询)时由浏览器呈现,宿主不重复弹;本机无浏览器(标签页全关或仅远程浏览器)时宿主弹' },
+                ...switchToggle({
+                  checked: config.hostNotify,
+                  onChange: (e) => setConfig({ ...config, hostNotify: e.target.checked }),
+                }),
+                ' 宿主机弹桌面通知'),
+              h('label', { className: 'tn-meta tn-switch', title: '本机浏览器在场(2 秒内有在途长轮询)时由浏览器呈现,离场时宿主补位桌面通知;与总开关判定一致,任一开启即生效' },
+                ...switchToggle({
+                  checked: config.hostNotifyFallback,
+                  onChange: (e) => setConfig({ ...config, hostNotifyFallback: e.target.checked }),
+                }),
+                ' 仅当本机无浏览器接收时补位'),
+            ], '由宿主进程直接弹 OS 桌面通知,服务器/浏览器全关场景可达;浏览器优先——本机浏览器在线时由浏览器呈现,宿主不重复弹,离场(2 秒内无在途长轮询)时宿主补位,边界情况(窗口边界与网络抖动)宁重复不漏。需点保存生效,测试页可逐条点火验证。'),
             field('事件分类', h('div', { className: 'tn-pills' },
               CATEGORIES.map((category) => h('span', {
                 className: 'tn-pill' + (config.enabled[category] ? ' tn-pill--on' : ''),
@@ -1767,6 +1871,20 @@ window.__ModuleLoader__.load({
                 ' 弹窗不可用时以标题闪烁替代'),
             ]),
           ) : null,
+          activeTab === '偏好' ? h('div', { className: 'tn-card' },
+            h('div', { className: 'tn-card__head' },
+              h('span', { className: 'tn-card__title' }, '会话列表'),
+              h('span', { className: 'tn-card__sub' }, '存宿主配置,各浏览器共用'),
+            ),
+            field('运行标记', [
+              h('label', { className: 'tn-meta tn-switch', title: FOLD_SWITCH_TITLE },
+                ...switchToggle({
+                  checked: config.folderRunningEnabled !== false,
+                  onChange: (e) => void toggleFolderRunning(e.target.checked),
+                }),
+                ' 有运行中会话的文件夹显示运行点'),
+            ], '侧边栏按工作区分组时,运行中的文件夹组头显示脉冲运行点并给图标着色,折叠与展开同样生效;变更刷新页面生效。'),
+          ) : null,
           activeTab === '音效' ? [
             h('div', { className: 'tn-card' },
               h('div', { className: 'tn-card__head' },
@@ -1964,6 +2082,7 @@ window.__ModuleLoader__.load({
               }, '测试声音'),
               h('button', { className: 'tn-btn', title: '弹出一条页内卡片;页内提示音已开启时随卡片补一声(点火测试,不经分类静音约束)', onClick: testPageNotification }, '测试页内通知'),
               h('button', { className: 'tn-btn', title: '弹一条系统通知验证授权与送达;未授权会先引导授权', onClick: testSystemNotification }, '测试系统通知'),
+              h('button', { className: 'tn-btn', title: '由宿主进程弹一条系统级桌面通知(osascript/notify-send/PowerShell toast),验证宿主通道可用性;弹在宿主所在机器', onClick: () => void testHostNotify() }, '测试宿主通知'),
               h('button', { className: 'tn-btn', title: '向已配置的 webhook 发送真实测试事件,回执显示投递结果;未配置时提示失败', onClick: () => void testWebhook() }, '测试 webhook'),
               config.imAvailable ? h('button', { className: 'tn-btn', disabled: busy, title: '向全部已配置目标发送真实测试事件,逐目标显示结果', onClick: () => void testIm() }, '测试 IM 通知') : null,
             ),
@@ -1973,17 +2092,95 @@ window.__ModuleLoader__.load({
     }
 
     return {
-      inject: ['slots'],
+      inject: ['slots', 'sessions', 'workspaces'],
       apply(ctx) {
+        const sessions = ctx.get('sessions')
+        const workspaces = ctx.get('workspaces')
         // 样式挂载宿主文档级:通知栈在面板未打开时也要有完整样式
         ctx.effect(() => {
           const style = document.createElement('style')
+          // 自带 data-plugin:缺失时宿主 claimStyles 会把它归属给后续材质化插件,其 HMR 重建即误删
+          style.setAttribute('data-plugin', '@mzzsfy/dsh-turn-notify')
           style.textContent = CSS
           document.head.appendChild(style)
           return () => style.remove()
         }, 'turn-notify styles')
         // 激活即轮询:通知链路不依赖设置面板是否打开过
         start()
+        // 工作区文件夹运行标记:服务快照投影 + DOM 组容器下标对位,状态变化经
+        // 订阅与 DOM 变更(合并窗口)双通道驱动;开关读宿主配置,变更刷新页面生效
+        let foldEnabled = null
+        ctx.effect(() => {
+          if (typeof MutationObserver === 'undefined' || typeof document.querySelectorAll !== 'function') return
+          let disposed = false
+          let timer = null
+          function clearAll() {
+            document.querySelectorAll('[' + FOLD_RUNNING_FLAG + ']').forEach((section) => {
+              section.removeAttribute(FOLD_RUNNING_FLAG)
+            })
+          }
+          function scan() {
+            const sections = document.querySelectorAll(FOLD_SECTION_SELECTOR)
+            if (sections.length === 0) {
+              clearAll()
+              return
+            }
+            // 开关未决时仅清除:终态正确且停用用户刷新页面不闪现标记
+            if (foldEnabled === null) {
+              clearAll()
+              return
+            }
+            const state = foldEnabled
+              ? folderRunningState(sessions.list.getSnapshot(), workspaces.list.getSnapshot())
+              : { ids: [], running: new Set(), ungrouped: false }
+            const expected = state.ids.length
+            // 数量不变量:组容器数 = 工作区数 或 工作区数+1(末位未分组桶);
+            // 漂移(单列表模式 / 搜索态 / 官方结构变更)即清除标记,不误标
+            const ungroupedLast = sections.length === expected + 1
+            if (sections.length !== expected && !ungroupedLast) {
+              clearAll()
+              return
+            }
+            sections.forEach((section, index) => {
+              const running = index < expected ? state.running.has(state.ids[index]) : ungroupedLast && state.ungrouped
+              // 同值跳过:流式输出期间扫描高频,重复写属性触发无谓的 CSS 重匹配
+              if (running === section.hasAttribute(FOLD_RUNNING_FLAG)) return
+              if (running) section.setAttribute(FOLD_RUNNING_FLAG, '')
+              else section.removeAttribute(FOLD_RUNNING_FLAG)
+            })
+          }
+          let scheduled = false
+          const schedule = () => {
+            if (disposed || scheduled) return
+            scheduled = true
+            timer = setTimeout(() => {
+              scheduled = false
+              timer = null
+              if (!disposed) scan()
+            }, FOLD_SCAN_DELAY_MS)
+          }
+          api('/api/turn-notify/config')
+            .then((payload) => {
+              foldEnabled = payload ? payload.folderRunningEnabled !== false : true
+            })
+            .catch(() => {
+              foldEnabled = true
+            })
+            .finally(schedule)
+          const unsubscribeSessions = sessions.list.subscribe(schedule)
+          const unsubscribeWorkspaces = workspaces.list.subscribe(schedule)
+          const observer = new MutationObserver(schedule)
+          observer.observe(document.documentElement, { childList: true, subtree: true })
+          schedule()
+          return () => {
+            disposed = true
+            if (timer !== null) clearTimeout(timer)
+            observer.disconnect()
+            unsubscribeSessions()
+            unsubscribeWorkspaces()
+            clearAll()
+          }
+        }, 'turn-notify folder running mark')
         ctx.slots.inject('settings.section', () =>
           ctx.slots.register(
             { name: 'settings.section', id: 'turn-notify', order: 41, label: '消息通知' },

package/src/core.mjs

@@ -283,8 +283,8 @@ 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']
+// (webhook/im/host)由 host 侧过滤,投影单元携带 routes 供浏览器侧过滤呈现通道。
+export const CHANNELS = ['sound', 'system', 'toast', 'blink', 'webhook', 'im', 'host']
 
 // 发声通道判定:页内提示、提示音与系统弹窗各自独立开关,聚焦静默仅压声音与系统弹窗;
 // 提示音另受分类配置约束:soundCategories 中该分类显式 false 即静音,缺省键与空分类放行。
@@ -496,6 +496,106 @@ export async function sendWebhook({ url, payload, fetchImpl = fetch }) {
 
 const CONFIG_WEBHOOK_SCHEMES = ['http:', 'https:']
 
+// 宿主桌面通知 spawn 超时:与 webhook 同语义,超时强杀不重试
+export const HOST_NOTIFY_TIMEOUT_MS = 10 * 1000
+
+// 回环判定:IPv6 环回、IPv4 环回与 IPv4 映射形态的 IPv4 环回;空与非法为假。
+// 回环来源的浏览器窗口即与宿主同机,是本机去重的判定依据
+export function isLoopbackAddress(address) {
+  if (typeof address !== 'string' || address.length === 0) return false
+  return address === '::1' || address.startsWith('127.') || address.startsWith('::ffff:127.')
+}
+
+// 宿主通知决策:浏览器优先——本机浏览器在场由浏览器呈现,宿主让位(正常路径
+// 零重复);离场由宿主补位。重复只发生在在场判定的边界情况(认可窗口边界与
+// 网络抖动),宁可重复不可漏。两开关均关不弹,任一开启即启用该通道。
+export function hostNotifyWanted({ hostNotify, hostNotifyFallback, localBrowserPresent }) {
+  if (hostNotify !== true && hostNotifyFallback !== true) return false
+  return localBrowserPresent !== true
+}
+
+// 本机浏览器在场判定:有在途长轮询即在场信号(无论时间戳新旧);无在途时,
+// 最近活动在认可窗口内(长轮询刚完成、断连刚出账)仍算在场,超窗或从未在场为假
+export function isLocalBrowserPresent({ inFlightPolls, lastSeenAt, now, windowMs }) {
+  if (typeof inFlightPolls === 'number' && inFlightPolls > 0) return true
+  return typeof lastSeenAt === 'number' && lastSeenAt > 0 && now - lastSeenAt <= windowMs
+}
+
+// 本机浏览器轮询判定:回环来源 + 长轮询续传形态(带 cursor)+ fetch 请求形态
+// + Origin 对账。投影为无守卫 GET,记账须排除可伪造在场的形态:no-cors(img
+// 跨站探活)、无 cursor 的手工探测、跨源 fetch(同机恶意网页,sec-fetch-mode
+// 同为 cors 无法区分,凭 Origin 与 Host 不符识别;同源 GET fetch 不带 Origin,
+// 无 Origin 放行,旧浏览器同样覆盖)
+export function isLocalBrowserPoll({ remoteAddress, hasCursor, secFetchMode, origin, host }) {
+  if (!isLoopbackAddress(remoteAddress)) return false
+  if (hasCursor !== true) return false
+  if (secFetchMode !== undefined && secFetchMode !== 'cors') return false
+  if (typeof origin === 'string' && origin.length > 0) {
+    try {
+      if (new URL(origin).host !== host) return false
+    } catch {
+      return false
+    }
+  }
+  return true
+}
+
+// 文本规整:换行压平为空格,防命令行参数与通知文案中的换行歧义
+const flattenNotifyText = (text) => String(text).replace(/[\r\n]+/g, ' ')
+
+// AppleScript 字符串字面量:反斜杠与双引号转义
+const appleScriptQuote = (text) => '"' + flattenNotifyText(text).replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"'
+
+// PowerShell 单引号字符串字面量:单引号加倍
+const powerShellQuote = (text) => "'" + flattenNotifyText(text).replace(/'/g, "''") + "'"
+
+// Windows toast 的调用方标识:未打包进程借用系统 PowerShell 的 AppUserModelId,
+// 缺此注册标识 toast 不展示
+const WINDOWS_POWERSHELL_AUMID = '{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\\WindowsPowerShell\\v1.0\\powershell.exe'
+
+// 平台命令构造:零依赖 spawn 所需的可执行文件与参数;未知平台返回 null。
+// darwin 走 AppleScript 通知,linux 走 libnotify,win32 走 WinRT toast 双行模板
+export function hostNotifyCommand(platform, title, body) {
+  if (platform === 'darwin') {
+    return { file: 'osascript', args: ['-e', 'display notification ' + appleScriptQuote(body) + ' with title ' + appleScriptQuote(title)] }
+  }
+  if (platform === 'linux') {
+    // '--' 终结选项解析:正文(回答前缀)以 '-' 开头时防被 getopt 误作选项簇
+    return { file: 'notify-send', args: ['--', flattenNotifyText(title), flattenNotifyText(body)] }
+  }
+  if (platform === 'win32') {
+    const script = [
+      '[Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] | Out-Null',
+      '$t = [Windows.UI.Notifications.ToastNotificationManager]::GetTemplateContent([Windows.UI.Notifications.ToastTemplateType]::ToastText02)',
+      "$e = $t.GetElementsByTagName('text')",
+      '$e.Item(0).AppendChild($t.CreateTextNode(' + powerShellQuote(title) + ')) | Out-Null',
+      '$e.Item(1).AppendChild($t.CreateTextNode(' + powerShellQuote(body) + ')) | Out-Null',
+      '[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier(' + powerShellQuote(WINDOWS_POWERSHELL_AUMID) + ').Show([Windows.UI.Notifications.ToastNotification]::new($t))',
+    ].join('; ')
+    return { file: 'powershell.exe', args: ['-NoProfile', '-NonInteractive', '-Command', script] }
+  }
+  return null
+}
+
+// 宿主桌面通知:spawn 平台命令并等待退出,真实结果返回;超时强杀,失败即弃
+// 不重试(fire-and-forget,与 webhook 同语义)。execFileImpl 须为注入的
+// node:child_process execFile,保持纯逻辑层可测。
+export async function sendHostNotify({ title, body, platform, execFileImpl }) {
+  const command = hostNotifyCommand(platform, title, body)
+  if (command === null) return { ok: false, detail: '不支持的平台: ' + String(platform) }
+  try {
+    await new Promise((resolve, reject) => {
+      execFileImpl(command.file, command.args, { timeout: HOST_NOTIFY_TIMEOUT_MS, windowsHide: true }, (error) => {
+        if (error) reject(error)
+        else resolve()
+      })
+    })
+    return { ok: true, detail: '已触发宿主通知' }
+  } catch (error) {
+    return { ok: false, detail: error && error.message ? error.message : String(error) }
+  }
+}
+
 // imTargets 读侧归一化:非数组回空,剔除形态非法项,仅保留两字段
 export function normalizeImTargets(raw) {
   if (!Array.isArray(raw)) return []
@@ -541,7 +641,7 @@ export function imBoundBotIds(list) {
 // 返回归一化后的补丁。
 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', 'kindRoutes']
+  const known = ['webhookUrl', 'minTurnDurationMs', 'rootsOnly', 'suppressSubagentWake', 'enabled', 'imTargets', 'kindRoutes', 'hostNotify', 'hostNotifyFallback', 'folderRunningEnabled']
   for (const key of Object.keys(patch)) {
     if (known.indexOf(key) < 0) return { ok: false, reason: '未知配置项: ' + key }
   }
@@ -594,6 +694,18 @@ export function validateConfigPatch(patch) {
     if (typeof patch.suppressSubagentWake !== 'boolean') return { ok: false, reason: 'suppressSubagentWake 须为布尔' }
     next.suppressSubagentWake = patch.suppressSubagentWake
   }
+  if ('hostNotify' in patch) {
+    if (typeof patch.hostNotify !== 'boolean') return { ok: false, reason: 'hostNotify 须为布尔' }
+    next.hostNotify = patch.hostNotify
+  }
+  if ('hostNotifyFallback' in patch) {
+    if (typeof patch.hostNotifyFallback !== 'boolean') return { ok: false, reason: 'hostNotifyFallback 须为布尔' }
+    next.hostNotifyFallback = patch.hostNotifyFallback
+  }
+  if ('folderRunningEnabled' in patch) {
+    if (typeof patch.folderRunningEnabled !== 'boolean') return { ok: false, reason: 'folderRunningEnabled 须为布尔' }
+    next.folderRunningEnabled = patch.folderRunningEnabled
+  }
   if ('enabled' in patch) {
     const enabled = patch.enabled
     if (enabled === null || typeof enabled !== 'object' || Array.isArray(enabled)) return { ok: false, reason: 'enabled 须为对象' }
@@ -657,6 +769,9 @@ export function resolvedConfig(settings) {
     minTurnDurationMs: duration,
     rootsOnly: source.rootsOnly !== false,
     suppressSubagentWake: source.suppressSubagentWake !== false,
+    hostNotify: source.hostNotify === true,
+    hostNotifyFallback: source.hostNotifyFallback === true,
+    folderRunningEnabled: source.folderRunningEnabled !== false,
     enabled: Object.fromEntries(CATEGORIES.map((key) => [key, enabled[key] !== false])),
     soundMapping,
     imTargets: normalizeImTargets(source.imTargets),
@@ -671,10 +786,13 @@ export function publicConfig(settings) {
     minTurnDurationMs: resolved.minTurnDurationMs,
     rootsOnly: resolved.rootsOnly,
     suppressSubagentWake: resolved.suppressSubagentWake,
+    hostNotify: resolved.hostNotify,
+    hostNotifyFallback: resolved.hostNotifyFallback,
+    folderRunningEnabled: resolved.folderRunningEnabled,
     enabled: resolved.enabled,
     soundMapping: resolved.soundMapping,
     imTargets: resolved.imTargets,
     kindRoutes: resolved.kindRoutes,
     webhookUrl: resolved.webhookUrl,
   }
-}
+}