前言¶
在 DSH 裏跑長任務時，進度往往只出現在主界面或日誌裏，眼睛要來回找。若你習慣把窗口鋪開到別的空間，很容易誤以爲任務已經停住。dsh-hud 是社區維護的客戶端插件，在屏幕邊緣用獨立透明窗口浮出「聊天氣泡」式通知，把 THINKING、WORKING、STEP DONE、COMPLETED 等事件接到本機 DSH 的 session/event 上，無需額外聯網上報。下面介紹它做什麼、怎麼裝、在什麼環境下能出現氣泡。
這是什麼¶
- 名稱：
dsh-hud（npm 包名），倉庫 nuclearmilk/dsh-hud - 維護者：nuclearmilk
- 分類：客戶端（設置側欄註冊「任務通知流HUD」頁，桌面版由獨立 Electron 進程承載氣泡）
- 協議：MIT（README 與
package.json一致；資料中package.json版本爲 1.5.1） - 定位：Cappella 風格的水潤毛玻璃氣泡 HUD，爲 DeepSeek Harness 彙報任務進度
氣泡數據僅在本地進程間流轉；控制接口監聽 127.0.0.1:52399，配置寫在 Electron userData 下的 dsh-hud-config.json。
核心功能¶
四類進度氣泡¶
插件按會話事件展示四種狀態（README 約定）：
| 狀態 | 行爲要點 |
|---|---|
THINKING |
約 7 秒後自動淡出 |
WORKING |
全程常駐 |
STEP DONE |
短句小結 |
COMPLETED |
輸出摘要 |
視覺與交互（設置頁可調）¶
- 明暗雙主題、透明度 20%～100% 拖動實時生效
- 移動模式可拖拽，鎖定後坐標記憶
- 頭像：莫奈漸變、純色（色輪或
#8b5cf6等形式）、本地圖片 - 本機已安裝字體檢索與切換
allRight：關閉時左右交替彈出；開啓時整齊靠右
長任務與兜底¶
- 常駐「進行中」：未結束可顯示「任務進行中 · 已運行 mm:ss」，設置頁可關，默認開啓
- 靜默兜底：超過設定時長（默認 45 分鐘）無進度事件時自動收起並留說明，避免宿主異常時氣泡一直掛着
運行時自給¶
桌面版裝完即可用，不需要預先安裝 Electron，也不需要 dsh-pet 等插件。缺運行時時插件會從鏡像拉取（README 示例爲 electron 43.3.0，首次約 138 MB，之後複用 ~/.dsh/electron/）。可選用環境變量 DSH_HUD_ELECTRON、DSH_HUD_ELECTRON_MIRROR、DSH_HUD_ELECTRON_DIR、DSH_HUD_ELECTRON_VERSION 指定路徑、鏡像、目錄或版本。
若拿不到任何 Electron 可執行文件，DSH 主流程仍運行，只是無桌面氣泡；日誌會 WARN，設置頁有橙色提示。
安裝與啓用¶
桌面版（Windows / macOS / Linux App，推薦）¶
desktop profile 由 Electron 應用獨佔，命令行無法管理。請用界面安裝：
- 打開 DSH → 設置 → 插件 → 添加插件
- 安裝方式選 Git，輸入框粘貼（不要帶尖括號或中文說明）：
https://github.com/nuclearmilk/dsh-hud
- 點 安裝，等進度完成
- 重啓 DSH（氣泡爲獨立 Electron 進程，由宿主在啓動時拉起）
- 設置側欄出現 「任務通知流HUD」 頁即表示安裝成功
也可用 Releases 的 dsh-hud-<版本>.tgz 下載地址安裝。釘死版本示例：
https://github.com/nuclearmilk/dsh-hud#v1.5.1
# 後寫 commit hash 亦可；不寫則裝默認分支最新代碼。
命令行（僅非 desktop profile，例如 tui）¶
--profile 必填：
dsh plugin --profile tui add https://github.com/nuclearmilk/dsh-hud
對 desktop 執行會報錯：profile "desktop" is managed exclusively by the Electron application。
本地開發可用 link：
dsh plugin --profile tui add link:/path/to/dsh-hud
更新與卸載¶
| 操作 | 做法 |
|---|---|
| 更新（Git / link） | 界面卸載後重裝；link 方式 git pull 後重啓 DSH |
| 卸載 | 設置 → 插件 → 選中 dsh-hud → 卸載 → 重啓 DSH |
典型用法¶
- 按上文在桌面版 DSH 安裝並重啓。
- 打開 任務通知流HUD 設置頁，按需調主題、透明度、位置、
allRight、常駐進行中、靜默超時時長等。 - 在本機 DSH 正常發起會話任務；氣泡隨
session/event在屏幕邊緣彈出。無需單獨啓動 HUD 進程。
若設置裏有頁但屏幕無氣泡：常見於宿主不是 Electron 桌面（CLI / web profile）。桌面版一般不需額外處理；非桌面環境 README 說明氣泡不會出現。
升級後界面仍舊：舊氣泡可能是 detached 進程佔用端口 52399；1.4.2 起啓動時會向舊實例發 /api/quit。仍異常時可手動結束殘留 electron 進程後重啓 DSH。
適用場景與注意¶
適合：經常在桌面 DSH 跑 agent / 長步驟任務，希望餘光能看到進度、又不想切回主窗口的人。
注意：
- 插件以當前 DSH 進程權限運行；安裝前建議閱讀倉庫源碼與 MIT 許可證。
- 社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；星標等元數據以各站點實時爲準（資料線索爲 0 star）。
- 不聯網、不上報；仍會在本機拉取 Electron 運行時（若本地尚無）。
結尾¶
dsh-hud 把 DSH 會話進度翻譯成屏幕邊緣的氣泡通知，長任務有「進行中」計時與無事件超時收起，桌面版自帶 Electron 獲取邏輯。需要細節與排障表見倉庫 README。
- 目錄頁：https://www.skillhub.cn/plugins/nuclearmilk/dsh-hud
- GitHub：https://github.com/nuclearmilk/dsh-hud
