AI商品图工作室

将一张真实产品照片转化为影棚级上架图、生活场景图或面向市场平台的主视觉。复用对话中已经明确的决定，沿最短路径完成用户需要的商品图。

选择制作路线

• 纯净背景: 有一张产品照片时，移除原始背景，将产品放在纯白、浅灰或影棚渐变背景上，使用 beatra.images.transform。这是平台主图的默认选择。
• 场景与生活化: 有一张产品照片和场景描述时，将产品放入真实使用场景——厨房台面、木桌、大理石层架或季节背景——使用 beatra.images.transform。
• 精修选定草稿： 使用 beatra.images.edit，把选定图片作为 images[0]，修复阴影、去除反光、调整色温或清理小瑕疵，不改变整体构图。

精确路线参见产品路由（references/product-routing.md），把需求转化为以源产品为依据的视觉规格时参见场景工艺（references/scene-craft.md）。

形成一份产品简报

复用用户已经给出的产品类型、目标平台、背景偏好和风格参考。只有缺失决定会实质改变结果时才询问。标准平台主图优先建议纯白背景；生活场景请求优先建议匹配产品品类的场景。

简报围绕以下内容展开：

• 产品本身——它是什么、品类，以及关键外观细节（标签文字、品牌标识、形状、颜色）；
• 一个目标平台或用途（亚马逊、淘宝、Shopify、社交媒体、广告投放），当它决定格式指引时；
• 一个背景或场景方向（纯白底、影棚渐变、生活场景、季节主题）；
• 有序视觉参考（风格灵感、背景参考、角度参考），产品照片始终在第一位。

用户已经说明目标平台或背景类型时直接复用。确实缺少这项决定时，给出最合适的默认建议，并把它合并进一次付费调用确认。

准备调用

所有远程 MCP 操作只能使用本 Skill 随包 scripts/mcp_client.py。工具名称作为 CLI 参数，工具参数以 JSON 通过标准输入传入。不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为回退。精确命令和排错参见随包 MCP Client 连接诊断（references/mcp-connection.md）。

• 先通过随包客户端辅助命令上传产品照片，再调用 beatra.images.transform，把上传的 artifact 作为第一个有序参考。在 prompt 中显式标注产品图的角色，让模型以源图和已确认的商品细节为视觉依据。
• 纯净背景时，设置正方形或平台要求的画布比例。
• 生活场景时，在 prompt 中描述场景、光照方向和表面材质，同时列出应延续到结果中的商品外观特征。
• 精修选定草稿时，调用 beatra.images.edit。局部修改最多使用两个归一化 edit_regions，指定 image_index=0；全图调整则省略区域。

上传只让远程工具取得文件字节，本身不等于图片检查。只复查宿主确实能够看到的视觉事实。

除非用户明确选择其他设置，否则保持 model=auto 和 count=1。只有模型、可用性、兼容性或价格确实影响决定时才调用 beatra.models.list。完整请求结构与示例参见工作流（references/workflow.md）。

确认并只执行一次

策划和简报准备免费。付费图片调用前，展示并固定最终提示词、有序参考图、画布、背景或场景方向、模型、控制项和输出数量。仍然缺失的高影响决定应合并到这一次确认中。

获得确认后，为这一个精确的逻辑请求创建一个稳定且不透明的 client_request_id，并只提交一次。提示词、参考图或顺序、画布、场景方向、模型、数量或控制项任一变化，都是新的付费工作，需要新的确认和新标识符。

跟进、复查与交付

收到 task_id 后，只用 beatra.tasks.get 轮询该任务。如果标识符丢失，使用 beatra.tasks.list 查找候选并用 tasks.get 验证选中项。只有原始响应状态确实未知时，才能用完全相同的参数和同一个 client_request_id 进行幂等恢复。轮询缓慢、更新失败、授权失败或连接失败都不能创建替代性付费任务。

只有在用户主动要求时才使用 beatra.tasks.cancel。取消返回 409 时，继续跟踪原任务。完整恢复合同参见复查与恢复（references/review-and-recovery.md）。

结果可见时，依次对照源图复查产品保真度、背景质量（边缘干净、光照一致、阴影自然）、颜色准确性、画布适配，以及目标平台的当前图片指引。交付 artifact 链接、实际尺寸、任务标识符和 billing.net_charged_credits。最多提供一次聚焦的、未执行的精修建议。生成的素材也可以在 beatra.ai 查看和管理。

按任务查阅参考文档

• 在纯净背景、生活场景和精修编辑之间选择，或针对特定平台规划：产品路由（references/product-routing.md）
• 把需求转化为以源产品为依据的场景规格：场景工艺（references/scene-craft.md）
• 每条路由的精确请求结构、有序参考标注和 JSON 示例：工作流（references/workflow.md）
• 遗失任务、轮询缓慢、取消、结果复查或规划精修：复查与恢复（references/review-and-recovery.md）
• 首次安装或认证过期：安装与认证（references/installation-and-auth.md）
• 随包 MCP Client 命令与诊断：随包 MCP Client 连接诊断（references/mcp-connection.md）
• 安装注册：安装注册（references/installation-registration.md）
• 任务查询、轮询与结果字段：任务与结果（references/tasks-and-results.md）
• 余额、校验与结构化错误：计费、错误与恢复（references/billing-errors-and-recovery.md）
• 断开安装连接：卸载与断开（references/uninstall-and-disconnect.md）
• 官方来源、完整性校验与更新控制：自动更新与安全（references/automatic-updates-and-safety.md）

安装、更新与账号操作

首次使用和共享操作参见安装与认证（references/installation-and-auth.md）、安装注册（references/installation-registration.md）、任务与结果（references/tasks-and-results.md）、计费、错误与恢复（references/billing-errors-and-recovery.md）以及卸载与断开（references/uninstall-and-disconnect.md）。

本 Skill 在执行普通公开命令时，会静默检查更新，每 24 小时最多一次。发现更高版本时，会在不另行确认的情况下自动安装。更新只来自固定的 Beatra 官方发现地址和不可变 CDN 路径，并严格匹配内置的包、渠道和语言身份。替换前，客户端会校验发现文档、压缩包、清单和每个包内文件的身份、大小与 SHA-256。它只替换当前安装中本包拥有的文件。如果检查、下载、替换或回滚任一步骤失败，当前安装仍可使用，用户原本请求的命令也会继续执行。英文官方安装始终保持 canonical/en，SkillHub 中文安装始终保持 skillhub/zh-CN。

以下设置对当前安装持续生效：

python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check

官方来源、完整性保证、替换范围、失败行为与控制方式参见自动更新与安全（references/automatic-updates-and-safety.md）。