DaVinci Auto Editor

使用此技能时，请按以下顺序执行：

1. 1. 读取与 examples/config.example.json 结构相同的配置文件。
2. 校验 apibaseurl、apikey、materialpath、timeline_fps 等关键参数。
3. 递归扫描素材目录，并向云端上报素材索引。
4. 调用云端 API 创建任务并获取剪辑计划。
5. 在本地仅生成最小执行计划，不要将完整的云端内部逻辑写入本地文件。
6. 由 Node 生成 Resolve 可导入的 timeline.edl 和导入说明文件。
7. 将准备结果回传云端。

输入参数

至少需要提供以下字段：

• - apibaseurl
• apikey
• projecttype
• aspectratio
• materialpath
• templateid
• subtitlemode
• musicpolicy
• pacepolicy
• outputmode
• renderpreset
• timelinefps
• timelineresolution

可选字段：

• - tasktimeoutms
• pollintervalms
• requesttimeoutms
• taskname
• webhookurl
• extra_metadata

输出结果

默认在素材目录旁创建 davinciauto_editor// 目录，包含以下文件：

• - resolve-import.json：最小本地导入计划
• timeline.edl：Resolve 导入文件
• IMPORT-TO-RESOLVE.txt：导入说明
• execution-report.json：本地执行报告

推荐工作流

• - 将核心决策、模板逻辑、API Key 鉴权和配额管理放在云端服务。
• 本地仅保留素材扫描、结果导出和回传逻辑。
• 优先使用短路径、稳定命名的素材目录，以减少 EDL relink 成本。
• 在正式任务前，先用样本素材验证时间线 FPS 和素材命名。

依赖要求

• - Node.js 18 或更高版本
• 已安装 DaVinci Resolve
• 可访问云端 API 的网络环境

错误处理原则

• - 缺少配置、素材目录不存在、API 调用失败时，立即停止并返回非 0 退出码。
• 始终写出 execution-report.json 以便排查。
• 不在本地输出完整的云端推理结果，仅输出导入所需的最小执行数据。
• 明确提示第一版仅覆盖基础拼接和时间线导入准备。