前言¶
在使用 DeepSeek Harness（DSH）進行智能體開發時，Agent 常常處於等待人工介入的狀態，例如需要授權工具或回答問題。開發者通常需要手動盯着 DSH 窗口，這會打斷當前的工作流。這個插件通過 Windows 原生通知解決這一問題，允許 Agent 在後臺運行時主動通過系統橫幅或卡片告知狀態，開發者無需一直聚焦窗口即可掌握進度。
插件簡介¶
這是一個由 VoodooB0Ys 維護的 DSH 插件。它提供 Windows 原生 Toast 橫幅和全屏兜底卡片，在 Agent 需要授權、提問、完成、出錯或中止時觸發提醒。點擊通知即可直接切回對應的 DSH 對話，實現分屏工作的無縫銜接。
核心功能¶
- Windows 原生 Toast 橫幅：使用系統原生通知渠道。
- 全屏兜底卡片：當橫幅被 Windows 壓掉時，顯示自定義置頂卡片。
- 事件提醒：支持授權、提問、完成、出錯、中止五種事件。
- 點擊交互：點擊通知將切換回對應對話並滾動至最新消息。
- 聚焦抑制：當開發者正看着該對話時，不會彈出干擾。
- 子代理提醒：支持爲子代理/會話開啓提醒（默認關閉）。
- 去重機制：短時間內同一事件只提醒一次。
安裝與啓用¶
使用 DSH 插件管理器進行安裝：
github:VoodooB0Ys/dsh-desktop-notify
安裝後需重啓 DeepSeek Harness 宿主進程（熱重載不生效）。
典型用法¶
安裝完成後，插件默認啓用。可以通過編輯 profile 的 cordis.patch.yml 來調整提醒行爲，例如關閉原生橫幅、調整去重時間窗口或設置子代理提醒開關。
適用場景與注意¶
- 系統要求：僅支持 Windows 10/11 (x64)。依賴 PowerShell 5.1 和 .NET Framework 4。
- 版本要求：需要 DSH 0.2.0-rc.2 或兼容版本。
- 運行機制：需要註冊 COM 激活器以實現點擊通知切換對話的功能。
- 熱重載限制：修改代碼後必須重啓宿主進程，插件在啓動時註冊路由。
- 回合判定：短於 5 秒的回合結束不算作“完成”。
- 權限：插件以當前 DSH 進程權限運行，請從可信源安裝。
短結尾¶
dsh-desktop-notify 解決了智能體開發中“盯着屏幕等待”的痛點，讓 Agent 的長任務可以在後臺靜默運行，僅在你需要它時出現。更多詳情請訪問 GitHub 倉庫。
