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 并同步目录名。

计价说明