Back to home

baka-world

dsh-notify

DeepSeek Harness desktop notification plugin (notify-send / D-Bus)

Stars
0
Language
JavaScript
Created
Aug 15, 2026
Updated
Aug 15, 2026

Introduction

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"]
    }
  }
}
  1. cd ~/.dsh/profiles/web && pnpm install
  2. 重启 dsh web

License

MIT