🫧 Flux Kontext Pro — Pro Pack on RunComfy

核心用法

Flux Kontext Pro 是 Black Forest Labs 推出的专用单图局部编辑模型，本 Skill 通过 RunComfy CLI 调用 blackforestlabs/flux-1-kontext/pro/edit 端点。核心输入为单张公开可访问的 HTTPS 图片 URL + 一句声明式编辑指令，支持 aspect_ratio 和 seed 参数控制输出。

典型调用流程：
1. 安装 RunComfy CLI (npm i -g @runcomfy/cli)
2. 认证登录 (runcomfy login 或设置 RUNCOMFY_TOKEN)
3. 执行编辑：runcomfy run blackforestlabs/flux-1-kontext/pro/edit --input '{"prompt":"...","image":"https://..."}'

Prompt 工程要点

• 前置保留指令：以 "Keep [identity/pose/framing] unchanged" 开头，再描述变更
• 单一变更原则：避免复合编辑（"改A并加B且删C"），拆分为顺序多轮
• 主动语态："She is now holding..." 优于被动表达
• 文本编辑：带引号的精确文本替换表现良好

显著优点

| 优势 | 说明 |

|------|------|

精准局部编辑 | 专为单图修改设计，高保真保留源图身份特征 |

| 强 Prompt 控制力 | 明确的保留-变更结构能被模型可靠执行 |

| 一致性输出 | 相同 seed 可复现变体，适合 A/B 对比 |

| 品牌资产友好 | 文本替换、色彩调整等商业场景表现稳定 |

局限性与风险

• 单图限制：不支持多参考图融合，该场景需转用 Nano Banana Edit
• 多语言文本：复杂嵌入式文字编辑弱于 GPT Image 2 edit
• 从零生成：无源图时需改用 Flux 2 Klein 文生图模式
• 复合编辑漂移：试图一次完成多处修改易导致整体失真

适合人群

• 电商/品牌运营：产品图局部修改（换标签、调颜色、加道具）
• 内容创作者：人像精修（加配饰、改表情、换背景元素）
• 设计迭代工作流：需要快速验证单图变体的场景

常规风险

• Token 安全：CLI 将凭证存于 ~/.config/runcomfy/token.json（0600 权限），CI 环境建议用 RUNCOMFY_TOKEN 环境变量替代
• URL 信任：输入图片 URL 由 RunComfy 服务端抓取，需确保来源可信，防范图像提示注入攻击
• 网络依赖：模型 API 调用需稳定连接，超时/限流会返回 exit 75 重试码
• 输出下载上限：CLI 限制单文件 2GiB，防止异常生成导致磁盘耗尽

核心用法

flux-kontext 是一个纯 Markdown 文档型技能，通过封装 RunComfy CLI 调用 Black Forest Labs 的 Flux 1 Kontext Pro 图像编辑模型。用户需先安装 @runcomfy/cli 并登录获取 API Token，随后即可通过 runcomfy run blackforestlabs/flux-1-kontext/pro/edit 执行编辑任务。

输入参数极简：单张图源 URL + 声明式编辑指令，可选 seed 用于复现变体、aspect_ratio 控制输出比例。技能内置官方推荐的提示词模式——以"保留 X 不变"开头锁定身份/构图，再用祈使句描述单一变更，可显著提升保真度和指令遵循率。

显著优点

• 精准局部编辑: 专为"单图+单指令"场景设计，在保持人物身份、姿态、光照不变的前提下完成目标修改，优于通用文生图模型的编辑稳定性。
• 提示词可控性强: 官方文档验证的"保留-变更"句式结构，降低漂移风险；迭代式小步修改策略进一步减少复合错误。
• 高保真输出: 对品牌资产、人物面部等需要严格一致性的场景表现出色，支持文本替换（需配合明确字体/位置描述）。
• 零代码依赖: 纯文档型技能，无可执行代码，无第三方依赖，部署简单。

潜在缺点与局限性

• 单图限制: 不支持多图源融合或 1-20 张批量编辑，此类需求需转向 Nano Banana Edit。
• 复合指令漂移: 单条提示包含多处变更时易产生意外结果，必须拆分为顺序单步执行。
• 多语言/嵌入文本编辑弱: 涉及复杂文字修改时，GPT Image 2 edit 通常表现更佳。
• 外部 CLI 依赖: 实际网络请求由 RunComfy CLI 处理，技能本身不直接控制超时、重试等行为，故障排查需查阅 CLI 文档。
• T3 来源维护: 由个人开发者维护，更新频率和长期支持存在不确定性。

适合人群

• 设计师、营销人员：需要快速迭代单张品牌素材或人物照片，保持视觉一致性。
• 内容创作者：对特定元素进行精准替换（如换装、加道具、改背景局部）而不破坏整体构图。
• 开发者：已在 RunComfy 生态内，希望通过 CLI 集成图像编辑到自动化工作流。

常规风险

• API Token 安全: Token 存储于 ~/.config/runcomfy/token.json（权限 0600），CI 环境建议使用 RUNCOMFY_TOKEN 环境变量避免文件泄露。
• 图像 URL 可信度: 输入图像由 RunComfy 服务器拉取，需确保 URL 来源可信，防范图像类提示词注入。
• 数据出境: 请求发送至 model-api.runcomfy.net，需确认符合组织数据合规要求。
• 输出不可预测性: 即使使用 seed，AI 编辑仍存在随机性，关键业务场景需人工复核。