dsh-billing — DSH Web GUI 实时计费监控插件

English · 中文

为 DeepSeek Harness（DSH）Web GUI 定制的计费 监控插件：实时统计本机模型调用用量与费用，按供应商/模型单价计费（DeepSeek v4 峰谷价），支持余额锚定、官方单价同步与账本持久化。全部通过官方接口与客户端 slots 系统实现，不修改 DSH 源码。

能力

能力	说明
实时余额	侧边栏底部余额 pill，2 秒刷新；余额状态点（充足 / 不足 / 耗尽，告警闪烁）
概览面板	点击 pill 在侧边栏内展开：已消费 / 调用次数 / 输入 / 输出 token + 最近流水（峰谷标签），收起侧边栏自动收起
供应商计费	按 供应商+模型 → 同名模型 → 供应商默认 → 全局默认 匹配单价；DeepSeek v4 自 08-17 起峰谷定价（高峰 = 北京 9–12、14–18，空闲半价），命中缓存输入按低单价计
余额锚定	粘贴 platform.deepseek.com 的官方余额校准，之后按本机用量继续扣减
官方同步	一键拉取 DeepSeek 官方模型单价（内置基础价 + 持久化覆盖合并）
设置页	DSH 设置 → 「计费」分段：余额、阈值、默认单价、供应商单价表格、数据管理
Agent 工具	billing_balance：查询余额、费用、token 用量与按模型明细
持久化	账本 JSON 原子写入工作区，DSH 重启后自动恢复（余额、单价、流水）

截图

安装

本包为纯 JS、无构建步骤（lib/ 即发布产物），git 安装即可用，无需 prepare 脚本、无需构建授权（符合官方打包规范）：

# 从本仓库安装
dsh plugin --profile web add github:nianpangzhi233/dsh-billing

# 或本地 checkout / tarball
dsh plugin --profile web add ./dsh-billing
dsh plugin --profile web add ./dsh-billing-0.1.0.tgz

安装后重启 dsh web：侧边栏底部出现余额 pill（设置按钮上方）、 DSH 设置中出现「计费」分段，Agent 提示词中自动出现 billing_balance 工具说明。

配置

DSH 设置 → 「计费」分段（或侧边栏底部 pill 展开面板）：

• 余额：粘贴官方余额锚定、初始余额、低余额告警阈值（默认 ¥20）
• 计费单价：未知供应商默认单价（¥ / 1M tokens）+ 按供应商/模型单价表， 可增删行；「同步官方单价」一键拉取 DeepSeek 官方价目
• 数据：账本路径与保存时间、保存配置、重置用量（两次点击确认）

数据

• 账本文件：.dsh-billing-ledger.json（工作区目录优先，spRoot 兜底）， v2 结构：config（初始余额 / 阈值 / 单价嵌套表）/ usage（token 分项计数）/ ledger（每次调用流水，含峰谷费率）/ startedAt
• 单价匹配顺序：供应商+模型 → 任意供应商同名模型 → 该供应商默认 → 全局默认
• 峰谷价：高峰 = 北京 9–12、14–18；其余为谷（半价）；08-17 起对 deepseek 供应商 v4 模型生效

注意事项

• 只统计本机 DSH 的模型调用；官方余额含其他渠道消费，建议定期锚定校准。
• token 用量按分离计数：未命中输入（inputTokens）、缓存命中输入 （cacheReadTokens）、输出（outputTokens）。
• 计费为估算，单价与费率以 DeepSeek 官方为准；「同步官方单价」仅在官方 价目页可达时生效（需要平台 web provider）。
• 路由 /api/dsh-billing/* 仅限 loopback（同源校验）。

许可

MIT