前言¶
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 进程权限运行,请确保安装源可信。