Fast Path 的 video-composing 拒绝文档要求的 fast-clip-data task_order_num

[ShawYu19]

迁移来源

从 GridLtd-ProductDev/narrator-ai-py#80 迁移而来。

关联后端上下文：

• GridLtd-ProductDev/narrator-ai-py#63
• GridLtd-ProductDev/narrator-ai-py#80

负责人关联：当前 assignee 为 @pluckhuang（江波/黄江波），该关联由用户手动设置，本 issue 保留现状，不自动变更负责人。

问题现象

使用最新版 narrator-ai-cli-skill 的 Fast Path + 原声混剪流程创建内置素材《孤注一掷》解说任务时：

1. fast-writing 已完成，顶层 status=2；
2. fast-clip-data 已完成，顶层 status=2，并返回顶层 task_order_num；
3. 按当前技能文档，把 fast-clip-data 顶层 task_order_num 传给 video-composing.order_num，服务端返回任务关联记录缺失，导致合成任务无法创建。

报错：

Error: [10001] 任务关联记录信息缺失: task_id=None, order_num=fast_writing_clip_data_6007ec42_a009e8

环境信息

• 触发时间：2026-04-22 14:25-14:45（Asia/Shanghai）
• 工具：narrator-ai-cli
• 技能仓库：https://github.com/NarratorAI-Studio/narrator-ai-cli-skill
• 技能 commit：8f0e0fa21a8b62f67defaf749a2e77a78cfa45e7
• 账号余额验证：7194.52，余额可用

任务配置

• 素材：孤注一掷 / No More Bets / 2023
• Material ID：170
• 模式：target_mode=2 原声混剪
• BGM：Unresolved Issues (f5fa9c25-bec1-4f09-9fd3-9a1434bb912a)
• 配音：纪实磁性男声 (manchaozn_meet_24k@jilupian)
• dubbing_type：普通话
• 解说模板：烧脑悬疑-真相揭露解说 (narrator-20250928113959-cceaBA)
• 写作模型：flash
• 语言：Chinese (中文)
• 视角：third_person
• magic-video：未执行

素材文件：

video_oss_key:    5e978623-f88e-4138-84f7-526d613ad81a
srt_oss_key:      51718ed0-eaf7-484c-a224-7927cbe1202d
negative_oss_key: 5e978623-f88e-4138-84f7-526d613ad81a

fast-writing 结果

create data.task_id: 9d265fb2880c4861a7a36d79b63923d4
query status: 2
task_order_num: fast_generate_writing_9d265fb2_64d9c4
script file_id: 5a70f5de763f4957bee8a4e65ba8f925
script file_path: user_data/grid_n6haaDCMKqG6vIOdsu1Q/20260422/90ab3750/孤注一掷.txt
consumed_points: 4.3

fast-clip-data 请求

{
  "task_id": "9d265fb2880c4861a7a36d79b63923d4",
  "file_id": "5a70f5de763f4957bee8a4e65ba8f925",
  "bgm": "f5fa9c25-bec1-4f09-9fd3-9a1434bb912a",
  "dubbing": "manchaozn_meet_24k@jilupian",
  "dubbing_type": "普通话",
  "episodes_data": [
    {
      "video_oss_key": "5e978623-f88e-4138-84f7-526d613ad81a",
      "srt_oss_key": "51718ed0-eaf7-484c-a224-7927cbe1202d",
      "negative_oss_key": "5e978623-f88e-4138-84f7-526d613ad81a",
      "num": 1
    }
  ]
}

fast-clip-data 结果

create data.task_id: 6007ec42b4fd47d582aa8ea2eee37131
query status: 2
top-level task_order_num: fast_writing_clip_data_6007ec42_a009e8
nested results.order_info.order_num: 2d451aa40cb5b8d504b80859b7eda62a
subtask id: 170196
subtask status: 9
clip_data_file_id: b4894808ba0b438ebf8c3aaa6c165627
clip_data_file_path: user_data/grid_n6haaDCMKqG6vIOdsu1Q/20260422/fast_generate_w-18de2dd4c9be45b2/t_170196_143006_g0XO/clipsData.json
consumed_points: 35.0

备注：当前技能文档说明子任务内部 status=9 属于不同状态系统，轮询应以顶层 .status=2 为准。本样本顶层状态已成功。

按当前技能文档创建 video-composing 的请求

{
  "order_num": "fast_writing_clip_data_6007ec42_a009e8",
  "bgm": "f5fa9c25-bec1-4f09-9fd3-9a1434bb912a",
  "dubbing": "manchaozn_meet_24k@jilupian",
  "dubbing_type": "普通话"
}

实际返回：

Error: [10001] 任务关联记录信息缺失: task_id=None, order_num=fast_writing_clip_data_6007ec42_a009e8

已尝试排除

• 传 fast-clip-data 顶层 task_order_num：失败，返回关联记录缺失。
• 传 fast-writing 顶层 task_order_num：失败，返回未找到任务关联记录。
• 传 fast-clip-data.results.order_info.order_num：失败，返回未找到任务关联记录。
• 传子任务数字 ID 170196：失败，返回未找到任务关联记录。
• 执行 task save-clip 后重试：仍失败。
• 在 video-composing 请求中额外附带 task_id / file_id：仍失败，服务端错误里仍显示 task_id=None。

save-clip 返回：

{
  "task_id": "6007ec42b4fd47d582aa8ea2eee37131",
  "file_id": "b4894808ba0b438ebf8c3aaa6c165627"
}

期望结果

二选一：

1. video-composing 应按文档接受 order_num=fast_writing_clip_data_6007ec42_a009e8，并成功创建合成任务；
2. 如果接口契约已经变化，需要更新技能文档和工作流说明，明确 Fast Path 合成阶段到底应该传哪个 anchor/value。

实际结果

video-composing 在创建阶段失败，没有返回 data.task_id，因此没有最终 video_url。

建议核查点

1. 核查 6007ec42b4fd47d582aa8ea2eee37131 / fast_writing_clip_data_6007ec42_a009e8 是否存在于合成端使用的任务关联表中。
2. 核查 b4894808ba0b438ebf8c3aaa6c165627 对应的 clipsData.json 是否已绑定到该任务/订单。
3. 核查 /v2/task/commentary/create_video_composing 当前是否仍以 fast-clip-data.task_order_num 作为 Fast Path 的合成 anchor。
4. 如果服务端已改用其他 anchor，需要同步更新 SKILL.md 和 references/workflows.md。

验收标准

• 当前文档描述的 Fast Path video-composing 请求可以成功；或文档改为真实可用的请求方式。
• 如果服务端修复，创建响应应包含 data.task_id。
• 如果服务端修复，合成任务完成后 .results.tasks[0].video_url 应非空。
• 如果是文档修正，SKILL.md 和 references/workflows.md 中不再引导用户传一个会被拒绝的 order_num。

[pluckhuang]

#32 进行了修复