模型消耗统计（model-usage-plugin）
DeepSeek Harness（DSH）Web 设置面板插件：统计各模型的 token 消耗与估算费用，展示用量趋势、开发活跃度与 API 账户余额。
npm 安装 · MIT License · Node ^22.19 || >=24（与 DSH 一致）
模型消耗总览页
它回答什么
- 花了多少钱 —— 按模型估算费用，并换算到你关心的货币
- 钱花在哪个模型上 —— 费用占比（不是 token 占比：调用少但单价高的模型才是优化点）
- 什么时候贵 —— 按天 / 按小时的堆叠柱，可在费用、Tokens、工具调用三种口径间切换
- 最近是不是一直在干活 —— GitHub 风格的一年活跃度热力图
- 花得值不值 —— 工具调用数、失败率、每调用均价、每调用 Token、高频工具
- 账户还剩多少 —— 直接查询 DeepSeek 账户余额
数据全部来自你自己的会话记录，不联网上报。
安装
需要 DSH 的 Web profile（dsh web 能正常启动）。
npm（推荐）
dsh plugin --profile web add model-usage-plugin
dsh web # 重启使插件生效
dsh plugin 会把包装进 profile 并自动登记为 bundle 层；本包含 dsh.bundle.patch 声明，无需手改配置。
从 GitHub
dsh plugin --profile web add github:AKS1st/model-usage-plugin
dsh web
从源码（本地开发）
git clone https://github.com/AKS1st/model-usage-plugin.git
dsh plugin --profile web add /path/to/model-usage-plugin
dsh web
卸载
dsh plugin --profile web remove model-usage-plugin
dsh web
统计文件 $DSH_HOME/musage-stats.json 会保留，需要一并清理时手动删除即可。
使用
打开 设置 → 模型消耗，共三个页签：
| 页签 | 内容 |
|---|
| 总览 | 花费 / 总 Token / 账户余额 → 用量趋势 → 活跃度热力图 → 效率指标 → 花费去向 |
| 模型明细 | 全部模型（按费用降序），可展开查看 token 构成、修改单价、启用峰谷定价 |
| 配置 | 目标货币与汇率、余额查询、手动添加模型 |
装好后不需要任何配置：用量从插件运行起自动累积，历史用量也会自动补齐（插件的台账原先不存在的那部分，会从会话日志里回填，热力图卡上会显示"已回填 N 天历史"）。
另外两个页面的截图
模型明细（按"提供服务的模型"分组，同一模型的历史 id 合并成一张卡）：
模型明细
配置页：
配置
深色主题下同一套设计令牌，配色自动跟随：
深色总览
费用怎么算
费用 = Σ(各类 token × 对应单价)，按你设置的目标货币与汇率换算。缓存命中、缓存未命中、
缓存写入、输出分开计价——它们的单价差一两个数量级，合在一起算会差出好几倍。
这是估算，不是账单。 它不含官方折扣、赠送额度、阶梯价与税费；请以官方账单为准。
内置默认价
首次使用自动套用，可在"模型明细"里逐个修改，或点"重置"回到内置默认。
| DeepSeek 模型 | 缓存命中 | 缓存未命中 | 输出 |
|---|
deepseek-flash（V4.1-Flash）空闲 | ¥0.02 | ¥1 | ¥4 |
deepseek-flash（V4.1-Flash）高峰 | ¥0.04 | ¥2 | ¥8 |
deepseek-v4-pro（V4-Pro-0813）空闲 | ¥0.15 | ¥4.5 | ¥13.5 |
deepseek-v4-pro（V4-Pro-0813）高峰 | ¥0.30 | ¥9.0 | ¥27.0 |
单位：人民币 / 百万 tokens。高峰 = 空闲两倍，窗口为 UTC 周一至周五
01:00–04:00 与 06:00–10:00，其余时间按空闲价。
价目按官方页刷新（2026-09-14）：DeepSeek 模型 & 价格、
Z.AI Pricing、OpenAI Pricing。
本次修正了三处会把钱算错的问题：GPT-5.6 三档（luna/terra/sol）此前只记了官方价的一半、
GPT-6 Astra 与 GLM-5.2/5.3 漏了"缓存命中"价（读缓存被当成未命中 → 高估）；另外官方已明确
DeepSeek V4 Pro 继续提供且计费不变，因此删掉了此前"9/14 之后改按 Flash 价计费"的规则
（留着会把 V4-Pro 的用量低估约 5 倍）。
已下线的 deepseek-v4-flash、deepseek-v4-flash-0731、deepseek-v4-flash-vision-exp
请求由 V4.1-Flash 提供服务并按 Flash 价计费，因此与 deepseek-flash 计为同一个模型
（明细页会在卡片上标注合并了哪些 id，展开可看各自分项）。按官方公告，
deepseek-v4-pro 在 2026-09-14 12:00（北京时间）之后同样改由 V4.1-Flash 服务并按 Flash 价计费，
插件内置了这条带生效时间的规则。
第三方模型
| 模型 | 单价（每百万 tokens） |
|---|
glm-5.1 | CNY 6 / 24 / 缓存 1.6（官方价，取 ≤32k 输入档） |
glm-5.3-flash、z-ai/glm-5.3-flash、stealth/ox-alpha | USD 0.15 / 0.50 / 缓存 0.03 |
glm-5.2、glm-5.3 | USD 1.40 / 4.40（官方未公布，按上一代旗舰行情预置，请自行核对） |
gpt-6-astra | USD 10 / 50 |
模型 id 会自动归一（provider 前缀、日期后缀、:batch 变体、DeepSeek 旧 id），因此
日常用的别名都能命中同一条价格。
两个开关：自定义计费 / Token Plan
每个模型展开后都有两个开关，用来控制"这份用量该怎么算钱"：
| 开关 | 关闭（默认） | 打开 |
|---|
| 自定义计费 | 用内置默认价（含官方峰谷规则），单价框只读 | 用你自己填的单价与峰谷时段 |
| Token Plan | 按 token 计费 | 该模型由套餐覆盖：只记录 token，不算费用 |
- 只对支持套餐的模型显示 Token Plan 开关（OpenAI/Anthropic/Google/GLM/Qwen/Kimi 等；
DeepSeek 只有充值余额、没有套餐，所以不显示）。
- 订阅型 provider 自动算套餐：当某模型的用量来自订阅（如
openai-codex 的 Codex 订阅），
Token Plan 会默认勾上——这类用量本来就不按量计费，按 API 单价算出来的金额是假的。
想反过来看"若走 API 会花多少"，取消勾选即可（明确的取消会一直算数）。
- 计价来源可指定：同一个模型 id 在不同 provider 上可能单价不同（
glm-5.1 在阿里云百炼是
CNY 6/24/1.6、在 Z.AI 是 USD 1.4/0.26/4.4）。卡片里可按观测到的 provider 逐个设置覆盖价，
单来源模型自动选定并标注；多个来源又没指定时会明确提示"按基础价计费"。
- 来回切换不会丢数据：你填过的单价与峰谷规则一直保留在记录里，关掉自定义计费只是
"暂时不用它"，勾回来就还在。切换开关时只发送开关本身，不会用内置默认价覆盖你的值。
峰谷定价
内置默认价里已按官方窗口配好：DeepSeek 为 UTC 周一至周五 01:00–04:00 与 06:00–10:00
（即北京时间 09:00–12:00、14:00–18:00），高峰价 = 空闲价 × 2。勾上"自定义计费"后可改：
最多两个高峰时段（HH:MM，支持跨零点），可指定时区与"仅周一至周五"，高峰价留空则沿用正常价。
不会出现"计价为 0"：内置价目之外的模型会显示"未配置价格"而不是 ¥0（¥0 会被读成免费），
你可以手动补一条单价。
账户余额
在"配置"页填写 API Key 与余额接口 Base URL 后点"保存并查询"。API Key 留空则使用
DEEPSEEK_API_KEY 环境变量；页面里填写的 Key 只保存在内存，不会写入磁盘。
数据与隐私
- 统计、价格、汇率缓存与时间台账全部保存在
$DSH_HOME/musage-stats.json
- 统计接口只接受本机 loopback 同源请求；不要把带本插件的 WebServer 暴露到公网
- 只有两处联网：汇率换算（可缓存一周）与余额查询（只有你点击时才发起）
- 不上报任何用量数据，不抓取官方价格
常见问题
装好了但设置里没有这个页签？
插件必须重启 dsh web 才生效。面板标题旁会显示当前运行中的版本号（vX.Y.Z），
用它判断"跑的是不是新代码"：版本号变了才说明加载成功。
费用和官方账单对不上？
本插件是估算：只按 token 数与单价相乘，不含折扣、赠送额度、阶梯价、税费；汇率也是近似值。
它的用途是"看清钱花在哪、哪个模型值得优化"，不是替代账单。
token 数怎么这么大？
缓存命中读取也算 token——这正是官方计费的算法。Agent 每次请求都会携带完整上下文，
命中缓存的部分单价极低但数量很大，所以总 Token 常见以亿计，其中 95% 以上往往是缓存命中。
历史用量看不到？
插件的实时台账从安装时开始，历史部分由启动时自动回填（只补缺失的日子，不重复计数）。
热力图卡上会写明"已回填 N 天历史"；会话很多时需要几分钟，重启后稍等即可。
首页只列了几个模型？
总览只展示花费最高的几行，完整列表在"模型明细"页——这样首页高度不随模型数量增长。
余额查询失败？
检查 API Key 是否有效、Base URL 是否可达。填在页面里的 Key 重启后需要重新填写，
需要持久化请用 DEEPSEEK_API_KEY 环境变量。
开发
架构、设计约束、测试与验证流程见 docs/DEVELOPMENT.md：
npm test # 单元测试（jsdom / react 从 DSH 安装目录解析，本包无依赖）
npm run verify # 上线前闸门：不启动、不重启 dsh web
License
MIT
