shield_lock
JinDaGe
← Back to skills
extension
Category: Marketing & GrowthNo API key required

SKU对比图·规格表

按卖家提供的规格，做成SKU对比图，一组规格表和对比静帧。

personAuthor: beatra01hubOpenAPI
open_in_newRepositorydownloadDownload package

SKU对比图·规格表

按卖家提供的规格，为每个点名的对比轴做成一张对比静帧。交付 4 到 8 张。每张各自成文件。

适用范围与相邻路线

商品页需要按卖家已经写好的规格行做对比静帧时，使用本 Skill。

通用电商套图转到 ecommerce-listing-image-set。Shopify 商品页主题套图转到 shopify-pdp-set。亚马逊 A+ 卖点模块转到 amazon-a-plus-module-pack。不要到公开帖子或店铺目录里补缺失规格。

收集已确认事实

硬输入是：

  • 至少两个点名的 SKU；
  • 将出现在图上、由卖家提供的规格行（尺寸、材质、重量，或其他卖家已经写好的事实）；
  • 这套要几张，或允许使用默认 4 张。

复用对话里已有的品牌配色、投放位置、语言和必须保留项。只补问缺失的硬输入。4 到 8 以外的数量也能做：确认该规模和实时费用。

不要编造尺寸、价格、评分或认证。商品照片是视觉参考，不是缺失规格的来源。拿到文件不等于同意。

查看每张可选静帧。记录 MIME 类型、宽、高、画幅、字节大小和是否有 alpha 通道。本地文件检查后，只通过随包客户端上传 （scripts/mcp_client.py / beatra.assets.upload）。保留返回的产物编号。绝不要把本地路径传给 beatra.images.generate 或 beatra.images.edit。

默认每个点名的对比轴一张静帧。卖家要一套标准对比又没有点轴数时，用已经给出的事实最多排四个角色：总表、尺寸、材质、用法。缺事实的对比轴写在计划里。

整套共用同一套字体、配色和列顺序，让静帧读起来像同一组对比。

先做免费对比清单

任何付费出图前，先写带标签的对比清单。卖家没有另报 4 到 8 之间的数量时，默认四个对比轴。每条记下 SKU、由已提供规格写出的印刷行、视觉角色、语言、画幅，以及可选参考图的角色。

这份清单就是免费可见结果。规划不是批准。

安全默认：

  • 每个对比轴一次 beatra.images.generate；
  • model: "auto"，count: 1；
  • 画幅 {"type":"preset","tier":"2K","aspect":"1:1"}，除非卖家点名了别的上架版位；
  • 仅在卖家接受某张静帧并要求局部修正时使用 beatra.images.edit，把已接受的图放在 images[0]。

确认一次，按对比轴出图

规划不收费。第一笔计费调用前，读取 beatra.models.list，能力为 text_to_image：

{"capability": "text_to_image"}

出示一张当前生产卡并等待：

  1. 做什么 — 每个点名的对比轴一张 SKU 对比静帧 （beatra.images.generate）。
  2. 积分 — 刚读到的 text_to_image 价格乘以对比轴数。不要复用记忆中的数字。
  3. 几笔 — 每张静帧一次付费调用。不要把多个对比轴塞进同一个 count。
  4. 身份 — 每张静帧一个新的不透明 client_request_id。
  5. 若停在这里 — 带标签的对比清单仍然可用。
  6. 若余额不足 — 原样转达官方说明和充值链接 （https://console.beatra.ai/wallet?intent=buy）。翻译正文，保留链接。卖家说已充值之前不要重试。不要推荐 ¥198。

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

批准后每个对比轴只提交一次。同一连接上同时进行的生成任务不超过两个。

之后的局部修正是新的付费工作。先读当前的 image_edit 卡片。另出示一张六字段修正卡。使用新的 client_request_id。

审图、交付与恢复

对照已确认规格表核对印刷行。只报告宿主实际看得见的文字。把生成的小字当作审阅项，不当作认证规格表。

按对比轴顺序交付静帧、对比清单、观察到的尺寸和格式、任务标识、解析后的模型，以及返回的 billing.net_charged_credits。

拿到 task_id 后轮询该任务。创建响应丢失时，先用 beatra.tasks.list 搜索，再用 beatra.tasks.get 核对，然后再重放。只有参数逐字节相同才能复用原标识。SKU、规格行、画幅、模型或提示词变了就是新卡和新标识。只有卖家要求时才取消。

执行

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

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

{"capability": "text_to_image"}

printf '%s' '{"prompt":"Create the approved SKU comparison still for the named axis. Show only the confirmed SKUs and spec rows. Keep the shared comparison look.","model":"auto","count":1,"canvas":{"type":"preset","tier":"2K","aspect":"1:1"},"client_request_id":"opaque-sku-compare-01"}' | python3 scripts/mcp_client.py call beatra.images.generate

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

按任务查阅的参考

  • 规格清单、载荷、确认、轮询、恢复和审图，读 SKU comparison workflow（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