用 Claude Code 跑一个长任务，中间开了几个子智能体、调了几十次工具，终端输出早就滚出屏幕。事后想弄清楚“它到底做了什么、哪一步最慢、子智能体什么时候结束”，只能翻滚动条。

我写了一个小插件 session-timeline 来解决这件事：把一次会话画成时间线，用户提示词、模型回复、工具调用与结果、子智能体的分出与并回，都沿着一条线排开。在会话里敲 /timeline，页面就在浏览器里打开，像下面这样。

图 1｜一次子智能体任务的完整时间线：左侧是主线和支线，中间是执行记录，右侧是大纲。

1 想回答的三个问题

Claude Code 会把会话记录存在本地，但原始日志把回复、工具调用和内部记录混在一起，不好读。这个插件要做的，就是把其中人关心的部分按时间摆出来，回答三类问题。

• • 它做了什么：每一轮回复说了什么、调了哪些工具、改了哪些文件。
• • 时间花在哪：每轮回复用了多久、其中思考占多少、哪个工具调用卡了很久。
• • 子智能体怎么跑的：什么时候分出去、什么时候结束、主智能体什么时候才收到通知，以及中间排队等了多久。

2 页面怎么读

图 1 展示的是一次简单任务：主智能体让子智能体运行 main.py，再根据返回结果作答。图 2 是其中支线部分的放大。

图 2｜图 1 支线部分的放大：从 Agent 调用分出，执行 Bash 命令，到收到完成通知并回主线。

先看它做了什么。 图 2 中，灰色竖线是主智能体。在 Agent 调用处分出一条蓝色支线，往下依次是子智能体收到的任务、执行的 Bash 命令和返回的 Hello, world!。蓝线在“收到完成通知”处并回主线，随后主智能体汇总退出码和输出。修改文件的调用也同样挂在线上，能看到文件路径和改动前后的内容。

再看时间花在哪。 每条记录旁都标着耗时：Bash 调用 877 毫秒，子智能体任务 6.2 秒，主智能体这次回复 2.5 秒。三个数字口径不同，不能混看。存档里有思考时长时，回复旁还会标出“其中思考 N 秒”。

图 3｜右侧大纲：同一过程的缩略时间线，节点旁是各步耗时。

长会话里，可以先在大纲里找到关心的步骤，点一下跳到对应记录，再展开看具体的回复、参数和结果。

3 安装与用法

需要本机有 Node.js 18 以上。在 Claude Code 会话里敲：

/plugin install session-timeline --marketplace jianglong-nie/claude-session-timeline

装好后，/timeline 打开当前会话的实时页面，/timeline --html 导出一个可离线打开的 HTML 文件，方便保存或发给别人。其他参数见仓库 README。

两点提醒：实时页面显示的是已经写入存档的内容，正在生成的那段要等写完才出现；工具依赖 Claude Code 的内部存档格式，版本升级后可能有新记录类型显示不全。

这个插件做的事不复杂，就是把已有的会话记录整理成更容易看的时间线。如果你也在用 Claude Code，欢迎试一下，有问题可以在仓库提 issue。

项目：session-timeline，Claude Code 插件作者：jianglong-nie仓库：https://github.com/jianglong-nie/claude-session-timeline