前言¶

DeepSeek Harness (DSH) 的生態強調“一切皆插件”。在使用 Agent 開發或自動化任務時，往往需要即時反饋，比如構建完成、審批提醒或定時任務結果。然而，DSH 內置的機制或部分插件默認僅提供會話內的反饋，難以直接觸達手機或第三方協作平臺。dsh-notify 插件旨在解決這一痛點，它提供了 Agent 可直接調用的推送工具，並將官方日程模塊的提醒鏡像到外部渠道。

插件簡介¶

dsh-notify 是由用戶 Lubaoshuai 維護的一個 DSH 插件。其核心價值在於提供兩方面的能力：一是允許 Agent 在運行時通過 notify_send 工具發送任意消息；二是作爲 @deepseek-ai/dsh-schedule 的伴侶，將日程提醒同步到外部渠道，彌補官方 Schedule 僅在會話內生效的缺陷。

核心能力¶

• Agent 可調用工具：插件註冊了 notify_send 工具，Agent 可在對話中調用它，用於推送構建完成、審批請求、定時任務結果等消息。
• 日程提醒鏡像：官方 dsh-schedule 的設計僅限於會話內通知。dsh-notify 監聽相同的 schedule/change 事件流，將提醒鏡像分發到外部渠道。
• 多渠道支持：支持 Telegram, Slack, Discord, 飛書, 釘釘, Bark, ntfy, webhook。
• 併發與容錯：消息會併發發送到所有配置的渠道。單渠道失敗不會阻塞其他渠道，工具會返回各渠道的送達狀態。
• 配置與設置：支持通過配置文件管理，計劃在 v0.2 版本支持 Web UI 插件設置頁。

安裝與啓用¶

使用官方 CLI 安裝該插件：

# 從 npm 安裝（插件發佈後可用）
dsh plugin --profile web add dsh-notify

# 或直接從 GitHub 安裝
dsh plugin --profile web add github:Lubaoshuai/dsh-notify

安裝完成後，需要重啓 dsh web 會話，Agent 才能識別並調用 notify_send 工具。

配置與用法¶

1. 創建配置文件：在 DSH_HOME 目錄下創建 ~/.dsh/dsh-notify/config. 文件。
2. 配置渠道：在文件中定義 channels 列表，指定通知目標。例如配置飛書、Telegram 或 Bark。
3. 啓用日程鏡像：設置 "scheduleNotifications": true，以開啓日程提醒的外部同步。
4. 調整超時：通過 timeoutMs 參數控制通知發送的超時時間。
5. 重啓會話：修改配置文件後，重啓 dsh 進程使配置生效。

Agent 可以通過對話指令調用工具，例如：“請在我測試完成後通知我”。也可以直接使用 Webhook 頻道發送自定義 POST 請求。

注意事項¶

• 敏感信息保護：Bot Token 和 Webhook URL 屬於敏感憑證，建議在配置文件上設置權限爲 0600，避免泄露。
• 進程依賴：DSH 進程關閉時，通知不會發送。下次啓動時，由 schedule 模塊傳遞待發送的提醒。
• 網絡協議：Webhook 頻道應使用 HTTPS 進行出站集成。
• 未來計劃：v0.2 版本計劃增加 Web UI 設置卡片和 SMTP 郵件支持。

總結¶

dsh-notify 通過提供標準化的工具接口和日程同步機制，降低了 DeepSeek Harness 開發者在構建通知系統時的門檻。如果你需要將 Agent 的行爲或定時任務結果實時推送到手機或協作平臺，該插件提供了現成的解決方案。

目錄頁 | GitHub 倉庫