前言¶
在 DeepSeek Harness (DSH) 的 Web 環境中運行 Agent 或工作流時,任務往往在後臺持續執行。當任務完成、需要人工審批、計劃待確認或目標受阻時,如果瀏覽器處於關閉或後臺狀態,這些關鍵狀態很容易被遺漏。dsh-task-notify 插件解決了這個問題,它利用 Windows 系統原生的通知機制和 PushPlus 微信推送,確保你在任何情況下都能及時收到任務反饋。
插件簡介¶
該插件由開發者 V-Reason 維護,是一個開源的 DSH Web 客戶端插件。它不依賴瀏覽器權限,而是通過 PowerShell 調用 Windows 通知中心。插件支持在任務完成、需要審批、詢問用戶、計劃待確認以及目標受阻時發送通知,並提供獨立的開關控制,支持持久化配置和佈局自適應。
核心功能¶
-
系統級 Windows 通知
插件通過調用 PowerShell 7 的BurntToast模塊,向 Windows 通知中心發送消息。這包括顯示通知內容、播放系統提示音,並使用 DeepSeek 官方圖標。 -
手機推送(PushPlus)
插件集成了 PushPlus 服務,支持將任務通知同步推送到微信。即便電腦不在身邊,也能通過手機接收提醒。 -
通知內容與分類
- 內容:包含會話名(沿父鏈回溯到根會話)、時間、任務狀態(完成/失敗/中止等)。
- 分類觸發:支持多種場景的獨立提醒,包括需要審批(提權/越權)、詢問用戶(
ask_user_question)、計劃待確認(/plan完成後提交計劃)、目標受阻(持續阻塞停止)。
-
圖標熱更新
通知圖標默認讀取包內的deepseek.png。替換該文件後,下一條通知會自動使用新圖標,無需重建插件或重啓 DSH。 -
佈局自適應
插件的配置面板會自動跟隨dsh-better-sidebar的佈局,在右側面板和底部面板展開時進行高度讓位,確保不遮擋界面。
安裝與配置¶
安裝命令
在 DSH 的 Web profile 環境下執行以下命令:
dsh plugin --profile web add git+https://github.com/V-Reason/dsh-task-notify.git
前置環境要求
確保系統滿足以下條件:
* Windows 10/11。
* PowerShell 7 (pwsh)。
* 已安裝 BurntToast 模塊:
Install-Module BurntToast -Scope CurrentUser
重要配置說明
- 宿主行注入:本插件自帶
cordis.patch.ymlbundle 補丁用於注入宿主行,不要在 profile 的cordis.patch.yml中手動再次寫入dsh-task-notify,否則會導致啓動報錯。 - pnpm 構建限制:在 profile 的
pnpm-workspace.yaml中,必須確保allowBuilds: node-pty: true爲true,否則安裝會因ERR_PNPM_IGNORED_BUILDS失敗。
使用說明¶
-
獲取 PushPlus Token
訪問 https://www.pushplus.plus 掃碼登錄,複製「一對一推送」的 Token。 -
配置手機推送
點擊 DSH 界面標題欄右側的鈴鐺圖標,展開「手機推送」層,打開 PushPlus 開關並粘貼 Token。點擊「保存 Token」(或按回車)。 -
測試通道
使用「通知類型」層的「測試 Windows 通知」與「手機推送」層的「測試手機推送」按鈕驗證推送是否正常。 -
調整通知類型
在「通知類型」層中,根據需求獨立開關各類通知,例如「需要審批」、「詢問用戶」、「計劃確認」或「目標受阻」。
注意事項¶
- 審批策略:當審批策略爲
never(例如danger-full-access權限預設)時,審批請求會被自動拒絕,無需人工操作,因此不會發送審批提醒。 - 配置持久化:除 Token 文本輸入需要點擊保存外,所有開關調整均爲即改即存,無需手動保存。
- 版本兼容:插件依賴 DSH 的 profile 插件機制,安裝後需確保宿主環境滿足相關依賴要求。
結語¶
dsh-task-notify 通過系統通知和微信推送,降低了 DSH Agent 運行時的信息獲取成本。它提供了一套從安裝到使用的完整方案,適合需要在後臺穩定運行任務並希望實時獲取狀態的開發者。
- GitHub 倉庫: https://github.com/V-Reason/dsh-task-notify
- 插件目錄: https://www.skillhub.cn/plugins/V-Reason/dsh-task-notify