在使用 DeepSeek Harness（DSH）开发智能体时，实时掌握账户余额和对话成本是必要的。@javierni/balance-show 插件针对 DSH 的 Web GUI 开发，解决了这一需求，提供了一个集成的仪表盘来显示余额状态和详细的 Token 用量数据。
插件定位¶
这是一个由 JavierNier 维护的客户端插件。它读取当前 Harness 配置的 DEEPSEEK_API_KEY 来查询余额，而非 DeepSeek 官方插件，与平台无隶属关系。插件完全在本地运行，不内置 API Key，仅查询安装者自己的账户。
核心功能¶
- 余额卡片：右下角浮窗显示余额，字体按档位着色（≥¥50 绿、¥10–50 橙、<¥10 红），支持手动刷新和收起/展开。
- 位置记忆与避让：卡片位置按对话独立记忆，窗口缩放时跟随并限制在容器内；侧边栏等面板打开时，会自动贴到面板外侧避免遮挡。
- 当前对话统计：实时显示当前对话的 Tokens、缓存命中率与费用。费用按高峰/低谷分桶计价，悬浮可查看明细。
- 技术特性：零依赖、无构建步骤、自动检查更新、友好错误提示。
安装与启用¶
通过官方命令安装：
dsh plugin --profile web add @javierni/balance-show
安装完成后，重启 dsh web 并刷新浏览器页面即可看到卡片。
配置要求¶
安装后必须确认 profile 的 pnpm-workspace.yaml 包含以下两项，否则插件无法正确挂载，或更新功能无法生效：
# 1. 让 bundle 的 ESM 依赖能从 flat 目录解析
nodeLinker: hoisted
# 2. 排除 release-age 门禁，允许安装最新版本
minimumReleaseAgeExclude:
- '@javierni/*'
典型用法¶
安装重启后，卡片默认显示在右下角。你可以通过以下方式验证和更新：
- 验证余额：使用以下命令检查接口返回的余额数据。
curl http://127.0.0.1:3080/balance
- 更新插件：卡片底部常驻显示版本信息。当显示“线上版本 vX.Y.Z”为橙色且可点击时，点击即可通过本机 pnpm 执行更新。
注意事项¶
- 本插件不是 DeepSeek 官方插件，与平台无隶属关系。
- 插件读取当前 Harness 配置的
DEEPSEEK_API_KEY，不内置 Key。 - 价目表策展自官方公告，如官方调整价格，需手动同步更新
lib/pricing.js。 - 计费为本地估算，非平台权威账单。
- 更新需要本机可调用 pnpm 或 corepack（Windows 上 Node 自带 corepack）。
- 插件不内置 API Key，读取当前 harness 配置的
DEEPSEEK_API_KEY所对应账户的余额。
更多细节与源码请查看：GitHub 仓库
