Arta Edit Studio — setup
为 /reel-story 和 /reel-split 准备好新的克隆环境,然后个性化配置。
在运行每一步之前,用一句普通的中文解释清楚——许多用户并非开发者。在下载或安装任何内容(包、字体、模型权重)之前先询问用户,并说明大概的大小。
参数:$ARGUMENTS
1. 检查机器 —— 以 ✅ / ❌ 表格形式报告
| 需要 | 检查 | 缺失时的修复方法 |
|---|---|---|
| Python ≥ 3.10 | python --version | python.org |
| Node ≥ 18 | node --version | nodejs.org (LTS) |
| ffmpeg 含 zscale | 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—— 修复它标记的问题。- 告知用户:Whisper
large-v3模型(约 3 GB)将在首次转写时下载。
3. 字体
读取配置中的 fonts。对于 font/ 目录中缺失的每个文件,告知用户免费默认字体的来源,并提供下载选项(先询问):
- 波斯语
Vazirmatn-Medium.ttf—— github.com/rastikerdar/vazirmatn (发布版),OFL 许可 - 拉丁语
Poppins-SemiBold.ttf和显示用Poppins-Black.ttf—— fonts.google.com/specimen/Poppins,OFL 许可
其他任何字体同样适用:将文件放入 font/ 并修改配置文件中的路径。
4. 个人化配置
如果 reel.config.json 不存在,则复制 reel.config.example.json 为它,然后在一个消息中询问(跳过参数已回答的内容):
- 名称和 Instagram 账号(用于关注卡片)
- 视频的 spoken 语言(
fa、en、ar、de等) - 品牌/产品名称(可选)及其颜色 —— 或者用于提取颜色的 Logo 文件
- 吉祥物/角色图片(可选)→ 放入
assets/mascot/;Logo → 放入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. 收尾
用用户的 language 打印简短的“使用方法”,每个命令一个示例:
/reel-story <take> <主题、评论关键词、名称> 和 /reel-split <take> …。