@mzzsfy/dsh-turn-notify 0.10.0 → 0.11.1

package/README.md

@@ -82,12 +82,12 @@ turn-notify:
 
 ## 宿主桌面通知
 
-开启面板"通知"页的宿主通知开关后,通知触发时由宿主进程直接弹操作系统级桌面通知,零依赖:macOS 走 osascript,Linux 走 notify-send,Windows 走 PowerShell 调 WinRT toast;超时 10 秒,失败即弃不重试,不影响其余通道。去重方向为**浏览器优先**:本机浏览器在场(2 秒内有在途长轮询)时由浏览器呈现,宿主让位,正常路径同机零重复;本机浏览器离场(标签页全关或仅远程浏览器在线)时宿主补位。重复只发生在在场判定的边界情况(认可窗口边界与网络抖动),宁可重复不可漏。两个开关判定一致,任一开启即生效:
+开启面板"通知"页的宿主通知开关后,通知触发时由宿主进程直接弹操作系统级桌面通知,零依赖:macOS 走 osascript,Linux 走 notify-send,Windows 走 PowerShell 调 WinRT toast;超时 10 秒,失败即弃不重试,不影响其余通道。去重方向为**浏览器优先**:浏览器在场(2 秒内有在途长轮询)时由浏览器呈现,宿主让位,正常路径零重复;浏览器离场(标签页全关)时宿主补位。重复只发生在在场判定的边界情况(认可窗口边界与网络抖动),宁可重复不可漏。两个开关判定一致,任一开启即生效:
 
 - **宿主机弹桌面通知**:启用宿主通知通道(浏览器优先去重内建)。
-- **仅当本机无浏览器接收时补位**:与总开关等效,作为显式的补位语义表达保留。
+- **仅当无浏览器接收时补位**:与总开关等效,作为显式的补位语义表达保留。
 
-"本机浏览器在场"按投影长轮询记账:回环来源 + 续传 cursor + 同源形态的 GET 在服务端挂起期间计为在途,断连(标签页关闭/请求中止)经连接关闭事件即时出账,最近活动在 2 秒认可窗口内仍算在场——优雅断连的盲区不超过 2 秒;异常断连(睡眠、强杀、断网)服务端无感知,受长轮询挂起上限约束,最坏约 25 秒后自愈出账。浏览器在场但本机呈现偏好全关(声音/弹窗/页内全关或系统通知未授权)时,宿主同样让位,该事件本机无 OS 级通知(仅剩会话行高亮)。宿主在无桌面的服务器上时 spawn 会静默失败,无害;测试页"测试宿主通知"返回真实结果,可据此验证宿主机桌面环境是否可用。聚焦时宿主通知照弹(宿主无法感知窗口焦点,聚焦静默是浏览器侧偏好)。
+"浏览器在场"按投影长轮询记账:任意来源 + 续传 cursor + 同源形态的 GET 在服务端挂起期间计为在途,断连(标签页关闭/请求中止)经连接关闭事件即时出账,最近活动在 2 秒认可窗口内仍算在场——优雅断连的盲区不超过 2 秒;异常断连(睡眠、强杀、断网)服务端无感知,受长轮询挂起上限约束,最坏约 25 秒后自愈出账。来源不限地址:浏览器可在任意机器访问 dsh(局域网部署),在场信号看的是"有无 dsh 页面在轮询",与浏览器同不同机无关。浏览器在场但在场浏览器的呈现偏好全关(声音/弹窗/页内全关或系统通知未授权)时,宿主同样让位,该事件在浏览器侧无 OS 级通知(仅剩会话行高亮)。宿主在无桌面的服务器上时 spawn 会静默失败,无害;测试页"测试宿主通知"返回真实结果,可据此验证宿主机桌面环境是否可用。聚焦时宿主通知照弹(宿主无法感知窗口焦点,聚焦静默是浏览器侧偏好)。
 
 ## IM 推送
 
