桌面通知插件 baka-world/dsh-notify

dsh-notify

DeepSeek Harness 桌面通知插件：让后台运行的长任务不再“悄无声息”。

解决了什么痛点

DeepSeek Harness 里的 agent 任务经常一跑就是几分钟到几十分钟。用户切到别的窗口、别的标签页、甚至别的会话之后，任务什么时候结束、什么时候需要用户介入、什么时候异常终止，页面上虽然有状态，但没有任何能主动抓住注意力的提醒。结果是：

- 任务早就完成了，用户还在等；
- 流程卡在“等待用户批准/回答”上，用户却毫不知情；
- 任务静默失败，用户过很久才回来发现。

浏览器自带的通知有两个问题：通知会带上页面来源地址（泄露本地 IP / 端口），而且页面在后台或切换会话时不可靠。这个插件就是为了消除这种“等待真空”而开发的。

为什么这么做

- 桌面原生通知（notify-send / D-Bus）：由独立脚本发出，不经过浏览器，通知里永远不会出现本地 IP 来源；
- 三种关键场景全覆盖：任务完成、需要用户操作、任务异常终止；
- 可靠兜底：桌面通知不可用时自动播放提示音，绝不静默；
- 可测试：Settings 里提供三种通知的测试按钮，不用真的跑任务就能验证配置。

功能

- 任务完成 / 需要用户操作 / 任务异常终止时自动发送桌面通知
- 通知文案不含浏览器来源地址（本地 IP）
- Settings → 通知提醒：三种场景测试按钮、提示音开关、当前状态展示
- Host half 注册 POST /dsh-notify 路由，Browser half 注册设置页

安装（web profile）

1. 克隆到本地：git clone https://github.com/baka-world/dsh-notify
2. 在 ~/.dsh/profiles/web/package.json 里加入：

{
"dependencies": {
"dsh-notify": "link:/绝对路径/dsh-notify" },
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-notify"]
}
}
}

3. cd ~/.dsh/profiles/web && pnpm install
4. 重启 dsh web

License

MIT