video-editorlisted

# video-editor — 竖屏教程视频流水线 **代码和数据是分开的**： - **技能包**（这个目录）= 流水线本身。`scripts/` + `overlay-components/` + `references/` - **workspace** = 你的数据。任何同时含 `projects/` 和 `materials/` 的目录都算���**靠目录形状识别**， 没有标记文件、不用注册 所以脚本从哪调都行，数据根由**命令行参数**解析（`scripts/_workspace.py:find_workspace()`）。 ``` $WS/.venv/bin/python $SKILL/scripts/<x>.py projects/<name>/edit/cut-plan.yaml ``` `$SKILL` = 本目录，`$WS` = workspace 根（在 workspace 里执行时就是 `.`）。 没有 workspace？→ **[references/workspace.md](references/workspace.md)**（下载 starter 包、装环境、目录文法） --- ## 阶段地图 | 阶段 | 干什么 | 工具 | 产出 | |---:|---|---|---| | 0 | 建项目骨架 | `scripts/init_project.py <name>` | `projects/<name>/{raw,edit,assets,overlays,export,preview}/` | | 0.5 | 源片时基归一（**仅当**源是 VFR/怪帧率）| `scripts/normalize_cfr.py` | CFR 源 | | 1 | 词级转录 | `scripts/transcribe.py <project>` | `raw/*.yaml` | | 1.5 | 多机位分镜（**仅 ≥2 路源**）| 手写 | `edit/shot-analysis.yaml` | | 2 | **直接写 `cut-plan.yaml`** —— 选段、剪气口、排顺序 | 手写（或 `scripts/cutplan.py`）| `edit/cut-plan.yaml` | | 3 | 边界体检（**每次改完 segments 都要跑**）| `scripts/scope_check.py <plan> --apply` | 修正后的 OUT | | 4a | 粗剪 | `scripts/rough_cut.py` | `export/<name>-rough.mp4` + `.timeline.json` | | **R** | **送审**：递审稿链接 → 用户改剪辑 + 写 note → 取回 | `scripts/storyboard_status.py` | 改过的 plan + 待办清单 | | 4b | 按 note 补特效 | `scripts/overlays_v5.py` | `export/<name>-final.mp4` | | 5 | 字幕（**用户点头后才做**）| `scripts/generate_subtitles.py` | `export/<name>-subs.mp4` | **R ⇄ 4b 是个循环，不是一趟。** 每条片子都要绕，通常绕好几圈： ``` ┌───────────────── 用户还有意见 ─────────────