AI形象照工作室
将一张日常自拍、一个行业风格或已认可的草稿转化为影棚级专业形象照或人像。复用对话中已经明确的决定，沿最短路径完成用户需要的形象照。
选择制作路线
- 自拍变专业形象照: 有一张自拍照片时，指定职业风格和行业——企业、科技、创意、学术、医疗或创业——获得一张精致的专业形象照，搭配全新背景、职业着装和影棚光效，使用
beatra.images.transform。有源自拍时这是默认选择。 - 搭配背景参考变换: 用户同时提供自拍和期望的背景或场景时，使用
beatra.images.transform，把自拍作为images[0]，背景参考作为images[1]，将人物放入指定职业场景，同时保持身份特征。 - 精修已认可形象照: 使用
beatra.images.edit，把已认可的形象照作为images[0]，调整光效、背景、表情或着装，不改变人物身份和整体构图。
精确路线参见形象照路由（references/headshot-routing.md），把需求转化为专业形象照规格时参见人像工艺（references/portrait-craft.md）。
形成一份形象照简报
复用用户已经给出的职业背景、目标平台、风格偏好和视觉参考。只有缺失决定会实质改变结果时才询问。标准专业形象照优先建议方形 1:1 画布，搭配影棚光效、干净背景和人物居中的头肩构图。
简报围绕以下内容展开：
- 职业背景和行业——企业、科技、创意、学术、医疗、创业或自定义方向；
- 目标平台和用途——LinkedIn 主页、简历、公司官网团队页、商务名片或社交媒体；
- 一个风格方向——企业正装、现代商务休闲、创意艺术、干净学院风或医疗临床风；
- 背景偏好——纯白、柔和灰、深蓝渐变、现代办公、户外或影棚背景；
- 输出格式——方形适用于 LinkedIn 和社交媒体头像，竖版适用于简历和印刷；
- 有序视觉参考（自拍始终在第一位，背景或风格参考在后）。
用户已经说明行业或风格时直接复用。确实缺少这项决定时，给出最合适的默认建议，并把它合并进一次付费调用确认。
准备调用
所有远程 MCP 操作只能使用本 Skill 随包 scripts/mcp_client.py。工具名称作为 CLI 参数，工具参数以 JSON 通过标准输入传入。不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为回退。精确命令和排错参见随包 MCP Client 连接诊断（references/mcp-connection.md）。
- 先通过随包客户端辅助命令上传源自拍，再调用
beatra.images.transform，把上传的 artifact 作为第一个有序参考。在 prompt 中显式标注人物的身份特征，确保模型保持面部特征、肤色和发型不变。 - 搭配背景参考变换时，把背景图作为第二个有序参考上传，标注其仅为背景或场景参考。
- 精修已认可形象照时，调用
beatra.images.edit。局部修改最多使用两个归一化edit_regions，指定image_index=0；全图调整则省略区域。
上传只让远程工具取得文件字节，本身不等于图片检查。只复查宿主确实能够看到的视觉事实。
除非用户明确选择其他设置，否则保持 model=auto 和 count=1。只有模型、可用性、兼容性或价格确实影响决定时才调用 beatra.models.list。完整请求结构与示例参见工作流（references/workflow.md）。
确认并只执行一次
策划和简报准备免费。付费图片调用前，展示并固定最终提示词、有序参考图、画布、风格方向、背景、光效、模型、控制项和输出数量。仍然缺失的高影响决定应合并到这一次确认中。
获得确认后，为这一个精确的逻辑请求创建一个稳定且不透明的 client_request_id，并只提交一次。提示词、参考图或顺序、画布、风格方向、背景、模型、数量或控制项任一变化，都是新的付费工作，需要新的确认和新标识符。
跟进、复查与交付
收到 task_id 后，只用 beatra.tasks.get 轮询该任务。如果标识符丢失，使用 beatra.tasks.list 查找候选并用 tasks.get 验证选中项。只有原始响应状态确实未知时，才能用完全相同的参数和同一个 client_request_id 进行幂等恢复。轮询缓慢、更新失败、授权失败或连接失败都不能创建替代性付费任务。
只有在用户主动要求时才使用 beatra.tasks.cancel。取消返回 409 时，继续跟踪原任务。完整恢复合同参见复查与恢复（references/review-and-recovery.md）。
结果可见时，依次复查身份一致性（人物面部与源自拍相比是否可辨认？）、职业形象（着装、仪容和表情是否适合该行业？）、背景质量（背景是否干净专业？）、光效（光线是否自然均匀、焦点是否在眼睛上？）和画布适配（输出比例是否符合目标平台？）。交付 artifact 链接、实际尺寸、任务标识符和 billing.net_charged_credits。最多提供一次聚焦的、未执行的精修建议。生成的素材也可以在 www.beatra.cn 查看和管理。
工具返回积分不足时：把工具返回的原文整段交给用户，链接一个字不改。其余可以译成中文。不要改写成自己的充值说明。引导用户按原文去充值。
用户问还剩多少积分时，调用 beatra.wallet.get。问扣了什么时，调用 beatra.wallet.ledger。两者只读。不要发明账户余额或充值工具。不要把 wallet.get 当成每次付费提交前的必做步骤。
按任务查阅参考文档
- 在自拍变换、背景参考变换和形象照精修之间选择，或针对特定行业风格规划：形象照路由（references/headshot-routing.md）
- 把需求转化为包含光效、背景、着装和身份保持规则的专业形象照规格：人像工艺（references/portrait-craft.md）
- 每条路由的精确请求结构、有序参考标注和 JSON 示例：工作流（references/workflow.md）
- 遗失任务、轮询缓慢、取消、结果复查或规划精修：复查与恢复（references/review-and-recovery.md）
- 首次安装或认证过期：安装与认证（references/installation-and-auth.md）
- 随包 MCP Client 命令与诊断：随包 MCP Client 连接诊断（references/mcp-connection.md）
- 安装注册：安装注册（references/installation-registration.md）
- 任务查询、轮询与结果字段：任务与结果（references/tasks-and-results.md）
- 余额、校验与结构化错误：计费、错误与恢复（references/billing-errors-and-recovery.md）
- 断开安装连接：卸载与断开（references/uninstall-and-disconnect.md）
- 更新与安全：更新与安全（references/updates-and-security.md）
安装与账号操作
首次使用和共享操作参见安装与认证（references/installation-and-auth.md）、安装注册（references/installation-registration.md）、任务与结果（references/tasks-and-results.md）、计费、错误与恢复（references/billing-errors-and-recovery.md）以及卸载与断开（references/uninstall-and-disconnect.md）。
更新与安全
本 Skill 会自动更新。内置客户端每天最多一次从 Beatra 官网读取本渠道的版本信息
（中国大陆网络走 www.beatra.cn 与 cdn.beatra.cn）。有新版本时，它下载官方发布包，
逐个文件校验 SHA-256，再替换本 Skill 自己的文件；你放进这个目录的其他文件不会被
改动。替换过程中断时，下次运行会自动恢复到替换前的状态。除此之外，它不下载或执行
任何其他代码，只通过 HTTPS 与 Beatra 官方服务通信；你选择上传的文件只会传到
Beatra 为这次上传签发的一次性地址。
关闭自动更新：python3 scripts/mcp_client.py update --auto off。关闭后，客户端每天
最多提示一次在你安装它的商店里更新的命令。详见更新与安全（references/updates-and-security.md）。
