用途：oma-video 用于制作短/竖屏视频、README 或代码解说、演示走查类视频。三种模式及默认画幅：shorts（9:16，需主题或简报）、explainer（16:9，需主题或源路径）、demo（16:9，需通过 --capture 提供人工录屏）。不适合的情况：静态图用 oma-image，幻灯片用 oma-slide，纯音频用 oma-voice，交互式 HTML 解说用 oma-explanation；剪辑已有成片和直播不在范围内。
主要能力：输入为简报加可选 mode、aspect、locale、captions、visual、voice、music、duration、compositor、capture 路径与 seed。产物位于 .agents/results/videos/<timestamp>-<shortid>-<mode>/，其中 script.json、timing.json、render-spec.json 构成确定性素材总线，manifest.json 记录字幕与获取的音视频素材及其哈希、提供商、费用、警告和退出码。成功渲染需包含 <mode>-<slug>.mp4、可编码视频流及正时长 ffprobe。
用法：如 oma video generate "Jeju coffee" --mode shorts --aspect 9:16 --captions tiktok --script ./script.json --output json；仅规划可用 --dry-run。演示需人工录屏：oma video generate "feature walkthrough" --mode demo --capture <absolute-path>.mp4。合成与渲染：oma video compose <runDir> --output json、oma video render <runDir> --output json。诊断：oma video doctor、oma video provider list。generate --output json 返回 {exitCode, runDir, manifestPath, scriptPath, renderSpecPath, warnings, error}，视频与素材路径从 manifest 读取。
限制：OMA_VIDEO_MOCK=1 仅为测试工具，其 .mp4 占位文件不是交付物。付费提供商需环境键与费用护栏；在付费操作或重跑前比较规划估算与 cost.guardrail_usd 或 --max-usd。仅对已授权付费操作使用 --yes 或 OMA_VIDEO_YES=1。遵守 limits.max_duration_sec（180）与 limits.max_scenes（40）。输出与捕获路径须在 $PWD 内，除非明确允许外部输出。--dry-run 只写规划产物，不证明存在 MP4。缺失 HyperFrames 合成或 MPT 工具链会以诊断失败，不写占位 MP4。