整部作品提交技能 (Submit Project)

概述

本技能用于将一整部短剧项目的分镜任务（通常 50 条）批量提交到 Seedance 任务服务。

输入来源：

seedance_project_tasks.json（项目根目录下的唯一任务文件）

输出结果：

提交成功的 taskCodes
失败任务清单
submission_report.json

依赖协议

遵循 seedance-video-task-submit 协议（详见 skill-task-submit.md）：

服务地址默认：http://localhost:3456
核心接口：POST /api/tasks/push
支持单任务或批量（tasks 数组）

任务对象关键字段：

prompt (必填，使用 (@fileName) 语法引用参考图)
description
modelConfig（model / referenceMode / aspectRatio / duration）
referenceFiles (对象数组，每项包含 fileName / base64 / fileType)
realSubmit (默认 false)
priority (默认 1)
tags (建议包含 project_id,EPxx,A|B)

referenceFiles 存储与展开

存储格式（seedance_tasks.json 中）：referenceFiles 为相对路径字符串数组，相对于项目根目录。包含分镜参考图、角色参考图、场景参考图和道具参考图。

"referenceFiles": [
  "episodes/EP01/DM-002-EP01-A_storyboard.png",
  "characters/林策_ref.png",
  "characters/沈璃_ref.png",
  "scenes/scene_01_ref.png",
  "props/prop_01_ref.png"
]

提交时展开：提交前将每个路径展开为对象，读取文件转 base64：

"referenceFiles": [
  {
    "fileName": "DM-002-EP01-A_storyboard.png",
    "base64": "data:image/png;base64,iVBOR...",
    "fileType": "image/png"
  }
]

展开逻辑（Python 伪代码）：

import base64, os, mimetypes

def expand_reference_files(ref_paths, project_dir):
    result = []
    for rel_path in ref_paths:
        abs_path = os.path.join(project_dir, rel_path)
        file_name = os.path.basename(rel_path)
        mime_type = mimetypes.guess_type(abs_path)[0] or "image/png"
        with open(abs_path, "rb") as f:
            b64 = base64.b64encode(f.read()).decode()
        result.append({
            "fileName": file_name,
            "base64": f"data:{mime_type};base64,{b64}",
            "fileType": mime_type
        })
    return result

目录约定

目标项目目录（示例 DM-002_tjkc/）应包含：

DM-002_tjkc/
├── seedance_project_tasks.json          # 必须，唯一任务文件
├── episodes/
│   ├── EP01/
│   │   ├── dialogue.md
│   │   └── storyboard_config.json
│   └── ...
└── submission_report.json               # 本技能生成

执行流程

第一步：定位项目

若用户指定项目编号（如 DM-002），定位对应目录
若未指定，使用 projects/index.json 最新项目

第二步：加载任务

优先读取 seedance_project_tasks.json
若不存在，遍历 episodes/EP01-EP25/seedance_tasks.json 聚合
若用户指定单集（如 EP01），只读取该集的 seedance_tasks.json
校验任务结构：
- 每个任务必须有 prompt
- modelConfig 缺失时补默认值
- realSubmit 缺失时默认 false

第三步：展开 referenceFiles

对每个任务的 referenceFiles（相对路径字符串数组），执行 base64 展开：

拼接绝对路径：项目根目录 + 相对路径
读取文件二进制内容
转换为 {fileName, base64: "data:mime;base64,...", fileType} 对象
替换原 referenceFiles 数组

第四步：批量提交

按批次提交（推荐每批 20~50 条）到 /api/tasks/push
请求体格式：

{
  "tasks": [
    {
      "prompt": "...",
      "description": "...",
      "modelConfig": {
        "model": "Seedance 2.0 Fast",
        "referenceMode": "全能参考",
        "aspectRatio": "16:9",
        "duration": "15s"
      },
      "referenceFiles": [
        {
          "fileName": "DM-002-EP01-A_storyboard.png",
          "base64": "data:image/png;base64,...",
          "fileType": "image/png"
        },
        {
          "fileName": "林策_ref.png",
          "base64": "data:image/png;base64,...",
          "fileType": "image/png"
        },
        {
          "fileName": "scene_01_ref.png",
          "base64": "data:image/png;base64,...",
          "fileType": "image/png"
        }
      ],
      "realSubmit": true,
      "priority": 1,
      "tags": ["DM-002", "EP01", "A"]
    }
  ]
}

收集返回的 taskCodes
记录失败批次与错误信息

第五步：生成报告

在项目根目录生成 submission_report.json，格式示例：

{
  "project_id": "DM-002",
  "submitted_at": "2026-02-16T12:00:00Z",
  "api_base": "http://localhost:3456",
  "total_tasks": 300,
  "submitted_tasks": 300,
  "failed_tasks": 0,
  "task_codes": ["SD-20260216-0001"],
  "failed_items": []
}

运行指令

可通过以下表达触发：

"提交整部作品任务"
"把 DM-002 全部分镜提交到 Seedance"
"batch submit drama tasks"
"提交所有 seedance_tasks"

可附带参数：

项目编号：如 DM-002
realSubmit：true/false
批次大小：如 batch=30
API 地址：如 api_base=http://localhost:3456

检查清单

已定位正确项目目录
任务来源文件存在（项目级或分集级）
每个任务包含 prompt
批量提交到 /api/tasks/push 成功
已收集全部 taskCodes
失败项已记录并可重试
submission_report.json 已生成

输出示例

✅ 整部作品任务提交完成

项目：DM-002
总任务数：300
成功提交：300
失败：0

报告文件：/data/dongman/projects/DM-002_tjkc/submission_report.json

submit-anime-project