@@ -97,6 +97,10 @@ turn-notify:
 
 通知实际送达时,侧边栏会话列表中对应会话行以背景脉冲闪烁强调,六类各一色(完成绿/出错红/提问蓝/中断橙/审批黄/上限紫),点击该会话行即停止。开关在面板"偏好"页首项(独立开关,本机生效,各浏览器独立),默认开启。并行多会话时用于快速定位状态刚更新的会话:运行中的会话不闪烁(与 dsh 原生状态点分工——状态点表达运行中,闪烁表达已更新待查看),会话重新进入运行状态时闪烁自动让位;聚焦时正在查看的会话不闪烁,失焦期间本会话的通知照常闪烁,返回窗口即自动消失(回来即已读,焦点与页面可见双通道)。行定位按会话标题文本匹配,标题默认与侧边栏行同源(session-title 投影);该服务缺失或不可用(如伪会话无事件日志)时回落会话事件内存储的标题,可能与侧边栏不同步。会话行未渲染(列表折叠/懒加载未滚动到)时该次高亮静默跳过。重开页面的冷启动静默对齐同样挂高亮(见"多窗口只响一次"),重开即见哪些会话有动静。
 
+## 工作区文件夹运行标记
+
+侧边栏会话列表按工作区分组(官方 WorkspaceBrowser 分组模式)时,有运行中会话的工作区文件夹组头显示脉冲运行点并给文件夹图标着色,游离(未归属任何工作区)的可见运行中会话使末位「未分组」组头同样标记——折叠与展开同样生效。归属与运行态一律取服务快照投影,DOM 仅按下标对位官方组容器;组容器数漂移(单列表模式/搜索态/结构变更)即清除标记不误标。图标着色让位官方 folderActive(展开且含当前会话)态。开关在面板"偏好"页"会话列表"卡(存宿主配置,各浏览器共用),默认开启,变更刷新页面生效。
+
 ## 多窗口只响一次
 
 同一地址(同源)打开的多个窗口共享一次呈现:各窗口以长轮询挂起在 host 的通知队列上(事件产生或配置变更即时返回,空闲期单次挂起至多数十秒,失败按指数退避重连),经 localStorage 协调,仅一个窗口抢先呈现——发声并弹出页内提示、系统弹窗、高亮会话行,其余窗口全部跳过,不止声音。通知在产生后的下一次唤醒即送达,通常亚秒级;不同浏览器或不同地址打开的窗口各自发声互不感知。窗口关闭/刷新期间错过的通知不做重开回放:启动首轮静默对齐游标与完成标记,不逐条补发提示与声音(等待用户动作的审批与提问例外,照常呈现);未读会话行高亮不在静默范围,照常挂上。
@@ -123,8 +127,8 @@ turn-notify:
   minTurnDurationMs: 5000         # 最短回合时长(毫秒),回合结束类通知短于此不送达
   rootsOnly: true                 # 子代理会话不通知
   suppressSubagentWake: true      # 子代理相关回合不通知:后台委托未收尾或收尾唤醒(仅任务完成类)
-  hostNotify: false               # 宿主机桌面通知总开关;浏览器优先,本机浏览器在场(2 秒内有在途长轮询)时让位
-  hostNotifyFallback: false       # 宿主通知补位:本机浏览器离场(2 秒内无在途长轮询)时弹宿主桌面通知,与总开关判定一致
+  hostNotify: false               # 宿主机桌面通知总开关;浏览器优先,浏览器在场(2 秒内有在途长轮询)时让位
+  hostNotifyFallback: false       # 宿主通知补位:浏览器离场(2 秒内无在途长轮询)时弹宿主桌面通知,与总开关判定一致
   enabled:                        # 六类事件独立开关
     completed: true
     error: true
