落白lite & AI研学社·第 43 / 52 小节 · L3 · 单品课先修:L3-A1课程地图|← 上一课下一课 →
AI 入门与 ComfyUI 出图课
L3 / B 线 / B1
L3 · 单品课 · B 线第 1 站

手动涂抹局部修改:遮罩到底管住了什么

你把一张不错的客厅图发给客户,对方只回一句:沙发换成黑色皮沙发,其他别动。你整张重跑,地毯、挂画、窗外的光全变了。这一课先讲清遮罩原理,再一起把线追到 SaveImage。

01 / 现实问题与一句话目标

你大概也遇到过:一张图整体都不错,你只想把沙发换成黑色皮沙发。整张重跑,地毯、挂画、窗外的光全跟着变——你失去的是“其他部分不许动”的控制权。

这一课的目标:看懂遮罩怎样把“允许改”限制在一个区域,并学会用“从 SaveImage 倒推”的方法,识别一条看起来在改局部、其实没落盘的支路。

05 源文件 05📚基础版 手动涂抹局部修改.json 节点 / 连线 12 / 17 子图 3 层 重绘 25 步 · denoise 0.8 精修 Flux2 · 4 步
当前位置B 线 · 改图线 · 第 1 站
A6
建筑毛坯 + 参考
B1
手动涂抹局部修改你在这里
B2
文字识别局部修改
02 / PRINCIPLES

先弄懂遮罩:一张黑白图,决定哪里可以改

局部修改不是“用橡皮擦掉再画”,而是告诉采样器:这块地方可以重新长,其他地方请保持。这个“告诉”的载体,就是遮罩。

MASK

遮罩是什么

一张和原图等大的黑白图。白 = 允许重绘,黑 = 原样保留,灰 = 按灰度比例混合。它不是图层,不参与画面,只是一张“许可表”。

INPAINT

局部重绘怎么发生

把遮罩区域对应的潜空间(按 1/8 缩小的草稿画布,L3-01 讲过)内容重置成噪声,再让采样器只在那块区域去噪;遮罩外保持原 latent。所以“改哪里”由遮罩决定,“改成什么”由提示词决定。

EDGE

为什么边缘会假

遮罩边界是硬切时,重绘区和原图之间会出现一条缝。羽化(feather)让边缘渐变,外扩(grow)让重绘范围略大于目标,接缝才好藏。

还需要装好这些:FLUX1/flux_dev_fp8_scaled_diffusion_model.safetensors、t5/t5xxl_fp8_e4m3fn.safetensors + clip_l.safetensors、ae.safetensors、Impact Pack 的 MaskToSEGS 与 DetailerForEach、rgthree 的 Image Comparer、Flux2 的 flux-2-klein-base-9b-fp8 + qwen_3_8b_fp8mixed + full_encoder_small_decoder。缺一个,节点就会变红。
原图 沙发、地毯、挂画都满意 遮罩 白色区域 = 允许重绘 结果 只有沙发变了,其余保持
三格图要看的是“范围”,不是“画风”。中间那格的白块就是遮罩:它不告诉模型“改成什么”,只告诉模型“哪里可以动”。改沙发还是改抱枕,取决于你把白块画在哪、以及提示词写了什么。
三个容易混的词:遮罩(mask)是许可范围;SEGS 是把遮罩拆成一个个矩形区域后的一组“框”,方便逐个区域重绘;Detailer 是拿着这些框,逐个裁出来、放大、重绘、再贴回去的节点。05 号里这三样都出现了。第一次接触遮罩,先看微课 L3-05b · 遮罩是什么:它把黑白许可表、alpha、羽化/外扩和两套格子单独讲了一遍。
03 / BLUEPRINT

全景:两条支路,只有一条通到保存

05 号同时画了两套方案:上面一套是“遮罩 + 局部重绘”,下面一套是“整图 + 一句话交给 Flux2”。先顺着箭头看,再回答一个问题:哪条线最后接到了 SaveImage?先记住两个词——死端:一个节点的输出没接任何下游,ComfyUI 求值时就不会执行它,不报错,只是安静地不工作;子图:把一堆节点折叠成一个方块,双击才进得去,这份文件里 3 个子图全叫 New Subgraph。

