前言¶

在使用 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 仓库
• 社区目录