dsh-notifier
DeepSeek Harness (dsh) 系统通知插件:任务完成或需要人工确认/输入时,发送操作系统原生通知。
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:YZz-S/dsh-notifier说明文档
阅读完整 README ↗dsh-notifier
DeepSeek Harness(dsh)系统通知插件:当任务完成,或需要你在页面中手动输入 / 确认信息时,发送一条操作系统原生通知,让你切到别的窗口时也不会错过关键节点。
功能
- 任务完成通知:顶层会话从
running回到idle(一个回合结束)时,发送「任务已完成」 - 需要确认 / 输入通知:触发审批(
approval/request,例如需要你确认执行某个工具)时,发送「需要确认」,并带上工具名与原因 - 不干预审批流程:审批通知走 waterfall 的
next()透传,绝不抢答、不改变审批结果 - 跨平台:Windows(Toast + 气泡兜底)/ macOS(
osascript)/ Linux(notify-send)
触发的事件
| 事件 | 模式 | 通知内容 |
|---|---|---|
agent/status → idle(顶层会话,且此前为 running) | emit | 任务已完成 |
approval/request | waterfall | 工具 X 需要你在页面中确认(+ 原因) |
文件说明
| 文件 | 说明 |
|---|---|
index.js | 可安装的 Host 半边(dsh.bundle 入口,ES module) |
cordis.patch.yml | bundle 补丁:插入 notifier 插件行 |
host.js | 动态用法(cordis_define 的 code.host) |
package.json | 声明 dsh.bundle 的可安装包元信息 |
README.md | 本说明 |
LICENSE | MIT 许可证 |
安装(dsh.bundle)
本仓库同时是可安装的 dsh 插件包(package.json 声明 dsh.bundle):
dsh plugin --profile web add github:YZz-S/dsh-notifier
安装后任务完成或需要人工确认/输入时自动发送系统通知(纯 Host 插件,无需刷新页面)。
动态用法(cordis_define 加载 host.js)仍保留,两种方式二选一。
使用方法
方式一:动态 Cordis 插件(临时运行)
在 dsh Web GUI 的会话中,用 Cordis 工具定义并运行:
- 调用
cordis_define:code.host粘贴host.js的内容(plugin.kind: 'new',idPrefix取 3–6 个小写字母) - 调用
cordis_run激活(纯 Host 插件,无需刷新页面) - 下一次任务完成或需要确认时即会弹出系统通知