vhs-recording

用VHS脚本生成终端录制GIF动画

安装使用

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

帮我安装这个 AI Skill:vhs-recording。
它的用途是:用VHS脚本生成终端录制GIF动画
完整的 Skill 内容见:https://321skill.com/skills/vhs-recording-x-5/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

'请用vhs-recording生成一个演示git clone、add、commit、push完整流程的终端录制GIF,终端宽度80列,高度24行,字体使用Monaco,每个命令间隔2秒。' AI会先编写对应的VHS脚本,然后执行vhs-recording run命令,输出名为git-operation.gif的文件,并自动保存到当前目录。

介绍

vhs-recording 解决了终端操作演示难以标准化、重复制作的问题。传统屏幕录制软件需要手动操作,且输出文件体积大、不便于嵌入文档或社交媒体。本工具通过编写 VHS 脚本(一种轻量级描述语言)精准控制终端输入、输出、延时和样式,自动生成清晰的 GIF 动图,让技术演示、教学步骤、CLI 工具展示变得可版本化、可复用。

使用方式非常简单:先安装 vhs-recording 命令行工具,然后编写一个 .vhs 脚本文件,在其中定义终端的大小、字体、命令序列、等待时间等。执行 vhs-recording run script.vhs 即可输出 GIF 文件。你也可以通过 AI 助手自动生成脚本模板,只需描述你想要的演示内容,AI 会帮你编写 VHS 脚本并运行。

适合技术文档工程师、开源项目维护者、在线课程讲师、开发者社区运营人员等需要频繁制作终端演示素材的角色。尤其适合将演示流程集成到 CI/CD 管道中,在每次代码更新时自动重新生成最新的操作截图。

建议:脚本中的延时参数需根据实际命令执行速度调整,避免过快或过慢;GIF 输出尺寸不宜过大,否则文件体积会膨胀;对于复杂交互(如 vim 编辑、多窗口操作),建议拆分为多个短脚本分别录制后拼接。

核心特点

与手动录屏工具相比,vhs-recording 通过脚本化方式实现可重复、可版本控制的终端录制,天然适配自动化文档生成和持续集成流程;与同类脚本录制工具(如 asciinema)相比,它直接输出 GIF 格式,无需额外转换,且支持更精细的样式控制。

注意事项

不适合需要实时交互、鼠标操作、GUI 界面或非终端环境的录制场景。

常见问题

如何安装 vhs-recording?

运行 npm install -g vhs-recording 或 brew install vhs-recording,具体请参考仓库 README。

GIF 文件太大怎么办?

可以通过调整脚本中的终端宽度、减少帧数或使用调色板压缩来减小文件体积。

给 AI 助手的安装指引

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

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