AI电商上架套图
把已核实的商品照片和 SKU 信息整理为一个有顺序的上架图片组，包括主图、卖点、细节、场景、尺寸或包装信息。每张图都必须持续呈现同一个经确认的 SKU、事实和品牌方向。
主图合规与辅图说服分开。只需要一张干净背景图、一张场景图，或针对单张商品图的定向修改时，转交 product-photo-studio；卖家只想核对单张主图是否符合某个站点的规则，或只要一次定向修复时，转交 marketplace-main-image-preflight。本包适合为一个 SKU 制作统一的多图上架组。模特上身图，以及长图详情或 A+ 视觉模块，都不在本包这一个 SKU 的图片组范围内——在选定并安装对应的专门包之前，不要在本包里做这两类工作。
先确认输入与图片计划
硬输入是真实商品照片和已确认的 SKU 事实。缺事实不编造卖点图。收集商品照片、SKU 名称与型号、颜色、材质、尺寸、包装清单、已确认卖点、禁止改变的标识，以及目标站点和图片位。不能从用户材料证实的事实不要写入图片。宿主看不到的图片，按卖家声明的用途处理，不要声称自己已经看过；上传只是把素材交给 Beatra，并不等于已经查看。先出有序镜头表（主图、卖点、场景、尺寸、包装），等卖家确认计划，再按张付费出图。先给出图片顺序、每张图的目的、需保留的细节、短文案边界与选用画布；卖家确认后才进入付费制作。
一组图只覆盖一个已核实的 SKU。卖家有颜色、尺寸或材质变体时，以随图提供的那个变体领衔，放进整组确认里一并确认，不必先问；只有照片里不止一个变体、卖家又没有说明时才问哪个领衔。要在同一组里加一张展示全系列的图，需要卖家另外提供一张真正同时包含全部变体的照片，不能把几张单独的照片拼起来当作一张全系列图。由卖家在任何付费调用之前选择：在领衔那组里加一张全系列图，还是每个变体各做一组。多个 SKU 就是多轮制作，之间共用槽位模板和视觉方向，绝不共用事实卡。详见上架图片组工作流（references/workflow.md）。
逐张制作
准备槽位卡、选择路线或写请求载荷之前，先读上架图片组工作流（references/workflow.md）。再次发现只需针对单张主图检查站点要求时，转交 marketplace-main-image-preflight。需要重新构建同一商品的画面时使用 beatra.images.transform，并将经过确认的商品图放在 images[0]；需要对已有成图做局部更正时使用 beatra.images.edit。为模型、画布、控制项或价格作决定前查询 beatra.models.list。默认使用 model 为 auto、每个任务 count 为 1，并为每个逻辑请求分配唯一不透明的 client_request_id。每张图片保持 count: 1，在交付中记录 billing.net_charged_credits。
只在单张有明确局部问题且卖家批准时再使用 beatra.images.edit；仍把已确认商品图放在 images[0]。立刻保存返回的 task_id，以 beatra.tasks.get 跟踪到终态。若响应或任务标识丢失，先以 beatra.tasks.list 查找候选并用 beatra.tasks.get 确认；仅应卖家要求取消，且不替换已经进入执行的原任务时使用 beatra.tasks.cancel。
只使用随包 scripts/mcp_client.py 进行上传和远程调用。工具名称通过 call 传入，JSON 通过标准输入发送；不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 降级或回退。以下示例只展示命令形态，实际内容必须替换为卖家已批准的信息：
printf '%s' '{"capability":"image_to_image"}' | python3 scripts/mcp_client.py call beatra.models.list
printf '%s' '{"images":[{"type":"artifact","artifact_id":"sku-front"}],"prompt":"Create the approved product-hero slot. Preserve the verified SKU shape, colour, label, and included items.","canvas":{"type":"preset","tier":"2K","aspect":"1:1"},"count":1,"client_request_id":"opaque-sku-hero-id"}' | python3 scripts/mcp_client.py call beatra.images.transform
审阅、恢复与资料
规划阶段不收费。第一次付费调用之前，只出示一次整组确认，冻结完整的有序槽位表、每张图的提示词、底图与参考图的顺序、已批准的事实来源、每个槽位的画布、模型行为、出图数量、当前每张单价，以及总价上限和总调用次数；这次确认还要说明中途停下时卖家已经拿到什么，以及余额在中途用尽时那份已冻结的计划会怎样。卖家批准这一次之后才开始付费出图。收到结果后，检查商品形状、颜色、标签、随附物、事实一致性、图片顺序和画布适配。缓慢任务仍是同一任务；只可对相同的请求标识重放丢失的创建响应，任何已批准槽位、事实来源、底图与参考图顺序、画布、模型、出图数量或控制项的变化，均是新付费请求并需重新批准。
- 图片组计划、槽位顺序、变体分流、提示词写法、请求载荷、确认卡、任务恢复与图片组复核，以及查询剩余积分和这一趟扣了多少：上架图片组工作流（references/workflow.md）
- 第一次制作，或整组图看起来不像同一套时：一整套上架图片组的完整示例（references/worked-example.md）
- 出图不对、任务变慢、响应丢失或批准后要改动时：常见问题与反模式（references/faq.md）
- 首次安装或授权失效：安装与授权（references/installation-and-auth.md）
- 不收费的包安装注册：安装注册（references/installation-registration.md）
- 任务轮询、产物和结果字段：任务与结果（references/tasks-and-results.md）
- 余额、校验和结构化错误：计费、错误与恢复（references/billing-errors-and-recovery.md）
- 随包客户端连接诊断：随包 MCP Client 连接诊断（references/mcp-connection.md）
- 更新与安全：更新与安全（references/updates-and-security.md）
- 移除本包或共享凭据：卸载与断开连接（references/uninstall-and-disconnect.md）
更新与安全
本 Skill 会自动更新。内置客户端每天最多一次从 Beatra 官网读取本渠道的版本信息
（中国大陆网络走 www.beatra.cn 与 cdn.beatra.cn）。有新版本时，它下载官方发布包，
逐个文件校验 SHA-256，再替换本 Skill 自己的文件；你放进这个目录的其他文件不会被
改动。替换过程中断时，下次运行会自动恢复到替换前的状态。除此之外，它不下载或执行
任何其他代码，只通过 HTTPS 与 Beatra 官方服务通信；你选择上传的文件只会传到
Beatra 为这次上传签发的一次性地址。
关闭自动更新：python3 scripts/mcp_client.py update --auto off。关闭后，客户端每天
最多提示一次在你安装它的商店里更新的命令。详见更新与安全（references/updates-and-security.md）。
