前言¶
在 Windows 上用 DeepSeek Harness（DSH）桌面端跑多個智能體會話時，主窗口一最小化，就很難一眼看出哪條會話在跑、哪條在等審批、哪條剛結束。切回 DSH 再翻列表也費時間。dsh-session-hud 是社區插件，在 DSH 最小化或隱藏時彈出一塊始終置頂的玻璃風格浮層，集中展示會話狀態，並支持一鍵回到對應會話。下文按「是什麼 → 能做什麼 → 怎麼裝 → 怎麼用 → 注意點」說明，事實均來自插件 GitHub README 與 package 元數據。
這是什麼¶
- 名稱：
dsh-session-hud（倉庫 wangjiaqizero/dsh-session-hud） - 維護者：wangjiaqizero（README 作者字段爲 Session HUD contributors）
- 分類：客戶端（DSH 插件目錄歸類爲客戶端）
- 許可證：MIT
- 當前版本（package.json）：0.1.0
- 定位：面向 DeepSeek Harness 的桌面浮層 HUD；DSH 在屏幕上時浮層隱藏，最小化或隱藏 DSH 時出現；僅支持 Windows 10/11（x64），macOS / Linux 暫未支持。
插件以 DSH desktop 0.2.x 爲宿主，依賴桌面端的窗口狀態上報；瀏覽器裏跑的 dsh web 沒有可跟隨的桌面窗口，因此不適用。
核心功能¶
README 中已列出的能力如下，安裝前可對照是否符合你的 workflow。
- 跟隨 DSH 窗口：DSH 可見時 HUD 隱藏；最小化或隱藏後出現；DSH 恢復後再隱藏。
- 實時會話狀態：運行中 / 等待審批 / 剛結束 / 錯誤，並顯示工具名、回合或步驟、已用時間。
- 一鍵回到會話：點擊 HUD 中某一行會打開 DSH（若已最小化則恢復），並導航到該會話。
- 貼邊收納（Edge dock）：把浮層拖到左、右或上邊緣約 24 px 內，會收成細條標記（彩色信標 + 運行中會話數）；懸停展開，拖標題欄回屏內可恢復常規浮窗。
- 行內審批：待審批卡片可在 HUD 上直接點「允許 / 拒絕」。
- 頁腳控制：透明度、始終置頂、「跟隨」模式；設置與位置在重啓後保留。
- 隱私取向的日誌：診斷日誌按設計不記錄會話標題、標識符或絕對路徑。
浮層本身是 Electron 窗口；首次展示時會一次性下載 Electron 運行時（約 110 MB，與插件版本共享緩存）。
環境要求¶
| 項 | 要求 |
|---|---|
| 系統 | Windows 10/11 x64 |
| DSH | desktop 0.2.x（engines.dsh: >=0.2.0-0 <0.3.0-0） |
| Node（開發/測試） | >= 20 |
| 磁盤 | 約 110 MB 用於 Electron 運行時（僅首次） |
| Electron（插件捆綁版本） | 44.7.0 |
安裝與啓用¶
在 DSH desktop 配置下添加插件，然後重啓 DSH：
dsh plugin --profile desktop add dsh-session-hud
也可在 DSH 的 Plugins → Discover 中安裝（以目錄是否上架爲準）。
重啓後，側欄頁腳會出現「mobile window」類按鈕；點擊它，或最小化 DSH，即可顯示 HUD。
首次運行與 Electron 運行時¶
首次顯示浮層時，插件會把 Electron 運行時下載到：
%USERPROFILE%\.dsh\session-hud\runtime\
默認先試 npmmirror 鏡像，失敗則回退到 Electron 官方 GitHub release。若網絡都不可達，可指向本機已有的 electron.exe：
$env:HUD_ELECTRON_PATH = "C:\path\to\electron.exe"
也可將已解壓的 electron-v44.7.0-win32-x64 目錄複製到上述 runtime 路徑。
典型用法¶
下表摘自 README，便於日常對照。
| 操作 | 方式 |
|---|---|
| 顯示 / 隱藏 | 側欄頁腳按鈕，或開啓跟隨 DSH 窗口 |
| 打開某條會話 | 點擊 HUD 中的行 |
| 處理審批 | 在審批卡片上點允許 / 拒絕 |
| 貼邊收納 | 拖窗口至左 / 右 / 上邊緣 24 px 內 |
| 展開已收納 HUD | 懸停邊緣標記（或點擊） |
| 取消收納 | 把展開面板的標題欄拖回屏幕內 |
| 跟隨模式 | 頁腳「跟隨」開關（開 = 跟隨 DSH 窗口） |
| 透明度 / 置頂 | 頁腳控件 |
本地通信走 127.0.0.1 的 41333–41342 端口橋接；除一次性下載 Electron 外不向公網發數據，README 稱無遙測。運行時狀態（窗口位置、貼邊、透明度、日誌等）在 %USERPROFILE%\.dsh\session-hud\；刪除該目錄可重置全部 HUD 狀態。
卸載插件：
dsh plugin --profile desktop remove dsh-session-hud
卸載後 session-hud 目錄默認保留（避免再次安裝時重複下載運行時）；若要騰出空間並徹底重置，需手動刪除該文件夾。
適用場景與注意¶
適合誰
- 長期在 Windows 桌面用 DSH 0.2.x，會同時開多條會話，且習慣最小化主窗口騰出屏幕的用戶。
- 需要最小化 DSH 後仍能看運行 / 待審批狀態，並希望從浮層直接審批或跳回會話的場景。
務必注意
- 平臺與宿主：僅 Win32；須用 DSH 桌面應用，不是
dsh web。 - 插件權限：插件在當前 DSH 進程權限下運行，安裝前建議自行查看 源碼倉庫 與 MIT 許可證。
- HUD 不出現時：確認插件在
desktopprofile 已啓用並重啓 DSH；DSH 在前臺時 HUD 會刻意隱藏——需最小化 DSH 或點側欄按鈕。 - 運行時下載失敗：查看
%USERPROFILE%\.dsh\session-hud\logs\hud-host.log，重試（客戶端/hud/restart或重啓 DSH），或設置HUD_ELECTRON_PATH。 - 端口占用：41333–41342 均被佔用時插件會報錯，HUD 按鈕可能顯示「未連接」。
- 升級後貼邊佈局異常：可刪除
%USERPROFILE%\.dsh\session-hud\userdata\overlay-state.json重置幾何狀態。 - 調試：可選
HUD_DEBUG=1開啓診斷；README 強調內容爲脫敏設計。
DSH 生態遵循「一切皆插件」；SkillHub 插件目錄 爲社區站點，與 DeepSeek / 幻方無官方從屬關係，安裝來源以你實際使用的 registry / Discover 列表爲準。
結尾¶
dsh-session-hud 解決的是「DSH 最小化後會話狀態不可見」這一具體問題：浮層置頂、可貼邊、可審批、可一鍵回會話，且數據與橋接限於本機。若你在 Windows 上常駐 DSH desktop 0.2.x，可按上文命令安裝並在首次運行時預留 Electron 下載時間與磁盤空間。
- 目錄頁：https://www.skillhub.cn/plugins/wangjiaqizero/dsh-session-hud
- GitHub：https://github.com/wangjiaqizero/dsh-session-hud
