向您的 AI 程式碼代理顯示錯誤,而不是 4K 影片
有些錯誤只以動作形式存在:閃爍、競態條件、在動畫中途破裂的版面配置。Maxisnap 在 Windows 上記錄區域或全螢幕並匯出一鍵 AI 最佳化 MP4 ,簡短、大小合適,準備進入 Claude Code、Codex CLI 或 Gemini CLI,而不上傳不必要的大檔案。
Windows 10(1903+)/ 11 · 免費方案 · macOS 尚未推出
螢幕截圖凍結時刻;錄影顯示序列。 當您在終端機中與 AI 程式碼助手配對時,有些問題不可能在靜止中描述:懸停狀態跳躍、提交兩次的表單、結結巴巴 2 秒然後恢復的影片播放器、在一個監視器上結結巴巴但不在另一個上的捲軸。對於這些,5 秒鐘的剪輯比三段散文甚至單一幀說明的要多。
問題在於原始螢幕錄影是傳遞給模型的錯誤檔案類型。一分鐘的完整解析度擷取可能是數十 MB,而接受影片的工具對檔案大小很挑剔,且上傳大檔案的速度很慢。Maxisnap 會修復檔案本身,而非基礎設施:它記錄你指向的內容、讓你修剪至重要時刻,並匯出專為 AI 工具設計的小型副本——然後提供給你複製、拖曳或按路徑參考的檔案。
何時應該發送錄影而不是螢幕截圖?
當問題在單個幀中可見時發送螢幕截圖,例如堆疊追蹤、錯誤對齐的元素、錯誤的顏色。當錯誤涉及時間的變化時,應轉向錄影:只在動畫運行時出現的東西、必須按特定順序發生的互動,或您無法透過單一點擊重現的時序問題。錄影還免費攜帶確切的重現步驟,因為代理會看著您執行它們。
| 問題 | 最佳格式 | 為什麼 |
|---|---|---|
| 堆疊追蹤或錯誤對話 | 螢幕截圖 | 一個幀保持模型需要的所有文字 |
| 錯誤轉譯的版面配置 | 螢幕截圖 | 靜態;靜止更便宜且同樣清楚 |
| 動畫或轉場故障 | 錄影 | 故障只存在於幀中 |
| 難以重現互動錯誤 | 錄影 | 剪輯是重現步驟 |
| 結結巴巴、落後或競態條件 | 錄影 | 時序是整個重點 |
為什麼不只是上傳原始錄影?
因為原始捕獲遠大於需要。全解析度高幀率視訊承載著模型不使用的細節,它可以以適中的寬度和足夠光滑的幀率清楚地閱讀 UI。過大的剪輯上傳速度較慢,更有可能達到單個檔案大小限制,而且在將影片取樣為幀的工具上,不如大小合適的剪輯資訊豐富。將剪輯修剪到重要時刻並對清晰度而不是保真度進行編碼是在將視訊發送到 AI 工具之前可以做的最高槓桿率的事情。
Maxisnap 的 AI 最佳化 MP4 是那個大小合適的副本:大約 1280 px 寬, 24 fps,與 單聲道 音訊、寫成 aioptimized_*.mp4。也有超輕選項(每秒幾幀、無音訊),用於當工具接受影片但您想要最小可能檔案時。
| 你送出的內容 | 短剪輯的典型大小 | 結果在工具中 |
|---|---|---|
| 原始全螢幕錄影 | 數十 MB | 上傳速度慢,可能超過大小限制 |
| Maxisnap AI 優化 MP4 | 大小的一小部分 | 上傳速度快、保持下限、清楚讀取 |
大小取決於剪輯長度、動作和內容;重點是比率,而不是固定圖形。Maxisnap 不會自動化任何 AI 工具,它只產生檔案。
我如何錄製錯誤並將其交給 Claude Code?
四個步驟、一個應用程式、第二個工具中的無重新編碼:
- 記錄它。 按下
Ctrl+Alt+3錄製區域或Ctrl+Alt+4用於全螢幕(您遊標下的監視器)。重現錯誤,然後再次按快速鍵或按一下停止。兩個快速鍵都是可重新映射的。 - 修剪死亡空氣。 結果視窗開啟,具有內嵌播放器和開始/結束修剪把手,將其切到實際顯示故障的兩秒鐘,所以模型不會看著您找到它。
- 匯出 AI 最佳化副本。 選擇 AI 優化格式,Maxisnap 寫一個緊湊
aioptimized_*.mp4。在 v2.4.9.2 中,未改變的剪輯會立即傳遞,轉換輸出會被快取,所以檔案在您要求時已準備就緒。 - 交付它。 使用結果視窗的複製或拖曳來將檔案移動到您的終端機,或儲存它並在提示中按路徑參考它。
因為匯出已經很小且形狀正確,您完全跳過「為什麼我的上傳這麼慢/被拒絕」往返。
哪些 AI 程式碼工具接受影片,以及如何?
終端機程式碼代理中的影片支援比影像支援更新和更不統一,而且變化很快,所以最便攜的習慣是將檔案保留在磁碟上並參考它,而不是依賴剪貼簿貼上。這是目前的情況;檢查每個工具自己的文件以取得今天的確切行為。
| 工具 | 如何給它一個檔案 | 筆記 |
|---|---|---|
| Claude Code | 在提示中按路徑參考已保存的檔案,或將檔案拖到終端機中。 | 檔案路徑是 Windows 和 WSL 上最可靠的路由,剪貼簿貼上可能會無聲失敗。 |
| Codex CLI | 將檔案拖進去,或用您的版本支援的影像/檔案旗明確傳遞它。 | 傳遞明確路徑避免依賴不穩定的剪貼簿。 |
| Gemini CLI | 按路徑參考檔案,或將其拖到提示中。 | 多模式支援因版本而異;無論如何保存檔案路由都有效。 |
| ChatGPT / Claude / Gemini 應用程式 | 附加 aioptimized_*.mp4 在聊天的上傳控制中。 | 小檔案上傳速度快,不太可能達到大小限制。 |
某個助手是否可以讀取影片以及如何讀取,由該工具設定並經常變化。Maxisnap 的工作是製作一個小的、標準 MP4,您可以透過任何有效的路由交付。
$ diff raw-capture ai-optimized.mp4
[RAW] full-screen, full-res, full frame rate -- tens of MB, slow upload, may exceed the limit [MAXISNAP] trim + AI-optimized export ++ ~1280px, 24fps, mono, a fraction of the size [RAW] the whole two-minute session -- the model watches you hunt for the bug [MAXISNAP] start/end trim to the fault ++ five seconds that show exactly the problem [RAW] re-encode in a second tool, find the file -- extra steps between you and the answer [MAXISNAP] Copy / Drag / Save from the result window ++ file in the terminal in one move
錄影可以包括音訊嗎?
是的。Maxisnap 預設會同時錄製系統音訊和您的麥克風,無需驅動程式,因此您可以在重現錯誤時進行敘述(「看這裡的計數器,它從 3 跳到 5」),這將您的意圖與視覺一起提供給模型。AI 優化的匯出保持單一單聲道軌跡以保持較小,超輕選項在您只需要圖片時完全放棄音訊。如果您想發送靜默剪輯,那是一個設定,而不是變通方法。
AI 程式碼的螢幕錄影,常見問題
我可以與 Claude Code、Codex CLI 或 Gemini CLI 分享螢幕錄影嗎?
是的。Maxisnap 在 Windows 上記錄區域或全螢幕,並匯出緊湊的 AI 優化 MP4,您透過它支援的路由交給工具,拖曳檔案或在提示中按路徑參考。檔案路徑是 Windows 和 WSL 上最可靠的方法。Maxisnap 產生檔案;它不會自動化助手。
AI 優化的影片設定是什麼?
AI 優化 MP4 約為 1280 px 寬 24 fps 與單聲道音訊,儲存為 aioptimized_*.mp4。超輕選項以每秒幾幀且無音訊的方式記錄,以取得最小可能檔案。您也可以匯出標準 MP4、GIF 或 WebM。
我如何只記錄螢幕的一部分?
按下 Ctrl+Alt+3 並拖曳一個方塊圍繞您想要的區域; Ctrl+Alt+4 改為記錄您遊標下的全螢幕。記錄後,結果視窗讓您在匯出前修剪開始和結束。
為什麼我的原始螢幕錄影太大而無法上傳到 AI 工具?
全解析度高幀率視訊遠大於模型需要。修剪到相關時刻並匯出 AI 優化 MP4 會產生遠小的檔案,上傳速度更快,不太可能達到單一檔案大小限制,同時保持清楚足以讓工具讀取。
它能在 Windows 上執行嗎?
是的,Maxisnap 是 Windows 原生的(Windows 10 1903+ 和 Windows 11)。macOS 構建正在開發中,尚無公開下載。這是一個 113 MB 安裝程式,錄音機、螢幕截圖工具、標註和 OCR 都在一個應用程式中。
記錄錯誤。修剪它。交付它。
捕獲區域或全螢幕、匯出 AI 優化 MP4、將其放入您的程式碼代理,Windows 上免費。
相關: 給 AI 程式設計用的螢幕截圖 ‧ 將螢幕截圖貼到 Claude Code ‧ 螢幕錄影 + 截圖工具 ‧ 錄製錯誤報告