dsh-plugin-token-billing

DeepSeek Harness（DSH）的 Token 计费 / 用量仪表盘 插件（官方类型、双端插件：Host + Browser）。

⚠️ 目前自用：本人日常使用中的个人项目，功能与稳定性按个人需求打磨，非常欢迎提出建议和意见（Issues / PR 均可）。

功能一览

功能	说明
当前会话计费	输入框下方一行显示本会话费用、输入/输出 token 与账户余额；悬停查看按模型拆分（含高峰/闲时/旧价）、余额明细
每回合费用	每条消息下方显示该回合费用（挂在回合最后一条助手消息上，与产物清单互不冲突）
账户余额	调用 DeepSeek GET /user/balance，实时显示总额 / 充值 / 赠送
右侧用量仪表盘	窗口右侧常驻面板（鼠标移出自动收起、平滑动画）：最近对话（可展开、时间/花费排序）、余额曲线（30 天 / 一周 / 24 小时，坐标轴/十字线/缩放）、开销热力图（GitHub 风格）、时段消费、模型花费
预算与告警	设置月度 / 会话预算与告警阈值（%）；达到阈值面板警示（黄），超预算面板标红并在侧边栏按钮显示脉冲红点提醒
官方计价	内置 DeepSeek 官方价目表：峰谷定价（高峰 9-12 / 14-18 点北京时间，闲时半价）、缓存命中折扣、2026-08-17 前旧价档，按每条请求时刻自动计价
设置开关	设置 → 插件 中可一键开启/关闭（状态持久化到 settings.yaml）

安装（符合 DeepSeek Harness 官方插件规范）

本插件是官方类型的持久化插件（非动态临时插件）：

• Host 端：lib/index.js（Cordis 插件，注册 settings 命名空间 + 私有 RPC 通道）
• 浏览器端：lib/client.js（window.__ModuleLoader__.load 官方 bundle 格式，经 package.json 的 dsh.client 声明进入浏览器插件清单，随进程重启自动加载）

安装步骤（假设 $DSH_HOME 为你的 harness 主目录，如 K:\software\DSH\.dsh）：

1. 把本包放进部署依赖目录（与官方 @deepseek-ai/* 包同级）：

   $dst = "$env:DSH_HOME\profiles\node_modules\@local\dsh-plugin-token-billing"
   Copy-Item -Recurse . $dst
   

2. 在 $DSH_HOME\profiles\web\cordis.patch.yml 注册插件行：

   - insert:
       - id: token-billing
         name: '@local/dsh-plugin-token-billing'
   

3. 重启 harness，打开 Web 界面即可看到右侧仪表盘与计费行。

说明：包名沿用 @local/dsh-plugin-token-billing，与安装目录保持一致（浏览器 bundle 的 id 必须等于包名）。若未来发布到 npm，可改名为正式 scope 并同步目录名。

计价说明

• 价格表内置自 DeepSeek API 官方价目表（2026-08-14 核对）：
  • deepseek-v4-flash：缓存命中 0.020.10 元 / 未命中 13 元 / 输出 2~9 元（按新旧档与峰谷）
  • deepseek-v4-pro：缓存命中 0.0250.30 元 / 未命中 39 元 / 输出 6~27 元
  • 2026-08-17 00:00(+08) 前按旧价；之后按峰谷价（高峰 = 北京时间 9-12、14-18 点，闲时半价）
• 按每条请求的真实 usage（会话日志中的 assistant/message.usage）与请求时刻计价；缓存写入不收费；旧模型（deepseek-chat / deepseek-reasoner）按官方历史价。
• 余额曲线为按消费倒推的估算（锚定当前余额，未计入充值记录）。

技术要点（官方规范对齐）

• 双端包：main（Host 插件）+ exports["./client"]（浏览器 bundle）+ dsh.client 声明（platform: "web"）。
• Host 通过 connection.rpc.handle 注册私有通道 /token-billing（与 api-gateway 同层的官方通用 RPC 通道），客户端 connection.rpc.call 调用，数据为无损 JSON。
• 开关状态经私有 RPC 读写 settings 命名空间（持久化到 settings.yaml）——官方 settings 网关目前只暴露白名单内的命名空间，第三方插件无法直接读，因此走私有通道。
• 图标内联自 Lucide（MIT），无额外运行时依赖；主题使用 DSH 的 CSS 变量。
• 依赖：@deepseek-ai/dsh-settings、@deepseek-ai/dsh-credentials、@deepseek-ai/schemastery。

未来优化方向

见 ROADMAP.md。

License

MIT。图标来自 Lucide（MIT）。