企业官网建设流程全解析

一条命令武装Claude Code、Cursor和50+个AI工具：claude-real-video的agent skill安装全攻略

【免费下载链接】claude-real-videoLet Claude (or any LLM) actually watch a video — scene-aware, deduplicated frames + transcript, from a URL or local file. Runs locally, MIT.项目地址: https://gitcode.com/gh_mirrors/cl/claude-real-video

claude-real-video是一个免费的开源视频分析工具（MIT协议），它让 Claude、GPT 等任何 LLM 真正"看懂"视频——而不是只读字幕。通过安装它的agent skill，你只需一条命令，就能让 Claude Code、Cursor、Codex、Copilot、Gemini CLI 等 50 多个 AI 编程工具获得"看视频"的能力。本文提供从环境准备到验证生效的完整安装指南，零基础也能照做。

为什么你需要给AI装上这只"眼睛"？

把 YouTube 链接丢给 AI 时，大多数模型只会读文字稿，画面内容全靠"脑补"。claude-real-video 的做法完全不同：

• 场景感知抽帧：只在镜头真正切换时提取关键帧，而不是固定每秒 1 帧；
• 滑动窗口去重：A-B-A 式的重复镜头只发一次，静态幻灯片从几百帧压缩到 1 帧；
• 本地 Whisper 转录：音频转文字在你的机器上完成，原始视频不会上传。

📊 同一个 58 秒片段：固定 1fps 采样 = 58 帧，crv 只保留真正不同的 26 帧——token 更省，细节不漏。

安装前检查：agent skill 的环境要求

安装 claude-real-video skill 前，确认三个前提：

ffmpeg 安装命令：

# macOS brew install ffmpeg # Linux sudo apt install ffmpeg # Windows winget install Gyan.FFmpeg

最快安装方法：pip + npx 一条命令搞定

这是官方推荐的安装路径，也是 README.md 首页给出的方式：

pip install "claude-real-video[whisper]" npx skills add HUANGCHIHHUNGLeo/claude-real-video

两步分别做什么？

1. pip install "claude-real-video[whisper]"—— 安装crv命令行工具。注意[whisper]这个 extras必须显式写出，否则没有语音转文字能力（带字幕的视频除外）；
2. npx skills add—— 把 skill 文件分发到你机器上所有兼容 agentskills.io 规范的 AI 宿主：Claude Code、Cursor、Codex、Copilot、Gemini CLI 等，一次安装，处处生效。

👉 装完后，把视频链接粘贴进你的 AI 工具，直接问"这个视频讲了什么"，agent 会自动检测 skill 并调用crv。

备用方案一：仓库自带的 install-skill.sh 脚本

如果不方便用 npx，仓库提供了一键安装脚本 install-skill.sh。它会先克隆仓库，然后运行脚本：

git clone https://gitcode.com/gh_mirrors/cl/claude-real-video cd claude-real-video bash install-skill.sh

脚本的工作流程（对应手动操作的话非常繁琐）：

• 把 skill 安装到默认路径~/.agents/skills/claude-real-video-for-agents；
• 自动探测已安装的 AI 平台：Claude Code（~/.claude/skills）、Codex、Gemini CLI、OpenCode、Pi、MiMoCode；
• 按提示选择a（全部）或指定编号，用软链接把 skill 挂进各平台的 skills 目录——以后更新 skill，所有平台同步生效。

备用方案二：手动复制（5 秒学会）

skill 本质上就是一个 Markdown 文件，手动安装最简单：

# 以 Claude Code 为例 mkdir -p ~/.claude/skills cp -r claude-real-video/skills/claude-real-video-for-agents ~/.claude/skills/

各平台对应目录：~/.claude/skills/、~/.codex/skills/、~/.opencode/skills/、~/.gemini/skills/。

仓库里其实准备了两份 skill，按需选择：

Claude Code 用户：插件市场方式

如果你只用 Claude Code，还可以直接在会话内安装（支持自动更新）：

/plugin marketplace add HUANGCHIHHUNGLeo/claude-real-video /plugin install claude-real-video@claude-real-video

安装验证：30秒确认skill已生效

验证只需两步：

# 1. 确认核心工具可用 crv --help # 2. 手动跑一次，确认抽帧+转录正常 crv "https://www.youtube.com/watch?v=任意视频" --no-transcribe

看到crv-out/目录下生成frames/（关键帧）、MANIFEST.txt（给 LLM 读的分析清单），说明一切就绪。此时把视频链接发给你的 AI agent，它会走这样的流程：

1. 运行crv "<url>" --grid --why "你的问题"提取关键帧；
2. 先读MANIFEST.txt了解全貌；
3. 查看grids/里的 3×3 联系表，而不是逐帧看图（图片数量约省 9 倍）；
4. 引用时间戳回答你的问题。

常见问题排查

Q：npx skills add报权限错误？改用上面的install-skill.sh或手动复制方式，效果相同。

Q：转录结果是空或乱码？确认安装时带了[whisper]后缀；首次运行会自动下载约 139MB 的 Whisper base 模型，耐心等待即可。追求更快可用pip install 'claude-real-video[fast]'启用 faster-whisper。

Q：AI 工具装了却不调用 skill？skill 靠 description 里的触发词激活——直接说"帮我看看这个视频：xxx"，并确保消息里包含 URL 或本地文件路径。

Q：长视频会不会撑爆上下文？skill 已内置对策：长视频自动建议--max-frames 60，--grid把 9 帧拼成 1 张图。

小结

装好 claude-real-video 的 agent skill 之后，你的 AI 工具就完成了从"读字幕"到"看画面"的升级，而且所有处理都在本地完成，隐私可控。三句话记住整个流程：

1. pip install "claude-real-video[whisper]"装核心；
2. npx skills add HUANGCHIHHUNGLeo/claude-real-video装 skill（或跑 install-skill.sh）；
3. 粘贴视频链接，开问。

更多用法（--from/--to时间窗、--speakers说话人标注、MCP 服务器等）详见 README.md 与 skills/claude-real-video-for-agents/SKILL.md 中的完整 CLI 参考表。

【免费下载链接】claude-real-videoLet Claude (or any LLM) actually watch a video — scene-aware, deduplicated frames + transcript, from a URL or local file. Runs locally, MIT.项目地址: https://gitcode.com/gh_mirrors/cl/claude-real-video