前言¶

在 DeepSeek Harness（dsh）Web 裏跑智能體時，倉庫有沒有未提交改動、當前連了哪些 MCP、會話 token 用了多少，往往要切終端或翻日誌。dsh-hud 把這類信息收進輸入欄旁的一個浮動面板，點一下儀表盤圖標即可查看，不必離開對話界面。

下面介紹這個由社區維護者 a903067276-rgb 開發的客戶端插件：它是什麼、能看什麼、怎麼裝、怎麼用，以及安裝前需要注意的事項。

這是什麼¶

dsh-hud 是面向 DeepSeek Harness Web 端的 HUD 狀態面板插件。輸入工具欄增加一個儀表盤按鈕，點擊後在右側打開可拖拽寬度的浮動面板，集中展示 Git 狀態、MCP 服務、Skills、官方用量與會話統計；按鈕上還會顯示未提交文件數量的即時角標。

項目託管於 GitHub（a903067276-rgb/dsh-hud），在 SkillHub 社區目錄歸類爲「客戶端」；當前 package.json 版本爲 1.2.16，許可證 MIT。這是社區獨立項目，非 DeepSeek 官方產品。

核心功能¶

面板內數據大致分爲以下幾塊，均來自本地運行的 dsh 實例（餘額除外，見下文）。

Git

• 分支名、ahead/behind、未暫存 / 已暫存 / 未跟蹤文件（可摺疊分組）
• 每個文件顯示 +N/-N 摘要，點擊可展開完整 diff
• 最近 5 條 commit

MCP

• 從工具名 mcp__<server>__<tool> 推導出的已連接 MCP 服務列表

Skills

• 當前 agent 可用的 skills 列表

官方用量與會話

• 當前模型與 reasoning effort、plan mode 狀態
• Token 用量（input / output / cache-hit rate）
• 會話統計：turns、steps、LLM 與 tool 耗時、decode tok/s、context 使用百分比
• 按模型拆分的 token 桶（requests、input、cache、output），切換 flash/pro 後仍可同時看到

餘額

• 通過宿主側 GET /user/balance 拉取官方 DeepSeek 賬戶餘額，使用 DEEPSEEK_API_KEY 憑證；密鑰不離開宿主，不可用時顯示 --

工具欄按鈕在未打開面板時仍會對 Git 做輕量輪詢，角標數字即未提交文件數。

安裝與啓用¶

本倉庫是官方 bundle 插件（根目錄 package.json 含 dsh.bundle 與 dsh.client），通過 profile 管理器安裝：

dsh plugin --profile web add "github:a903067276-rgb/dsh-hud#main"

安裝後需 重啓 dsh web（bundle 層在啓動時組裝，HMR 不生效）。dsh plugin 會轉發到 pnpm，因此需要 pnpm 在 PATH 中。

手動掛載備選路徑見倉庫 docs/install.md。官方 bundle 安裝與手動掛載 二選一，不要同時使用。

版本兼容

舊版安裝示例：

dsh plugin add github:a903067276-rgb/dsh-hud#v1.2.11

dsh plugin add github:a903067276-rgb/dsh-hud#rc6-compat

環境要求

• DSH Web >= 0.1.1-rc.1（例如 npx @deepseek-ai/dsh web）
• git CLI 在 PATH 中
• DSH 的 shell 服務在各平臺通過 bash -c 執行命令（Windows 爲 Git Bash），無需額外 shell

平臺支持：macOS 已在開發環境完整測試；Linux 與 Windows 尚未充分測試，預期可用，細節見 docs/install.md#平臺支持。

典型用法¶

1. 按上文命令安裝並重啓 dsh web。
2. 在輸入工具欄找到 儀表盤（gauge）圖標（遵循 DSH 官方 design tokens，隨深色/淺色主題切換）。
3. 點擊打開右側浮動面板（默認寬 240px）；拖拽左邊緣可在 200–480px 間調整，寬度記入 localStorage。
4. 帶數量角標的分區標題可點擊摺疊/展開；數據每 30 秒自動刷新（面板關閉時僅 Git 角標繼續輕量輪詢）。

可選環境變量：在目錄樹極大、文件監視不可靠的機器上，可設 DSH_HUD_NO_WATCH=1 關閉文件監視，改由 30 秒輪詢與手動/焦點刷新驅動更新。默認監視深度上限爲 128。

架構簡述¶

宿主（Node，lib/index.js）通過 webServer 註冊 /api/dsh-hud 路由，在單次 bash -c 中執行 Git 命令；瀏覽器端（lib/client.js）在 input.left 座位掛載按鈕、在 shell.overlay 座位掛載面板，二者通過模塊級 store（useSyncExternalStore）共享狀態。客戶端爲手寫 window.__ModuleLoader__.load(...) bundle，無構建步驟、零運行時依賴。維護者細節見 docs/architecture.md。

設計取向是 只讀、極簡：不執行 git 寫操作、不設獨立配置頁；若需要提交/推送 UI 或文件樹，應選用其他 SCM 類插件，dsh-hud 僅作一眼可用的狀態 HUD，可與它們並存。

適用場景與注意¶

適合在 DSH Web 里長時間對話、需要隨時確認倉庫髒文件、MCP 連接、token 與會話指標的智能體開發者。

安裝前應知：

• 插件以當前 dsh 進程的權限運行，會執行本地 git 命令並讀取 MCP/skills 投影；除官方餘額 API 外無其他出站請求。
• 餘額功能依賴宿主配置的 DEEPSEEK_API_KEY。
• 社區目錄 SkillHub 與 DeepSeek / 幻方無官方從屬關係；安裝前建議自行查看源碼與 MIT 許可證。

若你希望在 Web 對話界面內快速掃一眼項目與會話狀態，而不打開終端或另開工具，dsh-hud 提供的是輕量只讀 HUD，安裝成本低、與 DSH「一切皆插件」的生態一致。

• 目錄頁：https://www.skillhub.cn/plugins/a903067276-rgb/dsh-hud
• GitHub：https://github.com/a903067276-rgb/dsh-hud