DeepSeek Harness (DSH) 在运行智能体任务时,开发者通常需要保持浏览器标签页打开以接收状态变更。dsh-notify-push 插件通过 ntfy、Bark、Gotify、Telegram 或 webhook 等网络服务,将通知推送到手机和手表,使开发者可以在关闭机器的情况下接收到 Agent 的运行状态。
核心功能¶
- 多端推送:支持推送通知至手机和手表(通过手机通知镜像)。
- 后端支持:支持 ntfy、Bark、Gotify、Telegram、webhook 等服务。
- 事件触发:支持配置 Agent finished、Agent error、Approval needed、Question asked、Test notification 等事件类型。
- 通知内容:通知包含事件类型、主机、会话、详情四个部分,标题支持 DSH · 前缀。
- 设置面板:提供 Settings → Notify Push 设置面板,支持可视化配置。
- 持久化配置:支持通过 cordis.patch.yml 配置,配置修改无需重启即可生效。
- API 接口:提供 status、history、test、config 等接口。
安装与启用¶
- 环境要求:需要 DeepSeek Harness 版本 0.2.0-rc.2 和 Node.js >=22.17.0。
- 生成安装包:在插件目录下运行命令生成安装包:
pnpm run pack
- 安装方式:桌面端 profile 由 Electron 应用管理,不支持
dsh plugin add命令行安装。需在 Settings → Plugins 中安装生成的.tgz包。 - 生效步骤:安装后需要重启 Profile 和重新加载页面,插件才能生效。
典型用法¶
- 打开 Settings → Notify Push 面板进行配置。
- 在 Settings → Notify Push 面板中选择 provider(如 ntfy),填写 server 和 topic。
- 选择需要触发的事件类型并保存。
- 使用面板中的 Send test notification 按钮发送测试通知。
配置示例(cordis.patch.yml)¶
配置同样支持通过 cordis.patch.yml 文件写入,该配置在插件升级后依然保留:
- id: dsh-notify-push
name: dsh-notify-push
config:
provider: ntfy
ntfyServer: https://ntfy.sh
ntfyTopic: <your_topic>
注意事项¶
- 密钥字段:tokens、device keys 等密钥字段为只写,无法查看已存储的值。
- API 限制:所有 API 路由(如
/api/dsh-notify-push/status)均为回环限制、方法检查和大小限制。 - 通知结构:通知内容固定包含事件类型、主机、会话、详情四个部分。