AKS1st/model-usage-plugin
统计各模型 tokens 消耗并估算费用，显示账户余额 | Model token usage stats and cost estimation with account balance for DSH
Listed
6
Usage
Bundle verified
Preview
What it does
Per-model token usage and cost estimation with DeepSeek account balance, shown in a Settings panel tab.
Best for
- DSH users who need per-model token, call, failure, cache, and estimated-cost breakdowns.
- Teams comparing models or managing budgets with editable pricing, currencies, exchange rates, and peak/off-peak periods.
- DeepSeek API users who want account balance displayed alongside local usage statistics.
Not ideal for
- Workflows requiring invoice-grade billing figures; costs are estimates based on configured prices and exchange rates.
- Users of non-DeepSeek providers who expect the plugin to retrieve their provider account balances; the documented balance query is for DeepSeek.
- Users unwilling to provide a DeepSeek API key when balance retrieval is required; UI-entered keys remain only in memory unless configured through the environment or credentials.
README
模型消耗统计（model-usage-plugin）
DeepSeek Harness（DSH）Web 插件：统计各模型 tokens 消耗并估算费用，显示 API 账户余额。
功能
- 按模型统计 tokens（区分缓存命中 / 未命中 / 写入）、调用与失败次数，估算费用
- 内置主流模型默认价格（国产模型按人民币、海外模型按美元），首次使用自动套用，可随时修改
- 峰谷定价：每个模型可勾选”峰谷定价”，最多支持两个高峰时段（HH:MM，支持跨零点）， 两个高峰时段共用同一组高峰价；高峰期 token 按高峰价计费，非高峰期按正常价计费（高峰价留空则沿用正常价）
- DeepSeek 默认价按官方最新峰谷计费更新：deepseek-v4-flash / deepseek-v4-pro 预置 官方 2026-08-17 定价（空闲价与高峰价、两个高峰时段 09:00–12:00 / 14:00–18:00， 服务器本地时间），deepseek-chat / deepseek-reasoner 为官方最新价； 已知 DeepSeek 模型若仍停留在旧默认价或峰谷时段为空，启动时自动升级为官方默认配置 （已配置有效高峰时段的用户自定义价格不受影响）
- 汇率换算：费用统一按目标货币展示（默认人民币）。汇率成功获取后连同时间戳缓存到数据文件， 无缓存时启动自动刷新一次；打开设置页时缓存不超过一周不自动刷新（需手动点击”更新汇率”）， 无缓存或超过一周自动刷新一次
- 查询 DeepSeek 账户余额，页面顶部大字展示总 Token 与账户余额
- 设置面板”模型消耗”页签；”仅显示已调用模型”可隐藏未使用过的模型
安装
从 GitHub 仓库安装（纯 JS，零构建，即装即用）：
dsh plugin --profile web add github:AKS1st/model-usage-plugin
dsh web # 重启 web 服务使 profile 生效
本地安装（clone 后直接指向仓库目录）：
git clone https://github.com/AKS1st/model-usage-plugin.git
dsh plugin --profile web add /path/to/model-usage-plugin
dsh web
通过 dsh plugin（pnpm 转发）安装到 profile，并自动登记为 bundle 层。卸载：
dsh plugin --profile web remove model-usage-plugin
使用
打开 设置 → 模型消耗：
- 顶部：总 Token、账户余额、目标货币与汇率状态
- 每模型卡片：token 明细与费用；点”配置价格”可修改单价与计价货币、启用峰谷定价并设置 高峰期时间段与高峰价，或点”重置”恢复默认价
- 勾选”仅显示已调用模型”时只展示实际使用过的模型
数据与隐私
- 统计、价格与汇率缓存（含时间戳）保存在
$DSH_HOME/musage-stats.json - 页面填写的余额 API Key 仅保存在内存，不会写入磁盘；需持久化时请配置
DEEPSEEK_API_KEY环境变量或凭证
License
MIT
Frequently Asked QuestionsFAQ
Use the verified command dsh plugin --profile default add github:AKS1st/model-usage-plugin in a DSH-enabled shell. The command resolves the public package metadata and keeps the plugin attached to the catalog identity shown on this page.
Compatibility follows the bundle and profile status shown above. If a profile is not detected, keep the plugin disabled there and check the repository documentation before enabling it in production.
The GitHub link and activity metadata are the source of truth for releases and maintenance. Revisit this page after a new release to confirm the catalog has observed the latest version.