known-errors

已知错误

请以当前 MCP 工具架构和返回的结构化错误为准。如果当前清单与旧版负载不同，请勿使用记忆中的旧版负载重试。

修改被拒绝

• 如果同一轨道上的内容重叠，请勿强行写入或悄悄删除冲突项。判断内容是顺序排列还是分层呈现，酌情选择可用轨道，或询问应保留哪一项。
• 如果出现轨道锁定或 id 过时错误，请刷新受影响的时间线范围，并仅使用当前 id 和状态重试。
• 如果出现验证错误，仅更改被拒绝的字段或事务结构；保留项目其他无关状态。

导入和媒体

• 托管插件界面使用 asset-import 适配器和 import_media；如果不存在，请勿用仅限后端的 push_asset 或 download_media 调用替代。
• 如果媒体转换失败，请在提供时使用助手提供的结构化重试。否则，说明不受支持的来源并要求提供兼容的替代项；请勿重复使用相同的失败编辑器导入路径。
• 仅在依赖字节数据的操作之前等待上传。字节数据仍在上传时，已知的资源 id 可用于元数据和时间线放置。

生成和动态图形

• 仅使用当前主机上可见的生成工具。Codex 和 Claude Code 插件使用 create_motion_graphic_from_code 直接创作动态图形；内置的 ChatCut Agent 可能提供 submit_motion_graphic。
• 保留原始提供方或内容策略错误。请勿为重复相同的尝试消耗额度，也不要悄悄切换模型。

验证和导出

• 修改成功并不能证明视觉效果正确；如果需要查看结果，请加载 verification。
• 渲染任务请使用 track_export。本地导出失败本身并不是切换到云端的理由：请修复报告指出的浏览器或时间线问题，然后重试本地导出。本地导出被阻止，或导出已完成但文件缺失时，请按 export 的回退顺序处理：仅在用户同意后使用云端；只有云端无法完成时才使用 ChatCut Desktop。如果云端渲染无法读取某项资源，只有在获得用户许可后，才能通过 asset-import 解决远程就绪问题；否则请说明限制。

如果出现身份验证或项目访问错误，请先核实确切的项目 id，并确认编辑器和插件使用同一个 ChatCut 账户，然后再尝试调试代码或基础设施。