封面优化预检

上传已有的视频缩略图、社交封面、文章首图或播客封面，先获得一份可执行的发布前检查，再按批准方向制作两到三版用于对比的候选。诊断覆盖视觉钩子、焦点层级、标题与画面匹配、文字安全区、手机缩略图可读性与裁切适配；不承诺未经真实投放验证的点击率结果。

所有上传和远程操作只使用随包客户端；不得配置或调用宿主 Beatra Connector，也不得使用 REST/OpenAPI 降级或回退。单一微信封面可转交 wechat-cover-maker，小红书封面可转交 rednote-cover-maker，海报设计可转交 poster-design-studio。所有远程操作仅经随包 scripts/mcp_client.py 完成。

先做发布前检查

收集现有封面、标题或核心信息、目标渠道、受众、现有品牌元素与不得改变的人物、产品、标识和颜色。给出简洁检查卡：钩子和焦点、文字可读性、标题匹配、裁切与安全区、移动端缩略图，以及优先级最高的修改建议。让用户从不同方向中选择一个，再开始候选制作。

可选：读同题材基线

检查卡本身只是对一张封面的判断，旁边没有任何可对照的东西。当前连接开放了 Beatra 公开社交查询时，本包可以去读同题材已经在跑的东西：YouTube、TikTok、抖音、小红书上这个话题的一页搜索结果——标题和公开数据；封面图本身只有 YouTube 能取到，另外三个平台没有任何白名单操作会返回图片。同样只有 YouTube 能读用户自己频道近期的一页作品，先把频道链接解析成 ID 再读。白名单只有这七个操作，不要为了补上缺口去够名单之外的操作。

这一步可选、付费，并且在运行之前单独确认一次，不并进下面那次图片确认——它落在本包承诺免费的窗口里，并进去就等于在免费区间里收了费。每一页搜索、每一张封面图各算一次计费，说清一共几次再跑；不跑也照常交付检查卡。

同一句「看看同题材还有什么」在抖音和小红书上比在 TikTok 上贵十倍，YouTube 居中。不要只报一个价——每一次都读实时价格，报它返回的那个数。判定的依据是白名单本身，不是一份例外清单：平台上没有白名单里的操作，就没有基线。 公众号文章封面、视频号封面、B站封面、播客封面都属于这一类，而且不止这些。就直说这类封面没有基线可读，绝不拿别的平台的数据顶替。

查询返回的是数字、标题和链接，不等于你看过那张图。 拿到封面图链接而宿主打不开时，就说找到了但没看到，基线只保留确实返回的标题和数据。看到的数字属于别人的作品，用来说明这张封面要进入的是什么场子，不构成对它自己表现的任何预测——本包依然不给点击率预测、不给分数、不做承诺。查完之后照样要报账：返回的载荷、任务 ID、终态和这次实际扣掉的积分——查询没有模型、尺寸和时长可报，但它确实收了费。创建响应丢了，先照图片那条路一样把任务列出来、把对上的那条查清楚，然后才用同一个请求标识重放逐字节相同的参数，那才算一次预付查询；换任何一个参数（包括翻页）都是新的付费工作，要新的标识和新的确认。完整路线、取参数的办法和确认话术见同题材基线（references/baseline-lookup.md）。

制作两到三版候选

用户批准后，使用 beatra.images.transform 制作不同但可比较的候选，数量为 count: 2 或 count: 3。已有封面只需要局部修正时，使用 beatra.images.edit，把原图放在 images[0]；已知局部坐标时才使用 edit_regions。模型默认 model: "auto"，需要能力、画布、控制项或价格信息时查询 beatra.models.list。每项获批的逻辑请求使用新的稳定 client_request_id。

提交后立刻记录 task_id 并用 beatra.tasks.get 跟踪至终态。若标识丢失，先用 beatra.tasks.list 查找候选，再以 beatra.tasks.get 确认。仅在用户请求取消时处理；若取消返回 409，继续跟踪原任务。交付卡和候选时记录真实的 billing.net_charged_credits，并由用户做最终发布选择。

付费确认与恢复

检查和计划免费。唯一可能排在它们前面的付费调用是那次可选的同题材基线，而且只有在用户同意、并单独确认过它自己的价格之后才会发生。每个付费创建前展示精确提示、原封面、候选方向、画布、模型、数量和实时价格，并取得明确批准。缓慢任务仍是同一任务；创建响应丢失时，只能用逐字段相同的请求标识重放相同请求。任何封面、标题、候选方向、模型或画布变化都是新的付费请求，必须重新批准。

按任务查阅资料

• 随包客户端命令和诊断：随包 MCP Client 连接诊断（references/mcp-connection.md）
• 检查卡、候选方向、确认与恢复：封面预检工作流（references/workflow.md）
• 已有封面的局部修正与候选比较：封面预检工作流（references/workflow.md）
• 读同题材封面和公开数据、每次查询要花多少、结果如何标注来源：同题材基线（references/baseline-lookup.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）。