VHS终端会话录制与GIF生成器

录一段终端 demo 有多难

把命令行操作录成演示几乎总要手忙脚乱：敲快了看不清，敲慢了显得假；中途打错一个字符就得整段重录；帧率忽快忽慢，后期还要裁头裁尾、调色加字幕。更尴尬的是文档里的截图和真实流程对不上——代码改了，图也得跟着重做。

它如何工作

这个技能基于 charmbracelet/vhs，思路是把“录屏”变成“声明式渲染”。你不再对着屏幕按录制键，而是写一个 .tape 脚本，把整场会话描述出来：

• 内容：用 Type "..." 声明要逐字敲入的命令，用 Delay 控制每步之间的停顿节奏；
• 外观：指定终端尺寸、字体、行号、光标样式和配色主题；
• 依赖：用 Require 声明脚本依赖的外部程序，保证渲染时 git、kubectl 这类命令在场。

写完后交给 VHS 在无头环境里执行并逐帧渲染，最终输出 GIF、视频或静态图像。同样的脚本可以随时重跑，得到像素级一致的结果——流程改了就改脚本，不用重新录。

适用边界与注意点

• VHS 依赖 ttyd 和 ffmpeg，两者必须已安装且在 PATH 中，否则渲染会直接失败。
• 它模拟的是“敲键 + 回显”，不是真实交互：鼠标操作、TUI 应用的内部行为都可能失真。
• 输出观感取决于终端尺寸、字体与主题的配置，跨机器一致性要靠固定的 .tape 设置来保证，而不是碰运气。
• 适合文档演示、README 展示、分享一条固定命令流；如果目标是交互式教学或实时操作回放，它并不是替代品。