前言¶
DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。在本地开发和调试过程中，准确追踪 Token 消耗是评估成本和优化模型调用的关键。现有的 DSH 会话记录通常仅在当前进程运行时有效，重启后即丢失。dsh-token-usage-sidebar 插件解决了这个问题，它从 DSH 的提供商运行时获取使用记录，并将这些数据持久化存储在本地 SQLite 数据库中，提供侧边栏摘要和原生设置页面两种查看方式。
核心功能¶
该插件提供了以下具体功能：
- 侧边栏摘要：在 DSH 界面侧边栏显示今日、昨日和生命周期的总计 Token 使用情况。
- 原生设置页面：在 DSH 设置菜单中提供“Token Usage”页面，支持详细的指标展示。
- 详细指标卡片：支持 Compact 模式展示 Total（总计）、Input（输入）、Output（输出）、Cache（缓存）、Reasoning（推理）和 Calls（调用次数）。
- 时间范围选择：支持 Today（今日）、Yesterday（昨日）、7D（最近 7 天）和 All time（全部时间）的选择。
- 动态过滤：提供商和模型列表直接从 DSH 实际数据中提取，不依赖硬编码的预设列表。
- 本地持久化：使用 SQLite 日记账进行存储，支持 WAL 日志，确保写入延迟稳定。
- 关机安全：在 DSH 关闭前会刷新未保存的数据，防止意外丢失。
- 历史恢复与去重：从 DSH 会话记录中恢复历史数据，并执行去重处理，确保每个调用只被计算一次。
安装与启用¶
通过 DSH CLI 安装到 web 配置文件：
dsh plugin --profile web add @y2zyyr/dsh-token-usage-sidebar
安装后需要重启 dsh web 服务以加载插件。
使用说明¶
- 查看统计：在 DSH 界面左侧侧边栏即可看到今日、昨日和总量的概览。
- 查看详情：进入 DSH 设置菜单，在“Token Usage”页面查看更详细的指标卡片。
- 筛选数据：在详情页面选择时间范围（如 7D），下方的指标卡片和表格会根据该范围内的实际数据动态筛选对应的提供商和模型。
注意事项¶
- 这是一个社区插件，并非 DeepSeek 官方插件。
- 插件使用提供商/运行时报告的数据进行统计，而非基于分词器的估算。
- 卸载插件不会清除本地已持久化的 SQLite 记账数据。
- 历史报告是诚实的，会明确显示源扫描状态和历史覆盖率。
总结¶
该插件通过 SQLite 日记账实现了稳定的本地统计，适合需要长期追踪 Token 消耗的开发者。更多细节可查阅项目主页或 GitHub 仓库。
