商品视频复刻 V1.2.1
把用户的商品和参考视频变为可播放、可追溯、可迭代的成片。先判断应保留什么，再选择模型能力。本包是 Agent 执行规范与工具包，不是脱离模型、网络及授权也能工作的独立程序。
执行约定
- 默认做 1 个完整视频；有实质不同的策略且用户允许探索时做 2–3 个。用户明确要三版就规划三版。最多同时推进 3 个最终方案。一个方案的多段模型任务不算多个最终视频，但仍受服务并发限制；默认任务串行，确认配额后才提高到最多 3。
- 用户指定商品、模型、时长、参考范围、严格程度优先。错商品或身份不明时询问；已授权的镜头、分段、Prompt 等创作选择自行推进，不反复确认。
- Prompt 不写商品 PID、内部 ID、本地路径或无关品牌。商品图可确认的 SKU 和有来源的卖点优先；不编造功能、价格或检测结果。
- 每个方案保存实际输入、请求、配置、输出、后期、判断依据、失败和验证。记录证据、选择与取舍，不记录私有思维链、凭据。先本地归档，再按要求发布平台，不额外向他人发消息或公开分享。
- 目标是交付计划中的全部 1–3 个视频，至少一个通过最低验收的真实成片。全部失败时如实报告，不能假装满足最低数量，也不无限付费重试。
按阶段加载
| 阶段 | 阅读 |
|---|---|
| 首次运行、换 Agent | 运行与迁移 |
| 从输入跑到交付的命令示例 | 完整运行示例 |
| 理解、长度、策略、Prompt | 决策树 |
| 前贴、剧情、口播、字幕、人物与 SKU 保真 | V1.2.1 参考保真门禁 |
| 建计划、版本与元数据 | 数据契约 |
| 当前 Codex＋小云雀 | 现有适配器 |
| 更换理解、生成、图像或音频工具 | 开放适配接口 |
| 执行、恢复、后期、验收 | 执行与验收 |
| 本地标注平台 | 平台适配 |
| 已遇到的反例 | 回归案例 |
端到端步骤
- 核对目标：建立 run.json，解析商品、SKU、图片、参考及要求；多个参考逐一探查后选取，记录排除理由。名称/图片明显错配先澄清。先找已有任务，避免重复提交。
- 发现能力：确认理解、生成、媒体处理工具及认证；查询模型与模式当前限制，保存原始和规范化能力快照。未知不能当作无限制，指定模型不可用不能静默换模型。
- 理解参考：探查视频流和容器时长、帧率、尺寸与音轨。抽帧覆盖全片，再加密钩子、商品、转折与切点；口播或剧情需要音频/转写。记录实际理解模型、抽帧率、范围、时间戳和限制，输出内容结构、逐段口播/字幕覆盖、字幕唯一责任源、人物声音与站位画像、BGM/关键动作和 SKU 几何负约束。抽图不等于已经看图。
- 确定保留与长度路线：选择镜头、因果、功能模块、局部元素或情绪机制。吸睛前贴、语言结构、剧情关系、前后半程口播/字幕、BGM 和关键动作均按参考指纹映射。全长严格复刻超限→自然切点分段；允许压缩改编→重写完整短广告，默认总时长不低于参考的 85%。只取前贴需目标允许，不能把前贴当完整广告。分别检查输入总时长和输出时长。
- 规划 1–3 个方案：策略要有实质差异。说明商品怎样参与转折，绑定时间轴、素材角色、人物身份参考、逐段口播/字幕覆盖、字幕责任源、BGM、时长、SKU 几何负约束、风险及验收。同一人物跨分段时优先准备并复用一个角色三视图/设定图；不能绑定身份资产时减少切段并标风险。保存 plan.json 与 Prompt；运行
scripts/replica.py validate-plan后人工检查语义和模式限制。 - 调用生成：按依赖准备参考片段/条件图，条件图先目检；保存素材路径与哈希。提交前记录意图，提交后立即保存 ID/链接并告知用户。按原 ID 查询下载，慢或下载失败不得重生成。遵守失败分类和有限重试。
- 后期：保留原模型文件。按目标帧数/PTS 裁切拼接，检查接缝，不用变速掩盖时长错误。按政策处理音轨，重写剧情不能默认带回旧商品口播。字幕只保留一个可信来源。
- 验收与迭代：验证文件和完整解码、时长/帧数/音轨；分开评估商品正确性、前贴/剧情机制、逐段口播与字幕覆盖、字幕是否重复、人物一致性与站位构图、声音画像、BGM/关键动作、时长比例和连续性。参考很像但商品未替换、口播缺段、双层字幕或剧情降级仍是失败。先修后期；生成修订在预算内默认最多一次，创建父子版本，保留旧版和用户评价。
- 交付：每版关联方法、版本、Prompt、实际配置、Input、原始与最终 Output、workflow、QA。写 results.md；按要求并列挂到对应参考视频并验证播放/刷新。报告完成数、差异、质量限制与待办。
续跑
中断后先读 run.json、plan.json、events.jsonl 和 jobs/*/state.json。有任务 ID 就 query；submitting/submission_unknown 无 ID 先核查服务端，禁止再次 submit。downloaded 只代表拿到文件，validated 才代表最低验收通过。关键阶段更新 agent.md，使其他 Agent 可接手。