@@ -149,18 +153,18 @@ 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 与宿主桌面通知(如开启)送达(声音与弹窗的浏览器前提)。
-- 宿主桌面通知为浏览器优先去重:本机浏览器在场(2 秒内有在途长轮询)时宿主让位,边界情况(认可窗口边界、网络抖动、反代致来源恒为回环而恒判在场)宁可不弹不误弹,优雅断连的离场盲区不超过 2 秒,异常断连受长轮询挂起上限约束(最坏约 25 秒);聚焦时宿主通知照弹(宿主无法感知窗口焦点);无桌面的宿主上 spawn 静默失败,无害。在场记账的形态校验(回环 + 续传 cursor + 同源)为启发式,防无意探活误压制与网页伪造在场(DNS rebinding 将域解析至回环的页面同源可过校验,但该页面同时已握有全部写配置 API,通知压制非最大损失面),不构成对抗本机进程的安全边界。
+- 宿主桌面通知为浏览器优先去重:浏览器在场(2 秒内有在途长轮询)时宿主让位,边界情况(认可窗口边界、网络抖动)宁可不弹不误弹,优雅断连的离场盲区不超过 2 秒,异常断连受长轮询挂起上限约束(最坏约 25 秒);聚焦时宿主通知照弹(宿主无法感知窗口焦点);无桌面的宿主上 spawn 静默失败,无害。在场记账的形态校验(续传 cursor + 同源 fetch 形态)为启发式,防无意探活误压制与网页伪造在场(DNS rebinding 将域解析至 dsh 的页面同源可过校验,但该页面同时已握有全部写配置 API,通知压制非最大损失面),不构成对抗本机进程的安全边界。
 - IM 依赖 dsh-im 的 bot 在线,离线时该次通知弃置不补发;成功回执仅代表平台受理。
 - 不同浏览器或不同地址打开的窗口各自发声,互不去重。
 - 系统弹窗在 HTTP 非回环下永久降级,HTTPS 化后自动恢复;Windows 下受系统通知设置与专注助手约束。
-- 长轮询空闲期连接由代理或服务端挂起,经中间反代时需允许数十秒的挂起响应,否则退化为更频繁的重连。
+- 长轮询空闲期连接由代理或服务端挂起,经中间反代时需允许数十秒的挂起响应,否则退化为更频繁的重连;反代还需透传 Host 头(如 nginx `proxy_set_header Host $host`),否则同源对账失败、真实浏览器不入账,宿主通知每次重复弹(失败方向与"宁可重复不可漏"一致)。
 - 等待动作二次提醒的"已处理"判定以本窗口可见信号(会话切换/高亮清除)近似,无会话标题的通知无法感知处理,宁可多响一次。
 - 点击直达依赖侧边栏会话行可被标题匹配命中,行未渲染或标题不同步时仅聚焦不切换。
 
@@ -185,3 +189,6 @@ node scripts/dev-link.mjs dsh-turn-notify   # 仓库根执行:归一 profile 依
 
 工作副本以 junction 挂进 profile,host 半区改动保存约 1 秒热重载,client 半区改动刷新页面即生效,无需发版;规约与全仓归一见 `node scripts/dev-link.mjs all`。
 
+## dsh 版本兼容
+
+三版本全部通过:通知开关与播报形态、激活 live。0.1.6 控件数 13→19 属宿主演进,不构成不兼容。

package/package.json

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

package/src/client.js

