DeepSeek Harness 的 Web 界面在处理长任务或需要人工介入的流程时，用户往往需要保持标签页打开。当页面处于后台或用户切换应用时，任务完成或权限请求的提示容易被忽略。该插件通过浏览器原生通知系统，弥补了这一体验缺口。
插件简介¶
这是一个由 pd90506 维护的插件，旨在为 DeepSeek Harness Web GUI 添加系统级通知功能。它监听会话状态变更和权限请求事件，当这些事件发生时，通过浏览器通知中心向用户发送提醒。
安装与启用¶
- 执行以下命令安装插件：
dsh plugin --profile web add https://github.com/pd90506/dsh-web-notification/archive/refs/tags/v0.1.0.tar.gz
- 重启 Web 服务器，使插件的宿主端和客户端模块生效。
核心功能¶
- 任务完成通知：当任意会话的代理状态从
running变为idle时触发通知。 - 权限请求通知：当 Harness 发起批准或权限请求时触发通知。
- 通知机制：插件通过内存队列缓存事件，客户端通过 GET /__dsh-web-notification/poll 接口轮询获取通知。支持多标签页同时监听，同一会话的重复通知会互相覆盖而不是堆叠。
- 图标处理：通知图标为 DSH 页面自身的
/favicon.svg，在页面内转换为 PNG 显示。
使用方法¶
- 确保已重启 Web 服务器。
- 在浏览器中为 DSH 页面（例如
http://127.0.0.1:3080）授予通知权限。 - 在操作系统设置中允许浏览器显示横幅和声音（例如 macOS 系统设置）。
技术与安全说明¶
- 资源消耗：插件仅为 UI 功能，不消耗 Token，不注册模型工具，不写入会话日志。
- 策略干扰：批准监听器为严格透传，调用
next()继续流程，不干扰 Harness 的策略执行或批准卡片。 - 安全边界：轮询接口仅返回通知项目本身，不包含消息内容或工具参数。
局限性¶
- 运行依赖：需要 DSH 页面在标签页中打开且通知权限已授予。页面关闭后无法接收通知，且浏览器拒绝的权限无法在页面内覆盖。
- 延迟：通知延迟最高可达 2 秒（轮询间隔）。
- 离线处理：如果在页面未连接期间发生事件，最多排队 60 秒。
总结¶
该插件通过轮询机制实现了跨标签页的即时通知，适合需要频繁切换工作流或长时间运行 Harness 任务的场景。安装包遵循 MIT 许可证。
