dsh-billing
DeepSeek Harness 插件：账户余额 + 会话费用（人民币），带 Web UI 悬浮显示。
功能
| 入口 | 用法 | 说明 |
|---|---|---|
| UI 会话头部双胶囊 | 无需操作，常驻显示 | 余额 + 本会话费用 并排显示在会话标题旁；点击任一胶囊立即刷新两个 |
| 悬停明细 | 鼠标悬停 | 余额胶囊：充值/赠金/美元；费用胶囊：按模型的 token 与费用拆分 |
斜杠命令 /balance |
聊天框输入 /balance |
查询账户余额（人民币优先，附美元） |
斜杠命令 /cost |
聊天框输入 /cost |
当前会话费用明细 |
工具 deepseek_billing |
直接问模型"余额多少/花了多少钱" | query = balance / cost / both |
结构
host.js— 宿主插件：命令 + 工具 +/billing/{balance,cost}RPC 通道（供浏览器胶囊轮询）client.js— 浏览器 bundle（__ModuleLoader__工厂格式，仅依赖平台共享的 react，无构建步骤）conversation.session.header.actions槽位（负数 order = 静态会话上下文）→ 余额 + 会话费用双胶囊package.json— 声明dsh.bundle（空 patch）+dsh.client（web 平台）cordis.patch.yml— 空层；本插件由 profile 的cordis.patch.yml插入行激活
安装（一条命令）
组合包自带激活层（cordis.patch.yml），安装后自动生效，无需手改任何配置：
# 从本地目录安装
dsh plugin --profile web add ./deepseek-billing
# 或从打包产物安装（跨机器分发推荐）
dsh plugin --profile web add ./dsh-billing-0.2.0.tgz
# 或从 npm / git 安装（发布后）
dsh plugin --profile web add dsh-billing
dsh plugin --profile web add github:you/dsh-billing
安装后重启 dsh web，再刷新浏览器页面（F5）使新 boot graph 生效。
宿主侧 API key 使用 DEEPSEEK_API_KEY 凭据引用（在 Web 模型设置页保存即可）。
配置（全部可选）
config.pricing 按模型覆盖单价（元/百万 tokens），支持峰谷价自动切换（见 host.js 顶部默认值）。例如：
config:
pricing:
deepseek-v4-pro:
cacheHit: 0.025
cacheMiss: 3
output: 6
schedules:
- effectiveAt: '2026-08-17T00:00:00+08:00'
timezoneOffsetMinutes: 480
peakWindows: [[9, 12], [14, 18]]
offPeak: { cacheHit: 0.15, cacheMiss: 4.5, output: 13.5 }
peak: { cacheHit: 0.30, cacheMiss: 9.0, output: 27.0 }
更新频率（事件驱动，空闲零请求）
- 轮次中：每完成 10 步刷新一次（步号跨过 10 的整数倍时触发）
- 每轮结束（turn/end）：刷新一次，结算本轮收尾的步（短轮也靠它结算）
- 挂载 / 切换会话 / 点击胶囊 / 页面从后台切回可见：立即刷新
- 空闲时零请求：没有定时轮询；只有上述事件发生时才有请求
- 服务端按需从内存会话日志计算，无后台常驻任务
价格自动同步（官方改价怎么办）
- 启动时 + 每 12 小时自动拉取官方价格页（https://api-docs.deepseek.com/zh-cn/quick_start/pricing/）解析最新单价（含峰谷价与生效时间）
- 解析失败自动回退：上次成功在线值 → 内置默认值；费用输出会标注当前来源与同步时间
- 优先级：用户显式配置 > 官方在线同步 > 内置默认（用户对某个模型写过 pricing 就永远以它为准）
- 可在
config.priceSync关闭或调整：{ enabled: true, url: "...", intervalMs: 43200000 }
计费口径
- token 取自会话日志中 provider 上报的
usage（含缓存命中拆分；失败重试也计入） - 单价内置官方价格，2026-08-17 起自动按北京时间峰谷价
- 子代理是独立会话，各自单独统计
- 输出为估算值，实际扣费以 DeepSeek 官方账单为准
维护提示
- 改
client.js后：客户端 HMR 会自动更新，刷新页面必生效 - 改
host.js后：若热重载未生效（Node ESM 缓存），可改文件名/包名触发重导入，或重启dsh web
官方文档：
- 查询余额：https://api-docs.deepseek.com/zh-cn/api/get-user-balance/
- 模型 & 价格：https://api-docs.deepseek.com/zh-cn/quick_start/pricing/
- Harness 客户端模块：https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/client-modules
