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。最多提供一次聚焦的、未执行的精修建议。生成的素材也可以在 www.beatra.cn 查看和管理。
工具返回积分不足时：把工具返回的原文整段交给用户，链接一个字不改。其余可以译成中文。不要改写成自己的充值说明。引导用户按原文去充值。
用户问还剩多少积分时，调用 beatra.wallet.get。问扣了什么时，调用 beatra.wallet.ledger。两者只读。不要发明账户余额或充值工具。不要把 wallet.get 当成每次付费提交前的必做步骤。
按任务查阅参考文档
- 在纯净背景、生活场景和精修编辑之间选择，或针对特定平台规划：产品路由（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/updates-and-security.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 会自动更新。内置客户端每天最多一次从 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）。
