# Harness Engineering EP.01

**类型**：YouTube 教育视频  
**状态**：✅ 完成  
**系列**：Jixian 频道 — Harness Engineering  
**完成时间**：2026-04-13

## 最终产出

- **视频地址**：https://youtube.dev.suchka.me/harness-engineering/harness_v10_final.mp4
- **时长**：281s（4.7 分钟）
- **大小**：23.8MB
- **幻灯片数**：16 张，含音频

## 工程文件

| 文件 | 路径 |
|------|------|
| HTML 主文件 | `gpu-local:/proj/youtube/harness-engineering/index.html` |
| 音频（16 段）| `gpu-local:/proj/youtube/harness-engineering/audio/s01.wav ~ s16.wav` |
| 录制脚本 | `capture_v10_clean.py` |
| 最终输出 | `gpu-local:/proj/youtube/harness-engineering/output/final.mp4` |
| 本地预览 | `http://192.168.0.190:8102/harness-engineering/index.html` |

## 幻灯片时长

| Slide | 时长(s) | 累计开始(s) |
|-------|---------|------------|
| s01 | 15.54 | 0.0 |
| s02 | 20.64 | 16.04 |
| s03 | 25.54 | 37.18 |
| s04 | 25.52 | 63.22 |
| s05 | 21.30 | 89.24 |
| s06 | 25.20 | 111.04 |
| s07 | 19.16 | 136.74 |
| s08 | 20.00 | 156.40 |
| s09 | 26.94 | 176.90 |
| s10 | 26.54 | 204.34 |
| s11 | 24.24 | 231.38 |
| s12 | 28.12 | 256.12 |
| s13 | 20.78 | 284.74 |
| s14 | 24.44 | 306.02 |
| s15 | 22.32 | 330.96 |
| s16 | 18.78 | 353.78 |

**总时长**：约 373 秒（注：最终 MP4 为 281s，经过裁剪）

## 设计细节

- **色彩系统**：选项 A（橙色系），最终从紫色改为橙色
- **动画**：GSAP 入场动画（16 张各自定制）
- **背景**：bg-s01~s16.jpg 底层 + hex 纹理叠加，opacity=0.3
- **布局**：`.content` 左右 margin 各增加 5%，画面更紧凑居中

## 制作经验（关键）

### 录制方案（v10，已验证最佳）
- **方式**：System Chrome `--app` + `ffmpeg x11grab`（`capture_v10_clean.py`）
- **优点**：真实 30fps，无 browser UI，Playwright 只做控制
- **对比旧方案**：比 fake clock 截图方案更流畅

### S01 闪烁 Bug 修复
- 原因：第一张幻灯片动画触发前 content 可见
- 修复：`showSlide(0)` 前手动 pre-hide content

### ffmpeg 规则
- `filter_complex` 必须用 Python `subprocess.run(list)`
- 不能用 `shell=True`（zsh glob 展开会报错）

### 音频生成
- 基于 MiniMax 模型的语音克隆
- 24000Hz, mono 格式

## 相关

- [AI-视频生产管线](../topics/AI-视频生产管线.md)
- [gpu-local-基础设施](../topics/gpu-local-基础设施.md)