LaoYueHanNi/dsh-token-usage

简体中文 | English

一个 dsh 用量插件：在 Web 界面直接展示模型 token 用量。安装后打开设置（侧栏底部齿轮），即可看到「Token 用量」页 —— 汇总卡片（含费用）、按日总 token 折线图、按模型明细表与定价弹窗，支持按日期区间和模型筛选，效果见上图。

仓库：https://github.com/LaoYueHanNi/dsh-token-usage

功能

• 实时记录：每次成功的模型请求追加一行到按天分片的 JSONL 文件（请求 id、模型、输入 / 输出 / 缓存读 / 缓存写 token、时间、会话 id）。
• Web 统计页：过滤条（日期区间 + 模型下拉 + 1d/7d/30d 快捷区间）、汇总卡片、按日趋势图（悬停查看当日总量）、按模型明细表。
• 费用统计与模型定价：按模型单价（¥/百万 token）实时计算费用 —— 汇总卡醒目展示总费用，按模型表每行带费用列，未定价模型高亮提示（费用按 ¥0 计）。定价模型的名字旁有**「定价」小按钮**，点击弹窗展示该模型的完整价格表：每行一个计费条件（默认价、上下文档位 ≥ 512K、峰谷时段 09:00-12:00、限时规则的日期窗口分组），条件对应的入/出/缓/写四价各自成列，与逐条计费的解析规则一一对应。定价由云端镜像与手工文件合并而来：启动时自动从 model-price-table（cc-switch-analyzer 同源）拉取镜像，pricing.json 手工覆盖/补充。
• 历史补齐：首次启动自动同步安装前已发生的请求（幂等）。

模型定价

逐条请求精确计费：每条记录按自身时间戳走 cc-switch-analyzer 同款规则链——时间区间规则（timeRules）优先，命中后用规则内上下文档位（contextTiers）与峰谷价（dailySlots）；未命中走模型根的档位 → 峰谷 → 基础价。档位匹配以上下文 token 量近似（本请求 input + cacheRead + cacheWrite）。定价表更新价格后，全部历史按新价即时重算，无需重建数据。定价来自两个文件，读取时合并，pricing.json 的条目永远优先（整模型覆盖，含禁用其云端规则）：

文件	来源	说明
pricing.ccsa.json	启动自动拉取	云端 model-price-table（cc-switch-analyzer 同源）的本地镜像，每次重启 dsh 自动刷新，失败时沿用旧镜像
pricing.json	手工编辑	覆盖同步价或补充缺失模型，手动微调不会被同步冲掉

云端 feed 格式（currency 须为 RMB；modelId 与 aliases 都会展开为可匹配的键；timeRules / contextTiers / dailySlots 全部参与计费）：

{
  "version": 4,
  "updatedAt": 0,
  "currency": "RMB",
  "models": [
    { "modelId": "deepseek-chat", "inputCostPerMillion": 2, "outputCostPerMillion": 8,
      "cacheReadCostPerMillion": 0.5, "cacheCreationCostPerMillion": 1, "aliases": ["deepseek-v3"] }
  ]
}

pricing.json 的扁平格式（键为模型 id、与记录中的 model 完全一致；inputPerMillion、outputPerMillion 必填，cacheReadPerMillion / cacheWritePerMillion 可选、缺省按输入价计费）：

{
  "deepseek-chat": { "inputPerMillion": 2, "outputPerMillion": 8, "cacheReadPerMillion": 0.5 }
}

文件损坏或条目非法时对应模型按未定价处理，不影响统计页；保存后刷新页面即可生效。默认数据目录：~/.dsh/token-usage/（配置了 path 时以该目录为准）。

安装

从 GitHub 安装（推荐）

dsh plugin --profile web add github:LaoYueHanNi/dsh-token-usage

包声明了 dsh.bundle，add 会自动把插件挂进 profile 的层栈，无需手动改配置。构建产物 lib/ 随仓库提交（没有 prepare 脚本），git 安装开箱即用，无需任何构建白名单配置。首次启动自动补齐一次历史记录，之后纯实时记录。

从本地目录安装（开发调试用）

dsh plugin --profile web add link:D:/plugins/dsh-token-usage

link: 安装的是符号链接：重新构建插件后重启 dsh web 即可生效。

更新

dsh plugin --profile web update dsh-token-usage

移除

dsh plugin --profile web remove dsh-token-usage

插件会从 profile 移除并停止加载。数据文件（$DSH_HOME/token-usage/）会保留，需要时手动删除。

开发

先构建一次插件：

npm install
npm run build && npm run build:client

刻意不设 prepare 脚本。 编译产物 lib/ 已提交进仓库。pnpm ≥ 10 默认拒绝执行 git-hosted 依赖的构建脚本，除非加入白名单（报错 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED），因此若保留 prepare，每个用户用 github: 安装都会失败。改为随仓库分发预构建产物后，dsh plugin add github:LaoYueHanNi/dsh-token-usage 才能零配置开箱即用。改动 src/ 下的任何文件后，务必重新构建并提交更新后的 lib/，否则别人安装到的是旧产物：

npm run build && npm run build:client
git add lib/

临时挂载 —— 仅当次启动生效，不动 profile，cordis.yml 指向构建产物 lib/index.js。cordis.yml 是机器本地的（含你 checkout 的绝对路径），不进 git：先从模板复制一份，并把 name 改成你机器上 lib/index.js 的绝对 file:// URL：

cp cordis.example.yml cordis.yml   # 然后编辑其中的 name 路径
dsh web --patch <插件目录>/cordis.yml

此模式只挂载 host 半边（数据记录照常工作）；统计页依赖按包名解析的客户端 bundle，因此开发 UI 请用上面的 link: 安装方式：执行 npm run build && npm run build:client（或在插件目录跑 npx tsdown --watch）并重启 dsh web 后，浏览器端插件会自动热重载。