前言¶
在使用 DeepSeek Harness (DSH) 进行智能体开发时，追踪跨会话的 Token 消耗、请求频率以及对应的成本是成本控制和性能优化的基础。现有的 DSH 官方界面通常侧重于实时对话，缺乏长期的用量汇总视图。
插件介绍¶
dsh-token-usage-stats 是一个 DSH Web 插件，用于统计跨会话的 Token 用量、请求次数与可选成本。该插件提供了独立的仪表盘页面以及侧边栏底部的入口，方便开发者查看详细的用量数据。
- 维护者：jkStars
- 许可证：MIT
- 定位：联网工具 / 统计分析
核心功能¶
该插件具备以下核心能力：
- 跨会话统计：记录并统计所有会话的 Token 用量与请求次数。
- 独立仪表盘：提供独立的 Web 页面展示统计结果。
- 数据源接口：提供 JSON 数据源 API (
/api/token-usage-stats) 供外部调用。 - 视图切换：支持按小时（今天）和按天（近 3 天、近 7 天、近 30 天、全部）的视图切换。
- 智能计价：支持自定义模型定价，并内置了基于北京时间的“高峰/闲时”两档计价逻辑（周末按闲时）。
- 自动刷新：仪表盘数据每 10 秒自动刷新一次。
- 侧边栏集成：在侧边栏底部提供入口，点击后以模态框形式打开仪表盘。
安装与启用¶
使用官方提供的安装命令将插件添加到 Web Profile 中。
dsh plugin --profile web add dsh-token-usage-stats@0.3.14
安装后，插件会自动注入到 cordis.patch.yml 配置中，并尝试通过 dsh.client 清单自动加载浏览器端资源。安装完成后，重启宿主或刷新 GUI 界面即可生效。
配置¶
插件支持通过 cordis.patch.yml 配置货币类型和模型定价。只有配置了定价，仪表盘才会显示具体的成本金额。
默认配置包含 CNY 货币以及 deepseek-flash 和 deepseek-v4-pro 的官方高峰/闲时定价。
在你的 Profile 配置文件中覆盖示例配置：
- patch:
- id: token-usage-stats
config:
currency: USD
pricing:
deepseek-flash:
peak:
uncachedInputPerMillion: 2.0
cacheReadPerMillion: 0.04
cacheWritePerMillion: 0
outputPerMillion: 8.0
offpeak:
uncachedInputPerMillion: 1.0
cacheReadPerMillion: 0.02
cacheWritePerMillion: 0
outputPerMillion: 4.0
计价逻辑说明：
* 高峰时段：北京时间 09:00-12:00，14:00-18:00。
* 闲时时段：除高峰时段外的其他时间，且周末全天按闲时计算。
* 对于支持四档定价的模型，系统会根据使用时间取对应档位价格；对于只使用 peak/offpeak 两档的模型，任意时段按对应档位计算。
典型用法¶
安装并配置完成后，可以通过以下方式访问仪表盘：
- 侧边栏入口：点击侧边栏底部的「用量统计」按钮，仪表盘会以模态框形式弹出。
- 直接访问：在浏览器中访问
http://<host>:<port>/token-usage-stats。
进入仪表盘后，默认显示「今天」的按小时视图。你可以通过顶部的下拉菜单切换时间范围（今天、近 3 天、近 7 天、近 30 天、全部）。对于跨度较长的「全部」范围，图表会自动按自然周或自然月折叠展示，以保持清晰度。
注意事项¶
在使用该插件时，请注意以下事实：
- 统计范围：目前仅统计 DeepSeek 官方 API 的费用。基于本地 Harness 会话日志进行回放计算，不包含其它提供商或渠道的 API 费用。
- 成本显示：只有当你在配置中设置了模型定价时，仪表盘才会显示成本金额。
- 数据来源：数据来源于本地历史会话日志，并非实时的 API 费用查询。
- 权限与安全：该插件以插件形式运行，请确保安装来源可信，并在使用前检查源代码与许可证。
结语¶
dsh-token-usage-stats 是一个轻量级的统计工具，通过仪表盘和侧边栏入口，帮助开发者直观地掌握 Token 消耗趋势。配合自定义定价功能，可以精确计算不同时段的成本，适合需要精细化成本控制的 DSH 用户。
