dsh-game-hud
游戏风格悬浮 HUD 插件（DeepSeek Harness）。
- ❤ 血条：实时显示 DeepSeek 账户余额（官方
user/balance 接口），满格金额可配置（默认 ¥20）。
- ✦ 蓝条：当前会话上下文剩余（与官方 UI 同源的
contextPressure 投影），随对话增长从满格减少。
- 🚨 低余额告警：余额（血条）低于阈值（默认 10%）时，悬浮窗四周闪烁红光（可配置开关）。
- 🗜️ 折叠迷你视图：折叠后显示紧凑的血条 + 蓝条，随时扫一眼余额与上下文。
- ▲▼ 峰谷定价：官方规则（北京时间周一至周五 09:00–12:00 / 14:00–18:00 为高峰，其余时段含周末全天为空闲时段、价格为高峰的一半），显示当前单价与距下次切换倒计时（每秒跳动）。
- ⚡ 自动压缩：上下文剩余 < 5% 时自动触发
/compact；压缩满 2 轮后出现「开启新对话（携带记忆）」按钮；不点击则继续自动压缩。
- 🔁 携带记忆新对话：点击后用当前模型生成记忆摘要 → 新建会话并注入记忆（不回答旧问题、不丢记忆），新会话上下文重新累计。
配置
所有配置项都有默认值，可通过 DSH 设置 → 插件 → dsh-game-hud 界面编辑（保存后 HUD 实时生效，无需重启），或在 profile 的 cordis.patch.yml 中覆盖：
| 配置项 | 类型 | 默认值 | 说明 |
|---|
maxBalance | number | 20 | 血条满格金额（CNY）。余额超过此值显示满格，低于按比例减少 |
lowAlert | boolean | true | 低余额红光告警开关：余额（血条）低于 lowThreshold 时，悬浮窗四周闪烁红光 |
lowThreshold | number | 10 | 告警阈值（%）。仅血条触发，蓝条（上下文）不触发 |
priceTable | object | {} | 可选：按模型覆盖峰谷单价（元/百万 tokens）。未覆盖的模型用内置价格表 |
cordis.patch.yml 示例：
- insert:
- id: game-hud
name: 'dsh-game-hud'
config:
maxBalance: 50
lowAlert: true
lowThreshold: 10
priceTable:
# 官方价（元/百万 tokens），2026-09-10 12:00 起生效
deepseek-v4-flash:
peak: { input: 2.0, output: 8.0, cacheHit: 0.04 }
valley: { input: 1.0, output: 4.0, cacheHit: 0.02 }
实时机制
| 数据 | 刷新机制 | 实时粒度 |
|---|
| ❤ 血条（余额） | 客户端每 3 秒轮询宿主 → 宿主缓存 30 秒后重查官方余额接口 | 花钱后 ≤30s 内血条下降 |
| ✦ 蓝条（上下文） | 每 3 秒重新测量会话（与官方 UI 同源投影数据） | 每发一条消息就变 |
| ▲▼ 峰谷 + 倒计时 | 峰/谷时段按官方规则即时计算；单价来自内置价格表（可用 priceTable 覆盖） | 时段秒级；单价随插件版本更新 |
| ⚡ 压缩轮数 / 按钮 | 每 3 秒从会话事件日志统计 compaction/end | 压缩完成后 3 秒内出现 |
⚠️ 单价不是实时拉取的：内置价格表写死在 lib/index.js 的 PRICE_TABLE。官方调价后 HUD 仍会显示旧价，需要更新插件版本（或在设置里用 priceTable 覆盖）。只有余额（血条）是走官方 user/balance 接口实时获取的。
数据通道
- 宿主注册三个同源 HTTP 路由：
GET /hud/state?sessionId=<id> — 实时状态：余额 / 上下文 / 峰谷定价 / 压缩轮数 / maxBalancePOST /hud/digest — 用当前模型生成记忆摘要（携带记忆新对话的数据源）POST /hud/seed — 向新会话静默注入记忆（user/message append，不触发 agent 回复、不回答旧问题）
- API Key 经宿主
credentials 服务解析（默认 DEEPSEEK_API_KEY，自动读取 llm-deepseek 配置中的 apiKeyEnv）。
- 客户端以
window.__ModuleLoader__.load() 手写格式打包，无需构建器。
安装
方式一：dsh 命令安装（推荐）
dsh plugin --profile web add github:guoliyuan97-png/dsh-game-hud#v1.2.0
安装后重启 DSH：HUD 面板出现在浏览器右下角；配置入口在 设置 → 插件 → dsh-game-hud。
方式二：从 GitHub 直接安装
在 DSH 的 web profile（如 E:\.dsh\profiles\web）中：
// package.json
{
"dependencies": {
"dsh-game-hud": "github:guoliyuan97-png/dsh-game-hud#v1.2.0"
},
"dsh": { "profile": { "bundles": ["dsh-game-hud"] } }
}
然后 pnpm install 并重启 DSH，浏览器右下角会出现可拖动的 HUD 面板。
方式三：本地开发（file: 引用）
// package.json
{
"dependencies": { "dsh-game-hud": "file:./packages/dsh-game-hud" },
"dsh": { "profile": { "bundles": ["dsh-game-hud"] } }
}
许可
MIT
