多渠道推送通知Lubaoshuai/dsh-notify

dsh-notify

DeepSeek Harness 的推送通知插件。一个插件，两种能力：

1. notify_send 工具 —— Agent 随时可以把消息推到你的手机/聊天软件：长任务跑完了、需要你审批了、定时任务出错了。
2. Schedule 伴侣 —— 官方 @deepseek-ai/dsh-schedule 的提醒只会出现在会话里（官方设计如此，"no email, SMS, or push notification"）。dsh-notify 监听同一份 schedule/change 事件流，把每一次触发同步推送到你的渠道——提醒也能到达会话之外了。

支持的渠道

| 渠道 | 配置项 | 说明 |
|---|---|---|
| telegram | botToken, chatId, apiBase? | Bot API sendMessage；apiBase 用于自托管 Bot API 服务器 |
| slack | url | Incoming webhook |
| discord | url | Webhook |
| feishu 飞书 | url, secret? | 自定义机器人，支持 HMAC 签名 |
| dingtalk 钉钉 | url, secret? | 自定义机器人，支持 HMAC 签名 |
| bark | deviceKey, barkServer? | iOS 推送，服务器默认 https://api.day.app |
| ntfy | topic, server?, token? | 服务器默认 https://ntfy.sh |
| webhook | url, headers? | 通用 POST，body 为 { title, message, level, source, timestamp } |

可以配置任意多个渠道，每条通知并发投递到全部渠道；单个渠道失败不影响其他渠道，工具会返回逐渠道的投递回执。

安装

dsh plugin --profile web add dsh-notify        # 发布到 npm 后
dsh plugin --profile web add github:Lubaoshuai/dsh-notify   # 直接从 GitHub 安装

然后重启 dsh web 会话，notify_send 工具就会出现在对话里。

配置

创建 ~/.dsh/dsh-notify/config.json（尊重 $DSH_HOME 环境变量）：

{
"channels": [
{ "type": "feishu", "url": "https://open.feishu.cn/open-apis/bot/v2/hook/xxx", "secret": "可选" },
{ "type": "telegram", "botToken": "123456:ABC", "chatId": "42" },
{ "type": "bark", "deviceKey": "你的设备 key" }
],
"scheduleNotifications": true,
"timeoutMs": 15000
}

插件同时注册了 dsh-notify 设置命名空间：挂载了设置服务时，设置文档会叠加在配置文件之上。配置变更实时生效，无需重启。

改完文件重启 dsh，然后直接对 Agent 说："测试跑完通知我"，或者用官方 schedule 定个提醒，看它准时出现在手机上。

工作原理

- notify_send 是普通的注册工具：JSON-Schema 参数校验、规范的 { delivered, failed, results } 输出、协作式超时、可并发。
- Schedule 伴侣按会话折叠 version-1 的 schedule/change 事件（create → delete → dispatch），与官方包的折叠规则一致，因此通知能引用原始提醒内容（dispatch 事件本身只带 id）。
- 所有监听器都做了故障隔离：畸形事件、死掉的 endpoint、超时都会被上报，绝不会抛进宿主。
- 冷会话限制：通知只在 dsh 进程运行时能发出（任何进程内插件都一样）。dsh 关闭期间到期的提醒由官方 schedule 在下次恢复会话时补投，届时本插件会同步推送。

安全

- Webhook 地址和 Bot token 都是机密。配置文件位于 DSH_HOME 下；多人共用的机器建议设置文件权限 0600。
- webhook 渠道会向你配置的任意 URL 发数据——请使用 HTTPS，并把它当作出站集成而非入站 API。

开发

npm install
npm run check        # 类型检查 + 测试 + 构建 + pack 试运行

- npm run typecheck —— 两次 tsc 检查（源码、源码+测试）
- npm test —— vitest：折叠协议、逐渠道 HTTP 载荷（本地 node:http 服务器）、签名算法、配置归一化
- npm run build —— tsc 输出到 lib/（JS 到 lib/，声明到 lib/types/）

peer 依赖跟随已发布的 @deepseek-ai/* 包；插件按真实加载方式验证（cordis.patch.yml 中的 dsh.bundle patch 行，行名 = 包名）。

路线图

- v0.2：Web UI 插件页的浏览器设置卡片
- v0.2：SMTP 邮件渠道
- v0.3：分渠道免打扰时段与指数退避重试

许可证

MIT