claude-video 长视频处理完整指南稀疏扫描与聚焦重跑策略【免费下载链接】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命令就能下载视频、抽取帧、转写字幕让 AI 真正看懂长视频。本文面向新手手把手讲清长视频处理的核心策略——稀疏扫描Sparse Scan 聚焦重跑Focused Re-run帮你用最少的 token 拿到最准的答案。一、为什么长视频需要稀疏扫描 聚焦重跑claude-video 的底层逻辑很简单帧数 成本。每一帧都是一张图图片 token 是主要开销所以脚本用按视频时长分配帧预算的方式自动缩放抽帧密度视频时长默认帧预算实际效果≤ 30 秒约 30 帧密集几乎每个关键画面都有30 秒 – 1 分钟约 40 帧依然密集1 – 3 分钟约 60 帧舒适区推荐时长3 – 10 分钟约 80 帧稀疏但可用 10 分钟100 帧封顶触发 ⚠️稀疏扫描警告两个硬性上限2 fps、100 帧见 scripts/frames.py 中的MAX_FPS 2.0。也就是说一个 60 分钟的视频只会被抽 100 帧——平均每 36 秒才有一帧。这就是稀疏扫描先粗看一遍全片找到关键位置再细看。盲目对长视频做全量密集抽帧既烧钱又抓不住重点。二、长视频处理三步走扫描 → 定位 → 重跑第 1 步全片稀疏扫描直接丢给 Claude 长视频链接它会先完成一次稀疏扫描/watch https://youtu.be/xxx 总结这个视频讲了什么超过 10 分钟的视频报告会打印一条警告scripts/watch.py 第 176–183 行Warning:This is a 60-minute video. Frame coverage is sparse at this length — re-run with--start/--endto zoom into a specific section.看到这条警告别慌这正是工具在提示你该启用聚焦重跑了。第 2 步从扫描结果中定位章节稀疏扫描给出的帧都带tMM:SS时间戳字幕也带时间轴。让 Claude 基于这两路信息回答哪个时间段讲了 X——通常能缩小到一两分钟的范围。第 3 步用 --start / --end 聚焦重跑拿到大致时间后用--start/--end参数重跑时间支持秒、分:秒、时:分:秒三种写法# 只看 2:15 到 2:45 这 30 秒 /watch https://youtu.be/xxx --start 2:15 --end 2:45 # 从 1 小时 12 分到结尾 /watch https://youtu.be/xxx --start 1:12:00聚焦模式下帧预算明显更密集同样出自 scripts/frames.py 的auto_fps_focus聚焦区间长度帧预算≤ 5 秒2 fps最高 10 帧5 – 15 秒2 fps最高 30 帧15 – 30 秒约 2 fps最高 60 帧30 – 60 秒约 1.3 fps最高 80 帧60 – 180 秒约 0.6 fps100 帧封顶字幕也会自动过滤到同一时间范围内并且帧时间戳是全片绝对时间方便你对照原视频。三、长视频参数调节技巧除了--start/--end还有几个常用参数帮你进一步控精度、控成本参数作用使用建议--max-frames N压低帧数上限预算紧张时设--max-frames 40--resolution 1024帧宽从 512px 提到 1024px画面里有幻灯片、代码、小字时才用token 约 ×4--fps F手动指定抽帧频率仍受 2 fps 上限约束--no-whisper关闭语音转写纯画面类视频可省一笔 API 费用两个高频场景读屏幕文字教程、代码演示--resolution 1024 聚焦到讲代码的那一两分钟长访谈/播客画面变化少用默认 512px 稀疏扫描 字幕往往就够了不用重跑。四、成本意识什么时候值得重跑一个粗略的量级参考80 帧 512px 宽 ≈ 50–80k 图片 token而 10 分钟视频的字幕文本只要几千 token。所以短问题开头 3 秒画面是什么→ 直接聚焦重跑性价比最高概览问题这视频讲了啥→ 稀疏扫描即可别过度重跑同一会话内已经看过的视频直接追问即可Claude 手里已有帧和字幕无需重复跑脚本。另外注意 Whisper 上传上限约 25MB16kHz 单声道下约 50 分钟音频。更长的无字幕视频要么依赖平台原生字幕要么用--start/--end切小窗口再转写。五、关键文件速查文件说明SKILL.md技能契约完整流程与参数说明scripts/watch.py入口脚本编排下载 → 抽帧 → 转写scripts/frames.py抽帧 自动帧预算算法auto_fps/auto_fps_focusscripts/transcribe.py字幕解析与 Whisper 调度scripts/setup.py环境预检与依赖安装安装方面Claude Code 用户执行/plugin marketplace add bradautomates/claude-video后再/plugin install watchclaude-video即可其他环境可克隆仓库到本地技能目录git clone https://gitcode.com/GitHub_Trending/cl/claude-video ~/.claude/skills/watch六、小结长视频处理清单✅ 先全片稀疏扫描拿到带时间戳的粗粒度概览✅ 出现稀疏扫描警告 工具在建议你聚焦重跑照做即可✅ 用--start/--end定位章节聚焦模式帧更密、答案更准✅ 画面有字才开--resolution 1024平时用 512px 省 token✅ 同一会话连续追问不要重复跑脚本。一句话记住核心策略长视频别硬啃先粗扫定位再聚焦重跑——这就是 claude-video 处理长视频最省钱也最准的姿势。【免费下载链接】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），仅供参考