dengyie/OneVideo

用 Claude Code 生产带旁白视频（数据解说、纪录片、竖屏短视频）的流水线和 Skill。整个过程分阶段推进，每一步都有门控。
research → proposal → script → storyboard → assets → voice → compose → render → review → publish
事实+来源 方案 逐句脚本 分镜/图表 授权素材 TTS+响度 时间轴 Remotion 自动 QC 字幕/章节/简介
## 特性
引擎共享，项目只存数据：项目目录里只有 onevideo.json、plan/.json、public/、out/，所有项目共用 template/ 下的 Remotion 引擎。
阶段状态机：创作阶段要人工审批，审批时锁定产物哈希（按项目内相对路径计算，项目拷走不失效）。已审批的产物再被改动，该阶段变为 stale，需重新审批。改了 script 但没重跑 tts，timings 门控会直接报错，渲染被拦下。
机械门控：
数字门控：旁白里的每个数字都要对上 research 里有来源的 fact，claims 引用的 fact id 必须存在。
语速门控：按音节估算，范围 3.5–6.2 音节/秒。
字幕长度、场景时长、素材授权白名单。
逐句 TTS 计时：字幕和画面揭示跟着真实语音时间走。整片统一做 BS.1770 响度归一化（默认 −16 LUFS），带软限幅。
场景库：标题、数据卡、柱状图竞赛、折线、对比、时间线、引用、图片/视频 Ken Burns、章节卡、片尾等；风格和动效节奏可配置。
素材：NASA、Wikimedia Commons、Openverse 免 key 可用；Pexels（可选）；也可以通过 OpenAI 兼容接口生图。授权信息自动进入简介。
程序化配乐和音效：零依赖合成，没有版权问题。
渲染后 QC：检查编码、分辨率、帧率、时长、响度、真峰值、旁白中的静音、黑帧、冻结画面、静态占比，并按场景抽帧供人工审阅。
发布包：SRT/VTT 字幕、章节时间戳、带全部来源与素材署名的简介。
## 安装
需要 Node ≥ 20。
bash
git clone https://github.com/dengyie/OneVideo.git && cd OneVideo
npm run setup # 安装 template/ 的 Remotion（自带 ffmpeg）
npm link # 可选：全局提供 onevideo 命令
onevideo doctor
Linux 服务器（Debian/Ubuntu）另需 Chrome Headless Shell 的系统库和中文字体：
bash
apt-get install -y --no-install-recommends libnss3 libdbus-1-3 libatk1.0-0 libatk-bridge2.0-0 libcups2 \
libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libasound2 libpango-1.0-0 libcairo2 fonts-noto-cjk
小内存机器（2 GB）渲染时用 onevideo render --concurrency 1，或在 onevideo.json 里设 render.concurrency。
TTS 和生图使用 OpenAI 兼容接口，key 从环境变量 MANGOAPIKEY 读取（接口地址和 env 名可在 onevideo.json 里改），永远不会打印出来。
## 快速开始
bash
onevideo init my-video --example spacex-ipo # 从完整示例起步
cd my-video
onevideo status # 各阶段状态 + 下一步该读的导演文档
onevideo validate # schema + 门控
onevideo tts --sample # 先试听一句
onevideo build # tts → music → timeline → render → qc
onevideo approve review # 逐张看完 out/qc/frames/ 之后
onevideo publish # 需要 review 已审批
成片位于 out/ .mp4，审阅帧在 out/qc/frames/，发布包在 out/publish/。
从零开始的项目用 onevideo init my-video --pipeline data-explainer --style midnight-data，再按 onevideo status 的提示逐个阶段推进。
## 作为 Claude Code Skill 使用
bash
ln -s "$PWD" ~/.claude/skills/onevideo
之后对 Claude 说“帮我做一条关于 X 的视频”即可。SKILL.md 约定了工作方式：每个阶段先读 stages/ .md，交给用户审批，渲染后逐帧看图。