会话工时统计 zoahdev/dsh-timesheet

dsh-timesheet

npm

CI
License: MIT
dsh-plugin

DeepSeek Harness（dsh）的时间表：从会话日志中进行基于轮次的时间跟踪。

Token 仪表盘告诉你花了多少 token；这个仪表盘告诉你与智能体一起花费了多少实际时间——总计、按天、按项目、按提供商、按来源，外加工具调用次数、失败率和首次 token 时间。零运行时依赖；仅读取 .jsonl 会话日志。

安装

dsh plugin add dsh-timesheet

或独立运行：

npx dsh-timesheet ~/.codex/sessions

CLI

dsh-timesheet [--json]

- dir 必须包含 .jsonl 会话日志（例如 ~/.codex/sessions、dsh 会话目录或任何导出的会话文件夹）。
- 打印 Markdown 报告；--json 打印机器可读的 dsh-timesheet/v1 信封。
- 退出码：0 已生成报告，1 未找到轮次 / 有警告，2 用法/IO 错误。

npx dsh-timesheet ~/.codex/sessions
npx dsh-timesheet ~/.codex/sessions --json

在 harness 内使用（智能体可调用）

向你的 dsh 智能体提问：

给我出一份时间报表：timesheet，目录指向会话日志目录。
Give me a timesheet report: timesheet with dir set to your session-log directory.

该工具返回一份 dsh-timesheet/v1 报告：

{
"schema": "dsh-timesheet/v1",
"target": "~/.codex/sessions",
"ok": true,
"scannedFiles": 42,
"sessions": 42,
"turns": 310,
"totalDurationMs": 64800000,
"failedTurns": 7,
"toolCalls": 1284,
"byDay": [ { "key": "2026-08-18", "turns": 22, "durationMs": 5400000, "ttftMs": 110000, "failed": 1, "avgMs": 245454 } ],
"byProject": [ ... ],
"byProvider": [ ... ],
"bySource": [ ... ],
"warnings": []
}

它读取什么

会话日志使用标准 dsh 事件信封：

- session_meta → 会话 id、工作区（cwd）、模型提供商、来源（desktop / CLI / VS Code / ...）
- event_msg / task_started → 轮次开始
- event_msg / task_complete → 轮次结束、duration_ms、time_to_first_token_ms、error
- response_item / function_call → 工具调用次数

以 .jsonl 结尾的文件会被解析；格式错误的行会被跳过并给出警告。压缩的 .jsonl.zstd 日志不会被直接读取——请先导出或解压它们（解压后该格式就是纯 JSONL）。

它为什么存在

- 生态系统跟踪 token 和成本，但没有插件跟踪实际时间——这是 dsh 插件注册表中 WakaTime 形状的空缺。
- 回答“我的 6 个小时都去哪了？”是有意识地花费智能体时间的第一步。
- 零运行时依赖，构造上即为只读：它从不写入你的会话。

开发

pnpm install
pnpm typecheck
pnpm build
pnpm test
pnpm test:integration

CI 在 Windows 上运行 dsh-plugin-doctor 预检、单元测试、打包产物集成（真实 timesheet 调用），以及全新 profile 的 dsh web 启动冒烟测试。

许可证

MIT © 2026 zoahdev

dsh-timesheet（中文）

DeepSeek Harness（dsh）的时间报表插件：从会话日志做基于 turn 的时间跟踪。

Token 仪表盘告诉你花了多少钱；这个插件告诉你真实花了多少墙钟时间——总计、按天、按项目、按模型供应商、按来源，外加工具调用次数、失败率和首 token 延迟。零运行时依赖，只读 .jsonl 会话日志。

安装

dsh plugin add dsh-timesheet

独立使用：

npx dsh-timesheet ~/.codex/sessions

CLI

dsh-timesheet [--json]

- dir 需要包含 .jsonl 会话日志（如 ~/.codex/sessions、dsh 会话目录或导出的会话目录）。
- 输出 Markdown 报告；--json 输出机器可读的 dsh-timesheet/v1 报告。
- 退出码：0 生成成功，1 没有 turn / 有警告，2 用法/IO 错误。

npx dsh-timesheet ~/.codex/sessions
npx dsh-timesheet ~/.codex/sessions --json

在 harness 内使用（agent 可调用）

对 agent 说：

给我出一份时间报表：timesheet，目录指向会话日志目录。

工具返回 dsh-timesheet/v1 报告（结构见英文版 JSON 示例）。

读取什么

会话日志使用标准 dsh 事件结构：

- session_meta → 会话 id、工作区（cwd）、模型供应商、来源（desktop / CLI / VS Code / ...）
- event_msg / task_started → turn 开始
- event_msg / task_complete → turn 结束、duration_ms、time_to_first_token_ms、error
- response_item / function_call → 工具调用计数

只解析 .jsonl，畸形行跳过并告警。压缩的 .jsonl.zstd 不直接读取——先解压（解压后就是纯 JSONL）。

为什么需要它

- 生态里到处是 token 和成本统计，但没有人统计墙钟时间——这是 dsh 插件注册表里 WakaTime 形状的空洞。
- 回答“我 6 小时去哪了”是开始有意支配 agent 时间的第一步。
- 零运行时依赖、天然只读：永远不会写你的会话。

开发

pnpm install
pnpm typecheck
pnpm build
pnpm test
pnpm test:integration

CI 跑 dsh-plugin-doctor 预检、单元测试、打包集成（真实 timesheet 调用）、Windows 全新 profile 的 dsh web 启动冒烟。

许可证

MIT © 2026 zoahdev
相关生态工具

- dsh-dep-audit - 依赖供应链卫生
- dsh-quality-score - 插件质量评分卡 + 全注册表排行榜
- dsh-ecosystem - 健康扫描、影响、趋势、实时仪表盘
- dsh-tutorials - 双语插件流水线教程常见问题

- 如何安装？ dsh plugin add dsh-timesheet 或直接运行 CLI（见 README）。
- 需要 API key 吗？ 不需要。
- 是只读的吗？ 默认是；任何写入/应用都是显式标志。
示例

完整 CLI 用法见 README。快速开始：

npx dsh-timesheet --help