前言¶
DeepSeek Harness (DSH) 採用插件化架構,開發者常需在開發過程中監控 Token 解碼速度與賬戶餘額。mc-hud 是一個非官方插件,它將 DSH 的默認消耗面板改造成了 Minecraft 風格的 HUD,通過紅心和雞腿圖標直觀展示數據。
核心功能¶
該插件通過側邊欄和頂欄兩種方式展示數據,並適配明暗主題。
-
側邊欄顯示
- 底部顯示紅心(解碼速度)和雞腿(餘額)。
- 紅心錨點分段映射:
0→10、100→9、130→7、200→3,支持半心粒度。 - 雞腿支持半格粒度,上限 ¥100,每 ¥10 一格。
- 信息行顯示緩存命中率(紅心右側)與本會話累計消耗(雞腿右側)。
-
頂欄圖標
- 模式標籤與模式選擇器使用原版 Minecraft 圖標:
- 普通 = 鐵劍
- 極簡 = 地圖
- PTC = 命令方塊
- 創造 = 草方塊
- 模式標籤與模式選擇器使用原版 Minecraft 圖標:
-
數據刷新與適配
- 餘額每 60 秒刷新,失敗後 15 秒重試;UI 每 2 秒更新。
- 側邊欄窄欄時自動隱藏。
- 圖標自適應側邊欄寬度。
- 明暗主題自適應,文字顏色、描邊與背景色隨 DSH 主題自動切換。
安裝與啓用¶
使用官方提供的安裝命令即可完成部署。
dsh plugin --profile web add mc-hud
安裝完成後,重啓 DSH 進程即可生效。
技術與配置¶
插件分爲 Host(服務端)和 Client(前端)兩部分。
-
文件結構
lib/index.js:Host 半,處理餘額查詢、價格常量與緩存統計。lib/client.js:Client 半,負責 UI 插槽註冊與渲染邏輯。
-
價格常量與錨點
- 價格常量位於
lib/index.js:
- 價格常量位於
PRICE_IN_MISS = 1.5
PRICE_IN_HIT = 0.05
PRICE_OUT = 4.5
// 高峯時段價格翻倍
* 紅心錨點位於 `lib/client.js` 的 `heartsFromTok` 函數。
- 開發調試
- 修改代碼後,需同步更新副本目錄以生效(針對 file: 依賴)。
- 語法檢查命令:
npm run check
注意事項¶
- 項目性質:本插件爲非官方粉絲項目,與 Mojang / Microsoft 無關。
- 素材授權:貼圖素材爲非商業派生作品,僅用於個人用途,請勿商用。運行只依賴內嵌的小尺寸派生像素圖。
- 權限運行:插件以當前 DSH 進程權限運行,請確保安裝源可信。