dsh-session-hud：DeepSeek Harness 會話懸浮窗插件

前言¶

DeepSeek Harness (DSH) 在運行長任務時，用戶往往會切到其他窗口，導致無法實時掌握當前進度或遺漏待批准的工具調用。dsh-session-hud 插件旨在解決這個問題，它將運行中會話的當前工作內容與待批准提示實時推送到一個獨立的 WinUI 3 懸浮窗中。

該插件由 xieani090612 維護，採用 MIT 協議開源。

核心功能¶

• 獨立懸浮窗：基於 WinUI 3 構建，獨立於 DSH 主界面運行。
• 實時狀態展示：顯示運行中會話的當前工作與待批准提示。
• 窗口交互：支持窗口拖動、縮放、置頂，並跟隨系統明暗主題。
• 自適應佈局：界面會隨窗口大小自適應，支持列表與格子雙視圖切換。
• 便捷入口：在 DSH 側邊欄提供打開按鈕，支持 /hud 命令調用。

安裝¶

1. 確保當前 DSH 版本包含插件系統。
2. 執行安裝命令（需替換 <profile> 爲你的配置檔名稱）：

dsh plugin --profile <profile> add file:C:\path\to\dsh-session-hud-1.1.0.tgz

也可以使用 link: 方式指向本地目錄：

dsh plugin --profile <profile> add link:C:\path\to\dsh-session-hud

安裝完成後需要重啓 DSH 以加載新模塊。

使用方式¶

• 命令調用：在 DSH 中輸入 /hud 即可喚出懸浮窗。
• 側邊欄入口：插件加載後，會在 DSH 側邊欄提供相應的打開按鈕。
• 窗口操作：窗口支持自由拖動、縮放。可以將窗口拖至副屏或縮小至單條顯示。

技術細節與限制¶

• 平臺依賴：僅支持 Windows 10 及以上系統。
• 零運行時依賴：dist/ 目錄爲自包含發佈，用戶無需安裝 .NET 運行時或 Windows App Runtime。
• 通信機制：插件宿主與懸浮窗通過臨時文件加原子重命名的方式交換狀態快照，避免併發讀取問題。
• 圖標授權：插件代碼遵循 MIT 協議，但默認圖標（來源於立繪生成）的版權不在 MIT 覆蓋範圍內。如需重新分發，需單獨確認圖標權利或自行替換 assets/icon-source.webp 並重新生成 app/app.ico。

總結¶

dsh-session-hud 通過原生 WinUI 3 窗口爲 DSH 提供了即時的狀態監控能力，解決了長時間運行任務中狀態丟失或操作遺漏的問題。對於需要在多任務環境下管理 DSH 會話的開發者，該插件提供了一個輕量級且不依賴複雜運行時的解決方案。

GitHub 倉庫 | 插件目錄