用途:把磁盘上的真实素材(拍摄、旅行、录屏)剪成成片、集锦或高光。分析在本地完成,只有入选镜头会上传,交付物同时包含可编辑的 Moda 时间线和渲染出的 mp4。生成新素材属于 moda-video-clip,设计元素上的动效属于 moda-video-motion,本流程只剪已有素材。
主要能力:用 Rushes 工具包在本地索引、分析和搜索素材;按目标时长生成候选池并挑选镜头;按精确时间裁剪并导出入选片段;上传入选素材后导入 OTIO 时间线,导出 mp4 草稿并迭代。索引、上传、导入、导出和迭代均不计费。
使用方式:先加载 moda-core;运行 moda rushes doctor --json 检查工具包,缺失时用 moda rushes install 安装(会先说明下载内容,体积达数 GiB)。随后依次执行 moda rushes ingest FOOTAGE --project INDEX、moda rushes analyze INDEX、moda rushes status INDEX --json。用 moda rushes search INDEX "…" --top-k 8 --json 和 moda rushes show INDEX mom_… --json 检验搜索质量,再用 moda rushes highlight INDEX --target-minutes N 生成候选,用 moda rushes select INDEX mom_… --name … --reason … --json 按播放顺序选定。用 moda rushes extract INDEX sel_… --handles 2s --out SELECTS --json 提取,逐个 moda file upload 上传并回填真实 asset id。创建画布后先 dry-run:moda edit import CANVAS_REF cut-v001.otio --media-map media-map.json --dry-run,确认后加 --yes 应用;用 moda export CANVAS_REF --format mp4 --scope main_edit -o draft.mp4 出草稿。新版本用新文件 v002、v003,不覆盖唯一成片。
适用场景:高光集锦、粗剪、从不断增长的素材文件夹做周期性剪辑(可配合 moda-automate),成片的社交版本用 moda-social,封面静帧用 moda-image。
限制:Rushes 不上传、不调用云端推理、无需 Moda 账号;Moda 云端负责渲染导出,不读取本地磁盘。只上传入选素材,禁止整目录批量上传。未知特效、未配对叠化和资源上限会在 validation.diagnostics 中按名称拒绝,需如实转达,不得声称不支持的编辑无损导出。纯音频时间线无法导出 mp4,需保留至少一个视觉片段。完整推理仅支持 Linux x86_64 和 Apple Silicon,其他平台使用仅媒体配置或手动降级路径并说明所用方式。无法安装 Rushes 时可手动挑选镜头并跳过索引,但须说明选择为手动。遇到 rushes_not_installed 或 rushes_update_required 时运行 moda rushes install 后重跑同一命令;otio_import_rejected 需按保真度报告逐项修复,不得编造 asset id;编辑时 stale_revision 重新读取并重试一次即可恢复。首次运行 rushes 命令前务必阅读 references/footage.md,编写或导入时间线前阅读 references/otio.md。