Communitygithub.com

Jenesyx/reel-setup

当用户运行 /reel-setup、刚刚克隆 Arta Edit Studio 或由于缺少 Python 包、Node 包、ffmpeg、字体或 reel.config.json 导致 reel 命令失败时使用。

reel-setup 是什么?

此技能用于初始化 Arta Edit Studio 开发环境,确保所有依赖项正确安装且项目配置就绪。它通过逐步检查主机环境(Python、Node、ffmpeg 等),并在执行前以清晰的中文说明每一步操作,特别适合非开发人员。支持 Windows、macOS 和 Linux 平台,能够自动检测缺失的组件(如 Python 包、Node 模块、字体文件)并提示用户下载,同时估算下载大小。该工具还会引导用户完成个人化配置(如品牌颜色、角色图片等),并在最后进行冒烟测试以确保环境可用。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jenesyx/arta-edit-studio/tree/main/.claude/skills/reel-setup

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Arta Edit Studio — setup

为 /reel-story 和 /reel-split 准备好新的克隆环境,然后个性化配置。 在运行每一步之前,用一句普通的中文解释清楚——许多用户并非开发者。在下载或安装任何内容(包、字体、模型权重)之前先询问用户,并说明大概的大小。

参数:$ARGUMENTS

1. 检查机器 —— 以 ✅ / ❌ 表格形式报告

需要检查缺失时的修复方法
Python ≥ 3.10python --versionpython.org
Node ≥ 18node --versionnodejs.org (LTS)
ffmpeg 含 zscaleffmpeg -hide_banner -filters 输出包含 zscaleWindows:gyan.dev "full" 构建 · macOS:brew install ffmpeg
NVIDIA GPU (可选)nvidia-smi无 → Whisper 在 CPU 上运行,速度慢约 10 倍
渲染用 Chromenpx hyperframes doctor (步骤 2 后)doctor 会提示如何操作

2. 安装(先询问)

  1. python -m venv .venv
  2. PyTorch —— 根据操作系统从 pytorch.org 获取命令;如有 NVIDIA GPU,选择 CUDA 版本(约 2.5 GB),否则选择 CPU 版本。
  3. .venv/Scripts/python -m pip install -r requirements.txt (macOS/Linux:.venv/bin/python)。
  4. npm install (HyperFrames 渲染器、GSAP、Lucide 图标)。
  5. npx hyperframes doctor —— 修复它标记的问题。
  6. 告知用户: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> …。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能