前言¶
在 DeepSeek Harness（DSH）平台进行 Agent 开发时，经常遇到会话等待审批、需要回答结构化提问或任务成功/失败的场景。如果开发者没有时刻关注 DSH 页面，很容易错过这些关键事件。该插件通过浏览器通知机制，解决了这一问题。
功能特性¶
插件支持全会话监听，不限于当前打开的会话。它提供四类通知：会话待审批、等待回答、任务成功和任务失败。功能包括子代理任务通知独立开关、标签页鲸鱼图标变色（黄/红/绿优先级）、前台抑制（当前会话不重复提醒）、多标签页单发（BroadcastChannel 机制）、点击直达会话、独立配置模块、隐私安全（通知不包含聊天正文或参数）以及中英文双语言界面。
安装与启用¶
安装前需确保已安装 DSH CLI 与 pnpm，并保持 DSH 页面打开。
1、执行安装命令：
dsh plugin --profile <profile> add github:Ycet/dsh-notifications
2、重启网页应用：dsh web
3、打开 DSH 页面，进入「设置 → 插件 → 插件配置」
4、展开「消息通知」模块，点击「授权通知」并在浏览器权限提示中选择允许
5、点击「发送测试通知」验证浏览器设置
配置与用法¶
配置存储在 DSH settings 服务的 dsh-notifications 命名空间下。
| 字段 | 默认值 | 说明 |
|---|---|---|
enabled |
true |
总开关 |
approvalPendingEnabled |
true |
待审批通知 |
questionPendingEnabled |
true |
结构化提问通知 |
taskSucceededEnabled |
true |
任务成功通知 |
taskFailedEnabled |
true |
任务失败通知 |
subagentTaskEndedEnabled |
true |
子代理任务通知开关 |
faviconEnabled |
true |
标签页图标变色总开关 |
前台抑制：默认只有在 DSH 标签页处于后台，或事件来自非当前会话时才发送通知。
点击直达：点击通知会聚焦 DSH 并打开对应会话；若目标会话已不存在，则只聚焦页面。
图标变色逻辑：鲸鱼图标颜色由非子代理会话状态决定。黄色表示有会话待审批或等待回答；红色表示有会话任务失败；绿色表示有会话任务完成。优先级为黄 > 红 > 绿。点开会话可清除该会话的颜色贡献。子代理会话状态不影响图标颜色。
注意事项¶
1、版本兼容：插件兼容 DSH 0.1.0-rc.6 / 0.1.0-rc.7。
2、运行状态：DSH 页面必须保持打开，浏览器关闭后无法接收通知。
3、浏览器权限：必须授予当前 DSH 地址通知权限，非安全远程 HTTP 地址可能被拒绝。
4、图标支持：鲸鱼图标变色依赖页面 favicon，Firefox 和 Safari 未列入首版验收范围。
5、功能限制：不提供原生 Node 通知、浏览器关闭后的推送、自定义通知音或外部消息渠道。
6、 多标签页机制：采用 BroadcastChannel，极端浏览器崩溃后最多等待约 6 秒重新选举。
结尾¶
该插件为 DSH 用户提供了直观的消息通知和状态反馈机制，适合需要长时间运行 Agent 任务并关注状态变化的场景。相关文档与源码可访问插件目录或 GitHub 仓库获取。
