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)均爲迴環限制、方法檢查和大小限制。 - 通知結構:通知內容固定包含事件類型、主機、會話、詳情四個部分。