DeepSeek Harness (DSH) 生态中已有不少关于 token 消耗和成本统计的工具，但缺少对“墙钟时间”的统计。dsh-timesheet 是一个填补这一缺口的客户端插件。它从会话日志中提取 turn 级数据，计算总耗时以及按日、项目、供应商和来源的汇总统计。
核心功能¶
该插件提供基于回合的时间跟踪，主要功能包括：
- 数据来源：从 DSH 标准会话日志中读取 turn 级时间数据。
- 统计维度：支持按日、按项目、按模型供应商、按来源（desktop / CLI / VS Code 等）汇总。
- 统计指标：提供总耗时、工具调用次数、失败率、首 token 延迟。
- 输出格式：支持 Markdown 报告和机器可读的 JSON 报告（
dsh-timesheet/v1格式）。 - 运行方式：提供命令行工具，同时也支持在 Harness 内通过 agent 调用。
安装与启用¶
使用官方安装命令将插件添加到本地 DSH 环境中：
dsh plugin add dsh-timesheet
典型用法¶
命令行使用¶
在包含 *.jsonl 会话日志的目录下运行：
dsh-timesheet <dir> [--json]
dir：指定会话日志目录（如~/.codex/sessions）。--json：输出机器可读的dsh-timesheet/v1报告。
示例：
npx dsh-timesheet ~/.codex/sessions
npx dsh-timesheet ~/.codex/sessions --json
Agent 内调用¶
在 DSH 的对话中直接调用工具：
给我出一份时间报表：
timesheet，目录指向会话日志目录。
工具将返回结构化的统计报告。
适用场景与注意¶
该插件适合需要分析智能体实际运行耗时、优化工作流效率的开发者。
- 只读设计：插件天然只读，不会修改任何会话日志文件。
- 运行环境：需要本地环境安装 Node.js 版本 >= 18。
- 日志格式：仅支持解析纯文本的
.jsonl日志。对于压缩的.l.zstd日志，需要先解压或导出后再进行分析。
总结¶
dsh-timesheet 提供了 DSH 生态中稀缺的“墙钟时间”统计能力。通过 CLI 或 Agent 调用，可以快速获取会话耗时分布与工具调用情况，为时间管理提供数据支撑。
