支援設備.
對照原始碼實查
裝之前你應該先知道的事，包括它做不到的、要另外準備的，還有目前工具的現況能力。
做得到 有條件 做不到
平台
Intel Mac 能用嗎？
不能。macOS 版只支援 Apple Silicon（M1 以後），沒有 Intel 版本。
Windows 能用嗎？
可以，x64，有 .exe 與 .msi 兩種安裝檔。沒有 NVIDIA 顯示卡的話請看下面「速度」那幾列。
Linux 呢？
沒有安裝檔。可以從原始碼用 pip 裝，或用 Docker 跑。
要另外準備的
下載安裝檔就能用了嗎？
安裝檔已經包好 Python 後端與 ML 套件，但 FFmpeg（抽幀、轉檔）和 Ollama（視覺模型、向量、助手）兩套工具需要你額外自己裝，並先把模型拉下來。第一次轉錄時也會自動下載 Whisper 模型，往後工具就不必連網就能使用。
macOS（打開「終端機」，需先安裝 Homebrew）
brew install ollama ffmpeg exiftool
brew services start ollama
ollama pull bge-m3
ollama pull qwen2.5vl:7b
ollama pull qwen2.5:14bWindows（打開 PowerShell；Ollama 裝好後從開始選單開一次，它會留在背景執行）
winget install Ollama.Ollama
winget install Gyan.FFmpeg
winget install OliverBetz.ExifTool
ollama pull bge-m3
ollama pull qwen2.5vl:7b
ollama pull qwen2.5:14b三個模型合計約 15 GB，只需要下載一次。ExifTool 是選裝的，用來讀機型、鏡頭、拍攝時間；沒裝也能用，只是少了這些資訊。
完整步驟：macOS 安裝說明・Windows 安裝說明
安裝檔有數位簽章嗎？
還沒有。macOS 第一次開啟要用「右鍵 → 打開」，Windows 會跳一次 SmartScreen 提示，按「仍要執行」。之後開啟不會再出現。
速度
看畫面要多久？
視覺分析是整條流程最慢的一步。以預設模型在 M2 Max 上算，約 2,000 格要 3.5 小時。一支 60 秒以上的素材通常會抽好幾格，所以大批匯入適合收工後丟著跑一晚。
M2 Max 實測：qwen2.5vl:7b 約 8 秒／格，qwen3-vl:8b 約 60 秒／格。config.py
Windows 沒有 NVIDIA顯示卡呢？
轉錄預設走 CUDA，沒有 NVIDIA 會直接失敗。把環境變數 ARKIV_WHISPER_DEVICE 設成 cpu 就能跑，但處理時間以倍數計。Apple Silicon 走 MLX，不受影響。