🫧 Flux Kontext Pro — Pro Pack on RunComfy

核心用法

Flux Kontext Pro 是 Black Forest Labs 专为「单图精准局部编辑」设计的图像模型，通过 RunComfy CLI 调用 blackforestlabs/flux-1-kontext/pro/edit 端点。核心输入仅两字段：prompt（编辑指令）+ image（单张源图 URL），可选 aspect_ratio 和 seed。

最佳实践采用「保留优先」句式：先声明「Keep [身份/姿态/构图] unchanged」，再给出修改指令，例如："Keep the person's face and pose unchanged. Add an orange umbrella in her left hand." 这种祈使语态、单一变更的提示词能最大限度发挥模型的高保真特性。

显著优点

• 身份保持能力极强：在明确保留指令下，面部、姿态、服装等核心特征不易漂移
• 精准局部控制：专为「 she's now holding X 」类单点修改优化
• 高保真输出：输出质量稳定，适合品牌资产级别的图像迭代
• CLI 工作流友好：支持 --output-dir 自动下载、seed 复现对比，适合脚本化批量处理

潜在缺点与局限性

• 仅支持单图输入：多图参考场景（1-20 张）需转用 Nano Banana Edit
• 复合指令易漂移：「改 A 并加 B 且删 C」类提示应拆分为连续单步编辑
• 多语言/嵌入文字编辑弱势：此类需求 GPT Image 2 edit 表现更优
• 无图生图能力：纯生成任务需使用 Flux 2 Klein
• 文档字段不透明：除核心四字段外，其他参数需查阅实时模型页面确认

适合人群

• 电商/品牌设计师：需要高保真替换商品局部（标签文字、配色、配件）
• 摄影师/后期师：快速迭代单张人像的微调细节（表情、道具、背景元素）
• 自动化工作流开发者：通过 CLI + seed 实现可复现的图像变体生产线
• 对「主体一致性」有严苛要求的创意工作者

常规风险

• 模型误路由：用户明确说「Flux Kontext」时不可擅自切换至其他编辑模型
• 提示词顺序陷阱：未将保留声明置于句首可能导致非预期全局变化
• 公网 URL 暴露：输入图片需为可公开访问的 HTTPS 链接，敏感素材存在外泄风险
• CLI 令牌管理：RUNCOMFY_TOKEN 在 CI 环境需妥善保管，避免写入日志
• 复合编辑幻觉：试图单步完成多区域修改时，模型可能忽略部分指令或产生连锁漂移

核心用法

Flux Kontext Pro 是专为单图精准局部编辑设计的 AI 图像生成模型，由 Black Forest Labs 开发、RunComfy 托管。该 Skill 封装了官方推荐的提示词模式与 API 调用方式，通过本地 RunComfy CLI 调用 blackforestlabs/flux-1-kontext/pro/edit 端点。

典型调用流程：
1. 用户通过自然语言描述编辑需求（如"给人物左手添加橙色雨伞"）
2. Skill 自动优化为"保留优先"格式：Keep [不变元素]. [具体修改]
3. 调用 RunComfy CLI 提交单图 URL + 提示词
4. 等待轮询结果并下载至指定输出目录

关键设计原则：

• 单引用限制：仅支持一张源图，多图场景需路由至 Nano Banana Edit
• 保留优先提示：必须以"Keep X unchanged"开头锁定身份/姿态/构图
• 声明式指令：使用主动语态单句，避免复合修改

---

显著优点

| 优势 | 说明 |

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

| **高保真身份保持** | 在显式保留指令下，人物面部、品牌标识、光影关系稳定 |

| **精准局部控制** | 专为"单图单改"优化，优于通用多图编辑模型 |

| **提示响应可靠** | 遵循官方文档模式时，输出可控性显著高于 naive prompting |

| **快速迭代** | 短提示词 + 单图 = 快速结果循环，适合创意打磨 |

| **CLI 集成成熟** | RunComfy CLI 处理认证、轮询、下载全流程 |

---

潜在缺点与局限性

| 局限 | 影响 |

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

| **单图硬性限制** | 无法同时参考多图进行风格融合或批量处理 |

| **复合修改漂移** | "改A且加B且删C"类提示易导致整体风格偏移，需拆分为顺序调用 |

| **文本编辑弱于竞品** | 多语言/嵌入式文字修改效果不如 GPT Image 2 edit |

| **公网图片依赖** | 需公开可访问的 HTTPS 图片 URL，无法直接处理本地私域文件 |

| **文档不完整** | RunComfy 公开文档对高级参数说明有限，需查阅模型页获取最新字段 |

---

适合人群

• 电商/品牌设计师：需快速修改产品图标签、颜色，保持包装一致性
• 内容创作者：对单张人像/场景进行可控局部调整（加道具、换背景元素）
• AI 图像工作流搭建者：需要高保真编辑作为 pipeline 中间环节
• RunComfy 平台用户：已在使用该生态，希望获得最佳提示实践封装

---

常规风险

| 风险类别 | 说明 | 缓解措施 |

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

| **CLI 安装风险** | 文档提及 `curl | sh` 安装方式，虽为官方推荐但属潜在危险模式 | 优先使用 `npm i -g @runcomfy/cli`；如用 curl 先下载审查 |

| **Token 安全** | RunComfy CLI 存储认证 token 于 `~/.config/runcomfy/token.json` | 确保文件权限 0600，CI 环境使用 `RUNCOMFY_TOKEN` 环境变量 |

| **网络隔离** | Skill 本身无外联，但依赖 RunComfy CLI 连接官方 API | 确认出站白名单包含 `*.runcomfy.com` / `*.runcomfy.net` |

| **输出不可控** | AI 生成存在随机性，即使相同 seed 也可能有差异 | 关键场景预留多 variant 对比，不依赖单次输出 |

| **版权合规** | 编辑他人作品需确保拥有合法授权 | 建立素材来源审查流程，避免侵权风险 |

---

竞品路由建议

该 Skill 内置智能路由逻辑，自动选择最优模型：

• Flux Kontext ← 当前 Skill：单图精准局部编辑
• Nano Banana Edit：1-20 图批量编辑、多参考融合
• GPT Image 2 edit：多语言文字编辑、复杂语义理解
• Flux 2 Klein：文生图（无源图生成）

用户显式提及"Flux Kontext"时将强制路由至此 Skill，不受上述规则覆盖。