【用途】 该技能用于替换已有视频中的人物。它不会重拍或生成新场景，而是让新人物接管原人物的位置、姿态、动作、表情与构图；场景、机位、剪辑、其他人物、字幕和配乐保持不变。适合“把我放进这个片段”、换角、换脸、用自有 Character 做趋势视频等需求。
【与其他技能的分工】 若想让 Character 在新场景中复刻一段已录制的表演，或让同一动作换装换地点，应使用 creativeclaw-generate-video 的 Kling Motion Control Pro 动作迁移；若需为替换后的视频配新对白或配音，先完成替换，再使用 creativeclaw-generate-voiceover 与口型同步；若只需剪辑、裁剪、改画幅或拼接，使用 creativeclaw-edit-media。仅替换人物身份而保留原服装时，在指令中写明“保留原服装”。
【前置条件】 需已连接 Creative Claw 工具（如 list_models、generate_image 等可用）。若未连接，在 Claude 中打开 Creative Claw 插件页，进入 Connectors 标签，点击 Connect；如弹出“Add custom connector”对话框则点击 Add 并登录；在 Claude Code 中改用 /mcp。连接后再发起请求，不要用其他工具替代，也不要描述未实际生成的结果。
【使用方式】
- 视频：video_url 必须是至少 4 秒的直链视频文件。TikTok、Instagram、YouTube、X 等社交链接需先用 upload_asset({ url }) 导入，再使用 check_job 返回的 URL；本地文件通过上传选择器（import_media）导入。仅替换前 30 秒，超出时卡片会提示已截断；更长视频需切成不超过 30 秒的片段分别替换。
- 新人物：优先使用已保存的 Character，先用 list_characters 获取，再传 character_ids；普通照片导入后用 image_urls。身份取自 Character 的设定图，正面清晰、露出头发为佳；缺头顶可能导致发型错误，描述人物外形的 Character 描述比描述声音更有帮助。
- 指令：有多人或多个参考时必填。每次替换一行，按位置和外观指认原人物、按名称指认 Character，例如“左边穿黑色上衣的女性换成 Savta Rivka。右边穿深色西装的男性换成 Itay。”并注明必须保持不变的人。默认新人物从头到脚替换为参考中的脸、头发、身体和服装；只换人时需写明“保留原服装”。
- 启动：调用 swap_video_characters，传入 video_url、character_ids 或 image_urls 以及 instructions。分辨率默认 480p 草稿，除非用户明确要求 720p 或 1080p。仅在用户希望即便账户为 Auto 模式也要检查预览时传 review: true。不要为同一次替换再调用 generate_video。
- 预览：系统会选取每个目标人脸清晰的三个帧，免费展示新人物效果。若某帧只包含部分人物，则只显示对应该人物的 Character。检查身份、发型、服装、位置以及人物是否像实拍而非贴上去的。
- 调整预览（免费）：在卡片中点击“Adjust this preview”，或调用 update_video_workflow({ session_id, preview_index, changes, expected_version })，版本号取自最新结果。修改需具体，如“他本人的深色短发，不是卷发”“穿参考里的白色 T 恤”“匹配暖光和运动模糊”。调整后工作流会再次等待批准。
- 渲染：Review 模式下卡片显示价格并等待用户点击 Generate video；若卡片未显示，把审核链接（approvalUrl）给用户，切勿自行打开或替用户批准。Auto 模式下预览就绪后自动开始渲染。480p 草稿之后可在卡片上升级为 1080p，结果会同时列出两个价格。
- 状态：会话 ID 即任务 ID，check_job({ job_id: <session ID> }) 返回状态、预览和成片。卡片显示进度时不要轮询。
【常见问题】 提示“无法自信识别源人物”：帧选择器无法确定人物对应关系，需按每人一行写明位置和外观、每人对应一个 Character 重新开始。提示“无法从视频中选取帧”或其他“替换已停止”消息：任务已停止且未计费，用 check_job 检查输入后重新发起修正后的替换。预览发型错误、仍穿原衣或看起来像贴图：对该预览免费调整并给出具体修改；反复出现的发型问题通常源自 Character 设定图，换更好的设定图可改善后续所有替换。目标人脸在每帧中都过小、被裁切或背对镜头：无法展示身份，需改用目标人脸至少清晰出现一次的片段。只替换了其中一人：确认预览中两人都在、指令中两人都写明，然后重新渲染（新的付费渲染）。渲染因服务商内容规则被拦截（如受版权保护的音频）：不扣积分，原样重试大概率仍被拦截，可换无受保护配乐的片段。片段超过 30 秒：仅前 30 秒被替换，需分段处理。失败、退款或未用预算不构成再次付费渲染的授权；调整预览免费，新渲染需用户同意或按下 Generate video。
【替换后的声音】 替换会保留原声轨。若要让克隆声音的替换人物听起来也像其 Character：先用 isolate_audio 分离片段语音，再用 generate_speech（speech/cartesia-voice-changer，语音放在 extras.audio_url，传 Character 的 character_id，不带文本）修改，最后用 add_audio_to_video 放回。新台词则用 creativeclaw-generate-voiceover 并在成片上做口型同步。
【限制】 仅能替换已同意者（用户本人、获得许可的人）或虚构角色。视频须为至少 4 秒的直链文件，仅处理前 30 秒。分辨率默认 480p 草稿。内容受服务商规则约束。工具调用可附带 skills_used 数组（含 creativeclaw-swap-characters、实际遵循的其他 Creative Claw 技能，以及 <skill-name>/<relative-guide-path> 形式的指南条目）以注明所用技能与指南；用户拒绝追踪或字段不可用时省略，切勿发送其他插件名、隐私数据或本地路径。整个流程使用用户的语言进行。