vhs-recording

用VHS脚本录制终端操作并生成GIF动图

安装使用

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

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

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

使用示例

'帮我写一个 VHS 脚本,演示如何安装 node 和 npm,并运行一个简单的 hello world 程序,输出为 demo.gif'。AI 会生成一个 .vhs 文件,包含模拟输入 'npm init -y'、'node index.js' 等命令,并设置适当的等待时间。然后运行 vhs-recording 执行该脚本,即可得到完整的安装演示 GIF。

介绍

vhs-recording 解决的是开发者或内容创作者需要快速将终端操作过程转换为可分享的 GIF 动图的问题。传统录屏工具生成的文件体积大、依赖图形界面,而该工具通过声明式的 VHS 脚本精确控制每一步的输入、等待时间和输出,最终生成轻量、高清的 GIF,适合嵌入文档、博客或演示文稿。

使用方式:先编写一个 .vhs 脚本文件,描述要执行的命令、等待的秒数、按键序列等,然后运行 vhs-recording 命令指定脚本路径,工具会自动模拟终端环境并录制输出,完成后生成 GIF 文件。支持通过环境变量调整终端样式、字体和颜色主题。

适合需要频繁制作终端操作演示的运维工程师、文档工程师、技术内容创作者,以及需要在教程或报告中展示命令行步骤的开发者。也适合开源项目维护者快速生成功能演示动图。

建议:脚本编写时注意设置合理的等待时间,避免过快导致录制不完整;对于敏感操作(如密码输入),建议在脚本中使用占位符或环境变量注入;生成的 GIF 可以通过在线压缩工具进一步优化体积。

核心特点

与 asciinema、ttyrec 等录制工具不同,vhs-recording 使用声明式脚本定义录制流程,支持精确控制时间间隔、输入回放和输出样式,且脚本本身可版本化管理,便于团队协作和自动化 CI/CD 集成。

注意事项

不适合录制需要实时交互、图形界面或非终端环境的操作过程。

常见问题

如何安装 vhs-recording?

请参考项目 README 中的安装指引,通常可通过 go install 或 git clone 后编译安装。

如何编写 VHS 脚本?

VHS 脚本使用简单的 DSL 语法,例如 'Type "ls"' 模拟输入,'Enter' 模拟回车,'Sleep 1s' 等待1秒,'Output "demo.gif"' 指定输出文件。

给 AI 助手的安装指引

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

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