Communitygithub.com

playthegameoflife/tiktok-screen-recorder

录制短视频的真实屏幕录像并逐帧验证。用于需要捕获、录制或屏幕录制视频URL,或从队列文件中批量处理时。在无头Linux系统上处理从下载到验证输出的完整流程。

tiktok-screen-recorder 是什么?

该技能是一个完整的TikTok视频捕获流水线,专门用于在无头Linux环境中录制短视频的屏幕录像并进行逐帧验证。它通过`pipeline.sh`脚本自动执行下载、录制、转码和验证等步骤,确保输出视频帧精确无误。技能的核心特点是严格依赖退出码判断成功,而不是依赖人工检查时长或文件大小,因为无声丢失最后一帧的视频仍可能具有正确的时长和帧数。仅`verify.py`中首帧/最后一帧的对比检查能发现此类问题。支持单个视频URL和批量队列文件处理,可指定输出目录和可选的cookies文件。对于exit code 10(下载失败)等常见情况,脚本会预期处理并记录数量而非重试,避免在数据中心IP上无谓循环。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/playthegameoflife/tiktok-screen-recorder/tree/HEAD/hermes/skills/tiktok-capture

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

TikTok捕获流水线

运行 pipeline.sh。不要自行推导 ffmpeg、mpv 或 Xvfb 命令,也不要通过肉眼或时长来判断录制是否成功。

唯一规则

切勿报告捕获成功。只有 pipeline.sh 通过退出码决定。

这很重要,因为无声丢失最后一秒的录制仍然具有完全正确的时长和帧数。只有 verify.py 中的首帧/最后一帧比较能捕获这种情况。如果你曾试图检查时长或文件大小就认为成功,这正是此流水线要防止的失败。

运行单个任务

OUT_DIR=/data/out ./pipeline.sh "https://www.tiktok.com/@user/video/123"

需要cookies时,当源需要会话:

OUT_DIR=/data/out COOKIES=/data/cookies.txt ./pipeline.sh "$URL"

运行批量任务

从队列文件中逐行读取URL并循环。除非你先检查CPU预算,否则串行运行——每个任务需要大约2个vCPU才能保持30fps而不丢帧,每个任务从自己的PID派生出显示号和PulseAudio实例,因此并发运行不会冲突。

while read -r url; do
    [ -z "$url" ] && continue
    OUT_DIR=/data/out ./pipeline.sh "$url" || echo "FAILED: $url"
done < queue.txt

退出码

退出码含义操作
0验证通过记录输出路径。无需其他操作。
3缺少依赖停止并报告。不可重试。
10下载失败预期情况。被屏蔽、私密或已删除。记录并继续。
11源无音频记录并继续。
12转码失败记录。重试一次,然后报告。
13捕获失败检查 Xvfb/pulseaudio 是否已安装且显示范围可用。
14修剪失败引导段无法测量或验证。报告;不要盲目重试。
15验证失败输出位于 <output>.rejected。报告为流水线缺陷。

退出码10是常规情况,不是事故。在数据中心IP上,对于大量URL这是预期结果。报告为计数,不要在循环中重试。

当问题反复出现时

退出码14或15表示流水线本身有问题,而不是视频。读取运行的 manifest.json 测量值——first_frame_mae 和 last_frame_mae 区分两种情况:

  • 最后一帧MAE高,首帧MAE低 → 引导段测量偏短,结尾被截断。
  • 两者都高 → 捕获未对齐或显示器从未更新。

报告数字,而不是调整容差以强制通过。提高 --match-threshold 以获得绿色结果并不是修复方法。

相关技能