Arta Edit Studio — setup
讓全新克隆準備好執行 /reel-story 和 /reel-split，然後進行個人化設定。
在執行每個步驟前，先用一句簡單的句子解釋 — 許多使用者並非開發者。
在下載或安裝任何東西之前務必先詢問（套件、字型、模型權重），並說明大約的大小。
參數：$ARGUMENTS
1. 檢查機器 — 以 ✅ / ❌ 表格回報
| 需要項目 | 檢查方式 | 缺少時的解決方法 |
|---|---|---|
| Python ≥ 3.10 | python --version | python.org |
| Node ≥ 18 | node --version | nodejs.org（LTS） |
| 含 zscale 的 ffmpeg | ffmpeg -hide_banner -filters 應包含 zscale | Windows：gyan.dev 的「full」版本 · macOS：brew install ffmpeg |
| NVIDIA GPU（選用） | nvidia-smi | 無 → Whisper 在 CPU 上執行，速度約慢 10 倍 |
| 用於渲染的 Chrome | npx hyperframes doctor（步驟 2 之後） | doctor 會告知如何處理 |
2. 安裝（先詢問）
python -m venv .venv- PyTorch — 從 pytorch.org 取得適用於此作業系統的指令；若擁有 NVIDIA GPU 請選擇 CUDA 版本（約 2.5 GB），否則選擇 CPU 版本。
.venv/Scripts/python -m pip install -r requirements.txt（macOS/Linux：.venv/bin/python）。npm install（HyperFrames 渲染器、GSAP、Lucide 圖示）。npx hyperframes doctor— 修正 doctor 標記的問題。- 告知使用者：Whisper 的
large-v3模型（約 3 GB）會在第一次執行轉錄時下載。
3. 字型
讀取設定檔中的 fonts。對於 font/ 中缺少的每個檔案，告知使用者免費預設字型的來源，並提供下載選項（先詢問）：
- 波斯語
Vazirmatn-Medium.ttf— github.com/rastikerdar/vazirmatn（releases），OFL - 拉丁字母
Poppins-SemiBold.ttf與顯示用Poppins-Black.ttf— fonts.google.com/specimen/Poppins，OFL
任何其他字型也可使用：將檔案放入 font/ 並在設定檔中修改路徑。
4. 個人化設定
如果 reel.config.json 不存在，將 reel.config.example.json 複製為 reel.config.json，然後在單一訊息中詢問（跳過已透過參數回答的項目）：
- 姓名與 Instagram 帳號（用於追蹤卡片）
- 影片的語言（
fa、en、ar、de……） - 品牌／產品名稱（選填）及其顏色 — 或提供標誌檔案以從中擷取顏色
- 吉祥物／角色圖片（選填）→ 放入
assets/mascot/；標誌 →assets/brand/logo.png - 他們的 B-roll 片段所在位置（預設為
assets/broll/）
將回答寫入 reel.config.json（保留範例檔案中的所有鍵值）。
5. 冒煙測試
.venv/Scripts/python -X utf8 -c "import sys; sys.path.insert(0,'tools'); import config, story_build, showcase_build; print('tools ok')"- 如果
raw/中已有影片：$PY tools/face_track.py <take>應輸出臉部位置。
6. 交接
以使用者的語言印出一段簡短的「使用說明」，每種指令各附一個範例：
/reel-story <take> <主題、評論關鍵字、姓名> 和 /reel-split <take> ……。