# 视频包装设计器 · 使用说明

## 一句话说明
> 在浏览器里可视化设计视频叠加元素（片头/字幕/姓名条等）→ 下载配置 → 本地批量渲染出成品视频

---

## 工作流程

```
浏览器（设计）          本地电脑（渲染）
┌─────────────────┐     ┌──────────────────────────┐
│ 打开设计器        │     │ 安装 Python 环境          │
│  ↓               │     │ 安装依赖                 │
│ 打开视频          │     │                         │
│  ↓               │     │                         │
│ 添加片头/字幕/姓名 │     │                         │
│ 拖拽调整位置       │     │                         │
│  ↓               │     │                         │
│ 下载配置包         │ ──→ │ 接收配置包 + 视频文件     │
│                  │     │  ↓                       │
│                  │     │ 运行渲染脚本              │
│                  │     │  ↓                       │
│                  │     │ 批量生成成品视频 ✅       │
└─────────────────┘     └──────────────────────────┘
```

---

## 第一步：浏览器设计

**打开工具：**
https://www.jori.wang/video-designer/index.html

**操作步骤：**

1. 点击「📂 打开」→ 选择你的数字人视频（MP4/MOV/AVI/WebM）
2. 点击「快速添加」里的按钮，添加包装元素：
   - 🏷️ 姓名条 — 底部显示医生名字
   - 🎬 片头底 — 全屏色块背景
   - 📝 片头字 — 片头上叠加标题文字
   - 💬 字幕 — 底部字幕条
   - 🎞️ 片尾 — 结尾致谢页
   - 💧 水印 — 角落版权标识
3. 在画面上**拖拽**调整位置，拖角**调整大小**
4. 右侧面板修改：文字内容、颜色、字体、时段、动效
5. 满意后，进行下一步

---

## 第二步：下载配置

### 单个视频
1. 点击工具栏「⚡ 渲染」
2. 选择质量（流畅/高清/超清/原画）
3. 点击「开始渲染」→ 下载 `render_config.json`

### 批量视频（推荐）
1. 先设计好元素模板（姓名条位置/颜色/字体等）
2. 点击「🎞️ 批量」
3. 点击「➕ 添加视频」→ 把所有要处理的视频都加进来（可以多个）
4. 点击「📦 下载批量配置包」→ 下载 `batch_render_package.json`

---

## 第三步：本地渲染

### 准备工作：安装环境

**Windows / macOS / Linux 通用：**

```bash
# 1. 安装 Python（建议 3.9 以上）
# 下载地址：https://www.python.org/downloads/

# 2. 安装 ffmpeg（必需，渲染引擎依赖它）
# macOS:
brew install ffmpeg
# Windows: 下载 https://ffmpeg.org/download.html 或用 winget:
winget install ffmpeg
# Linux:
sudo apt install ffmpeg  # Ubuntu/Debian
sudo yum install ffmpeg  # CentOS

# 3. 安装 Python 依赖
pip install moviepy pillow
```

**验证安装成功：**
```bash
python3 -c "import moviepy; print('moviepy OK')"
ffmpeg -version  # 应该显示版本号
```

### 下载渲染脚本

👉 **从服务器下载这两个文件：**

- `render.py` — 单个视频渲染
- `batch_render.py` — 批量渲染

或者直接从这里复制：
- 地址：`https://www.jori.wang/video-designer/render.py`
- 地址：`https://www.jori.wang/video-designer/batch_render.py`

```bash
# 下载到本地
curl -o render.py https://www.jori.wang/video-designer/render.py
curl -o batch_render.py https://www.jori.wang/video-designer/batch_render.py
```

---

### 单个视频渲染

把 `render_config.json` 和你的视频放在同一个文件夹，然后：

```bash
python3 render.py \
  --config render_config.json \
  --input 你的视频.mp4 \
  --output 成品_final.mp4
```

**Windows 版本：**
```bat
python render.py --config render_config.json --input 你的视频.mp4 --output 成品_final.mp4
```

---

### 批量渲染

把 `batch_render_package.json` 和所有视频放在同一个文件夹，然后：

```bash
python3 batch_render.py \
  --config batch_render_package.json \
  --folder ./  \
  --output ./output/
```

这会自动处理文件夹里所有视频，输出到 `./output/` 目录。

**指定具体视频：**
```bash
python3 batch_render.py \
  --config batch_render_package.json \
  --videos 视频1.mp4 视频2.mp4 视频3.mp4 \
  --output ./output/
```

**指定质量（默认高清）：**
```bash
# low=流畅 / mid=高清 / high=超清 / ultra=原画
python3 batch_render.py --config pkg.json --folder ./ --quality high
```

---

## 文件夹结构示例

```
/Users/jori/Desktop/渲染任务/
├── render.py                 # 渲染脚本（已下载）
├── batch_render.py           # 批量脚本（已下载）
├── render_config.json        # 单个配置（从浏览器下载）
├── batch_render_package.json # 批量配置包（从浏览器下载）
├── 龙江医生_01.mp4           # 原始视频
├── 龙江医生_02.mp4
├── 龙江医生_03.mp4
└── output/                   # 渲染成品输出到这里
    ├── 龙江医生_01_final.mp4
    ├── 龙江医生_02_final.mp4
    └── 龙江医生_03_final.mp4
```

---

## 常见问题

**Q: 提示 `No module named 'moviepy'`**
A: 运行 `pip install moviepy pillow`

**Q: 提示 `ffmpeg not found`**
A: 需要安装 ffmpeg，见上面的安装步骤

**Q: 渲染出来的视频没有声音**
A: moviepy 默认会保留原音，确认原视频有声音即可

**Q: 字体显示不出来/乱码**
A: Windows 默认字体路径不同，把字体文件（.ttf）放到脚本同目录，或修改 render.py 里的 `get_font_path()` 函数

**Q: 视频太大渲染很慢**
A: 用 `--quality low` 降低码率，或减少 `threads` 参数

**Q: 可以给视频加水印吗**
A: 可以，用「快速添加」→「💧 水印」

**Q: 片头时长怎么控制**
A: 选中片头元素，在右侧「时段」里修改开始/结束秒数

---

## 环境要求总结

| 项目 | 要求 |
|------|------|
| Python | ≥ 3.8 |
| ffmpeg | 必须安装 |
| moviepy | pip install |
| Pillow | pip install |
| 内存 | 建议 8GB 以上 |
| 显卡 | 可选（有 CUDA 加速更快）|