前言¶

在使用 DeepSeek Harness（DSH）進行開發或調試時，側邊欄通常只承載對話內容。開發者難以直觀掌握當前會話的上下文剩餘量、Provider 的資源餘額以及工作區的累計投入時間。dsh-hud 插件通過引入遊戲化的 HP/MP/TIME 指標，將這些關鍵狀態直接嵌入 Harness 的側邊欄，無需額外搭建 Dashboard。

是什麼¶

dsh-hud 是一個爲 DeepSeek Harness 側邊欄設計的狀態顯示插件。它由 yuanliangxiannan 維護，採用 MIT 許可證。

核心價值在於提供三個直觀的儀表：
* HP（生命值）: 當前會話剩餘上下文容量。
* MP（魔法值）: 當前 Provider 剩餘資源。
* TIME（時間）: 當前工作區 Agent 累計工作時間。

核心功能¶

插件提供以下核心能力：

1. Provider-aware MP: 資源顯示跟隨實際 Provider 路由，而非模型名稱。支持 DeepSeek Official（顯示餘額）和 OpenCode Go（顯示 5H/Weekly/Monthly 配額，主值取最緊張窗口）。
2. 56px Rail: 側邊欄收窄至 56px 時，自動切換爲 Mini HUD（豎條 + Tooltip），不佔用額外空間。
3. 交互控制: 支持手動摺疊/展開完整 HUD（約 34px 圖標按鈕），點擊彈出詳情面板，並支持官方 COMPACT 動作。
4. 數據來源:
   • HP: 基於 Harness 的 contextPressure projection。
   • TIME: 對 session 的 turn/start → turn/end 做區間去重統計。
5. 配置: 支持自定義餘額滿格金額 (mpMaxBalance) 和資源刷新間隔 (balanceRefreshMinutes)。

安裝與啓用¶

從 Releases 下載 dsh-hud-0.1.0.tgz，然後執行以下命令。

BigFish 用戶:

dsh plugin --profile web add ./dsh-hud-0.1.0.tgz

原生 DeepSeek Harness 用戶:

dsh plugin add ./dsh-hud-0.1.0.tgz

安裝後完全退出並重啓 Harness，配置即可生效。

典型用法¶

1. 查看狀態: 側邊欄底部會顯示當前 HP、MP 和 TIME。HP 看上下文，MP 看資源，TIME 看工作區累計時間。
2. 摺疊/展開: 在寬側邊欄模式下，點擊 HUD 可將其摺疊爲單個圖標按鈕（約 34px），再次點擊恢復。
3. Rail 模式: 當側邊欄收窄至 56px 時，狀態欄自動變爲 Mini HUD，僅顯示豎條圖標和 Tooltip。

注意事項¶

1. 支持範圍: v0.1.0 僅內置 DeepSeek Official 和 OpenCode Go 的適配器。使用其他 Provider（如 GLM、OpenRouter）時 MP 顯示 --。
2. Rail 模式: Rail 模式下不顯示具體數字，僅保留視覺豎條。
3. 功能限制: 暫無 EXP/等級/成就/統計圖/歷史記錄等擴展功能。
4. 安全性: 插件僅在 Host 進程內解析 Provider 憑證（環境變量引用），絕不傳輸到 Client bundle、RPC 或日誌中。
5. 兼容性: 需要 DeepSeek Harness 版本 0.1.0-rc.6 及以上，Node.js >= 20。

總結¶

dsh-hud 通過直觀的儀表盤幫助開發者實時監控資源消耗，適合需要精細管理上下文和 API 資源的使用場景。

• GitHub 倉庫
• 社區目錄