浏览器通知 Wepoi9/dsh-web-notify

dsh-web-notify

这是 DeepSeek Harness（DSH）Web UI 的社区插件。会话完成、出错、阻塞，或者等待你操作时，它会发送浏览器/系统通知。

这是社区维护的插件，不属于 DeepSeek Harness 核心发行版。

功能

宿主侧注册一个 notifyTurn 会话投影。Web 客户端观察会话状态，用浏览器 Notification API 在以下情况发通知：

- 非可见会话以 completed、blocked 或 error 结束；
- 会话等待 approval、question 或 plan-review。

相关对话已经可见且处于焦点时，不发通知。

其他行为：

- 忽略 max-tokens、aborted、interrupted 这几种回合结束方式；
- 忽略子代理会话；
- 抑制重复的回合通知与交互通知；
- 多个更新同时到达时合并为一条通知（英文为 DSH · 3 updates / 1 Waiting, 2 Completed，日文为 DSH · 3件の更新 / 1件の操作待ち、2件の完了）；
- 点击通知会打开受影响会话中优先级最高的那个；
- 仅在浏览器权限为 granted 时发送通知。

兼容性

最新测试过的 DSH 版本：0.2.1-alpha.1。

| DSH 版本 | 验证情况 |
| 0.1.6-alpha.2 | 端到端行为已验证 |
| 0.1.7-alpha.2 | 插件加载、清单可见性、测试通知已验证 |
| 0.1.7-rc.1 | 插件加载、清单可见性、测试通知已验证 |
| 0.1.7-rc.2 | 插件加载、清单可见性、测试通知已验证 |
| 0.2.0-rc.1 | 插件加载、清单可见性、测试通知已验证 |
| 0.2.0-rc.2 | 插件加载、清单可见性、测试通知已验证 |
| 0.2.1-alpha.1 | 插件加载、清单可见性、测试通知已验证 |

0.2.1-alpha.1 上真实的会话完成/出错/交互通知触发尚未重新验证。更新的 DSH 版本在验证之前不视为兼容。

安装

安装依赖并构建客户端 bundle：

npm install
npm run build

把本地检出目录加入 Web 配置档：

dsh plugin --profile web add <absolute-path-to-this-repository>

安装后重启 DSH Web。

设置

打开 Settings → General → Browser notifications。

- 权限未决定时，请求浏览器通知权限。
- 权限已授予时，发送测试通知。
- 到浏览器的站点设置里撤销权限。

文案语言跟随浏览器的首选语言，而不是 DSH 的 Language 设置。以第一个可用偏好为准：ja 渲染日文，其他一律渲染英文。

隐私与通知内容

系统通知中心和锁屏可能显示通知内容。

本插件有意把通知文本限制为：

- DSH 会话显示标题；
- 英文的简短状态标签，比如 Completed、Error 或 Waiting for approval；在日语浏览器会话中则显示对应的日语。

它不包含 LLM 输出、命令文本或完整文件系统路径。如果没有显式标题，DSH 仍可能根据工作区目录名或会话标识符生成会话显示标题。

插件不会把通知数据发送到外部服务。通知在本地通过浏览器 Notification API 创建。

构建与测试

npm run build
npm run check
npm test

npm run build 会用 esbuild 重新生成 lib/client.js。改动客户端源码后要重新构建。

限制

- 需要浏览器通知权限，且权限按浏览器源（origin）划分。
- 只有在 DSH 页面已加载并保持连接时才能收到通知；插件不实现离线推送通知。
- DSH 迭代很快，扩展契约可能在不同预发布版本之间变化。
- 文案语言在客户端模块加载时选定一次；更改浏览器的首选语言要等下次刷新页面才生效。

贡献

欢迎提交 bug 报告和聚焦的 pull request。如果遇到通知失败，请附上 DSH 版本、浏览器、操作系统、相关会话状态，以及页面当时是否可见/处于焦点。

许可证

MIT。见 LICENSE。