前言¶

DeepSeek Harness 的 dsh-token-meter 提供实时 token 计量，但没有跨会话的聚合报表。用户需要了解“本月用了多少 token”或“哪个模型最费 token”时，通常需要手动翻阅日志。dsh-token-stats 插件解决这一问题：监听 session 事件，自动写入日志，并提供 token_report 工具进行聚合查询。

功能¶

该插件提供以下核心能力：

• 自动记录：监听 session/event 事件，在每次 assistant/message 带 usage 字段时，自动写入一条包含计数和会话 ID 的日志。
• 聚合报表：支持按天、周、月或全量聚合，支持按模型和日期区间过滤。
• 工具支持：提供 dsh-token-report 命令行工具，以及在 DSH 会话中由模型调用的 token_report 工具。
• 系统引导：通过系统提示段引导模型在用户询问 token 用量时调用 token_report。

安装与启用¶

系统要求¶

• 操作系统：Linux 或 macOS（Windows 未测试）。
• 环境：已安装 DeepSeek Harness CLI (dsh) 及其 profile。

安装命令¶

使用官方插件安装命令即可：

dsh plugin --profile headless add github:QEDQCD/dsh-token-stats

安装后，插件会自动挂载 token_report 工具到对应的 profile。

使用示例¶

命令行查看¶

在终端直接运行 dsh-token-report 查看汇总数据：

dsh-token-report                  # 今日 + 本月 + 全部汇总
dsh-token-report --by day         # 按天明细
dsh-token-report --model deepseek # 按模型过滤

模型侧调用¶

在 DSH 会话中，模型可以主动调用工具：

token_report(period: "month")
token_report(period: "month", model: "deepseek-chat")

限制与隐私¶

隐私安全¶

日志文件存储在 ~/.dsh/token_usage.l，仅包含 token 计数和会话 ID，不包含提示词内容或 API Key。

已知限制¶

• 存储路径：日志文件路径固定为 ~/.dsh/token_usage.l。
• 记录内容：当前无法记录模型名。
• 配置项：maxRecords 配置字段已声明但未实现，目前不限制记录数量。
• 兼容性：不支持 Codex。
• 操作系统：仅支持 Linux/macOS，Windows 未进行测试。