dsh-token-usage-counter

Token 用量统计插件

English | 中文

<div align="center">
<h2>看清每一个 Token 到底去了哪里。</h2>
<p>为 DeepSeek Harness 提供持久、准确的用量统计。</p>
<p>TypeScript · Cordis 插件 · 本地优先的 LLM 用量分析</p>
</div>

<p align="center">
<img src="assets/usage-stats-overview.png" alt="DeepSeek Harness 中的 Token 用量仪表盘" width="860">
</p>

token-usage-counter 是一个用于 DeepSeek Harness 的 Token 用量统计插件。
它会持久化 provider 上报的用量，支持全局、按会话、按 Provider / 模型查看，
并避免把失败请求或重试请求重复算入总量。

它解决了什么问题

| 能力 | 说明 |
| --- | --- |
| 精确分桶 | 输入（未命中）、输入（命中）、缓存写入、输出保持独立。 |
| 持久化累计 | 数据写入 Harness 的 usage-stats settings 命名空间，重启不会归零。 |
| 多维查看 | 支持全局、单个会话、Provider / 模型三个维度。 |
| 每日活跃度 | 为 Web 设置页的累计统计和本地日历热力图提供数据。 |
| 安全提交 | 只有匹配的成功消息确认后，usage-only chunk 才会计入。 |
| 交互式命令 | 挂载 commands 服务时提供 /tokens，随时查看当前摘要。 |

统计仪表盘