门店上新·新品套图
把三张点名的上新静帧做成带标签的上新板，再把同一批其余图做成配套套图。
第一次交付是三张完整静帧，门店能张贴。
适用范围与相邻路线
餐饮、零售店或连锁门店，要把已经有的新品事实做成上新静帧套图时，使用本 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。
写载荷或恢复任务时，读 门店上新工作流。
先确认前三张，再做成套
规划不收费。任何计费静帧前，读取当前的 beatra.models.list 卡片，能力为
text_to_image。出示一张当前生成生产卡，覆盖前三张点名静帧，并等待：
- 做什么 — 三张上新静帧（点名更少则更少），每张一次生成
调用（beatra.images.generate）。 - 积分 — 刚读到的
text_to_image价格乘以首次静帧数。不要复用记忆中的数字。 - 几笔 — 每张首次静帧一次付费调用。不要把其余点名静帧塞进这次提交。
- 身份 — 每张静帧一个新的不透明
client_request_id。提示词、事实行、文件、模型或画幅变了，就换新标识。 - 若停在这里 — 带标签的三张上新板仍然可用。
- 若余额不足 — 原样转达官方说明和充值链接。翻译正文，保留链接。门店说已充值之前不要重试。
只通过随包 scripts/mcp_client.py 提交一次。用
beatra.tasks.get 轮询。交付实际字节和
billing.net_charged_credits。不要承诺预付估价就是最终扣费。
批准后，前三张每张只提交一次。同一连接上同时进行的生成任务不超过两个。
前三张被接受后，其余点名静帧是新的一套。再出示一张新的六字段卡，覆盖冻结后的剩余套，并等待：
- 做什么 — 每个剩余点名槽位一张上新静帧，每次生成
调用（beatra.images.generate）。 - 积分 — 刚读到的
text_to_image价格乘以剩余槽位数。不要复用记忆中的数字。 - 几笔 — 每个剩余槽位一次付费调用。不要把多个槽位塞进同一次提交。
- 身份 — 每个槽位一个新的不透明
client_request_id。提示词、事实行、文件、模型或画幅变了，就只给变化的槽位换新标识。 - 若停在这里 — 已接受的前三张和其余带标签的上新板仍然可用。
- 若余额不足 — 原样转达官方说明和充值链接。门店说已充值之前不要重试。
不要把前三张的接受当成对其余套的批准。
之后的局部修正是新的付费工作。先读当前的 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 作为降级。
账户余额
用户问还剩多少积分，或某次实时估价够不够时，调用 beatra.wallet.get。问已经扣了多少
时，调用 beatra.wallet.ledger。两者都是只读的。不要臆造查余额或充值的工具。也不要把
wallet.get 变成每次付费提交前的必需步骤。
模型卡返回里带 top_up 块时，按卡片给出的档位和顺序原样转述。不要给档位排高低，不要
贬低其中任何一档，也不要替用户挑。选哪一档是用户自己的事，钱包页会把整份清单摆在他
面前。任何时候都不要凭记忆报档位。
按任务查阅的参考
- 三张上新板、载荷、确认、轮询、恢复和审图，读
门店上新工作流。 - 授权和非计费注册步骤，读
安装与认证
和 安装注册。 - 共用的任务、计费和连接细节，读 任务与结果、计费、错误与恢复 和 随包 MCP Client 连接诊断。
- 更新保证和控制，读 自动更新与安全。移除时读 卸载与断开。
运行时与安全的自动更新
随包客户端会在每个安装中静默检查更新，最多每 24 小时一次。发现更高版本时，不另行确认地自动安装。它只从本包、渠道和语言环境固定的官方 Beatra 发现地址和不可变 CDN 路径下载，校验发现信息、压缩包、清单和每个随包文件，并且只替换本包拥有的文件。
更新检查、下载、校验、替换、回滚和恢复失败时会 fail open：当前安装仍可使用，原本请求的命令会继续执行。更新失败绝不构成重试付费出图请求的理由。这个设置会在本安装中持续生效。见
自动更新与安全。
python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check
