TermCap¶
TermCap 将 Unix 终端会话录制为 asciicast v2，并渲染为可独立分发的 SVG 动画或 GIF。录制、重放、模板和媒体导出使用同一条时间轴，适合项目演示、操作教程和可复现的命令行记录。
按场景选择¶
| 目标 | 推荐命令 | 继续阅读 |
|---|---|---|
| 录制交互式 shell | termcap record demo.cast -g 80x20 | 快速开始 |
| 录制单条命令 | termcap record demo.cast -c "python demo.py" | 录制与渲染 |
| 像 wrapper 一样执行并录制 | termcap exec --media-output demo.svg -- python demo.py | 快速开始 |
| CAST 转 SVG | termcap render demo.cast demo.svg | CAST → SVG |
| CAST 直接转 GIF | termcap render demo.cast demo.gif --format gif | CAST → GIF |
| 已有 SVG 转 GIF | termcap svg2gif demo.svg demo.gif | SVG → GIF |
| 查看全部命令 | termcap | CLI 树 |
最短工作流¶
pip install termcap
termcap record demo.cast -g 80x20
termcap render demo.cast demo.svg
termcap render demo.cast demo.gif --format gif
控制空白区域
输出尺寸来自录制时的终端 geometry。短演示可使用 -g 80x12 或其他合适尺寸；TermCap 不会默认裁掉终端内部的有效行，因为全屏程序和较早帧可能使用这些区域。
当前能力¶
- asciicast v2 录制与重放
execwrapper：执行原命令、保存 CAST、按需渲染 SVG/GIF，并透传 exit code- ChatEnv 配置类型
termcap，用于管理TERMCAP_EXEC_ENV_SCRIPTS等默认执行环境入口 - ANSI/256 色、宽字符、光标和文本样式渲染
- 模板化 SVG 动画与静态 SVG 帧
- CAST → GIF 与 SVG → GIF
- 关键帧优先采样、GIF 时间量化与速度控制
- 内置模板 package data，可从 wheel 安装后直接使用
有关已实现能力和明确边界，参见能力边界。