前言¶
DeepSeek Harness (DSH) 允许用户通过配置文件定义智能体任务。当任务在后台运行或窗口最小化时，直接在界面查看状态会变得不便。dsh-web-push-notification 插件通过浏览器原生通知解决了这一问题，确保用户不会错过任务完成、停止、审批或需要回复的关键事件。
插件介绍¶
该插件属于联网工具类别，由 blauerberg 维护，开源协议为 MIT。它主要解决的是在 DSH 任务运行期间，如何通过浏览器通知实时获取任务状态更新的问题。
安装与配置¶
安装插件需要指定 profile。以 web profile 为例，执行以下命令：
dsh plugin --profile web add dsh-web-push-notification
安装后，需在配置文件中添加插件配置。默认配置文件路径为 $DSH_HOME/profiles/web/cordis.patch.yml。添加如下内容：
- id: dsh-web-push-notification
config:
vapidSubject: 'mailto:admin@example.com'
其中 vapidSubject 是 VAPID 联系 URI，可以是 mailto: 或 https: 格式。订阅和 VAPID 密钥默认存储在 $DSH_HOME/profiles/<profile>/web-push.json 中。
启用与使用¶
启动配置了插件的 profile：
dsh --profile web
由于浏览器安全策略，除非通过本地回环地址访问，否则必须通过 HTTPS 打开配置文件。在 iOS 和 iPadOS 上，启用 Web Push 之前需将配置文件添加到主屏幕。
启动后，打开 Settings → Notifications，启用 Web Push，并使用 Send test 进行测试。
功能与说明¶
该插件具备以下功能：
- 事件通知：支持任务完成、任务停止或失败、需要审批、需要回复四种事件类型，所有类型默认启用。
- 通知内容：支持完整内容通知（默认）和仅摘要通知两种模式。
- 独立设置：每个浏览器或安装的 PWA 单独存储其通知设置。
- 存储路径：订阅和 VAPID 密钥默认存储在
$DSH_HOME/profiles/<profile>/web-push.json中。
注意事项¶
- 插件以当前 DSH 进程的权限运行。
- 使用前建议检查源码与许可证。
此插件将 DSH 的状态集成到浏览器通知中，适合需要通过浏览器监控后台任务流的开发者。代码库和文档可在 GitHub 上找到。
