# auto-video-editing 安装指引（v1.11.0）

把这个 skill 装到你 Mac 上、跑通第一条口播视频出片，全程约 15-20 分钟（含解压 + 装依赖 + 第一次渲染体验）。

## 系统要求

| 项 | 最低要求 | 备注 |
|---|---|---|
| 系统 | macOS 13+ | Linux/Windows 暂未支持 |
| Python | 3.10+ | install.sh 会装 python@3.13 如果没有 |
| Homebrew | 已装 | install 之前自己装好：`/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` |
| 磁盘 | ≥ 5 GB | faster-whisper 模型 + 字体 + 工作空间 |
| 内存 | ≥ 8 GB | 渲染竖屏 1080×1920 视频用 |
| GPU | M-series Mac 推荐 | Intel Mac 也能跑，慢一些 |

## 5 步装好

### Step 1 — 解压

```bash
cd ~/Downloads
tar xzf auto-video-editing-v1.11.0.tar.gz
mv auto-video-editing-v1.11.0 ~/.local/skills/auto-video-editing
```

(目录路径随你选，不一定 `~/.local/skills/`。下面 install.sh 会自动建 `~/.codex/skills/` 的软链。)

### Step 2 — 跑 dry-run 看缺啥

```bash
~/.local/skills/auto-video-editing/scripts/install.sh
```

显示 8 阶段检查（macOS / brew / ffmpeg / Python deps / 字体 / 工作区目录 / Codex skill 软链 / doctor 验证）。所有项目要么 `✓` 要么 `!`（提示缺啥）。如果有 `!` 是 deps 缺，下一步会自动装；如果是字体缺，自己后面装。

### Step 3 — 真装

```bash
~/.local/skills/auto-video-editing/scripts/install.sh --confirm
```

会装：`ffmpeg` / `yt-dlp` / `python@3.13`（如缺） + pip 装 `faster-whisper` / `Pillow` / `opencv-python` + 建工作区目录 + 软链 skill 到 `~/.codex/skills/auto-video-editing`。

最后会自动跑 `skill_doctor.sh` 验证。希望看到 `33 passed / N warnings / 0 failures`。

### Step 4 — 装字体（手动）

把这 5 个字体放到 `~/Library/Fonts/`（双击 .ttf/.otf 文件 → 安装）：

- `HarmonyOS_SansSC_Black.ttf` / `HarmonyOS_SansSC_Bold.ttf`（华为官方免费）
- `优设标题黑_猫啃网.ttf`（猫啃网免费商用）
- `HelloFont ID YouQiTi.ttf`（HelloFont 个人免费）
- `SourceHanSansSC-Heavy.otf`（思源黑体 Adobe 开源）

字魂精灵体商用需付费授权 — 个人非商用免费可用。

字体不齐渲染会用系统 fallback，效果差。

### Step 5 — 配 license + 业务包

你买这个 skill 时收到的 `license.json` 文件：

```bash
mkdir -p ~/.auto-video-editing
cp ~/Downloads/your-license.json ~/.auto-video-editing/license.json
```

没买正式版？没事，**首次启动后有 14 天免费试用期**，让你完整体验后再决定是否付款。

如果你买了医美直播业务包（额外 SKU），把医美包目录放在：

```
~/.codex/skills/auto-video-editing/business_packs/medical-beauty-livestream/
```

激活：

```bash
echo 'export AUTO_EDIT_PACK=$HOME/.codex/skills/auto-video-editing/business_packs/medical-beauty-livestream' >> ~/.zshrc
source ~/.zshrc
```

没买业务包？用包内自带的 `business_packs/empty/`，自己填行业术语 + 风格规则。看 `business_packs/empty/README.md`。

## 验证装好

```bash
~/.codex/skills/auto-video-editing/scripts/skill_doctor.sh
```

期望末尾看到：
```
Summary: 33-34 passed, 1-5 warnings, 0 failures
Status: HEALTHY 或 USABLE WITH WARNINGS
```

`0 failures` 是关键。warnings 多数是数据等积累、不影响功能。

## 跑第一条视频

把一个口播视频（.MOV 或 .mp4）拖到 `~/Desktop/auto-edit-inbox/`，然后：

```bash
~/.codex/skills/auto-video-editing/scripts/watch_inbox.sh once
```

它会自动：
1. sha256 算 STEM
2. 在桌面建 batch 目录（你后面想好主题再 mv 改目录名）
3. cp `templates/renderer_basic.py` 到 batch 里
4. 填好 STEM / SOURCE / OUT_ROOT 等常量

剩下你要做：
1. 编辑那个 `render_<STEM>.py`，填 `COVER_TITLE` / `METADATA` 等
2. 生成 captions（看包内 `GETTING_STARTED.md` "第 1 件事"段）
3. `~/.codex/skills/auto-video-editing/scripts/lint_renderer.py render_*.py` 跑过
4. `python3 render_*.py` 出片

70 秒视频出片约 110-180 秒（M-series Mac）。

## 出问题去看

| 问题 | 看哪 |
|---|---|
| 不知道这 skill 是什么 | `SKILL.md` |
| 不知道从哪开始 | `GETTING_STARTED.md` |
| 渲染脚本怎么写 | `templates/README.md` + `templates/renderer_*.py` 三个模板 |
| 业务规则怎么改 | `business_packs/empty/README.md` |
| 字幕 / 封面 / 字体 / 视频版式 | `references/` 下 12 份文档 |
| 安装 / 环境出问题 | `scripts/skill_doctor.sh` 跑一遍看哪个 ✗ |
| 渲染卡了好像没动 | `scripts/cancel_render.sh <batch-dir>` 看真在跑还是死了 |
| 之前剪过什么版本 | `scripts/list_versions.sh <batch-dir>` |
| 想看自动复盘建议 | `scripts/skill_reflect.py` |

## 反馈渠道

试用过程中遇到任何卡点 / bug / 体验问题，反馈给 owner（你买 skill 时的卖家）。

我们会用这些反馈在 1-2 个月内迭代到 v1.12 / v2.0。早期反馈用户会被列入"种子用户感谢名单"。

—
auto-video-editing v1.11.0  ·  2026-05-11