dshp-balance-hp · DeepSeek 余额血量条（v1.0.1 静态插件）

DSH Web GUI 的余额显示插件：把 DeepSeek 余额做成游戏式「HP 条」。

• HP = 当前余额；上限 = 余额 + 今日消耗（估算，可在界面点 ✎ 同步平台值）
• 每 5 分钟自动刷新，余额变化自动累计今日消耗（充值不计入）
• 全部配置持久化到 DSH 工作区 .dsh-balance-history.json，重启不丢

皮肤（设置 → 余额血条）

皮肤	样式
默认简洁	跟随主题状态色的进度条
Minecraft	10 颗像素红心（半心精度），显示在输入框上方
暗黑破坏神	金币血球 + 暗金细条，悬浮为大号液面血球
守望先锋	整格量化血条（每格金额可调 ¥1/2/2.5/5/10）
三国杀	太极半形勾玉（鱼眼在头，默认 -10°），数量 3/4/5/6/8/10 可调，低血量 2 玉橙 / 1 玉红

安装

A. 静态安装（推荐，与其他插件一致）

本包是标准 DSH 双半区插件包：宿主半区为 TypertRemoteService（lib/host.js）， 客户端半区为 window.__ModuleLoader__ bundle（lib/client.js）， 自带组合补丁 cordis.patch.yml（安装即注入 - id: dshp-balance-hp 行）。

安装步骤（以 profiles/web 为例）：

# 1. 把包放入 profile 的 node_modules
mkdir -p /opt/dsh/profiles/web/node_modules/dshp-balance-hp
cp -r package.json lib cordis.patch.yml /opt/dsh/profiles/web/node_modules/dshp-balance-hp/

# 2. 把包名加入 profile 的 bundle 列表（package.json → dsh.profile.bundles）
#    "dshp-balance-hp"

# 3. 重启 Web 生效
sudo systemctl restart dsh

依赖 @deepseek-ai/dsh-typert-protocol 从部署根向上解析（已随 DSH 安装）。 若使用官方流程：dsh plugin --profile web add dshp-balance-hp（pnpm 转发）。

B. 动态安装（开发/调试用）

在 DSH 会话中使用 cordis_define 创建插件，代码取自：

• Host 半区：dist/host.raw.js
• Client 半区：dist/client.raw.js

然后 cordis_run 激活（首次需在 Web 界面 Run 卡片授权）。

数据与安全

• 只读余额：GET https://api.deepseek.com/user/balance（Bearer 方式，密钥经宿主 credentials 解析，不落盘）
• 本地写入仅 .dsh-balance-history.json（余额采样、今日基准、配置）
• 无任何外发网络请求，除余额查询外

开发

• lib/host.js — 宿主半区（BalanceGateway extends TypertRemoteService，5 个 Remote 端点：get-state/refresh/set-today-base/clear-today-base/set-config；余额拉取、消耗累计、配置持久化）
• lib/client.js — 客户端 bundle（window.__ModuleLoader__.load；5 种皮肤、勾玉 SVG 路径、设置界面、经 ctx.remote.dshpBalance 调宿主）
• src/、dist/ — 动态安装（调试）用源码与原文
• 勾玉几何：标准太极半形（大圆 r45 + S 线两段 r22.5），鱼眼 r6.75 位于头部； 基准姿态为镜像 + 顺时针 45°（S 线头/尾凸点同处 x=50 垂直线），默认再叠加 -10°。

TODO

• 优化充值后血量逻辑：充值会使余额跳升，当前「上限 = 余额 + 今日消耗」的口径下，充值会同步抬高上限；需明确充值事件的处理（识别并记录充值、调整今日消耗/上限基准口径、展示净变动），避免充值后血量比例与消耗数字口径不一致。

License

MIT