session-replay

将Claude Code会话JSONL文件转换为GIF动画终端回放

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:session-replay。
它的用途是:将Claude Code会话JSONL文件转换为GIF动画终端回放
完整的 Skill 内容见:https://321skill.com/skills/session-replay/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘帮我把刚才调试数据库迁移的Claude Code会话日志转换成GIF,我想分享给同事看问题复现步骤。’,它会引导你提供JSONL文件路径并执行转换命令,最终生成一个清晰展示命令输入和错误输出的动画GIF。或者,你可以直接运行安装好的工具,指定输入文件和输出路径,快速获得终端操作回放。

介绍

这个Skill解决了开发者需要分享或回顾终端操作过程时,仅靠静态日志不够直观的问题。它能够读取Claude Code会话生成的JSONL格式文件,并将其中的终端操作序列动态地渲染成一个GIF动画,生动地再现代码执行、命令输入和输出的全过程。

使用方式非常简单,用户只需准备好Claude Code会话导出的JSONL文件,通过简单的命令行指令调用该Skill,即可生成对应的GIF动画文件。整个过程自动化,无需用户手动录制屏幕或拼接截图。

它非常适合需要记录和演示命令行工作流、进行代码审查、制作教学材料或项目汇报的开发者。无论是个人复盘学习,还是团队协作分享,都能通过可视化的回放提升沟通效率。

建议在使用前确保JSONL文件格式正确且完整。生成的GIF文件大小取决于会话长度,对于非常长的会话,可能需要考虑分段处理或调整输出参数以优化文件体积。

核心特点

与普通的屏幕录制工具不同,它直接解析结构化的会话日志(JSONL)来生成动画,确保了回放的精确性和可重复性,且文件体积更小。同时,它专门针对Claude Code的会话格式进行了优化,能准确还原终端交互的时序和内容。

注意事项

不适合用于录制非Claude Code生成的或非JSONL格式的终端会话。

常见问题

如何获取Claude Code的JSONL会话文件?

在Claude Code界面中,通常可以通过导出或会话历史功能获取JSONL格式的日志文件。

生成的GIF动画能调整播放速度吗?

这取决于该Skill的具体实现,部分版本可能支持通过参数调整帧率或延迟来控制播放速度。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/session-replay/raw/index.md 读取 session-replay 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。