门店上新·新品套图

把三张点名的上新静帧做成带标签的上新板，再把同一批其余图做成配套套图。第一次交付是三张完整静帧，门店能张贴。

适用范围与相邻路线

餐饮、零售店或连锁门店，要把已经有的新品事实做成上新静帧套图时，使用本 Skill：列表静帧、店内上新海报，或配套上新板。

补货口播转到 restock-drop-talking。新品口播预告转到 creator-drop-talking。单 SKU 电商上架套图转到 ecommerce-listing-image-set。不要给静帧做动画，也不要做说话人头片。

收集新品

硬输入是：

门店或品牌；
点名的新品；
静帧要印上的语言。

复用已知投放位置、配色和必须保留项。只补问缺失的硬输入。不要编造成分、价格或宣称来凑静帧。

整套静帧也可以。第一次付费仍只做三张点名静帧。其余图等前三张被接受后再做。

商品照片是视觉参考，不是缺失成分、价格或宣称的来源。拿到文件不等于同意。查看每张可选静帧。记录 MIME 类型、宽、高、画幅、字节大小和是否有 alpha 通道。本地文件检查后，只通过随包客户端上传（scripts/mcp_client.py / beatra.assets.upload）。保留返回的产物编号。绝不要把本地路径传给 beatra.images.generate 或 beatra.images.edit。

若要标准套图且尚未给静帧编号，按已有事实规划四个点名视觉角色：列表静帧、店内海报、主推静帧，以及一张额外的列表或海报静帧。点名套图通常四张或以上。事实缺失的印刷行就省略，并在规划里保留这个缺口。

整套保持同一字体、配色和版式，让静帧读成一批上新。

先做免费三张上新板

任何付费出图前，先写带标签的三张上新板。前三张点名静帧每张记下印刷行、语言、版式、画幅，以及可选参考图的角色。其余点名静帧留在同一规划上，作为后续套图。这份上新板就是免费可见结果。规划不是批准。

安全默认：

每张静帧一次 beatra.images.generate 调用；
model: "auto" 且 count: 1；
列表画幅 {"type":"preset","tier":"2K","aspect":"1:1"}。只有投放面需要别的比例才改画幅：小红书用 3:4，故事用 9:16；
仅在门店接受某张静帧并要求局部修正时使用 beatra.images.edit，把已接受的图放在 images[0]。

设定具体模型、画幅、出图数量或价格前，读取当前的 beatra.models.list 卡片，能力为 text_to_image。

写载荷或恢复任务时，读门店上新工作流（references/workflow.md）。

先确认前三张，再做成套

规划不收费。任何计费静帧前，读取当前的 beatra.models.list 卡片，能力为 text_to_image。出示一张当前生成生产卡，覆盖前三张点名静帧，并等待：

做什么 — 三张上新静帧（点名更少则更少），每张一次生成调用（beatra.images.generate）。
积分 — 刚读到的 text_to_image 价格乘以首次静帧数。不要复用记忆中的数字。
几笔 — 每张首次静帧一次付费调用。不要把其余点名静帧塞进这次提交。
身份 — 每张静帧一个新的不透明 client_request_id。提示词、事实行、文件、模型或画幅变了，就换新标识。
若停在这里 — 带标签的三张上新板仍然可用。
若余额不足 — 原样转达官方说明和充值链接（https://console.beatra.ai/wallet?intent=buy）。翻译正文，保留链接。门店说已充值之前不要重试。不要推荐 ¥198。

只通过随包 scripts/mcp_client.py 提交一次。用 beatra.tasks.get 轮询。交付实际字节和 billing.net_charged_credits。不要承诺预付估价就是最终扣费。

批准后，前三张每张只提交一次。同一连接上同时进行的生成任务不超过两个。

前三张被接受后，其余点名静帧是新的一套。再出示一张新的六字段卡，覆盖冻结后的剩余套，并等待：

做什么 — 每个剩余点名槽位一张上新静帧，每次生成调用（beatra.images.generate）。
积分 — 刚读到的 text_to_image 价格乘以剩余槽位数。不要复用记忆中的数字。
几笔 — 每个剩余槽位一次付费调用。不要把多个槽位塞进同一次提交。
身份 — 每个槽位一个新的不透明 client_request_id。提示词、事实行、文件、模型或画幅变了，就只给变化的槽位换新标识。
若停在这里 — 已接受的前三张和其余带标签的上新板仍然可用。
若余额不足 — 原样转达官方说明和 https://console.beatra.ai/wallet?intent=buy。门店说已充值之前不要重试。不要推荐 ¥198。

不要把前三张的接受当成对其余套的批准。

之后的局部修正是新的付费工作。先读当前的 image_edit 卡片：

{"capability": "image_edit"}

另出示一张六字段修正卡。把已接受的静帧放在 images[0]，并用新的 client_request_id。

审图、交付与恢复

对照已确认事实表核对印刷行。只报告宿主实际看得见的文字。把生成的小字当作审阅项，不当作认证菜单、价格或成分标签。

按点名顺序交付静帧、带标签的三张上新板、观察到的尺寸和格式、任务标识、解析后的模型，以及返回的 billing.net_charged_credits。

拿到 task_id 后轮询该任务。创建响应丢失时，先用 beatra.tasks.list 搜索，再用 beatra.tasks.get 核对，然后再重放。只有参数逐字节相同才能复用原标识。只有门店要求时才取消。

执行

每个远程 Beatra 操作都只通过本包随附的 scripts/mcp_client.py 调用。把 MCP 工具名放在 call 后面，并向标准输入发送一个 JSON 对象。

python3 scripts/mcp_client.py call beatra.models.list

{"capability": "text_to_image"}

python3 scripts/mcp_client.py call beatra.models.list

{"capability": "image_edit"}

printf '%s' '{"prompt":"Create the approved store new-item still. Print only the confirmed item name and approved lines. Keep the shared pack look.","model":"auto","count":1,"canvas":{"type":"preset","tier":"2K","aspect":"1:1"},"client_request_id":"opaque-store-launch-01"}' | python3 scripts/mcp_client.py call beatra.images.generate

不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为降级。

按任务查阅的参考

三张上新板、载荷、确认、轮询、恢复和审图，读门店上新工作流（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 路径下载，校验发现信息、压缩包、清单和每个随包文件，并且只替换本包拥有的文件。

更新检查、下载、校验、替换、回滚和恢复失败时会 fail open：当前安装仍可使用，原本请求的命令会继续执行。更新失败绝不构成重试付费出图请求的理由。这个设置会在本安装中持续生效。见自动更新与安全（references/automatic-updates-and-safety.md）。

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