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