前言¶

在 DeepSeek Harness（DSH）里跑 dsh web 或桌面版时，模型调用会不断产生 token 消耗。DeepSeek 控制台能看官方账单，但本地会话里「这条消息花了多少」「本月累计多少」「峰谷时段是否该换模型」并不直观。手工对照官方定价页、自己记表格，既慢也容易漏。

dsh-web-billing 是社区维护者 bpc-oss 发布的 DSH 组合包插件，面向 dsh web 场景，在浏览器端做逐条消息记账、官方政策自动计价（含峰谷定价）、账号余额展示与费用汇总页。SkillHub 目录将其归类为 admin-security；GitHub 仓库当前约 11 stars，许可证 MIT，最新版本 2.3.2。

需要事先明确：插件统计的是 DSH 本地捕获的已完成 assistant/message 事件，不是 DeepSeek 账号的官方用量账单；跨 API key 核对请以 DeepSeek 控制台 Usage 导出为准。

这是什么¶

一句话定位：DeepSeek Harness Web 端的人民币 / 美元 token 计费插件——按官方政策自动计价（内置政策时间表，含 2026-08-17 起的峰谷定价），逐条消息记账，实时显示账号余额，界面语言自动切换 ¥ / $ 展示。

插件以标准 DSH bundle 形式分发（dsh.bundle.patch 指向包内 cordis.patch.yml），运行 Node.js ≥20，依赖 @deepseek-ai/schemastery 与 @deepseek-ai/dsh-home-paths。

核心功能¶

官方政策自动计价（峰谷跟随）¶

lib/pricing.js 内置 OFFICIAL_PRICING_POLICIES 价格时间表，每条政策有生效时刻（since）与单价表。已知政策节点包括：

计价语义要点：

1. 按消息时刻取价：每条消息按其完成时刻所属的政策与峰谷时段计费；新政策生效后自动切换。
2. 政策链继承：新政策未点名的模型沿用最近一次被点名的价格。
3. 改价自愈：政策表或配置变化后，重启时按当前规则重估全部存量记录。
4. 用户覆盖：prices 中模型精确条目覆盖官方价；officialPricing: off 则完全使用用户价格表。
5. 可扩展时间表：通过 policyOverrides 在配置里追加政策，无需改代码。

政策时间表策展自 DeepSeek API Docs 定价页，发现偏差可向仓库提交 PR。

Coding plan 计费¶

除 DeepSeek 官方 API 外，插件支持 DSH 内置的各类 coding plan（如 opencode-go、opencode、kimi-coding，以及 qwen / xiaomi / z.ai 的 token 订阅包）。价格表在 lib/coding-plans.js，按 (provider, model) 路由计价：

• 平台官方价：美元单价来自平台发布；人民币展示价 = 美元价 × codingUsdCnyRate（默认 7.2，仅展示换算）。
• 订阅 token 包：平台不公布逐 token 单价，调用按 0 元计。
• 升级 DSH 后，可运行 node scripts/sync-coding-plans.mjs 从本机 DSH 内置 catalog 重新生成价格表。

Provider 收费形式（metering）¶

每个 provider 可单独设置收费形式（设置 → 费用 → Provider 收费形式，即时生效）：

切换收费形式后立即重估全部历史记录，无需重启。

费用页与会话角标¶

设置 → 费用 提供浏览器端汇总页：时间段筛选（今日 / 本周 / 本月 / 近 30 天 / 全部 / 自定义）、概览与来源构成、Token 统计（含缓存命中率）、来源分组（本地部署省 / 订阅回本 / 白嫖 / 按量）、月度预算、CSV/JSON 导出、账本一致性自检。

会话头部角标（右上角）显示本会话今日 / 累计花费与节省、分模型统计、DeepSeek 峰谷提示，以及可开关的官方账户余额行。

账号余额与计价情报¶

余额通过 provider 的 API key 调用 GET /user/balance（默认 60s 刷新）。瞬时失败保留最近一次成功值，周期自动重试。

/billing/state 的 pricing 字段提供当前单价（currentUnitPrices）、下一次峰谷或政策切换时刻（nextTransitionAt）等计价情报，供客户端与外部工具使用。

安装与启用¶

插件有三种安装方式，任选其一：

# 从 GitHub 安装
dsh plugin --profile web add github:bpc-oss/dsh-web-billing

# 从 npm 安装（发布后）
dsh plugin --profile web add dsh-web-billing

# 本地开发：链接 checkout
powershell -ExecutionPolicy Bypass -File scripts/install.ps1 -Profile web

安装后重启 dsh web 生效。同一 $DSH_HOME 下请只运行一个实例，多个实例会争写同一账本文件。

git 安装时若 pnpm ≥10 要求构建授权，把提示的包键加入 profile 的 pnpm-workspace.yaml 的 allowBuilds 后重试；本包为纯 JS，通常无需构建。

覆盖默认配置时，在 $DSH_HOME/profiles/web/cordis.patch.yml 按 id 覆写整行（覆盖会替换整份 config，需重述所有键）。常用配置项：

完整配置项见 GitHub README。

典型用法¶

查看费用汇总¶

安装并重启 dsh web 后，打开 设置 → 费用，默认展示本月花费、Token 统计与来源构成。可按需切换时间段，或设置每月预算（¥）观察进度条。

切换 Provider 收费形式¶

在费用页的 Provider 收费形式 区域，为不同 provider 选择 usage、usage-free、subscription、free 或 local。切换后历史记录立即重估，订阅 provider 的调用会折算为「回本」视角。

同步 coding plan 与免费模型清单¶

升级 DSH 后，在插件目录执行：

node scripts/sync-coding-plans.mjs
node scripts/sync-promo-models.mjs

前者从本机 DSH 内置 catalog 更新 coding plan 美元单价；后者同步各 provider 的免费模型清单（见 lib/promo-models.js）。

自定义价格或追加政策¶

在 cordis.patch.yml 中设置 prices 覆盖特定模型单价，或通过 policyOverrides 追加官方政策条目（since 必填）。设置 officialPricing: off 可完全使用用户价格表。

导出账单¶

费用页支持 CSV（UTF-8 BOM）与 JSON 一键下载，便于离线对账或接入其他工具。

适用场景与注意¶

适合谁：

• 长期在 dsh web 使用 DeepSeek 及多种 coding plan，需要本地可见的 token 花费与节省统计。
• 需要跟随官方峰谷定价、自动重估历史账单，或按 provider 区分按量 / 订阅 / 本地 / 白嫖计费逻辑。
• 希望在会话界面实时看到本会话花费与官方账户余额。

注意事项：

1. 插件以当前 dsh web 进程权限运行，安装前应阅读源码与 MIT 许可证，确认 /billing 端点默认 loopbackOnly: true（仅回环地址访问）。
2. 本地统计与 DeepSeek 官方账单口径不同；余额来自 /user/balance，仅反映当前配置的 API key 对应账号。
3. 账本写入 $DSH_HOME 下 JSON 文件，多实例并发会损坏数据。
4. SkillHub 目录（skillhub.cn）是社区插件索引，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-web-billing 把 DSH Web 端的 AI 花销做成「看得见、算得清」：官方价自动跟随、峰谷时段感知、逐条消息账本、费用页与角标双入口展示。若你在 Harness 生态里需要本地 token 计费与预算管理，可以按上文步骤安装试用。

• SkillHub 目录：https://www.skillhub.cn/plugins/bpc-oss/dsh-web-billing
• GitHub 仓库：https://github.com/bpc-oss/dsh-web-billing