model-usage-plugin
DeepSeek Harness Web 设置面板中的按模型令牌使用量、成本估算和 DeepSeek 账户余额。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add model-usage-plugin@0.17.0Model Usage Plugin 以 model-usage-plugin 发布，当前版本为 0.17.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness（DSH）Web 设置面板插件：统计各模型的 token 消耗与估算费用，展示用量趋势、开发活跃度与 API 账户余额。
npm 安装 · MIT License · Node ^22.19 || >=24（与 DSH 一致）
数据全部来自你自己的会话记录，不联网上报。
需要 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 天历史"）。
费用 = Σ(各类 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 计费 | 该模型由套餐覆盖：只记录 token，不算费用 |
openai-codex 的 Codex 订阅），
Token Plan 会默认勾上——这类用量本来就不按量计费，按 API 单价算出来的金额是假的。
想反过来看"若走 API 会花多少"，取消勾选即可（明确的取消会一直算数）。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装好了但设置里没有这个页签？
插件必须重启 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
MIT