像剪辑师一样量化节奏:claude-watch 的 pacing 指标与镜头时长分析原理
像剪辑师一样量化节奏:claude-watch 的 pacing 指标与镜头时长分析原理
claude-watch(即 /watch 技能)让 AI 像剪辑师一样"看"视频:它通过场景变化抽帧统计 shot count、cuts/min 与镜头时长分布,把抽象的"节奏感"变成可对比的数字,最终写入结构化的 report.md。这篇文章带你完整拆解它的 pacing 指标是怎么算出来的。
为什么"节奏"需要被量化?
看视频时我们常说"这个片剪得密""那个片子节奏拖",但这只是一句主观印象。剪辑师手里其实有一把尺子:
- 每分钟切了几刀?(cut rate)
- 每个镜头平均停多久?(shot length)
claude-watch 的 editorial pacing metrics 做的正是这件事——让 AI 读完一个视频后,能用数字回答上面的问题。实现全部集中在 scripts/pacing.py 里,核心只有一个 compute_pacing() 函数,输入两组数据:
| 输入 | 含义 |
|---|---|
scene_times |
每个镜头的起始时间戳(秒),由场景变化检测产出 |
video_duration |
分析范围的总时长(秒) |
可选的 motion_scores(每镜头的运动强度,0–1)用于标注每个镜头"动不动感",目前保留为扩展位。
数据来源:一个镜头抽一帧
pacing 的原料来自 scripts/frames.py 的场景变化抽帧。它利用 ffmpeg 自带的场景检测滤镜:
select='gt(scene,0.3)'—— 相邻帧的画面差异超过 0.3(0–1 之间)就判定为"切了一刀",并抽出该帧。
阈值 0.3 是一个"宽容"的设定:既能抓住硬切(hard cut)和多数叠化(dissolve),又不会因为画面内的小运动误报。两个巧妙细节:
- 永远先抽第 0 帧(
eq(n,0)+):场景滤镜只对"变化"触发,不加这句会漏掉开场第一个镜头。 - 静态视频自动降级:屏幕录制、长口播这类画面,场景变化往往不足 10 处,脚本会自动回退到均匀抽帧(scripts/frames.py)——"稀疏的帧,好过几乎没有帧"。
抽到的每帧都带着精确时间戳,scripts/watch.py 把这些时间戳直接当作镜头切点交给 pacing 模块(scripts/watch.py)。
pacing 的 4 个核心指标
compute_pacing() 的输出是一个 JSON 结构(scripts/pacing.py):
| 指标 | 计算方式 | 直白含义 |
|---|---|---|
shot_count |
镜头数量 | 一共切了几个镜头 |
cuts_per_minute |
镜头数 ÷(时长 ÷ 60) | 每分钟切几刀 |
mean_shot_length |
各镜头时长求平均 | 平均每个镜头停多久 |
median_shot_length |
各镜头时长的中位数 | 抗极端值,反映"典型镜头" |
同时还会输出一份 shots 清单,逐镜头记录 start_seconds(起点)、duration_seconds(持续)和 motion_score(运动分,可为空)。
💡 为什么平均数和中位数都要?一个 3 秒镜头 + 一个 57 秒镜头的视频,平均值是 30 秒,完全失真;中位数 30 秒虽然也不准确,但配合平均值一起看,就能判断镜头时长的"分布形状"。
举个例子:60 秒视频的节奏长什么样?
单元测试里有一个很好的真实样例(scripts/tests/test_pacing.py):一段 60 秒视频,镜头起点在 0s、5s、13s、25s、35s、50s:
| 镜头 | 起点 | 时长 |
|---|---|---|
| 1 | 0.0s | 5.0s |
| 2 | 5.0s | 8.0s |
| 3 | 13.0s | 12.0s |
| 4 | 25.0s | 10.0s |
| 5 | 35.0s | 15.0s |
| 6 | 50.0s | 10.0s |
计算结果:shot_count = 6,cuts_per_minute = 6.0,mean_shot_length = 10.0s,median_shot_length = 10.0s——一个每分钟切 6 刀、单镜头约 10 秒的中等密度节奏。作为对比,一条 120 秒单镜头视频的结果是 cuts_per_minute = 0.5,节奏差异一目了然。
pacing 如何进入 report.md
每次 /watch 运行都会在工作目录生成一份固定结构的 report.md,其中 Editorial profile 小节由脚本直接填充确定性数字(scripts/report.py):
- Shots: 6
- Cuts/min: 6.0
- Mean shot length: 10.0s
- Median shot length: 10.0s
- Talking-head ratio: n/a (opencv not installed)
数字是机器算的,风格结论交给 AI:报告里留了一个 <!-- pending Claude fill: ... --> 占位标记,提示 Claude 结合 pacing 数字和英雄帧,写出一句风格指纹,比如"紧凑的快切 + 大量 B-roll,无屏显文字"。数值与叙事分工明确,这是整份报告可信度的关键设计。
进阶:pacing 数据还会驱动"英雄帧"选择
pacing 不止用于展示。select_hero_frames()(scripts/frames.py)从全部帧里挑 3–5 张"英雄帧"嵌入知识库时,会用到镜头级数据:
- 开场 10 秒内第一个场景变化之后的帧(对应 hook 显微镜区间);
- 运动分最高的镜头首帧——全片最"有戏"的一刻;
- 持续时间最长的镜头首帧——最稳定的画面。
其中运动分目前是一个预留桩(返回 0,scripts/pacing.py),未来可用 ffmpeg 的 signalstats 逐镜头计算;口播占比(talking-head ratio)同理,需要 opencv 依赖,暂在报告中保持 n/a。
边界情况:pacing 何时会"沉默"?
- 静态/录屏视频:场景变化不足 10 处时走均匀抽帧,此时
scene_times为空,shot_count = 0,报告里会显示"No scene-change data — likely a static/screen-recorded source.",而不是给出误导性的 0 节奏。 - 专注模式(
--start/--end):只统计指定区间内的镜头,时间戳仍是原视频的绝对时间。
快速上手:让 AI 分析你视频的节奏
- 在 Claude Code 中安装技能:
/plugin marketplace add taoufik123-collab/claude-watch/plugin install watch@claude-watch - 粘贴链接并提问即可,例如:
/watch https://youtu.be/xxxx what is the pacing like? - 长视频建议聚焦分析:
--start 2:15 --end 2:45,帧更密、结论更准。
实用建议:pacing 统计在 10 分钟以内的视频上最有参考价值;硬上限为 2 fps、100 帧(README.md)。
小结
claude-watch 的 pacing 模块证明了"像剪辑师一样思考"可以完全数字化:场景检测出切点 → 切点变镜头 → 镜头算指标 → 指标进报告 → 报告指导风格判断。四个指标、一条确定性数据流,就能让 AI 的回答从"感觉剪得挺快"升级成"每分钟 12 刀,中位镜头 2.5 秒,是典型的 fast-cut 风格"。
- 完整功能与安装说明:README.md
- 技能契约(报告字段、入库流程):SKILL.md
- 功能演进历史:CHANGELOG.md(pacing 指标在 0.2.0 版本引入)