claude-video参数速查表watch.py全部8个选项的完整参考【免费下载链接】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 真正看过视频后再回答问题。整套流程的核心是入口脚本 watch.py它的行为全部由1 个必传参数 8 个可选参数控制。本文是这 8 个参数的完整速查表每个选项的默认值、适用场景和常用组合一次讲清。一、watch.py 8 个参数速查总表先看全局后文逐项展开参数类型默认值一句话作用source必传位置参数—视频 URL 或本地文件路径--start T时间0聚焦区间起点支持SS/MM:SS/HH:MM:SS--end T时间视频结尾聚焦区间终点--fps F浮点数自动计算手动覆盖抽帧频率最高 2 fps--max-frames N整数80帧数上限硬顶 100--resolution W整数512帧宽度像素--whisper groq\|openai枚举自动选择强制指定语音转写后端--no-whisper开关关完全禁用语音转写--out-dir DIR路径系统临时目录指定工作文件保存位置 全部参数定义集中在 watch.py官方用法速记见 SKILL.md 与 README.md。命令行直接调用格式为python3 scripts/watch.py source [选项]。如果你还没有代码手动安装只需git clone https://gitcode.com/GitHub_Trending/cl/claude-video ~/.claude/skills/watch二、sourceURL 与本地文件二选一source是唯一的必传参数两类输入都支持URL任何 yt-dlp 支持的站点如 YouTube、TikTok、Vimeo、Loom、X 等几百个平台开箱即用。本地路径.mp4、.mov、.mkv、.webm等格式直接原地探测不经过下载。# URL问一个具体问题 python3 scripts/watch.py https://youtu.be/abc 第30秒发生了什么 # 本地文件排查录屏中的问题 python3 scripts/watch.py ~/Movies/screen-recording.mp4 界面在哪里出错了⚠️ 注意该技能不登录任何平台账号私有/需登录的内容无法访问。三、--start / --end一键聚焦时间段效果立竿见影这是收益最高的两个参数。只传--start或--end时区间自动补全到视频开头/结尾两者传齐则精确截取。时间格式支持SS、MM:SS、HH:MM:SS三种写法解析逻辑见 frames.py且会做合法性校验——--end小于--start、起点超出片长都会直接报错退出watch.py。# 只看 2:15 到 2:45 的 30 秒 python3 scripts/watch.py $URL --start 2:15 --end 2:45 # 从 1 小时 12 分处看到结尾 python3 scripts/watch.py $URL --start 1:12:00为什么强烈推荐一旦进入聚焦模式脚本会切换到更密的帧预算frames.py片段时长聚焦模式帧预算≤5 秒2 fps最多 10 帧5–15 秒2 fps最多 30 帧15–30 秒最多 60 帧30–60 秒最多 80 帧60–180 秒100 帧封顶对比全片扫描超过 10 分钟的视频仅稀疏取 100 帧聚焦模式在同样 token 预算下细节密度高出一个量级。转录文本也会自动过滤到同一时间区间帧时间戳保持为视频绝对时间方便对齐。四、--fps 与 --max-frames控制 token 成本的两道闸门claude-video 的 token 开销主要来自抽帧图片约 80 帧 512px 就要消耗 5–8 万图像 token这两个参数就是你的节流阀。--max-frames N压帧数上限默认 80 帧超过 100 会被强制压回 100watch.pypython3 scripts/watch.py $URL --max-frames 40 # 更省 token--fps F覆盖自动抽帧率不传时脚本按片长自动计算 fps预算逻辑见 frames.py≤30s 约 30 帧、1–3 分钟约 60 帧、3–10 分钟约 80 帧。手动指定时会被钳制在 2 fps 硬顶内python3 scripts/watch.py $URL --start 2:15 --end 2:45 --fps 3 # 3 会被钳制为 2 fps实际取满该区间最高密度典型决策全片粗扫用默认值 → 答案不够细 → 加--start/--end聚焦重跑而不是盲目调高--fps那样只会烧 token。五、--resolution需要读屏上文字时升到 1024默认每帧宽 512px对看动作、看画面足够。但如果 Claude 需要读出屏幕上的文字幻灯片、终端、代码截图升到 1024px 是正确姿势python3 scripts/watch.py $URL --resolution 1024 她提到的工具名字是什么⚠️ 代价要心里有数分辨率翻倍后单帧图像 token 约为原来的 4 倍只在确实需要读字时使用。六、--whisper 与 --no-whisper转写的三档开关转录文本有两条来源yt-dlp 直接拉取平台原生字幕免费、首选没有字幕时才走 Whisper API 转写。两个参数控制后者用法行为不传自动优先 Groqwhisper-large-v3更快更省无 Groq 密钥时用 OpenAIwhisper-1--whisper groq或--whisper openai强制指定后端适合一家 API 失败时换另一家重试--no-whisper完全禁用转写无字幕的视频只返回帧零 API 费用# 强制走 OpenAI 转写 python3 scripts/watch.py $URL --whisper openai # 本地纯看画面不花一分钱转写费 python3 scripts/watch.py demo.mp4 --no-whisper 两个 API 密钥都存放在~/.config/watch/.env首次运行 setup.py 会自动生成模板Groq 优先。绝大多数公开视频都有免费字幕Whisper 主要服务于本地文件和少数无字幕视频。七、--out-dir让工作文件留在指定位置默认情况下下载的视频、抽帧 JPEG、音频片段都写进一个自动生成的watch-前缀临时目录用完即弃。加--out-dir可以指定固定位置方便复查抽帧结果或留存转录python3 scripts/watch.py $URL --out-dir ~/watch-work工作目录路径会在脚本结束时的报告末尾打印追问完视频内容后记得清理。八、3 个高频参数组合直接抄作业长视频问局部最常用——超过 10 分钟的全片扫描会触发稀疏警告聚焦重跑才是正解python3 scripts/watch.py $URL --start 12:00 --end 13:30 这段讲了什么读屏上文字——演示录屏、课件视频python3 scripts/watch.py lecture.mp4 --resolution 1024 --start 5:00 --end 8:00省 token 粗扫——预算紧张时压低帧数python3 scripts/watch.py $URL --max-frames 40九、新手常见疑问快答Q80 帧和 100 帧上限为什么是死的帧数直接决定图像 token 成本watch.py 与 frames.py 双重封顶--max-frames默认 80、硬顶 100、--fps硬顶 2防止一条命令打爆上下文。Q视频多长效果最好10 分钟以内最佳更长请配合--start/--end。QWhisper 转写会传整个视频吗不会只上传 16kHz 单声道音频片段上限 25MB约 50 分钟音频。QWindows 下要注意什么用python而不是python3调用脚本。十、附录参数背后的源码位置文件说明scripts/watch.py入口参数解析、区间校验、自动 fps 编排scripts/frames.pyauto_fps全片预算与auto_fps_focus聚焦预算scripts/download.pyyt-dlp 下载与字幕拉取封装scripts/whisper.pyGroq / OpenAI 转写客户端SKILL.md技能完整契约含失败模式处理CHANGELOG.md版本历史把这张速查表存在手边下次调/watch时按场景选参局部细节用--start/--end读屏用--resolution控成本用--max-frames其余场景默认值就是最优解。【免费下载链接】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），仅供参考