dsh-session-notifier

dsh-session-notifier

给 DeepSeek Harness（dsh）Web 会话加桌面通知：会话完成、执行失败、需要审批、需要你回答时提醒你。

• 浏览器通知：页面开着时由客户端弹出；点击后定位到对应会话——已有标签页打开该会话就聚焦它（不刷新），没有才新开一个标签页。
• Windows Toast：在 WSL/Windows 下由 Host 直接调用 powershell.exe 弹出，页面关掉也能收到；点击会新开一个浏览器标签页并定位到对应会话（平台限制：无法聚焦已打开的标签页）。

点击后的完整行为见点击通知的行为。

English: desktop notifications for DSH Web sessions — browser notifications plus Windows toasts from WSL; clicking a notification opens its session.

安装

dsh plugin --profile web add dsh-session-notifier

然后：

1. 重启 dsh web（profile 的 bundle 列表只在启动时读取）；
2. 浏览器硬刷新（Ctrl+Shift+R）；
3. 首次点击 DSH 页面任意位置，允许浏览器通知权限。

也可以在 设置 → 通用 → 桌面通知 中查看权限状态、启用通知或发送测试通知。

从源码安装（本地开发）：

cd /path/to/dsh-session-notifier
dsh plugin --profile web add "link:$PWD"

触发事件

事件 · 来源 · 通知内容 回合完成 · agent/status 从 running 变为 idle · 任务已完成 · 执行失败 · agent/error · 执行失败： · 需要审批 · approval/request · 需要审批：（） · 需要回答 · user-questions/request · 需要你回答： ·

通知标题使用会话标题（sessionTitle 投影），无标题时回退到工作目录名或会话 id 前 8 位。子代理会话默认不通知。

通道与关注会话

客户端通过 SSE（/dsh-notifier/events）接收通知，并上报浏览器通知权限与当前正在浏览的会话。Host 的 windowsToast.enabled 决定是否同时弹 Windows Toast：

• auto（默认）：有页面已授予通知权限时只发浏览器通知，避免重复；没有可用页面时回退到 Windows Toast。关闭浏览器通道（browser.enabled: false）时视同 always，只弹 Toast。
• always：每条未被关注会话抑制的通知同时弹 Windows Toast，最可靠，但会与浏览器通知重复。
• never：从不弹 Toast。

被关注会话：同时只看一个页面、一个会话。聚焦且可见的页面上报的当前会话即被关注会话。

• 被关注会话的完成通知会被抑制（页面本身已经能看到结果），且对所有页面一致抑制。
• 其他会话的完成——同一页面的其他会话、其他标签页/窗口的会话——都会通知。
• 失败、审批、提问即使发生在被关注会话也会通知（这些需要行动）。
• 页面失焦、最小化或关闭时，所有完成都会通知；没有页面连接时由 Windows Toast 接管。

环境要求

要求 · 说明 DSH · >=0.2.1-rc.2 =20 浏览器 · Chrome / Edge（通知授权依赖用户手势） Windows Toast · Windows 或 WSL，PATH 中有 powershell.exe；其他平台只用浏览器通知

配置

默认配置在包内的 cordis.patch.yml。要覆盖，在本 profile 的用户 patch 层 （~/.dsh/profiles/web/cordis.patch.yml）加一条同 id 的配置；匹配的覆盖会替换整个 config：

- id: dsh-notifier
  name: dsh-session-notifier
  config:
    events:
      completed: true
      error: true
      approval: true
      question: true
    windowsToast:
      enabled: auto          # auto | always | never（也接受 true/false）
      sound: true
      appId: DSH.Web
      # launchUrl: http://127.0.0.1:3080/
    browser:
      enabled: true
    # 额外允许访问通知路由的主机名（反向代理场景）；绑定地址与本机地址始终放行
    allowedHosts: []
    debounceMs: 4000
    includeSubagents: false   # true 时子代理/子会话也通知

改完后由 HMR 重载配置；如果没生效，刷新页面或重启 DSH。

验证

# 通道状态（客户端数、浏览器通道是否可用、Toast 模式、被关注会话）
curl -s http://127.0.0.1:3080/dsh-notifier/state

# 发送一条测试通知：浏览器通知 + Windows Toast
curl -s -X POST http://127.0.0.1:3080/dsh-notifier/test -H 'content-type: application/json' -d '{}'

# 模拟某个会话的事件（用于验证关注会话抑制）
curl -s -X POST http://127.0.0.1:3080/dsh-notifier/test \
  -H 'content-type: application/json' \
  -d '{"kind":"completed","sessionId":"session-other"}'
# kind 可为 completed / error / approval / question / test

# 观察 SSE 广播
curl -sN 'http://127.0.0.1:3080/dsh-notifier/events?client=probe'

点击通知的行为

场景 · 点击后 浏览器通知，已有标签页打开该会话 · 聚焦该标签页，不刷新、不重新加载 浏览器通知，没有标签页打开该会话 · 新开标签页并以 ?dsh-session= 定位到该会话 浏览器通知，当前页就是该会话 · 聚焦当前页 浏览器通知，没有会话 id（全局通知） · 只聚焦当前页 Windows Toast · 新开标签页并定位到对应会话；无法聚焦已打开的标签页 目标会话已删除或无法打开 · 停留在当前视图（新标签页打开 DSH 首页）

新标签页定位完成后会把 dsh-session 参数从地址栏移除，之后刷新不会重复跳转。Toast 的打开地址可以用配置里的 windowsToast.launchUrl 覆盖。

已知限制

• 需要浏览器进程在运行才能收到浏览器通知；页面全部关掉后由 Windows Toast 接管（仅 Windows/WSL）。
• 通知路由只接受本机（127.0.0.1 / localhost / ::1）、dsh web 实际绑定的地址，以及 allowedHosts 里显式列出的主机；经 --public-url 反向代理访问时，要把代理域名加入 allowedHosts。路由没有额外鉴权，不要把端点暴露到不受信任的网络。
• Windows Toast 使用 DSH.Web 作为 AppID，插件首次发送时会在 HKCU\SOFTWARE\Classes\AppUserModelId\DSH.Web 写入显示名 DSH Web（用户级注册表，幂等，不需要管理员权限）。想换名称可改配置里的 appId。
• Toast 点击会新开一个浏览器标签页并直接定位到对应会话（?dsh-session=）。Windows 协议激活无法聚焦已经打开的标签页，这是平台限制；浏览器通知的点击则优先聚焦已有标签页。
• 审批/提问通知依赖 Host 的 approval/request、user-questions/request 事件；在审批策略为 never 时不会触发审批通知。
• 子代理会话默认被过滤，主会话完成时会统一通知。

License