DSH | DSH Balance | 账户余额、今日消耗与模型单价 / Balances and model costs

[pipilu123566]

非官方社区插件，由社区成员独立开发和维护。 / Unofficial community plugin, independently developed and maintained.

DSH Balance 在 DeepSeek Harness 侧栏集中展示账户余额、今日模型费用和会话消耗，并支持设置模型单价。1.1.0 已发布，目标宿主为 DeepSeek Harness 0.2.1-rc.5。

• 项目源码 · 插件集合 · 1.1.0 Release
• 中文说明 · English README
• 许可证 / License: MIT

演示截图

实际隔离 Harness 实例中的演示数据，不含真实账户信息，不代表真实厂商查询结果。Demonstration data in an actual isolated Harness instance.

1.1.0 新增功能

• 今日消耗：概览同时显示各来源可用余额与今日模型费用；不同币种分别展示。概览保留两位小数，展开查看精确值。
• 模型与会话明细：今日消耗可按模型、按会话查看，会话内还能展开模型拆分；每轮回复尾部显示本轮费用。
• 模型单价设置：按精确的厂商／模型设置输入、输出、缓存命中和缓存创建单价。保存后立即重算，重启后保留；支持恢复默认，并拒绝覆盖并发修改。
• 展示与状态改进：列表限高滚动，中英文界面；缺价、缺失用量和查询失败分别提示，不显示为零消耗。补充百炼／Qwen 尚未接入余额查询的原因说明。

金额是当前宿主已记录模型用量的费用估算，不是厂商账单，不包含其他设备、未记录请求及搜索、抓取等工具费用。今日按北京时间统计，fork 继承调用不重复计费。内置 DeepSeek 官方价格快照核对于 2026-10-30，覆盖日期为 2026-09-19 至 2026-12-31；第三方同名模型不套用官方价格，自定义单价的单位为所选币种／百万 Token。完整计价条件见 README。

余额来源与操作

支持 DeepSeek 登录账户、DeepSeek API、OpenRouter 和硅基流动余额适配。OpenRouter 需要管理密钥；自定义反向代理不在支持范围内。其他已配置来源可配置模型单价，余额查询以支持矩阵为准。

悬浮或键盘聚焦钱包入口展开面板，点击固定；支持手动刷新，打开期间每分钟更新，关闭后停止轮询。凭据缺失、不支持、限流和失败分别展示。余额按币种和钱包类别分开，不推算剩余 Token。

安装与升级

从 Release 下载可安装包 pipilu123566-dsh-balance-1.1.0.tgz；GitHub 自动生成的源码压缩包不能代替它。完全退出目标 Harness 实例，在下载目录执行：

dsh plugin --profile desktop add ./pipilu123566-dsh-balance-1.1.0.tgz --ignore-scripts

重新打开 Harness，钱包入口位于侧栏底部账户按钮上方。已有公开版本按相同步骤升级；Web 用户将 desktop 换成自己的 profile 名称。同一 profile 只使用一个余额 bundle。macOS 命令路径、校验文件和卸载步骤见 README 与 Release。

与 DSH 的集成

这是原生 Cordis bundle。Host 通过宿主凭据服务查询已配置来源，通过会话查询与投影统计已记录用量；Typert 提供余额、费用汇总和单价设置接口，单价使用宿主设置服务保存。Client 通过 sidebar.footer.action 和 conversation.chat.turnTail 公开槽位接入，复用宿主 React、主题和语言服务。密钥留在 Host，仅发送到对应厂商的白名单 HTTPS 端点；插件没有独立后端或分析追踪。

验收范围

26 项自动测试通过；在 macOS 的隔离 rc.5 Web 实例验证了实际安装包、真实会话投影、按模型／会话／回合金额对账、单价保存与重启保留、中英文界面、390px 窄布局、键盘操作、卸载重装，以及匿名下载包在另一全新 profile 的安装启动。外部余额使用模拟响应，未新增真实模型调用。真实厂商凭据、新的 Electron 桌面安装、Windows、Linux 和其他宿主版本未复验。完整验收记录。

English summary

DSH Balance 1.1.0 combines provider balances with daily model-cost estimates. View spending by model or session, expand session breakdowns, see per-turn costs, and configure four pricing categories per provider/model. Prices persist across restarts and saving recalculates estimates. Currencies remain separate, and missing usage or prices are explicit. Estimates cover recorded model usage, not provider bills or tool charges.

Targets Harness 0.2.1-rc.5. Download the 1.1.0 installable package, quit Harness and run the command above. See the English README for provider requirements, pricing limits and installation details.

如遇安装或显示问题，欢迎在 Issues 提供插件版本、宿主版本、系统和去除凭据的报错。功能首先服务于个人需求，欢迎建议，也欢迎 Fork 后按自己的需要开发。后续更新继续维护此帖。