前言¶

在 DSH 的插件式环境里，会话侧信息可以随宿主一起扩展，而不必另开一个计费面板。dsh-billing 是一个 DeepSeek Harness 插件，用来在 Web UI 中显示 DeepSeek 账户余额和当前会话费用（人民币）。它解决的是对话进行中需要确认“余额还有多少”“这一轮花了多少”的问题。相比每次手动查询账单，它把余额和本会话费用放在会话头部，并提供斜杠命令、工具和 UI 三种入口。

这是什么¶

dsh-billing 由 TheTianzz 维护，许可证为 MIT。它的定位是 DeepSeek Harness 插件，将 DeepSeek 账户余额与会话费用接入当前 Web UI，支持人民币展示，并支持按模型查看 token 与费用拆分。

核心功能¶

会话头部显示¶

• Web UI 会话头部双胶囊常驻显示余额和本会话费用。
• 点击任一胶囊，立即刷新余额和会话费用。
• 鼠标悬停余额胶囊，显示充值、赠金、美元明细。
• 鼠标悬停费用胶囊，显示按模型的 token 与费用拆分。

命令入口¶

下面两个斜杠命令用于在聊天框中查询：

/balance
/cost

• /balance：查询账户余额（人民币优先，附美元）。
• /cost：查看当前会话费用明细。

工具入口¶

如果直接问模型，可以使用工具：

deepseek_billing
query = balance / cost / both

deepseek_billing 支持 query = balance / cost / both，可以直接问模型“余额多少”或“花了多少钱”。

刷新与价格同步¶

• 刷新是事件驱动的，空闲时零请求，无后台常驻任务。
• 启动时 + 每 12 小时自动拉取官方价格页，解析最新单价（含峰谷价与生效时间）。
• 配置全部可选。
• 价格同步优先级：用户显式配置 > 官方在线同步 > 内置默认。

可选配置项如下：

config.pricing
config.priceSync

• config.pricing：按模型覆盖单价（元/百万 tokens），并支持峰谷价自动切换。
• config.priceSync：关闭或调整价格同步。

安装与启用¶

安装命令如下：

dsh plugin --profile web add dsh-billing

执行完成后，按下面步骤启用：

1、重启 dsh web。
2、刷新浏览器页面（F5），使新 boot graph 生效。
3、在 Web 模型设置页保存 DEEPSEEK_API_KEY 凭据引用。

典型用法¶

启用后，可使用下面这些入口：

• 聊天框输入 /balance 查询账户余额（人民币优先，附美元）。
• 聊天框输入 /cost 查看当前会话费用明细。
• 直接问模型“余额多少/花了多少钱”，由 deepseek_billing 处理。
• 点击 UI 会话头部任一胶囊，立即刷新余额和会话费用。
• 鼠标悬停余额胶囊查看充值、赠金、美元；悬停费用胶囊查看按模型的 token 与费用拆分。

适用场景与注意¶

适合在 DeepSeek Harness Web 会话中查看余额、本会话费用和按模型拆分的用户。需要注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码和许可证。
• 插件输出为估算值，实际扣费以 DeepSeek 官方账单为准。
• 子代理是独立会话，各自单独统计。
• 失败重试也计入费用。
• config.pricing 与 config.priceSync 均为可选项。

结尾¶

dsh-billing 的价值是把 DeepSeek 的账户余额和会话费用放到当前 Web UI 会话附近，提供常驻显示、即时刷新和命令/工具查询入口。

• GitHub：https://github.com/TheTianzz/dsh-billing
• 目录页：https://www.skillhub.cn/plugins/TheTianzz/dsh-billing（URL 来自插件线索）