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 調用，可以快速獲取會話耗時分佈與工具調用情況，爲時間管理提供數據支撐。
