huaiyuWangh/dsh-session-notify

dsh-session-notify

DSH web 插件：会话停止提醒——输出完成（运行中 → 已停止）或等待你处理的停止（审批 / 计划审查 / 提问）——在页面处于后台时，通过桌面通知、提示音和标题闪烁进行提醒。点击通知即可跳转到该会话。

纯插件层实现；无需修改 DSH 源码。

提醒矩阵

| 页面状态 | 停止的会话 | 效果 |
|---|---|---|
| 后台（另一个窗口） | 任意会话 | 通知 + 提示音（若开启）+ 标题闪烁（若开启） |
| 前台 | 非当前会话 | 通知 + 提示音（当“前台”偏好开启时） |
| 前台 | 你正在查看的会话 | 按设计静默 |

通知可点击：点击 → 聚焦窗口 → 切换到该会话。

安装

官方 bundle 渠道（一条命令即可安装并挂载）：

dsh plugin --profile web add dsh-session-notify

手动/开发安装：

node build.mjs        # needs esbuild
cp -R lib cordis.patch.yml package.json ~/.dsh/profiles/web/node_modules/dsh-session-notify/
then add to ~/.dsh/profiles/web/cordis.patch.yml:
- insert:
- id: session-notify
name: 'dsh-session-notify'

重启 dsh web；bundle 更新后请强制刷新页面。

行为说明

- 监听客户端运行时的 ctx.sessions.list store（与侧边栏状态点相同的数据源：host/session-status 帧 + pendingInteraction 投影）。
- 每次提醒都使用唯一的通知 tag，并显式关闭该会话上一条仍存活的通知：macOS 会静默吞掉对仍存在于通知中心里的同一标识符的重复投递，因此若使用固定的每会话 tag，第一次之后的每次提醒都会被丢弃。
- 偏好设置持久化在 localStorage（dsh-session-notify.prefs.v1），无需宿主服务。
- 文案通过 DSH locale 服务实现双语（中/英）。
- 重新加载时采用静默基线：不会为已经处于等待状态的会话重放提醒。

已知限制

- 浏览器标签页关闭时不会提醒（客户端插件运行在页面中）。
- 需要浏览器通知权限（在设置区域授权一次即可）。
- 是否出现横幅受两层控制：站点权限授予后，macOS 仍可能在“系统设置 → 通知”中静音该浏览器 App，且专注模式/勿扰会吞掉横幅——JS 的 new Notification() 构造会成功但无可见效果，插件无法检测到这一点。
- 通知的来源行显示页面来源（例如 127.0.0.1:3080）；浏览器强制使用此标签，JS 无法更改。