时间线工程档复用

⚠ 先摆清一件事：剪辑没有"预置骨架"（海报那三套行业模板，它一套都没有）⇒

剪辑要"复用"，靠的是你自己的工程档：把一条满意的片子存成 *.timeline.json，下一条载入换素材。

本文讲清：工程档长什么样 · 住哪 · 怎么存/载 · "绑定"意味着什么 · 三条复用路线。

本专题手工维护（2026-10-12 建）；⚠ 按钮文案与路径以应用当前版本为准（本页快照 2026-10-12）。

一、⚠ 先摆清：剪辑没有"套模板"这回事

⇒ 一句话：剪辑的"模板"是你自己攒的；攒得越多，开工越快 ✓

二、工程档长什么样 · 住在哪

⚠ 关键理解：这一个目录同时管"存"和"载"（字段名就叫"保存 / 载入共用"）⇒ 团队协作时把它指到共享目录最顺 ✓

三、怎么存 · 怎么载（面板上就两个按钮）

提示原话（照抄，几秒后自动消失）：

保存成功：已保存时间线文件：<路径>
保存失败：时间线保存失败：<原因>
载入成功：已载入时间线：<路径>
载入失败：时间线载入失败：<原因>
解绑成功：已解除时间线文件绑定（此后仅保存在画布内）

⚠ 载入没有"覆盖确认"弹窗 —— 覆盖这件事写在按钮说明里（"覆盖当前编辑"）⇒

先「保存时间线…」另存一份，再点载入，是最稳的习惯 ✓

四、★ "绑定"意味着什么：双向同步

载入（或首次保存）之后，面板就与这个文件"绑定"了：
   你在面板上改 ⇒ 改动自动写回磁盘（title / updatedAt 会更新，文件路径不变）
   你改磁盘上的文件 ⇒ 下次载入即生效

⚠ 三条要记住的：

• 绑定 = 自动写：此后每次改动都会写盘（所以别把工程档放在会被同步盘反复回滚的位置）✓
• 解绑 = 只留在画布内：不想让它再动文件，就点解绑 ✓
• ⚠ 人机同时改一份文件会撞上"写保护"：AI 用 save_timeline 存盘时，若发现文件在上次保存后被别处改过（最常见就是渲染端的自动保存）⇒ 它会拒绝覆盖并提示，要覆盖得显式给它 force ✓

⇒ 协作建议：要么你在面板上改（自动写盘），要么让 AI 改（它写、你这边先别动），别同时 ✓

五、三条复用路线（从最快到最自由）

路线 ③ 的走法（照抄工具名）：

uc_do_gain_timeline_spec   ⇒ 拿到完整字段契约与合法取值（先读它，再写文件）
uc_do_save_timeline        ⇒ 节点 → *.timeline.json（落盘留档）
uc_do_load_timeline        ⇒ 文件 → 节点（回灌后你在面板上精修）
uc_do_validate_timeline    ⇒ 只读校验 ＋ 时间轴预演 ＋ "将被丢弃"清单

六、做"系列片"：一条工程，多个版本

载入工程 → 换素材 / 换字幕 → （需要时）改成片规格 → 另存为一个新 *.timeline.json
        → 各版本分别导出成片

• 同一系列要出多条 ⇒ 都从同一份工程派生（片头 / 字幕样式 / 音乐位不漂）✓
• 换题材 ⇒ 另起一份新工程（或换掉整条轨道），比在旧稿上改快 ✓

七、载入时会发生一件"看不见的整理"（归一化）

载入不是原样搬进来，应用会做一次静默归整，并给你一份改写清单：

⇒ 所以：换机器 / 换素材后先载入一次，看它剔掉了什么，再决定要不要补素材 ✓

八、常见五问