Effectcraft Motion Export

---
name: effectcraft-motion-export
description: 当用户需要用 effectcraft 完成动效输出检查，涉及合成时长、帧率与编码时使用；适用于从素材诊断到可编辑交付的完整任务。
license: Apache-2.0
---

# 动效输出检查


执行具体方法前读取 [Craft 场景命令与参数](references/craft-methods.md)，按其中的对象选择、会话、输入替换和结果检查执行。

## 任务起点

先读取素材，确认交付用途、目标尺寸或时长、修改范围与必要格式。能从任务和素材确定的细节直接采用合理默认值；只询问会改变结果的缺失条件。

需要可见编辑器时交给 **effectcraft-editor** 技能。独立安装：`npx skills add full-aigc-skills/effectcraft-skills --skill effectcraft-editor`。当前新增技能为本地候选，发布前使用本地配套插件，不把此安装命令当作已发布证明。

## 执行步骤

1. 核对输出尺寸、帧率、时长和透明要求。
2. 确认工作区间与音频起止，禁用测试图层。
3. 先渲染短片段检查效果，再渲染完整范围。
4. 重开输出检查首尾帧、时长与透明通道。

## 工具落地

使用 command_list 读取当前 Web 引擎命令；command_run 的 id 和 params 对应实际 execute 接口；inspect 检查画面，save_project 保存新工程路径，save_file 取回已生成虚拟文件。

先读取实际工具 schema，再填写参数；对象或文档 ID 使用返回值。查询到的命令必须在当前后端可用。保存前选择新输出路径，保留输入。需要的算法、格式或命令不存在时说明缺口，不能用相近名称冒充。

序列帧交付按 [Craft 场景命令与参数](references/craft-methods.md) 的原生 `render` 参数执行，并核对实际帧数与尺寸；工程另存成功不等于已经导出。

## 结果检查

- 渲染任务完成后才检查实际文件。
- 不将预览帧当完整视频。
- 输出失败保留工程与错误信息，避免无依据重跑。

对照用户目标检查实际内容，而不只检查进程退出码。局部编辑查看局部细节，版式任务查看整页，时间媒体查看起止与关键段。异常结果先检查当前工程，避免重复执行不可逆操作。

## 交付

返回可编辑工程、实际派生文件和简短说明：做了哪些修改、哪些步骤因当前能力未执行、需要用户判断的内容。只列真实存在且已经检查的文件。若用户随后返工，读取本次源工程并局部修改，保留已接受的内容。

## 技能商店场景经验

遇到可编辑工程与渲染分别验收时，读取[商店工作流适配](references/market-workflows.md)，使用对应的Craft方法和实际结果检查。上游技能不作为运行依赖。