用途:为 PR 或文档制作精致的终端演示动画,流程为脚本→录制→转换→嵌入。
主要能力:提供工具选型建议(GitHub PR 用 asciinema→agg 输出 GIF;需更小文件用 asciinema→svg-term-cli 输出 SVG;TUI 截图用 tmux→freeze),并给出录制、转换、校验与嵌入的完整步骤。
使用方式:先安装工具,macOS 可执行 brew install asciinema、cargo install --git https://github.com/asciinema/agg、npm install -g svg-term-cli(可选)。录制前先写脚本,控制在 20-30 秒,只展示一个重点;准备环境时 clear、设置 PS1='$ '、TERM=xterm-256color,终端尺寸 100x24,并隐藏敏感信息。录制命令为 asciinema rec demo.cast --cols 100 --rows 24,结束后按 Ctrl+D 或输入 exit。转换为 GIF 用 agg demo.cast demo.gif,可加 --speed 1.5 或 --font-size 14;SVG 用 svg-term --in demo.cast --out demo.svg --window。校验包括检查文件大小(GitHub 需小于 5MB)、时长、敏感信息,以及用 svg-term --at 15000 或 asciinema cat 配合 freeze 生成预览帧做视觉检查。最后在 PR 中用 Markdown 图片语法嵌入,并附一句说明,文件建议放在 docs/demos/ 或 assets/。
适用场景:需要为代码变更、CLI 功能或文档提供直观终端演示的开发者。
限制:资料未提供跨平台安装细节、agg 与 svg-term-cli 的完整参数、具体版本要求及收费信息;演示时长、文件大小等为建议值,实际效果需自行验证。