fix: 八方向拆分不再切断角色;全仓库参数补齐中文 tooltip

【修复】角色被格线切断(脚、手杖、飘起的斗篷被削掉)
新增 expand_beyond_cell(默认开启):格子只用来判定「这是哪个方向」,
角色的实际范围由它自身的连通区域决定,按质心归属确保邻居不混入。
实测 8/8 方向的裁剪框边缘 alpha 从 1.00(内容顶到边界=被切断)
降到 0.00,S 方向高度 326→356、E 方向宽度 150→188 把缺的部分找了回来。
代价是需要两遍扫描(先求全序列并集框再提取),耗时 4.7s→14.9s。

【规则】每个参数都必须有中文 tooltip,作为以后的统一约定
全仓库 26 个节点 169 个参数,此前缺 115 个,现已 100% 覆盖。
tooltip 写「怎么调」而不只是「是什么」:给取值区间的实际影响、
推荐值与踩坑提示(如 OpenAI/ZenMux 的地址栏不能带 :// ,
素材拆分节点用于动画序列时顺序会漂移等)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
rui40000
2026-07-29 19:07:01 +08:00
co-authored by Claude Opus 4.8
parent 28fd14aaad
commit 5d3834503e
25 changed files with 512 additions and 123 deletions
+19 -4
View File
@@ -168,7 +168,11 @@ class RuiSDMatteLoader:
"tooltip": "官方测试配置为 fp32(amp.enabled=False)。\n"
"fp16 省显存但 SD 2.1 的 VAE 在半精度下容易溢出,可能出现黑图或噪点。"
}),
"device": (["auto", "cpu"], {"default": "auto"}),
"device": (["auto", "cpu"], {
"default": "auto",
"tooltip": "auto = 有显卡就用显卡。\n"
"SDMatte 体量大,cpu 推理会慢到不实用,仅作兜底。"
}),
"attention_slicing": ("BOOLEAN", {
"default": True,
"tooltip": "分片计算注意力。1024 分辨率下显存峰值从约 15.5GB 降到 9.1GB,\n"
@@ -208,8 +212,14 @@ class RuiSDMatte:
def INPUT_TYPES(cls):
return {
"required": {
"sdmatte_model": ("SDMATTE_MODEL",),
"image": ("IMAGE",),
"sdmatte_model": ("SDMATTE_MODEL", {
"tooltip": "由「SDMatte 加载器」输出的模型。\n"
"加载器有缓存,多个抠图节点可共用同一个加载器。"
}),
"image": ("IMAGE", {
"tooltip": "待抠图的原图。RGBA 输入会自动丢弃 alpha 只取 RGB\n"
"(VAE 编码器只收 3 通道,多出的 alpha 不能当颜色喂进去)。"
}),
"mask": ("MASK", {
"tooltip": "指示要抠哪个目标的提示掩码,不必精确,粗略覆盖主体即可。"
}),
@@ -250,7 +260,12 @@ class RuiSDMatte:
"再逐像素取最大值合成提示图 —— 即每个点的影响半径。\n"
"官方训练用 25,测试期用 25+10=35,故默认 35。"
}),
"seed": ("INT", {"default": 0, "min": 0, "max": 0xFFFFFFFF}),
"seed": ("INT", {
"default": 0, "min": 0, "max": 0xFFFFFFFF,
"tooltip": "随机种子,仅在 prompt_type=point_mask 时真正起作用\n"
"(决定在提示区域里随机取哪 10 个点)。\n"
"其余提示类型下改它不会改变结果。"
}),
},
}