MiniMax H3 分段连续性计划编译

适用场景

在 MiniMax H3 生成超过单段时长的视频前，把总时长、镜头时间线、音频模式和连续性约束编译成可执行的分段计划。它只处理脱敏 JSON，不调用模型、不上传媒体，也不替用户提交付费任务。

前置条件

• - Python 3.9 或更高版本
• 一份脱敏的项目配置 JSON
• 已知的总时长、分段时长、镜头时间和音频模式

输入与输出

输入必须包含 project_id、total_duration、segment_duration、audio_mode 和 shots。source_track 模式还需要 master_audio_sha256。输出目录会生成 segment_plan.json 与 segment_plan.md，其中包含连续的分段窗口、镜头映射、交接标记和错误信息。

安装或导入

保持技能目录结构不变，直接运行 scripts/compile_segment_plan.py。不需要安装第三方包。

执行步骤

CODEBLOCK0

分段长度默认限制在 1 到 15 秒之间；需要其他限制时在输入中提供 max_segment_seconds。每一段都由时间线计算得到，最后一段自动收短到总时长。

错误恢复

脚本以非零退出码停止，并在标准输出给出字段级错误。补齐缺失字段、修复镜头间隙、检查总时长和音频模式后重新运行。不要在失败报告上继续提交模型任务。

权限、隐私与不可逆边界

只读取用户主动提供的配置和脱敏哈希；不读取密钥、Cookie、原始素材或账号信息，不上传文件，不生成模型任务，不扣费。输出仅是计划与检查报告，用户仍需人工确认模型参数和实际渲染。

验收方法

使用示例输入运行脚本，确认退出码为 0，segment_plan.json 中的分段首尾相接、镜头覆盖完整、handoff_required 在第 2 段起为真。将示例中的 segment_duration 改为 16 后，确认脚本以退出码 1 拒绝。