DeepSeek Harness（DSH）的 Web 界面主要用于交互，开发者通常需要关注 API 调用的成本与账户余额。dsh-ui-billing 插件在 Web GUI 的侧边栏底部增加了一个计费组件，用于显示当前会话的费用和实时 API 余额。
这是一个显示当前会话成本和 API 余额的小组件。它属于客户端插件，由 HenryHwong 维护，遵循 MIT 许可证。
核心功能¶
Current-session cost
显示当前对话的总成本。插件会折叠 assistant/message 的使用记录，根据加载时的价格表计算 CNY 成本。切换会话会更新显示；翻页和压缩不会改变显示的金额。如果存在未定价的 token，会标注 (+N tokens unpriced)。
Live API balance
显示提供商账户余额。通过 harness 的 provider facts 读取，每 60 秒刷新一次，或在连接重置时刷新。点击行刷新按钮可手动刷新。
Collapsed-rail glyph
当侧边栏折叠时，显示单个 ¥ 符号，鼠标悬停显示两行信息，点击刷新余额。
Idle by default
没有订阅者挂载时不获取数据，节省资源。
安装与启用¶
该插件通过 DSH 的插件管理器安装。在 Web 配置文件目录下执行以下命令：
dsh plugin --profile web add @huanghanheng/dsh-ui-billing
配置与价格表¶
插件默认使用内置价格表和计费规则。如需自定义，需在插件配置中指定：
- id: ui-billing
name: '@huanghanheng/dsh-ui-billing'
config:
prices:
'deepseek-v4-pro':
offPeak: { inputPerM: 4.5, cacheReadPerM: 0.15, outputPerM: 13.5 }
peak: { inputPerM: 9, cacheReadPerM: 0.3, outputPerM: 27 }
peakHours: [[540, 720], [840, 1080]]
utcOffsetMinutes: 480
配置项说明：
* prices：自定义各模型的输入、缓存读取、输出价格。
* peakHours：高峰时段配置（分钟数）。
* utcOffsetMinutes：时区偏移（480 代表北京时间 UTC+8）。
依赖与前置条件¶
- DSH 版本：需要 DSH 0.1.7-rc.1 或更新版本。
- Projection Registry Composed：Web 界面需加载
@deepseek-ai/dsh-session-projection包以支持成本行显示。 - API Key：必须配置 DeepSeek API Key（通过凭证服务或环境变量
DEEPSEEK_API_KEY）。 - 权限：插件以当前 dsh 进程权限运行。
安全说明¶
- Display only：仅展示数据，不写入会话日志，不发送给模型，不产生额外的 RPC 调用（除只读的
/api/billing.balance）。 - Credentials host-side：API 密钥通过宿主机凭证服务解析，不会进入浏览器包。
该插件解决了 Web 界面下查看成本和余额的痛点，适合需要精细控制 API 调用成本的开发者。
