用途:收尾遗留的 asciinema 录制。它会发现正在运行的 asciinema 录制进程和未处理的 .cast 文件,优雅停止进程,校验文件完整性,压缩后推送到 orphan 分支。
主要能力:发现运行中的 asciinema rec 进程与 ~/eon 下大于 1M、30 天内的 .cast 文件;通过交互选择要处理的文件;按 SIGTERM→SIGINT→SIGKILL 顺序停止进程;检查文件是否完整、是否可播放;用 zstd 压缩;推送到 orphan 分支;可选删除本地 .cast。
参数:file 指定 .cast 文件;--all 处理全部未处理文件;--force 优雅停止失败时用 SIGKILL;--no-push 仅本地不推送;--keep-local 压缩后保留本地 .cast。
用法示例:/asciinema-tools:finalize;/asciinema-tools:finalize ~/eon/project/tmp/session.cast;/asciinema-tools:finalize --all --force;/asciinema-tools:finalize session.cast --no-push。
限制与依赖:推送需 GitHub token(GH_TOKEN/GITHUB_TOKEN 或 gh auth token),且需先运行 /asciinema-tools:bootstrap 配置 orphan 分支克隆;压缩需安装 zstd(brew install zstd);强制停止可能导致文件截断。相关命令:/asciinema-tools:daemon-status、/asciinema-tools:convert、/asciinema-tools:summarize。