claude-video进阶用法--fps手动调帧率的场景与风险【免费下载链接】claude-videoGive Claude the ability to watch any video. /watch downloads, extracts frames, transcribes, hands it all to Claude.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-videoclaude-video 是一款让 Claude 会看视频的开源技能粘贴链接或本地文件/watch就会自动下载视频、抽取画面帧、提取带时间戳的字幕让 Claude 真正看过再回答。它的进阶玩法里最容易被忽视的参数就是--fps手动调帧率——用对了能省下一大笔 token用错了则可能让 Claude 看漏关键画面。这篇指南带你搞懂它的工作原理、4 个适用场景和 3 个必须避开的坑。先搞懂自动帧率auto-fps是怎么算的claude-video抽帧的核心思路是按预算抽帧而不是固定帧率视频越长单帧间隔越大总帧数被压在可控范围内。自动预算大致如下来自 README.md视频时长默认帧数预算观感≤30 秒~30 帧很密基本覆盖每个关键时刻30 秒 – 1 分钟~40 帧依然密集1 – 3 分钟~60 帧舒适3 – 10 分钟~80 帧偏稀疏但可用10 分钟100 帧触发稀疏扫描警告建议聚焦重跑这套逻辑实现在 scripts/frames.py 的auto_fps函数中。对绝大多数问题自动帧率已经够用--fps的意义在于当你明确知道自动预算不合适时手动接管。--fps参数是怎么生效的参数定义在 scripts/watch.py--fps F # Override auto-fps它有两个隐形规则直接决定你能调多高、调多少帧率上限 2 fps。入口脚本会把传入值钳制到MAX_FPS 2.0见 scripts/frames.py 和 scripts/watch.py填--fps 5实际只按 2 fps 抽帧。帧数受--max-frames封顶。默认 80、硬上限 100。目标帧数 fps × 时长但 ffmpeg 的-frames:v会在达到上限时直接停止抽帧见 scripts/frames.py。这意味着目标帧数可能远大于实际帧数后面细说。4 个适合手动调帧率的典型场景场景一慢节奏长视频主动降帧省 tokenToken 成本几乎全部花在帧图上80 帧 512px 宽大约就是 5–8 万图像 token参考 SKILL.md 的 Token efficiency 一节。对于 PPT 式讲解、静态录屏这类画面变化缓慢的内容自动预算偏浪费。/watch 教程.mp4 --fps 0.1 summarize this5 分钟视频按 0.1 fps 只抽 30 帧token 直接降到原来的约三分之一信息几乎不损失。场景二快速变化的片段拉高帧率抓一闪而过报错弹窗、UI 状态跳变、动画过渡这类内容低帧率下可能帧与帧之间就变了。此时配合--start/--end聚焦区间再提帧率效果最好/watch bug-repro.mov --start 0:45 --end 0:55 --fps 210 秒区间按 2 fps上限抽 20 帧正好把瞬间变化钉在画面上。场景三逐帧对比两个视频要固定节奏对比 A/B 两版录屏、检查动画掉帧时你希望两个视频以完全相同的节奏取帧方便一帧对一帧比较。自动帧率会随时长浮动固定--fps 1就是更确定的选择。场景四与--start/--end组合精确控制某一区间聚焦模式本身已有更密的预算≤5 秒可达 2 fps但如果你对每 3 秒一帧这种节奏有明确预期直接用--fps指定即可覆盖聚焦预算。例如从 1 小时视频的 1:12 处开始按 0.5 fps 抽到结尾/watch $URL --start 1:12:00 --fps 0.53 个必须避开的风险⚠️ 风险一填超过 2 的帧率会被静默钳制--fps 3不会报错而是被悄悄压到 2 fps。如果你按3 fps × 30 秒 90 帧去做预期规划实际只拿到 60 帧后续分析节奏会错位。记住有效范围是 0 fps ≤ 2。⚠️ 风险二帧数硬上限导致后半段静默截断这是最隐蔽的坑。目标帧数 fps × 时长但抽帧最多只取--max-frames默认 80帧就停。举例5 分钟视频 --fps 1→ 目标 300 帧实际上限 80 帧只覆盖前 80 秒后 4 分钟 Claude 根本没看到。报告里- **Frames:** 80 1.000 fps (budget 300, max 80)这行就是信号——budget 和实际帧数对不上说明发生了截断。对策要么把帧率降到帧数上限 ÷ 时长以内要么显式--max-frames 100并用--start/--end拆段跑。⚠️ 风险三帧率翻倍 ≈ token 翻倍帧数是图像 token 的主要来源且与--resolution相乘1024px 宽时单帧 token 约为 512px 的 4 倍。手动提帧率前先看一眼报告里的帧数预算确认预算撑得住。--fps最佳实践清单✅ 先按自动帧率跑一遍看报告中的Frames: N x.xxx fps (budget, max)再决定是否手动干预。✅ 提帧率只在 2 fps 以内有意义且务必配合--start/--end聚焦小区间。✅ 长视频降帧率用 0.05 / 0.1 / 0.2 这类小值优先省 token。⚠️ 核对 budget 与实际帧数对不上就是被截断重新计算fps ≤ 上限帧数 ÷ 时长。⚠️ 同一视频追问时直接复用已有帧不要带新参数重跑白白烧 token。相关模块与文档模块说明scripts/watch.py入口脚本参数解析、帧率钳制、报告输出scripts/frames.pyffmpeg 抽帧与自动帧率auto_fps/auto_fps_focusSKILL.md技能契约可选参数说明、聚焦模式预算表README.md帧预算表、使用示例、硬性限制commands/watch.md/watch斜杠命令定义把--fps当成手动挡平时挂自动挡auto-fps就能跑只有在明确知道路况画面变化快、token 要省、节奏要对齐时才值得接管方向盘。【免费下载链接】claude-videoGive Claude the ability to watch any video. /watch downloads, extracts frames, transcribes, hands it all to Claude.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-video创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考