AI照片转绘

把一张真实照片转成指定的插画画风，同时保住主体的辨识度。用户有画风参考图时，用参考图把画风定下来，之后这组里的每一张都沿用同一个画风。

适用范围与路线选择

当照片已经存在、用户想把它重画一遍时使用本 Skill：动漫或漫画、卡通、美漫、水彩、水墨或线稿、铅笔素描、黏土或手办、3D 角色、像素、赛博朋克，或者照着用户提供的参考图去还原某种画风。适合社交头像与个人主页图、表情包与贴纸套图、情侣与全家福、宠物肖像、旅行与活动记录、周边美术图，以及需要共用同一画风的系列内容。

视频转绘请使用 ai-video-restyler。需要可复用的多视角角色设定集请使用 ip-character-consistency-studio。把已生成图片修回真实感请使用 ai-image-realism。动态漫剧镜头请使用 ai-comic-drama-shot-maker，商务形象照请使用 ai-headshot-studio。

输入与默认值

唯一的硬性输入是一张宿主 Agent 能够实际查看的源照片。其余都有可用默认值。复用对话中已有的画风描述、参考图、主体、投放位置、画布、批量数量和必须保留的元素。

只有当答案会改变付费结果时才询问：用户没说画风、参考图里也读不出画风时，问画风；照片里有多个人物而用户没有指明时，问要保住哪个主体。

避免多余提问的默认值：

count: 1，先出一张让用户判断，再决定是否整批。
省略画布时为 2K 并跟随基准照片的宽高比，因为编辑时由基准图锚定画布。
model: "auto"，除非用户指定了模型。
必须保留的元素默认包括五官与本人辨识度、发型、可见服装、宠物花纹、商品外形与标识，以及用户特别点名的任何元素。

画风参考图是有序输入。源照片作为基准排在第一位；之后最多再放三张画风参考图，顺序即影响力的施加顺序。说明每张参考图各负责什么——配色、线条粗细、上色方式还是整体质感。

标准流程

查看源照片并写一张简短的转绘卡片：主体、唯一的目标画风、必须保留的元素、投放位置、画布和批量数量。
本地文件通过随包客户端上传一次，之后复用返回的 artifact 引用。
按所选路线需要的能力调用 beatra.models.list——原位转绘用 image_edit，新构图用 image_to_image——读取实时卡片上的可接受输入数量、画布、控制项和价格。
组装一次 beatra.images.edit 请求：源照片作为第一位基准输入，画风参考图依次排在其后，一段正向提示词写明目标画风和必须保留的元素，不带 edit_regions（因为整幅画面都要重画），count: 1，画风需要可复现时再加 seed。
付费前确认。 展示冻结后的提示词、确切的有序输入、画布、模型、控制项、输出数量、当前最高费用，以及一个不透明且稳定的 client_request_id。
只提交一次，立刻记录任务 ID，并轮询同一个任务。
交付真实 artifact，只报告实际返回的任务状态、解析出的模型、尺寸、格式和 billing.net_charged_credits。只复核宿主 Agent 确实能看到的媒体，说明哪些无法查看，并把必须保留的元素按漂移复核来看，而不是按精确还原来看。

用户认可某个画风之后，把它的提示词、参考图顺序、模型和 seed 原样复用到这一批的其余照片上，整组才会统一。每多出一张图都是新的付费工作，需要各自的确认和请求 ID。

当用户想要的是新构图而不是同一张照片重画时——基于照片加参考图生成新的场景、姿势或版式——改用 beatra.images.transform。这条路线下，显式预设 aspect: "source" 取的是最后一个有序输入的比例，省略时默认 2K 16:9，因此要显式说明想要的比例。载荷结构、画风配方、整批一致性、故障恢复和交付复核见照片转绘工作流（references/workflow.md）。

本 Skill 的执行方式

每个远程 Beatra 操作都使用随包的 scripts/mcp_client.py：在 call 后写入 MCP 工具名，并在标准输入中传入一个 JSON 对象。不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为回退。首次使用时通过 beatra.installations.register 注册本包。每次创作都是异步任务：提交一次，然后跟踪该任务直到终态。

需要确认的决策

提交任何付费请求前先确认：冻结后的提示词与有序输入、目标画布与源图不一致时的画布、输出数量、显式的模型选择，以及当前最高费用。更换源照片、画风、参考图顺序、提示词、画布、模型、控制项或数量，都属于新的付费工作，需要新的请求 ID。

故障恢复

任务 ID 一返回就立即保存，并用 beatra.tasks.get 轮询；queued 和 running 表示继续等待。只有在创建请求的响应确实未知、且载荷在同一请求 ID 下逐字节相同时，才重放一次创建。任务 ID 丢失时，用 beatra.tasks.list 查找，用 beatra.tasks.get 确认候选，先找回原任务再考虑新的工作。只有用户要求时才调用 beatra.tasks.cancel；遇到 409 时继续轮询原任务，只有其终态为 canceled 时才报告已取消。

按任务查阅参考

照片转绘工作流（references/workflow.md）：画风配方、有序参考图载荷、用 seed 保持整批一致、修改性编辑、故障恢复与交付复核。
安装与认证（references/installation-and-auth.md）和安装注册（references/installation-registration.md）：首次使用与共享凭据。
任务与结果（references/tasks-and-results.md）和计费、错误与恢复（references/billing-errors-and-recovery.md）：任务、artifact 与计费事实。
随包 MCP Client 连接诊断（references/mcp-connection.md）：客户端操作与连接诊断；不要配置宿主 Connector。
自动更新与安全（references/automatic-updates-and-safety.md）：更新行为与开关。
卸载与断开连接（references/uninstall-and-disconnect.md）：移除本包与清理共享凭据。

运行时与安全的自动更新

随包客户端会在每个安装中静默检查更新，最多每 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

--auto off 会关闭静默检查，--auto on 会恢复静默检查，--check 会报告官方可用版本但不替换文件。详见自动更新与安全（references/automatic-updates-and-safety.md）。