DeepSeek Harness 会话使用统计插件

在调试或优化会话时，开发者需要直观了解 Token 消耗、耗时和缓存命中率。现有的视图可能无法提供细粒度的按模型或按轮次的统计。这个插件在会话界面新增了 Usage 选项卡，提供按模型和按轮次的详细数据视图。

插件介绍¶

这是一个客户端插件，用于在会话中查看 Token、Wall time 和缓存命中率。它不修改 DeepSeek Harness 的源码，只读取和展示数据。维护者是 ewoowe。

核心功能¶

1. 会话内新增 Usage 选项卡：在会话界面展示会话总计。
2. 双表格视图：
   • Model usage（默认）：按模型展示 Token、Wall time 和 Cache hit 情况。
   • Message usage：按轮次展示 Token、Wall time 和 Cache hit 情况。
3. 排序与筛选：
   • 「Message usage」表格支持点击表头按任意列进行排序。
   • 支持多种时间范围筛选：Session, Today, 24h, Yesterday, 3d, 7d, Custom。
4. 历史记录加载：
   • 显示已加载窗口内的轮次覆盖情况（如 Folded 12 of 22 turns）。
   • 提供「Load the older turns」按钮加载历史记录。
5. 数据计算：
   • 使用 ISession.projections 计算整体统计数据。
   • 依赖 @deepseek-ai/cordis、react、react-dom 等依赖。

典型用法¶

1. 在会话中切换「Model usage」和「Message usage」两个表格视图。
2. 点击「Message usage」表头的任意列对表格进行排序。
3. 选择「Today」或「7 days」等时间范围查看特定时段的统计。
4. 点击「Load the older turns」按钮加载历史记录以查看折叠的轮次。
5. 查看包含小数位的缓存命中百分比（如 99.95）。

适用场景与注意¶

• 适用场景：适合需要精细分析会话成本和性能的开发者。
• 概念澄清：表格中的行代表「turn」（Prompt 及其对应的 Assistant 回复），而非单条消息。一个 Assistant 回复归属于其发起的 Prompt 所在的同一轮次。
• 时间范围：「Today」范围仅统计会话内花费的时间，并非系统当前日期。
• 缓存命中率：百分比不限制上限，保留小数（如 99.95）。
• 依赖项：需要 @deepseek-ai/cordis、react、react-dom 等库。
• License：MIT。
• 源码保护：插件仅读取和展示数据，不修改 packages/ 目录。

总结¶

该插件通过 ISession.projections 和事件窗口计算数据，为会话分析提供了可视化的辅助。更多详情请访问 SkillHub 目录 或 GitHub。