用途:vhs-recording 用于通过 VHS tape 文件生成终端录制,输出动画 GIF,适合制作演示 GIF 或为教程记录命令行工作流。
主要能力:VHS 将声明式 tape 文件转换为终端会话动画 GIF。tape 文件定义命令、时序和终端外观。技能流程包括定位并校验 tape 文件、检查 VHS 安装状态、执行录制、验证输出 GIF 是否生成。
必要用法:先确认 tape 文件存在于指定路径并读取内容,校验必要指令,例如 Output 指令指定 GIF 目标路径,以及至少一个动作命令(如 Type、Enter 等)。然后检查 VHS 是否安装: which vhs && vhs --version 若未安装,可按平台安装: Linux/WSL:go install github.com/charmbracelet/vhs@latest macOS:brew install charmbracelet/tap/vhs 还需 ttyd 和 ffmpeg。执行录制: vhs <tape-file.tape> VHS 会解析 tape 指令、启动虚拟终端 ttyd、按时序执行命令、捕获帧,并使用 ffmpeg 编码为 GIF。完成后检查 Output 路径下 GIF 是否存在且文件大小非零(通常大于 50KB),并确认 VHS 执行无错误信息。
适用场景:终端会话录制、文档演示 GIF、CLI 工作流文档化。
限制:不适用于浏览器工作流(资料建议改用 scry:browser-recording),也不适用于非终端演示或 GUI 应用。若找不到 vhs,需检查 Go bin 目录(通常为 ~/go/bin)是否在 PATH 中;录制启动失败时需确认已安装 ttyd 和 ffmpeg;写入 GIF 出现 permission denied 时,需检查输出目录是否存在且可写。其余安装、收费、价格、平台或效果等信息暂未提供。