短视频转场衔接与音画过渡
把两段真实视频衔接为一个可播放成片。按叙事关系、运动方向和声音完整性选择转场，不在每个切点机械加特效。
获取必要输入
两段本地视频、目标画布/帧率、需要衔接的动作或语句、希望的过渡方式和声音处理。素材只取第一条视频与第一条音轨；需要选择其他轨道时先明确重封装。
利用用户已给信息完成方案；只询问会改变效果的关键缺项。没有看到素材时标明方案是待预览的建议，不声称做过画面识别、同步或视觉验收。对已有成片先另存输出，不改写源文件。
按内容作效果决策
- 同一过程或柔和时间流逝可先试 fade；明确章节分隔可试 fadeblack。
- 有清楚画面方向或操作推进时可试 wipeleft/wiperight、slideleft/slideright；不要为了转场颠倒动作因果。
- circleopen/circleclose 适合开场、收束或细节揭示；不掩盖关键文字、表情或产品状态。
- smoothleft/smoothright 提供较柔和的方向变化。使用用户已有风格时优先沿用。
- 先试听衔接两侧，选不切断关键词和尾音的位置。两个对白同时存在时，交叉淡化可能制造重叠，应改切点或选 audio=none 后在编辑器重排。
- 过渡时长是创作选择；样例 0.4 秒是演示参数。必须小于任一输入片段，且至少占一个输出帧。
从 场景配方 中选择适合的起点，调整参数而非机械套用。给出一句说明：效果要让观众理解什么、作用于什么位置、为何此强度合适。
执行
需要 Python 3.10+ 和提供 libx264/所用滤镜的本地 FFmpeg、FFprobe。无需登录、网络或付费 API；FFmpeg 是用户的本地运行依赖，不捆绑在此包。
- 将 examples/project.json 复制到素材附近，用真实输入路径和参数替换样例。
- 运行 dry-run 检查参数、源素材属性、输出尺寸、时长与声音选择。
- 先渲染低分辨率预览，确认效果，再导出正式尺寸。
- 回看实际导出文件，并保留同名 .render.json 记录。
命令及参数详见 运行说明。程序使用参数数组调用本地工具，不执行 shell 拼接。默认拒绝覆盖输出文件；允许覆盖时也不允许输出指向任一源素材。
技术边界
- 两路视频先等比缩放并补边，再统一 SAR、帧率、像素格式、时间基准和起始时间戳。
- xfade 的 offset=第一段时长-重叠时长；成片预计时长=两段时长之和-重叠时长。
- crossfade 模式以 48 kHz 立体声处理两路音频；缺音轨一侧补静音。两路都无音轨时保持无音轨。
- 不执行画面生成、运动补帧、自动匹配切点或自动对白对齐；方向选择由智能体/用户根据画面作出。
- 只支持已明确为 SDR 的普通视频流程；检测到 PQ/HLG 输入会停止，提示先采用明确的 HDR/色彩转换方案。
验收并交付
检查转场前、中、后三处以及整段回放：没有意外黑帧/冻结、图像比例不被拉伸、主体与字幕可辨、时间没有多扣或重复、声音没有断词或意外叠话。fadeblack 中间的黑场是所选效果，不能将它当成其他转场的正常黑帧。
按需交付效果说明、配置 JSON、预览/正式视频、输出参数和实际回看结论。自动检查尺寸/时长并不证明画面美观或内容真实。若没有执行或回看，准确写出未完成部分。
不要因为目录里有素材就假定可公开、可商用；沿用用户已明确的授权范围。涉及频闪、强抖动或视觉不适时降低强度并提供简单替代效果。
官方技术和来源分析见 来源与组件。
