时间花了,要花得明白。这一分钟里,AgentTime 怎么给 AI Coding Agent 记一本时间账:
agenttime-promo.mp4
AgentTime 是一个本地优先的 Agent 时间账本:把 Codex、Claude Code、Pi、Oh-My-Pi、DeepSeek Harness、Antigravity、OpenCode 等编码 Agent 的会话记录导入本机,按守恒口径切分出纯工作、等待人审阅、中途停了、待命四段耗时——每段都能从一手事件追溯,加总恒等于轮次墙钟——并把总账一路下钻到单个会话、单轮交互、单次工具调用的输入与输出。
你的 Agent 每天到底替你干了多少活、多少时间在等你点头、多少时间在空转?打开页面就能看到。
- 我一天的 Agent 里,真正干活的时间有多少?
- 一场会话里,多少花在模型想和写、多少在执行命令、多少在等我确认、多少是中途停了?
- 哪些会话最耗时?不同 Agent、不同模型的耗时分布差别有多大?
常见的时间统计把「开始到结束」整段记成工作时长——人在阅读、思考、等待审批的时间全被算成了 AI 在干活。AgentTime 用事件流里的一手证据把这段账拆开。
| 态 | 含义 | 计量依据 |
|---|---|---|
纯工作 work_ms |
模型想和写 + 本地工具执行 | 事件流一手机时(响应跨度、工具配对跨度)累加 |
等待人审阅 review_wait_ms |
人工审批/确认卡点 | 仅当来源落盘了审批事件才计入;否则如实标「未知」,不编造 |
中途停了 idle_gap_ms |
轮内无任何源事件的空白(网络阻塞、设备休眠、忙上一条等) | 轮内 ≥ 阈值无事件区间并集,扣除工具与审阅;源记录不写原因,只给时长不编造归因 |
待命(轮间间隔) standby_ms |
上一轮答完到下一轮提交的间隔 | 轮次边界相减,是你的时间,AI 零消耗 |
守恒恒等式:纯工作 + 等待人审阅 + 中途停了 = 轮次墙钟(发出 → 答复完毕),一分不多、一分不少。停摆阈值按适配器分档:Antigravity/Pi/Oh-My-Pi/DeepSeek Harness/OpenCode ≥2 分钟;Claude Code/Codex ≥30 分钟(交互式轮次的分钟级缝隙几乎都是真实生成,长挂起才判停摆)。
排队输入(上一轮未答复完毕时发出下一条,消息排队等待)单独记录为 queue_wait_ms;最后一条答复完毕后的「收尾空档」由前端按当前时刻实时计算——两者都不混入任何其他维度。
界面按展示层短词呈现这四态——AI 工作 / 等待确认 / 中途停了 / 轮间间隔;每个数字背后的术语与字段名,可在页内「这些时间怎么算?」弹窗查到完整三层映射。
配套下钻:轮次六 KPI(总时长 / AI 工作 / 自动完成度 / 超 15s 慢操作 / 排队输入 / 收尾空档)、单轮耗时构成总账(含每段守恒分解与工具逐次调用的输入/输出/起止)、慢操作 TOP 榜、按模型与思考级别的分项、逐轮 Token 用量。总览页另配「每天 AI 干活多久」趋势(按日/按周切换,长范围自动按周聚合)、「每个会话干了多久」时间轴、本时段结论卡与 Markdown 报告导出——全部本地生成、零上传。缺失证据一律如实标注,绝不推算充数——这是 AgentTime 的第一设计原则。
npx @ccclucky/agent-time想先体验界面?零配置一键加载全合成演示数据:
npx @ccclucky/agent-time --demo启动后会自动打开 http://127.0.0.1:8765(仅绑定本机,--no-open 可关闭),支持中/英双语切换与一键接入本机已检测到的 Agent 目录;点击「生成分享图」可本地渲染脱敏战绩 PNG 卡片。服务运行期间会自动同步:源记录有变化时自动重新导入并刷新页面。也可以全局安装或直接拉取终端摘要:
npm install -g @ccclucky/agent-time
agent-time # 或无连字符别名 agenttime
agent-time summary --days 7 # 终端快速查看近 7 天时间账单(支持 --json)要求 Node.js ≥ 22.15(内建 SQLite 与 zstd,无需编译原生模块)。CLI 还支持 --port、--db、--demo、--no-open 与 import --agent <adapter> <路径> 单独导入,见 agent-time --help。主页概览见 ccclucky.github.io/agent-time。
全部只读导入,格式随上游演进持续适配(设计决策见 docs/adr):
| Harness | 耗时口径 | Token 下钻 | Turn Inspector 抽屉 | 备注 |
|---|---|---|---|---|
| Codex | ✔ 完成锚点校准 · 长挂起停摆 ≥30 分钟 | ✔ 累计快照差分 | ✔ | 思考链官方加密(ZDR),如实标注 |
| Claude Code | ✔ 消息记录跨度 · 长挂起停摆 ≥30 分钟 | — | ✔ | 主会话流 |
| Pi | ✔ 一手机时累加 · 停摆 ≥2 分钟 | — | ✔ | 分支拓扑只取活跃路径 |
| DeepSeek Harness | ✔ · 停摆 ≥2 分钟 | ✔ 逐请求 | ✔ | 多帧 zstd 事件流 |
| Antigravity | ✔ 守恒五态 · 停摆 ≥2 分钟 · ask_question 计入审阅 |
✔ 逐请求输入/输出 | ✔ | 后台任务按完成回执计入;工具逐次含输入/输出与起止 |
| OpenCode | ✔ · 停摆 ≥2 分钟 | ✔ 逐请求 | ✔ | SQLite 会话库,一库多会话 |
| Oh-My-Pi | ✔ history.db 锚点回退 · 停摆 ≥2 分钟 | ✔ 逐请求 | ✔ | 旧版文件秒级轮次锚点,如实披露 |
接入能力随上游格式演进持续更新;每个 harness 的轮次边界、完成锚点与降级口径都以 ADR 形式落在 docs/adr。
- 服务只绑定
127.0.0.1,没有任何遥测、上报或账号体系; - 本机只落一份统计元数据库(SQLite),不保存工具参数、Prompt 源文与凭据;
- Turn Inspector 的提问与思考文本在你打开抽屉时按需从本机源文件读取,不落库、不上传;
- AgentTime 从不读取凭据文件,也从不扫描数据目录之外的任何位置。
会话详情:五维分布(可点击下钻)、六个 KPI、慢操作 TOP 榜与耗时归因。
Turn Inspector 抽屉:单轮的提问原文、模型思考链、工具调用栈与逐项耗时,全部按需从源文件提取。
聚合面板:TOP 会话、操作分布、按接入工具 / 项目 / 工具多维汇总。
接入配置:七个 harness 一页纳管,勾选即接入,支持自定义目录。
本地会话源(各 harness 数据目录 / SQLite 库,只读)
│ 事件流解析(每 harness 一个适配器)
▼
归一化 Event 流(start/complete/abort · model · tool_use/tool_result …)
│ 守恒切分(calculateEventTiming / calculatePiTiming)
▼
本地 SQLite 统计库(元数据) ──▶ 本地 Web(127.0.0.1:8765,零依赖原生前端)
同一文件重复导入幂等;源文件变化时保留旧快照并如实报错;分支副本等已知重复源按设计排除并单列说明。
git clone https://github.com/ccclucky/agent-time && cd agent-time
npm ci
npm test # 全量测试(node:test,无外部测试框架)
npm run check # 类型检查
npm run dev # 从源码启动需要演示数据?npx tsx scripts/make-demo-data.mts /tmp/agenttime-demo 生成一套全合成的多 harness 数据集(脚本同入口打印 serve 命令),本 README 的截图即来自它。
欢迎贡献——接入新 harness、完善口径披露、前端打磨都适合下手,见 CONTRIBUTING.md。
会拖慢我的 Agent 吗? 不会。导入是只读解析,无钩子无注入,Agent 进程完全无感。
为什么有的会话「等待确认」显示「—」? 该来源没有落盘审批事件,AgentTime 不把缺失证据当作「零等待」。这是刻意为之的诚实口径。
数据会离开我的电脑吗? 不会。无遥测、无上报、无账号,全部计算与存储都在本机。
支持团队聚合视图吗? 本版本只做本机个人账本。多机聚合在路线图上,但永远不会以牺牲本地隐私为代价。
认可并支持 LINUX DO 社区。





