与 AI 助手的协同
视频剪辑是"人机协同"节点：AI 能帮你做规范 · 校验 · 存取这些机械活，⛔ 但不替你剪、也不该替。
本文讲清：谁是"人机协同" · 沙箱里为什么被拦（含报错原话） · 在你自己画布上 AI 逐项能做什么 · 两道授权关。
本专题手工维护（2026-10-12 建）；⚠ 工具名与报错文案以应用当前版本与 tools/list 现查为准（本页快照 2026-10-12）。
一、先分清两类"地点"（这是全部判据的根）
| 地点 | 是什么 | 剪辑能不能在这做 |
|---|---|---|
| 你自己的画布 | 你打开着、看得见的那张（含"当前画布"） | ✅ 能（要人盯着对时间线，正是因为你能看见） |
| AI 沙箱画布 | 应用给 AI 自动建的隐藏画布（不占你的画布列表） | ⛔ 不能（见 §三） |
⭐ 判据只有一条：目标画布是不是"沙箱 / agent 画布" —— 是 ⇒ 直接拒绝；不是 ⇒ 放行 ✓
⚠ 两个"看起来有关、其实无关"的东西：
- 与画布类型（普通 / 创作者 / 项目…）无关；
- 与右上角「AI 编辑授权」开关无关（那是另一道门，见 §五）✓
二、谁是"人机协同"节点
| 判定 | 内容 |
|---|---|
| 按角色 | poster-design（海报设计）· video-edit（视频剪辑） |
| 按模板 | local.poster · local.video.edit |
⇒ 为什么把它们划出来：得人在面板上动手（一个排图层、一个对时间线）——
AI 代劳等于替你决定"哪段留、怎么剪"，所以设计上把这条路关掉 ✓（见《能力与边界》§四）
⚠ 硬门是同一道：海报与剪辑走的是同一份判据、同一处抛错 ⇒ 另一格见《海报设计 · 与 AI 助手的协同》✓（本文不复述它的细节）
三、★ 沙箱里会被拦住的动作（含报错原话）
被拦的是五个"施工"动作：建 · 改 · 跑 · 存 · 载 ✓
| 动作 | 对应工具（剪辑侧） |
|---|---|
| 建剪辑节点 | 建媒体节点（templateId: local.video.edit） |
| 改时间线数据 | 写媒体节点补丁（params.edit） |
| 跑它 | 运行节点（⚠ "跑"也算施工 ✓） |
| 存工程档 | uc_do_save_timeline |
| 载工程档 | uc_do_load_timeline |
被拦时的报错原话（照抄；⚠ 原文里的"出路③"是以海报举例，剪辑对应的文件是 *.timeline.json）：
【人机协同节点·禁止在沙箱施工】「…」是**人机协同**节点 —— 海报设计要人**在面板上排图层** ✓、
视频剪辑要人**对时间线** ✓ ⇒ **必须在用户看得见、点得到的画布上施工**，⛔ 不能放在沙箱画布 ✗。
本次目标：画布「…」（hidden=… / owner=… ✓）。
出路：① 让用户在他自己的画布上加这张节点 —— 你在**当前画布**上施工**已免授权** ✓；
② 需要底图/素材时，仍可用 uc_do_gen_once 在沙箱里出图出片，再请用户放进这张节点 ✓；
③ 想给用户一份海报设计文件（.poster.json）也请建在**与用户共用**的画布上 ✓。
⚠ 哪些动作不被拦：只读的两件 —— 取规范 / 校验（不写画布、纯本地计算）
⇒ 也就是说：沙箱里也能"看一眼这条时间线有没有问题"，但改不了它 ✓
四、在你自己的画布上，AI 逐项能做什么
| # | 动作 | 能不能 | 走哪个工具 |
|---|---|---|---|
| 1 | 取时间线规范（文件结构 / edit 字段契约 / 合法取值 / 推荐流程） | ✅ 能 | uc_do_gain_timeline_spec |
| 2 | 校验 ＋ 时间轴预演（结构 / 素材是否可达 / 每段段位与成片总长 / 将被丢弃清单） | ✅ 能 | uc_do_validate_timeline |
| 3 | 建剪辑节点 | ✅ 能（硬门放行；但要走写门，见 §五） | 建媒体节点（local.video.edit） |
| 4 | 改时间线数据（片段 / 叠加 / 音频 / 字幕 / 成片设置） | ✅ 能（同上） | 写媒体节点补丁 |
| 5 | 跑它（合成出 MP4） | ✅ 能（同上） | 运行节点 |
| 6 | 存 / 载工程档（*.timeline.json） | ✅ 能（同上） | uc_do_save_timeline / uc_do_load_timeline |
⇒ 一句话：硬门管"地点"（沙箱不行），授权管"写字"（写用户画布要先过门，§五） ✓
⚠ 剪辑侧没有"预检"工具（⚠ 海报有 uc_do_preflight_poster，剪辑没有对应的那个）⇒
"提前发现越界 / 会被丢弃"这件事，就靠 uc_do_validate_timeline 的预演与丢弃清单（见《技能协同…》§五）✓
三条剪辑独有的"协同侧"提醒：
| 事 | 说明 |
|---|---|
params.edit 为空 | 还没排过任何东西 ⇒ AI 存 / 校验会提示先写好时间线 ✓ |
| 写保护 | AI 存盘时若发现文件在上次保存后被别处改过 ⇒ 拒绝覆盖并提示（要它覆盖得显式 force）✓ |
| 渲染端自动保存 | ⚠ 在面板里"绑定"了工程档之后，你的改动会自动写回磁盘（双向同步）—— 这正是写保护里说的"其它端"⇒ 人机同时改一份文件时最容易撞上它（见《时间线工程档复用》）✓ |
五、AI 想动手时的两道关（与硬门是三回事）
| 关 | 规则 |
|---|---|
| 第一道 · 规则门禁 | 无论哪种画布，写之前必须先读该画布的操作规则（每张画布都有一份；⚠ 它按画布计、每次服务重启都会清空）✓ |
| 第二道 · 授权 | · 在当前画布上施工 ⇒ 不需要额外授权 ✓<br>· 写别的用户画布 / 外部客户端（没人在旁边看着）⇒ 需要你开启「AI 编辑授权」✓ |
两道关的报错原话（照抄要点）：
画布「…」写操作被拒：**该画布规则还没读**（第 ① 道门）。⚠ 这不是授权问题 ✗ …
画布「…」写操作被拒：**这是用户画布、且未开启「AI 编辑授权」**（第 ② 道门）。…📌 助手免授权只对「当前画布」…
⚠ 一条辟谣：右上角那个「AI 编辑授权」开关不是"助手能不能写当前画布"的开关 —— 它管的是别的通道（别的用户画布 / 外部客户端）✓
另一件会撞上的事（不是硬门）：创作者画布是"媒体节点 ＋ 素材直填"范式 ⇒ 连线 / 模板节点类工具在这类画布会被直接拒绝（会给出中文指引：改用媒体节点）✓
六、一条最实用的协同路径（谁干什么）
① 你：说清要剪成什么（用途 / 成片规格 / 素材在哪 / 大概顺序 / 要不要字幕与配乐）
② AI：gain_timeline_spec 取规范 ⇒ 建/改剪辑节点，或给你/存一份 *.timeline.json
③ AI：validate_timeline（结构 / 素材可达 / **段位与总长预演** / **将被丢弃清单**）⇒ 先把问题挑出来
④ 你（或你与 AI 一起）：在面板上排片、对时间线、定字幕与配乐、定稿 ← ⚠ 只是"**要在这张画布上做**"（沙箱里不行）✓
⑤ AI：save_timeline 存档；你：先「快速预览合成」，再「导出成片」⇒ 落资产库
| 分工 | 谁 |
|---|---|
| 轨道顺序 / 取舍 / 节奏 / 定稿 | 人 ✓ |
| 规范 / 校验 / 预演 / 存取 | AI（含外部 MCP 客户端）✓ |
| 合成 | 本机（ffmpeg，零算力）✓ |
七、⚠ 三件别误会
| 别以为 | 实际 |
|---|---|
| ❌ "AI 能帮我把片子剪好" | 它能建/改数据、挑错、存取，但剪辑与定稿要你（沙箱里连建都直接被拒）✓ |
| ❌ "沙箱里偷偷做一条也行" | 建 / 改 / 跑 / 存 / 载全部报错（原文见 §三）⇒ 这是设计，不是故障 ✓ |
| ❌ "开了「AI 编辑授权」就能在沙箱做" | 那个开关与硬门无关 ⇒ 沙箱照样拒绝 ✓（它管的是写别的用户画布）✓ |
来源：E:/workbuddyProj/unlimitCanvas/ai_manual/video_edit/07-与 AI 助手的协同.md