电商主图合规预检

把一张已有商品主图整理为简明、可追溯的预检卡，并只完成一次经卖家确认的定点修图。适用于即将为一个 SKU 在指定站点、地区和类目上架的卖家。

需要重新拍摄、生活方式场景、多图套组或宽泛创意方向时，转交 product-photo-studio。本包只围绕已提交主图、上架要求与一项直接对应预检卡的修复工作。

收集上架信息

复用对话中已有的主图、站点、地区、类目和必须保留的商品细节。要求卖家提供当前主图、一个明确的目标上架位，以及标签、标识、颜色、形状和随附物等不可改变的信息；站点、地区或类目变化时，还应提供最新要求。缺少目标或类目时先问一个简短问题。若宿主无法看清图片，明确把卖家描述标为卖家陈述，而不是观察事实。

默认只处理一张图片、一个上架位、原始画布和一项修复；除非卖家明确发起新的付费工作，不制作第二版。

先制作预检卡

先做预检卡，再决定是否修图。卡片应包括：站点、地区、类目、图片位和要求来源；可见事实或卖家陈述；每条要求及其 ready、needs review 或 repair proposed 状态；最小的背景、边缘、杂物或构图修复；以及卖家上传前仍需核对的事项。最终上架决定始终以站点自身为准，不把预检卡表述成通用认证。

选择最小修复

保留原画布时使用 beatra.images.edit，将原图放在 images 的第一位；只写一个问题的修复提示。仅当卖家指明局部区域且坐标已知时使用 edit_regions。
需要干净背景或有意重构图时使用 beatra.images.transform，仍把当前主图作为第一张有序参考，并将所有必须保留的细节写入提示。

除非需要为特定模型、画布、受支持控制项或价格作决定，否则保持 count: 1 和 model: "auto"。需要时用 beatra.models.list 查询 capability: "image_edit" 或 capability: "image_to_image"。宿主看不清图片时，不猜测尺寸、像素、商品占比或平台规则。

确认、执行与复核

规划和预检卡免费。每次付费调用前，向卖家展示卡片、精确修复提示、底图、画布、模型、数量、所需的实时价格和不能改变的细节；一条明确的继续指令才批准这次冻结请求。

只使用随包 scripts/mcp_client.py 上传本地媒体并调用 MCP 工具，保存返回的产物 ID。工具名作为命令参数，JSON 通过标准输入传入。不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为降级或回退方案。

为获批的逻辑请求分配稳定且不透明的 client_request_id，只提交一次并立刻记录 task_id。用 beatra.tasks.get 轮询至终态。可见输出后，核对修复、受保护商品细节、画布适配和可实际观察到的卡片项；交付结果链接、真实尺寸、任务 ID、解析模型与 billing.net_charged_credits，只提出下一项建议而不自动执行。

不重复付费的恢复

将冻结请求、批准、client_request_id、创建响应和任务 ID 一起保留。queued 或 running 仍是同一项工作。创建响应丢失时，只能用相同标识重放完全相同的请求；任务 ID 丢失时，先以 beatra.tasks.list 找候选，再用 beatra.tasks.get 确认。改变图片、提示、画布、模型或修复内容就是新的付费请求，必须重新批准并使用新标识。

上传授权过期或媒体不匹配时取得新的上传授权；模型校验时刷新实时模型卡；余额不足时先请卖家处理余额再提交未改变的请求。仅按卖家要求取消；若 beatra.tasks.cancel 返回 409，继续跟踪原任务，不创建替代任务。

按任务查阅资料

制作预检卡、选择路径、冻结付费请求或恢复任务：主图预检工作流（references/workflow.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/automatic-updates-and-safety.md）
移除本包或共享凭据：卸载与断开连接（references/uninstall-and-disconnect.md）

运行时和安全自动更新

随包客户端在每个安装中静默检查更新，每 24 小时最多一次。发现更高版本时，会不另行确认自动安装。只从当前包、渠道和语言环境的固定官方发现地址与不可变 Beatra CDN 路径下载；替换前校验发现数据、压缩包、清单和每个文件，只替换本包拥有的文件。检查、下载、替换或回滚失败时，当前安装保持可用，用户原本请求的命令继续执行。更新失败绝不重试已付费的图片请求，设置会在本安装中持续生效。

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）。