Zui近在鼓捣一个终端UI框架的文档时 我差点被录屏这件事搞到原地爆炸 你懂那种感觉吗？ 本来想展示个每秒跳一次数字的计数器动效 结果一改UI代码就得重新手动录一遍 窗口大小总跟上次不一样 终端主题偶尔还会串成同事那套阴间配色 剪GIF的时候卡帧卡到怀疑人生 Zui烦的是发版前还要检查一遍路径有没有写错

害 这哪是Zuo文档啊 纯纯是给录屏工具当免费劳动力嘛

直到我挖到了 VHS 这个玩意儿 才终于明白：原来终端录屏也Neng像写代码一样「自动化」

先别急着问「这是什么」

先聊聊你可Neng遇到过的痛处 比如你维护过CLI工具、TUI组件库或者终端演示项目吧？ 是不是总想着把程序「动起来」放进README或者官网？ 但系统录屏太麻烦了： 手残点错窗口会重录 换台电脑主题就变样 改个按钮颜色得从头剪视频

Zui关键的是——这些素材没法「复用」 今天录好的GIF明天改代码就废了 后天又得花半小时重新来一遍

Neng不Neng让「录制过程」变成像编译产物一样 改完代码跑一条命令就Neng自动生成新素材？

VHS 的答案是：Neng 而且比你想的还简单

先给 VHS 贴个「Zui简标签」

它不是什么复杂工具 就是个「帮你把终端操作写成脚本、再自动生成动态素材」的小帮手

核心只有一个东西：.tape 文本脚本

没错 就是文本文件！ 你Ke以把它理解成「写给终端的分镜剧本」——

要什么字体大小？Set FontSize 14 窗口多大？Set Width 120 Set Height 30 敲什么命令？Type "./target/debug/examples/counter" 等几秒kan效果？Sleep 4s 甚至退出时按 Ctrl+C douNeng写进去：Ctrl+CSleep 700ms

文本文件意味着什么？ 意味着Neng放Git仓库版本管理！ 意味着改UI时只需改脚本里一行Set Theme！ 意味着AINeng帮你优化脚本！

别嫌麻烦 先装这两个东西就够了

macOS 用户直接 brew 一口闷： bash brew install vhs

装完记得确认下 ffmpeg 在不在： bash ffmpeg -version | head -n 1

Linux 用户 apt/yum 随便选；Windows…害 要么 WSL 要么翻官网找安装包

写第一份 tape：从一个计数器开始

拿我那个 ratatui 小例子说事吧——就是那个每秒加一的计数器程序

新建个 counter.tape 文件扔进去这段：

text

Output docs/public/recordings/counter.gif # 输出GIF到这个路径 Require ./target/debug/examples/counter # 先确认这个二进制存在 Set Shell "bash" # 默认shell不用改 Set FontSize 14 # 字大点kan得清 Set Width 120 Set Height 30 # 窗口固定宽高 Set Theme "Catppuccin Mocha" # 指定主题色 Set Padding "10" # 边距留点空隙不拥挤 Set Framerate "15" # FPS不用太高 GIF小一点快 Type "./target/debug/examples/counter" # 在终端敲这个命令 Enter # ↓回车执行 Sleep 4s #等4秒kan数字蹦到4 Ctrl+C # ⌃C停掉程序 Sleep700ms #等一下画面缓冲完再结束

“这破脚本真Neng跑？”Neng！而且巨丝滑

第一步先编译你的程序：

bash cargo build --example counter #假设你的例子在examples目录下

然后 cd到 tape 文件所在目录跑 VHS：

bash vhs counter.tape

等个几秒钟…叮～

docs/public/recordings/counter.gif 文件自动出来了！

打开kankan——窗口大小一致、主题色完美、数字从1跳到4再停掉…完全就是你想要的效果！

“那百度不收录怎么办？”哦对这个我之前也踩过坑！

有天朋友问我：“为啥我Zuo的教程页放了 GIF，但百度快照里只有一张静图？”

我当时还傻兮兮说“可Neng GIF太大了吧”…直到后来研究SEO才明白：搜索引擎根本读不懂二进制 GIF 的内容啊喂！

但 VHS 的优势就在这儿！你kan我们刚才生成 GIF 的同时——完全Ke以把 .tape 文件一起放进仓库里啊！

比如你的文档目录结构Ke以这么整： text/docs/├── tapes/ ←放所有.vhs脚本├── recordings/ ←放生成好Gif/Mp4└── index.md ←文档正文引用recordings里의素材

搜索引擎爬你的 docs/tapes/目录时 不光Nengkan到 “这个 GIF是 counter.tape生成の ” 还Neng通过脚本里の Type ./target/debug/examples/counter分析出 “这是演示计数器功Nengの动态效果 ” !

相当于给 GIF加了一层「文字说明书」啊兄弟! 而且 script 文件版本可控: geng新功Neng时改 tape → rerun vhs →替换 GIF ,搜索引擎分分钟就Neng抓到geng新~

“除了 GIF还Neng要别的吗?”当然! VHS是全Nengの!

想要高清MP4放官网?WebM适配移动端?静态预览图贴首页? 一行 script搞定三种格式:

在 .tape 文件里加这三行: textOutput docs/public/recordings/counter.gifOutput docs/public/recordings/counter.mp4Output docs/public/recordings/counter.webm

跑一次 vhs ,三个格式直接齐活!

甚至想截张「Zui靓の瞬间」当预览图? 用 ffmpeg从 GIF里抽帧就行:

bashffmpeg \-y \ #覆盖Yi有文件不用问-s docs/public/recordings/counter.gif \#输入源-i docs/public/recordings/counter.gif \-ss2\ #从第2秒开始抽-frames:v1\ #只抽1帧-update \ #覆盖输出docs/public/recordings/counter-preview.png#输出路径

为啥抽第2秒?因为hen多TUI程序第一帧会闪一下 ,第2秒刚好是稳定画面~

“那 asciinema 和 VHS比哪个好?”各有用处啦~

不是说asciinema不好哦!它主打「录制原始 terminal session」 ,生成の .cast 文件Neng转 SVG / GIF / HTML!但对99%の文档需求来说—– VHSgeng直接!

asciinema 需要装 svg-term-cli agg一堆依赖才敢碰SVG;而 VHS只要一条命令就Neng出 GIF/MP4/WebM ,连新手dou不会翻车~

除非你需要「可交互の在线播放页」或者「保留原始输入记录」 ,否则老老实实先用 VHS ——简单才是王道!

Zui后想说: terminal应用天生就该「动起来」呀!

以前总觉得 “录屏是发布前の额外工作 ” ,现在才明白 : *动态演示根本就是 terminal项目の一部分 ! *

CLI工具の安装流程?TUI组件の状态切换?调试工具の实时输出?这些靠 static截图永远讲不清道不明 !

而 VHS帮我们把这件事变成本地操作 : 改代码→编译→run vhs→替换素材→push git—–全程不用动手剪视频 !

上周我改计数器颜色时 ,本来以为要重录三小时 GIF ,结果只是打开 tape 文件把 Catppuccin Mocha改成 Catppuccin Latte ,再跑一次命令…新 Gif直接无缝替换旧の !爽飞!

所以啊朋友们 : Ru果你们也在折腾 terminal UI / CLI工具 / TUI组件库 ——别再手动录屏啦!去试一下 VHS !

它不是什么黑科技 ,就是帮你把 “重复劳动 ”变成 “工程资产 ” 的小帮手～ 等你用上瘾了你会发现 : 原来让终端素材动起来 ,从来dou不是难事～

---