terminal-screenshots

使用 VHS 脚本生成终端截图、GIF 动图或视频,用于文档编写、演示及可复现的 CLI 可视化。

安装

概览

VHS(Video Here Script)是一款由 Charmbracelet 开发的开源工具,专为生成高质量、可复现的终端操作可视化内容而设计。它允许开发者通过简单的脚本文件(称为“磁带文件”)来精确控制终端行为,包括输入命令、等待输出、截取屏幕等,最终输出为静态截图、动画 GIF 或视频文件。VHS 的核心优势在于其轻量性和对现代终端主题的高度兼容性,支持多种流行配色方案如 Catppuccin、Dracula 和 Tokyo Night,确保生成的画面既美观又专业。该工具特别适合需要为命令行工具编写文档、制作演示视频或进行集成测试的场景,能够显著提升技术内容的视觉表现力与一致性。由于其基于 Docker 容器运行且依赖极少,部署简单,无需复杂环境配置即可快速上手。

核心功能特点

  1. 通过简单脚本生成终端截图、GIF 动图或 MP4 视频
  2. 支持自定义终端尺寸、字体、主题和窗口样式
  3. 可精准控制输入速度、等待输出、按键操作及环境变量
  4. 内置多种流行终端主题(如 Catppuccin、Dracula),一键切换外观
  5. 支持多格式输出:PNG 序列、WebM、MP4 和 GIF
  6. 易于集成到 CI/CD 流程中,用于自动化测试和文档构建

适用场景

VHS 最典型的应用场景是为命令行工具创建清晰、一致的文档插图。无论是展示一个 CLI 工具的完整使用流程,还是突出某个关键功能的效果,VHS 都能以高度可控的方式重现终端交互过程,避免因系统差异导致的截图不一致问题。对于开发者而言,它可以用于录制软件教程视频,将复杂的操作流程转化为流畅的视觉演示,极大降低用户学习成本。此外,在自动化测试领域,VHS 可用于‘黄金文件比对’(Golden File Testing),即先生成参考图像或录像,再在后续构建中验证实际输出是否匹配预期,从而确保终端界面的稳定性。另一个实用场景是制作项目 README 中的动态示例,使开源项目的介绍更加直观生动。由于 VHS 生成的内容完全由脚本定义,因此具备极强的可复现性——只要脚本不变,每次运行结果一致,非常适合团队协作和长期维护的技术文档。