① 遮罩支路:算得出,却没人要 LoadAndResizeImage 涂抹图 + 遮罩 clipspace/…3526.png MaskToSEGS 遮罩 → SEGS 框出可改区域 DetailerForEach 512 · 25 步 · denoise 0.8 逐个区域裁出来重绘 没有下游 输出口是空的 不参与本次执行 MASK SEGS IMAGE ② 真正落盘的支路:整图 + 一句话,交给 Flux2 同一张图的 IMAGE 原图,不是遮罩 #431 image 出口 DeepTranslator 改为黑色皮沙发 auto → english Flux2 子图 #476 17 节点 · 4 步 · CFG 1 拿整图当参考再生成 SaveImage #383 filename_prefix ComfyUI image text IMAGE 从 SaveImage 倒推,只要三步 ① #383 的 images 只接了 #476;#476 的 image 来自 #431,text 来自 #382。 ② #257 的 IMAGE 输出是空的。ComfyUI 只计算下游要用的节点,所以 #257 与 #259 都不会执行。 ③ 你看到的“改沙发”,是 Flux2 拿整张图 + 一句话重画了一遍,遮罩没有参与。
遮罩支路(死端) 实际落盘 遮罩 / 分割 图像输入 文字输入
窄屏速读:上支路 = 涂抹图 → MaskToSEGS → DetailerForEach → 无下游(不执行)。下支路 = 同一张图 + 翻译文字 → Flux2 子图 #476 → SaveImage #383。落盘的是下支路。

这就是 05 号最值得记住的地方

它不是“参数没调好”,而是接线断在最后一步:局部重绘算得再对,只要输出没接到保存节点,就等于没做。判断方法永远只有一个——从 SaveImage 往回走。

04 / NODE BY NODE

逐节点:遮罩怎么进来,又断在哪

按“输入 → 重绘支路 → 落盘支路 → 对照”四段看。每张卡都标了真实输入输出,方便你回到 ComfyUI 里对号。

A

涂抹图进来,一分为二

#431 / #259
#431LoadAndResizeImage涂抹图 + 遮罩

它做什么:读取你在浏览器画布上涂过的那张图。这个节点一次给出两个出口:image 是涂过的原图,mask 是你涂出来的白色区域。两者尺寸已经对齐,所以后面不用再手动缩放。遮罩通道选 alpha,意思是白区来自涂抹时的透明层——透明处就是“可以改”的地方。

imageclipspace/clipspace-painted-masked-1782214563526.png [input]
尺寸512 × 512
倍数2
遮罩通道alpha
image → #257 / #260 / #476mask → #259
注意路径:clipspace/… 是 ComfyUI 前端涂抹后写进 input 目录的临时文件。重启服务、清理 input、换一台机器,这条路径就会变红。
#259MaskToSEGS遮罩转区域

它做什么:遮罩是一整张黑白图,Detailer 却喜欢“一个个框”。MaskToSEGS 就是把白区拆成若干个矩形框(SEGS),每个框可以单独裁、单独重绘、单独贴回。

widgets_values[false, 3, false, 10, false]
输入mask ← #431
输出SEGS → #257

这五个值会影响框怎么合并、怎么外扩、怎么排序。初学阶段不用背,先记住一件事:它输出的是“框”,不是图。

B

局部重绘支路:五路输入,一个出口,出口是空的

#252 / #253 / #256 / #254 / #258 → #257
#252 · #253 · #256UNET / DualCLIP / VAEFlux1 三件套

它们是什么:这条支路用的是 Flux1,不是 SDXL。三个加载器分别提供采样所需的模型(UNET)、文本编码器(CLIP,L3-01 讲过)和解码器(VAE,有损翻译机)。这里要接两个文本编码器:t5xxl 管长句语义,clip_l 管局部细节,Flux 同时读两份。

