Seedance 局部编辑时间轴

适用场景

把已生成视频中的局部修改需求整理为 Seedance 2.5 可交接的时间轴计划，例如只改背景、服装颜色或一个物体，同时保留主体、镜头和其他区域。脚本只编译脱敏时间段，不上传原视频、不调用模型。

前置条件

• - Python 3.9 或更高版本
• 一份不含原始媒体路径、个人信息和密钥的 JSON 时间轴
• 用户已确认原视频及修改内容的权利，且知道目标平台是否开放局部编辑入口

输入与输出

输入包含 video_ref、duration_sec、segments 和 rights_reviewed。每个 segment 需要 start_sec、end_sec、target、change 和 preserve。输出目录生成 edit_timeline.json 与 edit_timeline.md，并给出相邻片段重叠、越界和空保留清单的错误。

安装或导入

保持目录结构，直接运行 scripts/compile_edit_timeline.py。不需要第三方包。

执行步骤

CODEBLOCK0

脚本按时间升序检查局部编辑范围，拒绝重叠片段、越过视频总时长的片段和未声明保留内容的修改。它不会把秒级计划冒充帧级编辑，也不会判断生成质量。

错误恢复

把相邻时间段拆开或合并，补齐每个片段的目标变化和保留项后重跑。平台实际界面若要求不同的时间格式，由人工将报告转换后再提交。

权限、隐私与不可逆边界

只读取脱敏 JSON，不读取原视频，不上传、不提交编辑任务、不扣费。局部编辑可能覆盖原输出，实际使用前应保留原片并由用户人工确认可回滚版本。

验收方法

运行示例输入，确认状态为 ready_for_review。将两个片段设为重叠或把 rights_reviewed 改为 false，确认脚本以非零退出码阻断。