DeepSeek Harness 的核心設計理念是「一切皆插件」。在開發或運行智能體任務時,任務可能在後臺靜默執行,開發者難以實時掌握任務狀態(如正在運行、等待審批或出錯)。dsh-notify-yimit 插件旨在解決這一狀態斷層問題,通過系統通知或桌面浮窗,在任務關鍵節點提醒用戶,並提供跳轉會話的入口。
插件簡介¶
- 名稱:
yimlt/dsh-notify-yimit - 維護者:YiMlT
- 定位:DeepSeek Harness 任務狀態通知插件
- 核心能力:在任務完成、出錯、運行中、等待審批、等待回答時發送提醒。支持 Windows 系統原生通知與自定義桌面浮窗,點擊可跳轉至對應會話。
核心功能¶
插件通過集成到 DSH 設置頁提供配置能力,主要包含以下功能:
- 通知方式選擇:在設置頁「通知」分節中,提供三種模式:
- Windows 系統通知
- 插件自定義桌面浮窗(默認關閉)
- 關閉(默認)
- 桌面浮窗特性:
- 常駐宿主架構:插件加載時啓動一個 PowerShell 宿主進程,使用 WPF 創建浮窗。所有浮窗在該進程內管理,通知創建延遲從約 1 秒降低至約 10 毫秒。
- 多浮窗堆疊:屏幕右下角無邊框置頂顯示,多個浮窗自動向上堆疊。
- 實時更新:運行中通知支持 400ms 節流原地更新文本,不重彈、不閃爍。
- 狀態性通知:運行中、等待審批、等待回答的狀態性通知,在狀態結束前不會自動消失。
- 自定義樣式:支持配置每種通知類型的背景色和文字色(完成=綠、出錯=紅、運行中=藍、待審批=黃、待回答=紫),以及浮窗顯示數量上限和顯示時長。
- 跳轉功能:支持選擇跳轉瀏覽器(Chrome/Edge/Firefox 等),通過 URL hash
#dsh-notify-yimit/session=<id>定位到對應會話。
安裝與啓用¶
- 執行安裝命令:
dsh plugin --profile web add dsh-notify-yimit
- 重啓
dsh web進程,使插件生效。 - 打開 DSH 界面,前往 設置 → 通知。
- 開啓插件總開關,並選擇通知方式(系統通知或自定義浮窗)。
配置說明¶
- 系統通知:點擊設置頁中的按鈕可一鍵申請瀏覽器通知權限。
- 自定義浮窗:在開啓插件總開關後,可配置顯示數量、顯示時長及顏色。
- 標題處理:若對話標題尚未生成(LLM 異步生成),浮窗將顯示佔位符“(未命名會話)”,待標題事件到達後會原地更新。
注意事項¶
- 運行環境:插件依賴 Windows 平臺及 PowerShell 5.1+ 環境。
- 默認狀態:插件默認關閉,需手動開啓。
- 通知行爲:
- 運行中:實時更新活動文本,直到任務結束。
- 等待審批/回答:不做防抖,多條信息會直接替換更新。
- 完成/出錯:達到配置的顯示時長後自動消失。
- 系統通知依賴:使用系統通知功能需要瀏覽器授予相應的通知權限。
總結¶
dsh-notify-yimit 通過常駐 PowerShell 宿主進程實現了低延遲的桌面浮窗體驗,並針對 DeepSeek Harness 的運行場景(如工具調用、審批流)進行了優化。對於需要長時間運行或複雜審批流程的智能體任務,該插件能有效提升開發者的掌控感。
- GitHub 倉庫:https://github.com/YiMlT/dsh-notify-yimit
- 插件目錄:https://www.skillhub.cn/plugins/YiMlT/dsh-notify-yimit