← 完整教程目录离线阅读器与全文搜索

18|从 SKU 表批量生成素材,逐条记录状态

把 SKU 表转成素材任务,先解决“哪一行对应哪个任务、发生异常后从哪里继续”。本篇用两条虚构 SKU 演示离线建计划,再逐条授权执行;不会一次自动跑完整个商品目录。

输入表的最小结构

examples/sku.csv 包含 sku、prompt、reference_url。SKU 必须唯一、大小写也不能冲突;prompt 只能使用经确认的商品事实。真实商品需要参考图时,填写已经获授权且仍有效的 URL,不能只写“商品名”就期待模型还原真实包装。

先准备,不联网

MODEL='替换为当前已确认模型ID'
python3 scripts/batch_plan.py --csv examples/sku.csv --model "$MODEL" \
  --out tutorial-output/sku-batch-01 --max-jobs 2

脚本生成每条 SKU 的配置、计划和 batch.json。它拒绝重复 SKU、空提示词、路径穿越和超出数量;不调用 Atlas。带单张参考 URL 时,必须按 schema 明确指定 --reference-field;模型要数组或其他结构时请改成逐项配置,脚本不会猜字段。

抽一行跑通

python3 scripts/run_job.py preview --run-dir tutorial-output/sku-batch-01/lamp-white

预览不是估价。另用与计划相同的模型与 params 查询费用,确认当前账户、数量与参考素材外发授权。首件批准后才执行:

python3 scripts/run_job.py submit --run-dir tutorial-output/sku-batch-01/lamp-white --approve
python3 scripts/run_job.py wait --run-dir tutorial-output/sku-batch-01/lamp-white

submit 返回 pending 时脚本退出码为 3,这是任务未完成,不应由上层自动重交。只有 wait/get 用来继续原 ID。脚本的 attempt.json 在首次尝试前落盘,第二次 submit 会被拒绝;不要删除它绕过保护。

从小样到第二行

审核第一件的产品保真、输出尺寸和交付文件。确认后对第二行单独预览、估价和批准。真实规模扩大时要加服务端项目额度、并发限制和账户级任务记录;本地 max-jobs 仅限制这次计划里的数量,不能限制其他机器同时消费。

复制给 Agent

根据 SKU 表创建本地 Atlas 任务计划,先不上传和生成。检查 SKU 唯一性、事实文案、参考输入和行数上限。先对一条 SKU 做预览与估价,批准后提交一次并保存回执。任何受理未知的行暂停,不用重新提交填满“成功率”。

交付与恢复

每条 SKU 保留 prepared、pending、unknown、remote_failed、remote_succeeded 及内容审核结果。重新运行只读取已存在的计划,不创建一组新目录再跑一遍。下载失败恢复下载;包装失真记录内容失败,两者处理不同。

依据与复现范围

依据:S1、S2、S6。本文使用本包约定的教学文件;模型能力与价格以执行时实际目录为准。线上付费步骤未代用户执行,离线验证结果见 测试报告。通用路径、授权和状态约定见 执行约定。