用途：诊断 ChatCut 插件在调用工具时出现的失败、变更被拒、响应结构异常，以及导入、生成或渲染操作被阻止的情况。以当前生效的 MCP 工具 schema 与返回的结构化错误为唯一依据，当当前 manifest 不同时，不要用记住的旧版负载重试。
变更被拒：同一轨道重叠时，不要强行写入或静默删除冲突项，应判断内容是顺序还是分层，必要时选可用轨道，或询问哪一项优先。锁定轨道或陈旧 id 失败时，刷新受影响的时间线范围，只用当前 id 和状态重试。校验错误时只改被拒字段或事务结构，保留无关项目状态。
导入与媒体：托管插件界面用 asset-import 适配器和 import_media；在缺少后端专用 push_asset 或 download_media 时不要替代调用。媒体转换失败时，若 helper 提供结构化重试则使用；否则说明不支持的来源并请求兼容替代，不要重复同一失败的编辑器导入路径。只在与字节相关的操作前等待上传；已知 asset id 可在字节继续上传时用于元数据和放置到时间线。
生成与动态图形：只用当前宿主可见的生成工具。Codex 和 Claude Code 插件用 create_motion_graphic_from_code 直接编写动态图形；内置 ChatCut Agent 可能暴露 submit_motion_graphic。保留原始提供方或内容策略失败，不要为重复相同重试消耗额度，也不要静默切换模型。
验证与导出：变更成功不等于视觉正确，结果必须被看到时加载验证。渲染任务用 track_export。若云渲染无法读取 asset，仅在用户许可下通过 asset-import 解决远程就绪，否则报告限制。遇到鉴权或项目访问错误，先确认确切 project id，以及编辑器和插件使用同一 ChatCut 账号，再尝试代码或基础设施调试。