前言¶

在 DeepSeek Harness (DSH) 的日常使用中，追踪 Token 消耗和首字延迟对于成本控制和性能优化至关重要。DSH 自身不提供细粒度的统计面板，无法直观看到按工作区或会话拆分的消耗情况。下面介绍 dsh-usage-stats 插件，它直接读取本地会话日志，提供这些数据。

插件介绍¶

dsh-usage-stats 是一个统计每日 token 消耗与平均首字延迟的插件，可按工作区与会话拆分。该插件由 iuuuuuuuu 维护，遵循 MIT 许可证。

核心功能¶

• 按天统计：统计每日的 token 消耗与平均首字延迟，支持按未缓存输入、缓存读取、输出分列。
• 三层下钻：支持从总览 → 按工作区 → 按会话的三层明细下钻。
• 时间筛选：支持时间筛选，包括今天、近 7 天、近 30 天以及自定义区间。
• 交互排序：支持对任意指标列进行排序。
• 默认窗口：默认保留 30 天的统计窗口。
• 访问入口：设置里显示「用量统计」，侧边栏有可开关的柱状图图标。
• 数据来源：只读本地会话日志，不修改、不删除任何既有文件。

安装与启用¶

使用以下命令安装插件：

dsh plugin --profile <profile> add "git+https://github.com/iuuuuuuuu/dsh-usage-stats.git"

安装完成后刷新页面，即可在「设置 → 用量统计」中看到统计数据，同时侧边栏也会多出一个柱状图图标。

典型用法¶

进入「设置 → 用量统计」面板，默认显示今天的数据。用户可以通过侧边栏的图标打开独立全宽面板，使用时间筛选器查看特定区间的数据，并点击表头对「未缓存输入」、「缓存读取」或「平均首字延迟」等指标进行排序。

适用场景与注意¶

该插件适合需要对成本进行精细化监控，或需要分析首字延迟表现的用户。

安装前应检查源码与许可证。插件以当前 DSH 进程权限运行，需注意以下限制：

• 仅支持 zstd 格式：仅支持 zstd 格式的会话日志，不支持 compression: 'none' 的部署。
• 窗口固定：统计窗口固定 30 天，暂不可配置。
• 只读权限：插件只读会话日志，不修改、不删除任何既有文件。

结尾¶

dsh-usage-stats 提供了一个纯本地、只读的用量统计方案。通过它，开发者可以更清晰地掌握模型调用的成本构成与性能表现。