在 DeepSeek Harness (DSH) 中開發智能體時,需要時刻監控 Web UI 中的交互狀態。如果代理在後臺運行或長時間未響應,開發者容易錯過關鍵的通知信息。這個插件通過 Windows 系統級通知解決了這個問題,讓回合結束的狀態變得顯性。
這是什麼¶
這是一個名爲 hxy113/dsh-turn-notify 的 DSH 插件,由開發者 hxy113 維護。它利用 Windows 原生的 Toast 機制,在智能體完成一個回合時提醒用戶,並提供點擊跳轉功能。插件遵循 MIT 許可證。
核心功能¶
- Windows Toast 通知:當智能體回合結束時觸發系統級通知。
- 點擊跳轉:點擊通知可自動打開 Web UI 並定位到該會話。
- 會話過濾:僅對根會話(交互式會話)觸發,避免子代理或工作流內部回合造成干擾。
安裝與啓用¶
安裝插件並啓動 Web UI:
dsh plugin --profile web add github:hxy113/dsh-turn-notify
dsh web
典型用法¶
- 啓動 DSH Web UI。
- 運行智能體並完成一個回合。
- 右下角彈出 Windows Toast 通知。
- 點擊通知,瀏覽器自動打開並定位到該會話。
適用場景與注意¶
- 環境要求:需要 Windows 10/11,且運行
dsh web。 - 通知攔截:通知可能被系統的“專注助手”或應用通知設置攔截,這是 Windows 自身行爲,需檢查設置。
- 卸載:如需移除,執行:
dsh plugin --profile web remove dsh-turn-notify
卸載時會自動清理註冊表鍵值和遺留快捷方式。
- 技術細節:插件通過監聽
agent/turn-stopping事件,使用powershell.exe -STA配合 WinRTToastNotificationManager發送通知。點擊後通過註冊的/jump-session路由恢復會話。
總結¶
這個工具讓智能體開發過程中的狀態追蹤變得輕量且即時,適合需要頻繁交互和監控的場景。插件源碼位於 GitHub。