@terricsh/dsh-notify
Desktop notifications for DeepSeek Harness: approval / completion / error events with click-to-open deep links into the Web GUI.
安装
此插件尚未提供可验证的 bundle,或兼容性检查未通过。请先阅读仓库说明。 阅读完整 README ↗
说明文档
阅读完整 README ↗@terricsh/dsh-notify
给 DeepSeek Harness 的桌面通知插件:把审批请求 / 任务完成 / 出错等事件发成操作系统桌面通知,通知正文注明工作区 + 项目,点击通知可直接跳转到 Web GUI 里对应的会话(显示该会话的讨论内容)。
跨平台:
| 平台 | 通知方式 | 点击跳转 |
|---|---|---|
| Windows | PowerShell toast | ✅ 原生(点击整条通知或「打开项目」按钮) |
| macOS | terminal-notifier,缺失时退回 osascript | ✅ 装了 terminal-notifier 时;否则正文附链接 |
| Linux | notify-send | ⚠️ 正文附链接,notify-send 不支持点击打开 URL |
仓库:https://github.com/TerricSH/dsh-notify
目录结构
dsh-notify/
├── package.json # 包元数据 + dsh.client 清单(注册 Client 半边)
├── lib/
│ ├── index.js # Host 插件:监听事件 + 发通知 + 生成深链 URL
│ └── client.js # Client 插件:读 cookie 并打开对应会话
├── cordis.patch.example.yml
└── README.md
- Host 半边(
lib/index.js)是 host 平面插件:它监听进程级事件 (approval/request、agent/status、agent/error)并读webServer端口。 - Client 半边(
lib/client.js)通过package.json里的dsh.client清单 注册进 Web 客户端,负责深链跳转。
发布到 GitHub / npm
npm publish # 发布 @terricsh/dsh-notify 到 npm
git push origin main # 源码托管到 GitHub
发布
@terricsh/dsh-notify前,需先在 npm 上拥有@terricsh这个 scope (npm org create terricsh或直接npm adduser后用该 scope 发布即可)。
使用方法
两种安装方式二选一。装好后,当代理产生以下事件时会弹系统通知,点击通知 即可定位到 Web GUI 中对应会话(显示该会话的讨论内容):
- 审批请求(需要你批准某操作时)
- 任务完成(一轮对话结束)
- 任务出错
方式 A:从 npm 安装(已发布后,推荐)
-
装进 web profile:
dsh plugin --profile web add @terricsh/dsh-notify -
加 host 引用行(见
cordis.patch.example.yml),编辑$DSH_HOME/profiles/web/cordis.patch.yml(默认是[]):- insert: - id: notify-desktop name: '@terricsh/dsh-notify'