qsjzqssh / mc-hud

mc-hud

Minecraft 风格的 DeepSeek Harness 消耗 HUD 插件：侧边栏底部显示 红心（解码速度 tok/s）+ 鸡腿（余额剩余），顶栏模式标签与模式选择器使用原版 Minecraft 图标。

📖 人类用户读本文件；维护/修复的 AI 请读 AI_GUIDE.md（架构、坑史、改法全在里面）。

⚠️ 声明：本插件为非官方粉丝项目，与 Mojang / Microsoft 无关。HUD 图标为 Minecraft 素材的非商业派生作品，版权归 Mojang / Microsoft 所有；原图不随仓库分发（仅开发需要），运行只依赖内嵌的小尺寸派生像素图。请勿商用。

功能

• 红心 ×10：当前解码速度 tok/s（与输入框下方统计行同源），锚点分段映射 (0→10, 100→9, 130→7, 200→3)，半心粒度
• 鸡腿 ×10：DeepSeek 余额剩余，上限 ¥100、每 ¥10 一格（半格粒度）
• 信息行：缓存命中率（红心标签右侧）、本会话累计消耗 ≈¥（鸡腿标签右侧，按 DeepSeek-V4-Flash 官方空闲价估算）
• 模式图标：顶栏标签 + 英雄屏选择器使用原版像素图标——普通=铁剑、极简=地图、PTC=命令方块、创造=草方块
• 余额每 60 秒刷新（失败 15 秒重试）；UI 每 2 秒更新；侧边栏窄栏时自动隐藏；图标自适应侧边栏宽度

安装

方式 A：npm（最简单，推荐）

dsh plugin --profile web add mc-hud

或直接加到 Web profile 的依赖：

cd ~/.dsh/profiles/web
pnpm add mc-hud        # 或 npm install mc-hud

然后在 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 里加 "mc-hud"，重启 DSH 生效。 （npm 包名：mc-hud，npm 页面）

方式 B：从 Git 仓库

dsh plugin --profile web add "github:qsjzqssh/mc-hud#v1.0.0"

重启 DSH 后生效。

方式 C：本地目录

dsh plugin --profile web add /path/to/mc-hud

或手动：把 mc-hud/ 放到 ~/.dsh/profiles/web/ 下，在 ~/.dsh/profiles/web/package.json 的 dependencies 加 "mc-hud": "file:./mc-hud"、dsh.profile.bundles 加 "mc-hud"，然后 cd ~/.dsh/profiles/web && corepack pnpm install，重启。

卸载

从 ~/.dsh/profiles/web/package.json 移除 mc-hud 依赖与 bundle 项，删除 ~/.dsh/profiles/web/mc-hud/（及 node_modules/mc-hud），corepack pnpm install，重启。

技术说明

• Host 半（lib/index.js）：ctx.remote（typert Remote）提供 getHud / getPresets / setDefaultPreset；余额经 credentials.resolve('DEEPSEEK_API_KEY') + shell.run(curl) 查询（key 只走 env）；tok/s 与缓存命中读 sessionProjections 的 sessionStats / tokenUsage（与统计行同源）；价格常量 PRICE_IN_MISS/HIT/OUT（V4-Flash 官方空闲价）。
• Client 半（lib/client.js）：window.__ModuleLoader__.load wire 格式；插槽注册：sidebar.footer.action（HUD）、conversation.session.header.actions id agent-preset priority -1（替换官方标签）、conversation.hero.agentPreset priority -1（替换选择器）。全部注册带 try/catch，任一失败不影响启动。
• 素材：assets/ 内含原版 16×16 精灵图（红心/鸡腿/模式图标）；客户端内嵌 base64，无需外部文件。

调参

价格常量在 lib/index.js（PRICE_IN_MISS=1.5、PRICE_IN_HIT=0.05、PRICE_OUT=4.5，高峰时段翻倍）；红心锚点在 lib/client.js 的 heartsFromTok；BALANCE_CAP 为鸡腿上限。

开发

npm run check        # 语法检查两个 lib 文件

改动后同步部署副本：cp lib/*.js ~/.dsh/profiles/web/mc-hud/lib/ && cp lib/*.js ~/.dsh/profiles/web/node_modules/mc-hud/lib/（file: 依赖是硬链接副本，必须同步），然后重启。

License

MIT（见 LICENSE）。贴图素材版权归其原作者/游戏资产所有者所有，仅用于个人用途；发布分发前请自行确认素材授权。