deepseekplugins

DeepSeek Harness plugin

mc-hud

Minecraft-style token consumption HUD for the DeepSeek Harness web GUI: hearts = decode tok/s, drumsticks = DeepSeek balance, per-mode icons (sword/map/command-block/grass).

UI Enhancements
Jump to install

Source facts

Repository
qsjzqssh/mc-hud
Latest update
Aug 18, 2026
Category
UI Enhancements
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/qsjzqssh/mc-hud
Plugin: mc-hud
Author: qsjzqssh

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

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=命令方块、创造=草方块
  • 明暗主题自适应：HUD 文字颜色、MC 描边、空槽图标与模式下拉菜单底色跟随 DSH 主题（body[data-ds-dark-theme]）自动切换，浅色/深色下都可读
  • 余额每 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）。贴图素材版权归其原作者/游戏资产所有者所有，仅用于个人用途；发布分发前请自行确认素材授权。

---

插件由 deepseek-v4-flash 在创造模式中制作并上传

Back to searchOpen GitHub repository

More related plugins

View category