UNETFLUX1/flux_dev_fp8_scaled_diffusion_model.safetensors
CLIPt5/t5xxl_fp8_e4m3fn + clip_l
类型flux
VAEae.safetensors
#254CLIPTextEncodeFlux正向提示词

它做什么:把文字编码成 Flux 能读的条件。面板里两个文本框都写着 A car was driving on the road,guidance 3.5——但这两个框都被 #382 的翻译结果覆盖了。guidance 是 Flux 自己的“听话程度”旋钮,和 SDXL 的 CFG 不是同一个参数。

clip← #253
clip_l / t5xxl← #382(覆盖文本框)
guidance3.5

真正送进模型的是“改为黑色皮沙发”的英文译文,不是那句汽车。

#258ConditioningZeroOut负向清零

它做什么:把正向条件复制一份后清零,当作负向条件。Flux 的 CFG 固定为 1 时,负向本来就不起作用;这个节点只是把“没有负向”这件事显式化。

conditioning ← #254CONDITIONING → #257
#257DetailerForEach逐个区域重绘

它做什么:拿着 #259 给的每个框,把框内区域裁出来、缩到 512、用 Flux1 重绘 25 步(denoise 0.8),再按 5 像素羽化贴回原图。这是“局部修改”真正干活的地方。三个参数先落地:denoise 0.8 表示大部分重画、留两成旧信息;CFG 1 表示几乎不额外拉提示词;seed(种子)决定从哪团噪声起步。uni_pc 是采样算法,sgm_uniform 是步长分配,换它们只改细节,不改构图。

guide_size512
max_size1024
seed374707593963303
步数 / CFG25 / 1
采样器uni_pc · sgm_uniform
denoise0.8
feather5
关键事实:它的 IMAGE 输出口没有连任何节点。在 ComfyUI 的执行逻辑里,这意味着它和 #259 都不会被求值——参数再漂亮也没用。
C

落盘支路:一句话 + 整张图,重画一遍

#382 / #476
#382DeepTranslatorTextNode中 → 英

它做什么:把中文指令翻成英文。Flux 的文本编码器对英文更稳,所以这里不直接把中文喂进去。

源 / 目标auto → english
原文改为黑色皮沙发
引擎GoogleTranslator [free]
text → #254 clip_ltext → #254 t5xxltext → #476
#476Flux2 子图整图重绘

它做什么:子图内部有 17 个节点,折叠成一个方块。它拿原图当参考(ReferenceLatent:把原图压进潜空间当参考,不是直接拼贴),从空 latent(草稿画布)出发,用 Flux2 重画 4 步。它收到的只有 image 和 text,没有 mask——所以它根本不知道你想只改沙发。输入会先缩到 1 MP(约一百万像素),再进采样。

内层节点17
模型flux-2-klein-base-9b-fp8
文本编码qwen_3_8b_fp8mixed
VAEfull_encoder_small_decoder
步数 / CFG4 / 1
输入分辨率ImageScaleToTotalPixels 1 MP
text ← #382image ← #431IMAGE → #260 / #383
D

对照与保存:谁也没拦住它

#260 / #383
#260Image Comparer (rgthree)前后对照

