dsh-plugin-token-billing

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

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

功能一览

安装（符合 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.02~0.10 元 / 未命中 1~3 元 / 输出 2~9 元（按新旧档与峰谷）
  • deepseek-v4-pro：缓存命中 0.025~0.30 元 / 未命中 3~9 元 / 输出 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）。