@@ -278,7 +278,7 @@ window.__ModuleLoader__.load({
     const IDLE_AWAY_MS = 5 * 60 * 1000
 
     // 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
@@ -864,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 = '侧边栏会话列表按工作区分组时,有运行中会话的文件夹组头显示运行点并给文件夹图标着色,文件夹折叠与展开同样生效;游离会话所在的「未分组」组同样标记;单列表模式下无此标记。停用即全部隐藏,刷新页面生效。'
+
     // ---- 点击直达会话:页内卡片与系统弹窗共用 ----
 
     // 按通知单元激活会话:聚焦窗口并模拟点击侧边栏会话行(官方行点击即切换会话);
@@ -1019,6 +1068,7 @@ window.__ModuleLoader__.load({
       suppressSubagentWake: true,
       hostNotify: false,
       hostNotifyFallback: false,
+      folderRunningEnabled: true,
       enabled: Object.fromEntries(CATEGORIES.map((key) => [key, true])),
       imTargets: [],
     }
@@ -1136,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) {
@@ -1408,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()
@@ -1678,19 +1755,19 @@ window.__ModuleLoader__.load({
                 ' 后台委托未收尾或收尾唤醒的回合不通知(仅完成类)'),
             ]),
             field('宿主通知', [
-              h('label', { className: 'tn-meta tn-switch', title: '通知触发时由宿主进程弹系统级桌面通知(osascript/notify-send/PowerShell toast);浏览器优先:本机有浏览器窗口在线(2 秒内有在途长轮询)时由浏览器呈现,宿主不重复弹;本机无浏览器(标签页全关或仅远程浏览器)时宿主弹' },
+              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 秒内有在途长轮询)时由浏览器呈现,离场时宿主补位桌面通知;与总开关判定一致,任一开启即生效' },
+              h('label', { className: 'tn-meta tn-switch', title: '浏览器在场(2 秒内有在途长轮询)时由浏览器呈现,离场时宿主补位桌面通知;与总开关判定一致,任一开启即生效' },
                 ...switchToggle({
                   checked: config.hostNotifyFallback,
                   onChange: (e) => setConfig({ ...config, hostNotifyFallback: e.target.checked }),
                 }),
-                ' 仅当本机无浏览器接收时补位'),
-            ], '由宿主进程直接弹 OS 桌面通知,服务器/浏览器全关场景可达;浏览器优先——本机浏览器在线时由浏览器呈现,宿主不重复弹,离场(2 秒内无在途长轮询)时宿主补位,边界情况(窗口边界与网络抖动)宁重复不漏。需点保存生效,测试页可逐条点火验证。'),
+                ' 仅当无浏览器接收时补位'),
+            ], '由宿主进程直接弹 OS 桌面通知,服务器/浏览器全关场景可达;浏览器优先——浏览器在线时由浏览器呈现,宿主不重复弹,离场(2 秒内无在途长轮询)时宿主补位,边界情况(窗口边界与网络抖动)宁重复不漏。需点保存生效,测试页可逐条点火验证。'),
             field('事件分类', h('div', { className: 'tn-pills' },
               CATEGORIES.map((category) => h('span', {
                 className: 'tn-pill' + (config.enabled[category] ? ' tn-pill--on' : ''),
@@ -1794,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' },
@@ -2001,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

@@ -499,35 +499,29 @@ 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 }) {
+export function hostNotifyWanted({ hostNotify, hostNotifyFallback, browserPresent }) {
   if (hostNotify !== true && hostNotifyFallback !== true) return false
-  return localBrowserPresent !== true
+  return browserPresent !== true
 }
 
-// 本机浏览器在场判定:有在途长轮询即在场信号(无论时间戳新旧);无在途时,
+// 浏览器在场判定:有在途长轮询即在场信号(无论时间戳新旧);无在途时,
 // 最近活动在认可窗口内(长轮询刚完成、断连刚出账)仍算在场,超窗或从未在场为假
-export function isLocalBrowserPresent({ inFlightPolls, lastSeenAt, now, windowMs }) {
+export function isBrowserPresent({ 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
+// 浏览器轮询判定:长轮询续传形态(带 cursor)+ fetch 请求形态 + Origin 对账。
+// 来源不限地址:浏览器可在任意机器访问 dsh(局域网部署),在场信号看的是
+// "有无 dsh 页面在轮询",与浏览器同不同机无关。投影为无守卫 GET,记账须排除
+// 可伪造在场的形态:no-cors(img 跨站探活)、无 cursor 的手工探测、跨源 fetch
+// (恶意网页,sec-fetch-mode 同为 cors 无法区分,凭 Origin 与 Host 不符识别;
+// 同源 GET fetch 不带 Origin,无 Origin 放行,旧浏览器同样覆盖)——只有 dsh
+// 同源页面自身能发出合格形态,伪造面与来源地址无关
+export function isBrowserPoll({ hasCursor, secFetchMode, origin, host }) {
   if (hasCursor !== true) return false
   if (secFetchMode !== undefined && secFetchMode !== 'cors') return false
   if (typeof origin === 'string' && origin.length > 0) {
@@ -641,7 +635,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', 'hostNotify', 'hostNotifyFallback']
+  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 }
   }
@@ -702,6 +696,10 @@ export function validateConfigPatch(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 须为对象' }
@@ -767,6 +765,7 @@ export function resolvedConfig(settings) {
     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),
@@ -783,6 +782,7 @@ export function publicConfig(settings) {
     suppressSubagentWake: resolved.suppressSubagentWake,
     hostNotify: resolved.hostNotify,
     hostNotifyFallback: resolved.hostNotifyFallback,
+    folderRunningEnabled: resolved.folderRunningEnabled,
     enabled: resolved.enabled,
     soundMapping: resolved.soundMapping,
     imTargets: resolved.imTargets,

package/src/index.js

@@ -27,8 +27,8 @@ import {
   isSubagentWakeTurn,
   isValidImBotId,
   hostNotifyWanted,
-  isLocalBrowserPoll,
-  isLocalBrowserPresent,
+  isBrowserPoll,
+  isBrowserPresent,
   mapEventToCategory,
   mimeOf,
   normalizeImTargets,
@@ -62,7 +62,7 @@ const SOUNDS_DIR = join(homedir(), '.dsh', 'dsh-turn-notify', 'sounds')
 const REQUEST_BODY_MAX_BYTES = 64 * 1024
 // 长轮询挂起上限:低于客户端请求超时,保证客户端总在服务端放弃后才超时
 const LONG_POLL_WAIT_MS = 25 * 1000
-// 本机浏览器在场认可窗口:在途长轮询出账后的宽限时长,浏览器优先去重的时间边界;
+// 浏览器在场认可窗口:在途长轮询出账后的宽限时长,浏览器优先去重的时间边界;
 // 窗口内事件仍视为浏览器呈现,超窗即宿主补位(宁可重复不可漏)
 export const CLIENT_PRESENCE_WINDOW_MS = 2 * 1000
 
@@ -92,8 +92,9 @@ const SETTINGS_SCHEMA = z.object({
   minTurnDurationMs: z.number().default(MIN_TURN_DURATION_MS).description('最短回合时长(毫秒),回合结束类通知短于此不送达;AI 提问与审批请求即时送达'),
   rootsOnly: z.boolean().default(true).description('子代理会话不通知'),
   suppressSubagentWake: z.boolean().default(true).description('子代理相关回合不通知(仅任务完成类):后台委托未收尾的回合与收尾唤醒的回合'),
-  hostNotify: z.boolean().default(false).description('宿主机桌面通知:通知触发时由宿主进程弹系统级通知(osascript/notify-send/PowerShell toast);浏览器优先,本机浏览器在场(2 秒内有在途长轮询)时由浏览器呈现宿主不重复弹,离场时宿主补位'),
-  hostNotifyFallback: z.boolean().default(false).description('宿主通知回退:本机浏览器在场时由浏览器呈现,离场(2 秒内无在途长轮询)时宿主补位;与总开关判定一致,任一开启即生效'),
+  hostNotify: z.boolean().default(false).description('宿主机桌面通知:通知触发时由宿主进程弹系统级通知(osascript/notify-send/PowerShell toast);浏览器优先,浏览器在场(2 秒内有在途长轮询)时由浏览器呈现宿主不重复弹,离场时宿主补位'),
+  hostNotifyFallback: z.boolean().default(false).description('宿主通知回退:浏览器在场时由浏览器呈现,离场(2 秒内无在途长轮询)时宿主补位;与总开关判定一致,任一开启即生效'),
+  folderRunningEnabled: z.boolean().default(true).description('工作区文件夹运行标记:侧边栏分组模式下,有运行中会话的文件夹组头显示运行点并给图标着色;关闭后标记整体不渲染,变更刷新页面生效'),
   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 通道'),
@@ -207,10 +208,10 @@ export function apply(ctx) {
   const titledSessions = new Set()
   // 回合尾部统计:assistant/message 的 tokens 累加与回答前缀,回合结束随通知消费即清
   const assistantTails = new Map()
-  // 本机(回环来源)浏览器在场信号:在途长轮询计数与最近活动时刻,
+  // 浏览器在场信号:在途长轮询计数与最近活动时刻,
   // 在场 = 有在途请求或认可窗口内有活动,宿主通知的浏览器优先去重据此判定
-  let inFlightLocalPolls = 0
-  let lastLocalClientSeenAt = 0
+  let inFlightBrowserPolls = 0
+  let lastBrowserSeenAt = 0
   let seq = 0
   // 音效库写互斥:展示名索引读改写与落盘非原子,串行化防并发交错
   let soundWriteQueue = Promise.resolve()
@@ -273,16 +274,16 @@ export function apply(ctx) {
     if (routes === null || routes.indexOf('host') >= 0) deliverHostNotify(unit, settings)
   }
 
-  // 宿主桌面通知:浏览器优先,本机浏览器在场由浏览器呈现,宿主让位(正常路径
+  // 宿主桌面通知:浏览器优先,浏览器在场由浏览器呈现,宿主让位(正常路径
   // 零重复);离场(无在途长轮询且超认可窗口)由宿主补位;fire-and-forget,
   // spawn 失败不影响其余通道
   function deliverHostNotify(unit, settings) {
     const wanted = hostNotifyWanted({
       hostNotify: settings.hostNotify,
       hostNotifyFallback: settings.hostNotifyFallback,
-      localBrowserPresent: isLocalBrowserPresent({
-        inFlightPolls: inFlightLocalPolls,
-        lastSeenAt: lastLocalClientSeenAt,
+      browserPresent: isBrowserPresent({
+        inFlightPolls: inFlightBrowserPolls,
+        lastSeenAt: lastBrowserSeenAt,
         now: Date.now(),
         windowMs: CLIENT_PRESENCE_WINDOW_MS,
       }),
@@ -440,27 +441,26 @@ export function apply(ctx) {
       path: '/api/turn-notify/projection',
       handler: route('GET', {}, async (req, res) => {
         const query = new URL(req.url, 'http://localhost').searchParams
-        // 回环来源的浏览器长轮询即本机在场信号,宿主通知的浏览器优先去重据此判定;
+        // 浏览器长轮询即在场信号,宿主通知的浏览器优先去重据此判定;
         // 记账形态收紧防伪造:裸 GET(img 探活/监控探测)与跨源 fetch 不入账。
         // 记账期间计入在途,断连(浏览器关闭/中止)经 res close 事件即时出账,
         // 离场盲区收敛到认可窗口
-        let releaseLocalPoll = null
-        if (isLocalBrowserPoll({
-          remoteAddress: req.socket && req.socket.remoteAddress,
+        let releaseBrowserPoll = null
+        if (isBrowserPoll({
           hasCursor: query.has('cursor'),
           secFetchMode: req.headers ? req.headers['sec-fetch-mode'] : undefined,
           origin: req.headers ? req.headers.origin : undefined,
           host: req.headers ? req.headers.host : undefined,
         })) {
-          inFlightLocalPolls += 1
+          inFlightBrowserPolls += 1
           let settled = false
-          releaseLocalPoll = () => {
+          releaseBrowserPoll = () => {
             if (settled) return
             settled = true
-            inFlightLocalPolls -= 1
-            lastLocalClientSeenAt = Date.now()
+            inFlightBrowserPolls -= 1
+            lastBrowserSeenAt = Date.now()
           }
-          res.once('close', releaseLocalPoll)
+          res.once('close', releaseBrowserPoll)
         }
         try {
           const rawCursor = Number(query.get('cursor'))
@@ -471,7 +471,7 @@ export function apply(ctx) {
           const settings = readSettings(ctx)
           sendJson(res, 200, { units: projection.list(), soundMapping: settings.soundMapping, version: projection.version() })
         } finally {
-          if (releaseLocalPoll !== null) releaseLocalPoll()
+          if (releaseBrowserPoll !== null) releaseBrowserPoll()
         }
       }),
     })