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-x/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我把刚才调试数据库连接问题的Claude Code会话记录转换成GIF,我想放到项目Wiki里。’,它会引导你提供JSONL文件路径,并执行转换命令,最终生成一个展示从连接失败到修复成功的完整终端动画。或者,你可以直接命令它:‘使用session-replay转换 /path/to/session.jsonl 到 /output/demo.gif’。
介绍
这个Skill解决了开发者需要记录和分享终端操作过程,但传统录屏文件体积大、不便分享的问题。它通过解析Claude Code会话生成的JSONL文件,自动模拟终端输出,生成一个轻量级的GIF动画,清晰地再现了代码编写、命令执行等终端交互的完整流程。
使用时,你需要先确保拥有一个Claude Code会话导出的JSONL文件。然后,通过简单的命令调用该Skill,指定输入文件和输出GIF路径,即可快速生成动画。整个过程自动化,无需手动操作录屏软件或进行复杂的视频编辑。
它非常适合需要复盘代码调试过程、制作技术教程、向团队演示问题排查步骤,或为项目文档添加动态示例的开发者。无论是个人学习总结还是团队知识沉淀,都能提供直观的视觉记录。
建议在生成前,检查JSONL文件是否完整包含了关键的终端输出和命令序列。由于是模拟回放,生成速度取决于会话内容的复杂度和长度。对于非常长的会话,生成的GIF文件可能仍然较大,可以考虑分段处理或优化GIF的帧率和色彩设置。
核心特点
与普通录屏工具不同,它直接解析结构化的开发会话日志(JSONL)来生成动画,确保了回放内容与原始开发操作完全一致,且生成的文件是代码而非视频,更易于版本管理和嵌入文档。
注意事项
不适合需要录制包含图形界面操作、非Claude Code生成的终端日志,或对动画帧率和色彩保真度有极高要求的场景。
常见问题
支持哪些终端会话文件的转换?
目前主要支持Claude Code会话导出的JSONL格式文件。
生成的GIF动画清晰度如何?
清晰度取决于终端模拟的配置,通常足以清晰显示代码和命令文本,但可能不适合显示非常精细的图形。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/session-replay-x/raw/index.md 读取 session-replay 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/session-replay-x/raw/index.md(查看排版版本)