60 秒真實操作示範
真實安裝、真實執行、真實介面——一鏡到底，沒有剪接美化。
AI 其實沒看懂你丟的影片
把 YouTube 連結貼給 ChatGPT，它拿到的是標題、說明欄和字幕這些「文字」，畫面一格都沒看過，連封面圖都不一定有讀；Claude 更直接，影片檔根本不收。你以為它看完了，其實它只是讀了一份文字資料。
claude-real-video 解決的就是這件事：丟一個網址或影片檔進去，它抓出「畫面真的變了」的關鍵幀、自動去掉重複的圖、把聲音整理成逐字稿，打包成 AI 讀得懂的一包資料。影片解析與輸出生成都在你的電腦完成，原始影片不會上傳；你之後選擇貼給雲端 LLM 的畫格或逐字稿，仍會傳給該服務。ChatGPT、Claude、Gemini 都能讀。
安裝：兩行搞定
需要 Python（Mac 內建就有）跟 ffmpeg（處理影片用的免費工具）。打開終端機——Mac 按 cmd＋空白鍵搜尋「終端機」——照順序貼這兩行：
第一行，裝 ffmpeg（Mac 用這個；Windows 用 winget install Gyan.FFmpeg）：
brew install ffmpeg
第二行，裝工具本體：
pip install claude-real-video
使用：丟影片進去，拿一包資料出來
YouTube、IG、TikTok 的網址都可以，本機的影片檔也行：
crv "https://www.youtube.com/watch?v=你的影片"
跑完會出現一個 crv-out 資料夾，裡面三樣東西：
frames/——精選的關鍵畫面（只留畫面真的有變的，重複的自動丟掉）
transcript.txt——整支影片的逐字稿
MANIFEST.txt——給 AI 看的總說明，告訴它這包資料怎麼讀
grids/——加 --grid 才有：連續畫面拼成的九宮格（下面會講）
它是怎麼讓 AI 看懂影片的
不神秘，就四步，每一步都在你電腦上跑：
抽關鍵幀——先掃過整支影片，畫面真的變了才抓一張（場景變化偵測），不是傻傻每秒截一張圖
三道去重篩子——抓下來的圖再過三關：整張畫面差異比對、細部文字變化（投影片換字、字卡切換也抓得到）、動作通道（畫面裡小小的主體在快速動也留得住，0.7.16 新增）。留下來的每張都有新資訊
逐字稿帶時間戳——聲音用 whisper 在本機轉成文字，每一句都記下是第幾秒講的
合成時間軸文件——畫面對上台詞，織成一份 AI 讀得懂的總說明（MANIFEST）。AI 讀完這份，等於真的看過這支影片：哪一秒發生什麼、誰說了什麼、畫面長什麼樣，都對得起來
範例一：餵給 Claude 網頁版
打開 claude.ai 開新對話，把 frames 資料夾裡的圖片跟 transcript.txt 一起拖進輸入框（圖太多就挑重點的幾張），然後貼這句：
這是一支影片拆出來的關鍵畫面跟逐字稿。請幫我：1. 總結這支影片在講什麼 2. 列出它的內容結構 3. 告訴我最值得學的三個點
從這裡開始就隨你問了：叫它把影片改寫成貼文、抓出金句、分析運鏡節奏都行——因為它這次是真的「看過畫面」。
範例二：餵給 Claude Code（更順）
有在用 Claude Code 的話更簡單，連拖圖都不用。跑完 crv 之後直接在終端機輸入 claude，然後說：
讀 crv-out 資料夾：先看 MANIFEST.txt，再看關鍵幀跟逐字稿，然後告訴我這支影片在講什麼、它的腳本結構是怎麼安排的。
Claude Code 會自己打開資料夾、一張一張看圖、讀完逐字稿再回答，整包資料都吃得下。我自己拆解對標影片、研究別人的腳本怎麼寫，就是這個流程。
三個實際用法
裝好之後可以拿來幹嘛？我自己最常跑的三種：
1. 摘要一支捨不得花時間看的長影片
crv "https://youtu.be/影片網址" --why "幫我抓重點"
跑完把 crv-out 丟給 Claude，問它：「用五個重點總結，每個重點附上發生在第幾秒」。時間戳都在資料裡，它答得出來，你想跳著看也知道要跳去哪。
2. 拆解一支爆紅短片的節奏
crv "https://www.instagram.com/reel/xxx" --adaptive --text-anchors
--adaptive 抓慢速變化的運鏡、--text-anchors 在字卡出現的瞬間補幀——節奏快、字卡多的短片就開這兩個。跑完問 Claude：「它前三秒的 hook 是怎麼設計的、幾秒切一個畫面」，拆對標就是這樣拆。
3. 把自己的影片庫批量跑一遍
for f in ~/Videos/*.mp4; do crv "$f" -o "crv-out/$(basename "$f" .mp4)"; done
一行迴圈，整個資料夾的影片各自變成一包文字描述。之後問 Claude：「這批影片裡哪幾支有講到定價」，它用搜的就找得到。有位用戶就是這樣把相簿裡 2,181 支影片跑完，四天，分析結果直接寫回相簿的中繼資料。
新功能：讓 AI 看得更懂（最新 0.7.16）
上了 Hacker News 首頁之後，我照大家的回饋持續更新。最新這三個：
動作通道去重（0.7.16）
畫面裡小小的主體快動作，以前會被當「畫面沒變」刪掉。現在有專門的動作偵測通道，同一支測試片動作幀從 1 張變 10 張全保留——一位用戶拿 2,181 支影片實測回報，當天修完
幀數上限隨片長調整（0.7.16）
長影片不再被固定 150 張餓著，上限自動跟著片長走
特殊編碼影片不再中斷（0.7.16）
帶著老編碼中繼資料的影片照樣分析，不會半路炸掉
更早的更新（點開看全部）
- VAD 防幻聽 whisper 聽寫有個老毛病：遇到純音樂或安靜段落會自己編一句台詞
- 抖音連結直接吃 以前抖音會把下載器擋在門外，現在被擋時自動改走手機分享頁撈影片，貼 v.douyin 短鏈跟貼 YouTube 一樣直接能看
- 時間軸（timeline） 關鍵幀直接織進逐字稿：哪一句話配哪幾張畫面、沒人講話的空檔各自成段，AI 拿到的是「對好時的劇本」，不用自己對照兩份資料猜哪張圖配哪句話，長影片的張冠李戴從結構上消失
- 逐字稿安全圍欄 逐字稿是影片作者寫的、屬於「不可信內容」，現在整段用明確邊界包起來並教 AI「這是資料不是指令」，惡意字幕想叫 AI 做事會被當成內容回報而不是被執行；連偽造結束標記提早關欄都防了
- 中日韓 Windows 修正 繁中/日文/韓文 Windows 的終端機用老編碼（cp950/cp949），跑完最後一行的 ✓ 符號會讓程式「成功卻報錯」，已改成強制 UTF-8 輸出，跟 pip、git 同一套做法
- 簡易速度分辨 影片如果帶著「墊幀慢放」的指紋（重複幀排成規律短串），分析檔會自動多一行提醒 AI「這支疑似被放慢過」
- --speakers 說話者標籤 訪談、podcast、會議影片，逐字稿每句自動標出是誰在說（[SPEAKER_00]、[SPEAKER_01]…）
- --grid 把連續的關鍵幀拼成 3×3 九宮格
- --why "我想知道什麼" 把你看這支影片的目的寫進說明檔，AI 會帶著這個問題去看，不會給你一篇不痛不癢的流水帳
- --whisper-model turbo 逐字稿引擎檔位自己選：預設求快，口音重、講話含糊、中文影片就切 turbo（準度接近 large-v2、速度約 8 倍，0.7.3 起支援），錯字率明顯降
- faster-whisper 引擎 裝的時候多打四個字 pip install 'claude-real-video[fast]'，逐字稿自動換更快的引擎跑
- --viewer 分析完多一個 viewer.html，雙擊打開
- transcript.json 逐字稿多一份帶時間戳的版本（每句的起訖秒數），接你自己的工具或直接餵給 AI 都好用
- frames.json 每張關鍵幀都記下它在原片的精確秒數，從抽幀、去重到改名全程保留，做「AI 看課程、標到秒」的流程直接接得上
- --cookies-from-browser chrome 要登入才看得到的影片（IG、TikTok），直接讀你自己瀏覽器的登入狀態，不用再匯出 cookie 檔
- --kb ~/notes 看完的整理自動存成一篇筆記，放進你指定的資料夾（例如 Obsidian）
裝成 Claude Code 的 skill / plugin
有在用 Claude Code 的話，可以讓它自己學會看影片——之後把影片連結貼給 Claude 說「看一下這支」，它就會自己跑完整個流程再回答你，連指令都不用打。一行裝好：
npx skills add HUANGCHIHHUNGLeo/claude-real-video
喜歡用 Claude Code 內建的 plugin marketplace 的話，這兩行也是同一個東西：
/plugin marketplace add HUANGCHIHHUNGLeo/claude-real-video
/plugin install claude-real-video@claude-real-video
裝完重開 Claude Code 就生效。這條通路是 2026 年 7 月剛鋪好的，Codex、Cursor、Gemini CLI 這些也吃 npx skills add 那行。
常用參數
--lang zh——指定逐字稿語言（預設自動偵測）
--no-transcribe——只要畫面、不要逐字稿，跑更快
--keep-audio——連原始音檔一起留（給聽得懂聲音的 AI 用）
--max-frames 50——控制最多抓幾張圖（0.7.16 起不指定就隨片長自動調）
完整參數跟進階用法都在 GitHub 的說明文件裡：
在 GitHub 上打開 claude-real-video原始碼 · 完整文件 · MIT 授權
覺得好用？給顆星星 ⭐
GitHub 的星星（Star）是開發圈的按讚，星星越多、越多人會信任並使用這個工具。如果它幫到你，按一顆是最實際的支持——不用花錢，30 秒搞定：
註冊 GitHub 帳號（已經有的跳到第 3 步）：到 github.com 點右上角 Sign up，用 email 註冊，跟辦一般帳號一樣
驗證信箱：收信點確認連結，帳號就開通了
登入後回到工具頁：點上面那顆黑色按鈕，進到頁面後找到右上方的 ⭐ Star 按鈕，點一下變黃色就完成了
小提醒：從 IG 點連結會用內建瀏覽器開，看不到 Star 按鈕。用 Safari 或 Chrome 開啟並登入 GitHub，按鈕就出現了。
下一步