它做什么:左边放原图(#431),右边放结果(#476),拖动中线对比。它只是预览,不产生文件,也不参与保存。

image_a ← #431image_b ← #476

用来看“整图重画”到底改掉了多少你没要求改的地方——通常比你以为的多。

#383SaveImage唯一落盘

它做什么:保存 #476 的结果。前缀是默认的 ComfyUI,从文件名看不出这是“涂抹局部修改”的哪一版。

images← #476
filename_prefixComfyUI
05 / PARAMETERS

参数速查与四条边界

先把这张表当成“回到工作流时的对照单”:左边是节点,中间是真实值,右边是它管什么。表里的路径、种子、步数都取自 JSON,未做改写。

节点真实参数它管什么
#431 LoadAndResizeImageclipspace/clipspace-painted-masked-1782214563526.png [input]
512 × 512 · 倍数 2 · alpha
读入涂抹图,并同时给出 image 与 mask 两个出口。
#259 MaskToSEGS[false, 3, false, 10, false]把白区拆成一组矩形框(SEGS),供 Detailer 逐个处理。
#257 DetailerForEachguide 512 · max 1024 · seed 374707593963303
25 步 · CFG 1 · uni_pc · sgm_uniform · denoise 0.8 · feather 5
逐个框裁切、放大、重绘、羽化贴回。它本该是“局部”发生的地方,但 IMAGE 没有下游,默认不执行,只能用来观察。
#252 / #253 / #256flux_dev_fp8_scaled · t5xxl_fp8_e4m3fn + clip_l · ae提供 Flux1 的模型、文本编码与解码能力。
#254 CLIPTextEncodeFlux面板文本 A car was driving on the road · guidance 3.5
实际被 #382 覆盖
把“改成什么”编码成条件;面板文字不生效,以连线为准。
#258 ConditioningZeroOut负向 = 全零Flux 的 CFG 为 1,负向本就不参与,这里只是显式清零。
#382 DeepTranslatorauto → english · 改为黑色皮沙发 · GoogleTranslator [free]把中文指令翻成英文,供 #254 与 #476 使用。
#476 Flux2 子图17 节点 · 4 步 · CFG 1 · 1 MP
flux-2-klein-base-9b-fp8 + qwen_3_8b_fp8mixed
拿整图当参考重画一遍,不接收遮罩。
#383 SaveImageComfyUI保存 #476 的结果,是整条链路唯一的落盘口。
先记住一句话:遮罩决定“哪里可以动”,提示词决定“动成什么”,denoise 决定“动多少”,feather / grow 决定“接缝藏不藏得住”。四件事各管一段,不能互相替代。
边界 1

遮罩没盖住 = 一定不改

黑区在理想情况下原样保留。如果黑区也变了,先怀疑支路根本没走遮罩(05 号就是),而不是怀疑遮罩画得不对。

边界 2

遮罩内改成什么,遮罩不管

你把沙发涂白,提示词写“换成书架”,模型就会在沙发的位置长出一个书架。遮罩只给许可,不给内容。

边界 3

遮罩不懂物体边界

它是二维区域,不认识“沙发”和“地板”的交界。涂过界,地板会跟着变;涂不够,旧沙发的边会留在新沙发里。

边界 4:分辨率与细节有上限。Detailer 把每个框缩到 guide_size 512 再重绘,框里的细节上限就受这 512 约束。想让沙发纹理更细,先加 guide_size,再谈步数;只加步数不会凭空长出细节。注意:得先把 #257 接到保存节点,这个参数才会影响你看到的图。
06 / PITFALLS

踩坑:这条链路最会骗人的七个地方

前两条会让你“以为改了、其实没改”;中间三条会让你“改了、但改错地方”;最后两条是工程习惯。

遮罩支路是死端,图不是它出的致命

#257 DetailerForEach · IMAGE 输出为空

症状:你认真涂了遮罩、调了 denoise,出图和“只写一句话重画整张”一模一样。因为 #257 没有下游,ComfyUI 根本不会执行它。

改法:把 #257 的 IMAGE 接到一个新的 SaveImage,跑一次对比,你就知道“真局部”和“整图重绘”差多少。想接到 #260 的 image_b 也可以,但要先断开 #476 → #260 的那根线——那个槽已被占用。

clipspace 临时路径,换机就断高频

#431 · clipspace/clipspace-painted-masked-1782214563526.png [input]

症状:昨天还能跑,今天打开满屏红框,提示找不到图片。这是浏览器涂抹后写进 input 目录的临时文件,重启、清理、换机器都会没。

改法:涂完先把图另存到固定的 input/ 文件名,再用 LoadImage 指向它;或者每次重涂一遍。不要把临时路径当资产。

三个子图全叫 New Subgraph中

#476 → #475 → #474

症状:进了一层又一层,每层面包屑都写着同一个名字,改完参数不知道改的是哪一层。

改法:双击进子图前先记节点编号(#476 → #475 → #474),或者进去后立刻重命名。同名子图是排查时最大的噪音。

#254 面板写着汽车,实际在改沙发中

#254 CLIPTextEncodeFlux ← #382

症状:两个文本框都是 A car was driving on the road,你以为提示词没生效。其实 clip_l 与 t5xxl 两个输入口都接了 #382,面板值被连线整段覆盖。

改法:只改 #382 的中文原文;要验证面板是否生效,就断开 #382 → #254 的两条线再跑。

Flux2 的 1024 是默认值,不是实际尺寸中

#458 Flux2Scheduler · #462 EmptyFlux2LatentImage

症状:面板写着 1024 × 1024,出图却不是方的。因为 width/height 接了 #463 GetImageSize,而且 #472 先把图缩到了 1 MP。

改法:要改输出尺寸,看 #472 的 1 MP 与 #463 的来源图;不要改 #458 / #462 的框。

denoise 与 feather 是一对跷跷板低

#257 · denoise 0.8 · feather 5

症状:denoise 太低,遮罩里几乎不变;太高,框边缘开始“融化”,周围墙地也跟着改。feather 太小有硬边,太大又把重绘区糊回原图。

改法:先按上面的改法把 #257 接到保存节点(否则改它没有可见效果)。固定 feather 5,只调 denoise(0.5 / 0.65 / 0.8 各一张);找到合适强度后,再用 0 / 5 / 15 试 feather。

保存前缀还是 ComfyUI低

#383 SaveImage · filename_prefix

症状:涂抹实验跑了十几版,全在同一串编号里,分不清哪张是 denoise 0.5、哪张是 0.8。

改法:用 paint_dn080_ft05_s374707 这种前缀,把 denoise、feather、种子写进文件名。

07 / PRACTICE

练习:先证明它没改,再让它真的改

这一课的练习顺序很重要:先复现“遮罩没生效”,再亲手把线接上。你会对“从 SaveImage 倒推”这件事记得很牢。

EXERCISE 01

复现死端

不改任何参数,先只看节点图:#257 的 IMAGE 口有没有下游?再跑一次,对比出图与 #476。

应该看到:#257 的面板参数全对,出图却和“整图重绘”一样——因为它没被执行。
EXERCISE 02

把局部重连接上

新增一个 SaveImage,把 #257 的 IMAGE 接进去;保持遮罩只盖沙发。

应该看到:只有沙发区域变了,地毯、挂画、窗外光影保持不变。
EXERCISE 03

只改一句话

把 #382 的原文从“改为黑色皮沙发”改成“改为深灰色布艺沙发”,其他不动。

应该看到:遮罩内材质和颜色变了,形状仍受原沙发约束。
EXERCISE 04

denoise 三连

先完成 EXERCISE 02(#257 已接到保存节点),再固定种子,把 denoise 设为 0.5 / 0.65 / 0.8,各出一张。

应该看到:0.5 保留最多旧结构,0.8 最敢改;超过 0.9 容易把周围也带走。
EXERCISE 05

feather 找接缝

保持 #257 已接到保存节点,把 feather 改成 0 和 20 各跑一张,放大看沙发与地板的交界。

应该看到:0 有硬边,20 边缘发糊;5 左右通常最自然。
EXERCISE 06

换一张固定图

把涂抹结果另存到 input/paint_sofa.png,用 LoadImage 替换 #431,重启 ComfyUI 再打开。

应该看到:路径不再变红,工作流可以换机复现。

交作业前自检

  • 我能用一句话解释遮罩、SEGS、Detailer 三者的分工。
  • 我知道 05 号真正落盘的是 #476,不是 #257,并能从 SaveImage 倒推证明。
  • 我亲手把 #257 接到保存节点,看到了“真局部”的差别。
  • 我能说出遮罩没盖住、遮罩内提示词、denoise、feather 各管什么。
  • 我知道 clipspace 路径为什么不能当资产。
  • 我改尺寸时看的是 #472 与 #463,不是 #458 的 1024。
  • 我的保存前缀能看出 denoise、feather 和种子。