Linux scriptreplay 怎样调整记录回放的速度

Linux scriptreplay 调速的核心参数是 --divisor：传入 2 表示按两倍速度播放，传入 0.5 表示按原来一半的速度播放。它只重新显示已经记录的终端输出，不会再次执行录制时运行过的命令。

官方资料地址：https://www.kernel.org/pub/linux/utils/util-linux/

先区分 timingfile、typescript 和速度因子

script 录制时，输出文件和时间文件是两份不同信息：前者保存终端字符，后者记录相邻输出之间的延迟。回放时先把两者配对，默认输出文件名是 typescript；如果录制时指定了其他文件名，就必须通过 --log-out 或位置参数明确告诉播放器。

# 录制一段终端会话，同时保存输出和时间信息
script --log-timing=session.time --log-out=session.typescript

# 录制完成后按原始节奏回放；回放不会重新执行原命令
scriptreplay --log-timing session.time --log-out session.typescript

用 --divisor 固定调整回放速度

固定倍率时优先使用 --divisor。它的名字容易让人误解：数值实际是“原始延迟除以多少”，所以数值越大越快。大于 1 用于快速浏览，介于 0 和 1 用于慢放，1 则保持原速。

# 两倍速，适合快速检查一段较长的构建日志
scriptreplay --timing session.time --typescript session.typescript --divisor 2

# 半速，方便观察输出顺序和停顿位置
scriptreplay --timing session.time --typescript session.typescript --divisor 0.5

# 旧式写法：第三个位置参数同样表示速度因子
scriptreplay session.time session.typescript 2

如果日志里有多个输入输出流，先确认录制格式，再考虑 --stream out 或 --stream in 只播放目标流。不要把改变回放速度理解成改变原始日志的时间戳，源文件本身不会被改写。

长停顿用 --maxdelay，临时控制交给按键

演示录屏或故障复盘时，某个命令可能留下几分钟空白。此时可以用 --maxdelay 限制单次等待，例如最多等三秒；它只处理过长的间隔，其他输出仍按倍率播放。

# 保持原速，但把单次超长停顿压到 3 秒以内
scriptreplay --timing session.time --typescript session.typescript --divisor 1 --maxdelay 3

需要边看边调时，在回放过程中使用上方向键加速、下方向键减速、空格暂停或继续、右方向键立即推进当前一步。按键适合临时观察，不适合作为自动化脚本的稳定配置；批量回放应把倍率和最大停顿写进命令。

四项检查避免回放结果失真

另外，回放只是重新显示记录内容，不能证明命令在当前机器上仍然可执行。需要验证脚本行为时，应单独准备安全的测试环境，而不是直接把 typescript 当成可运行脚本。

常见问题

--divisor 设为 0.1 会发生什么？

它表示按原始速度的十分之一播放，也就是大约慢十倍。长日志会明显变慢，必要时可同时设置 --maxdelay。

为什么改了 typescript 文件却没有改变停顿？

停顿来自 timingfile，不来自输出文件的字符内容。要调整速度，应改 --divisor 或替换匹配的 timingfile。

能不能只快进某一个步骤？

可以在交互回放中按右方向键立即推进当前步骤；如果需要可重复的固定结果，建议拆分记录或使用稳定的 --divisor 配置。