nodes/WJLUOXIAO-XB_ToolBox
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

增加模式

Browse Source
This commit is contained in:
AI_Architect
2026-09-21 11:18:43 +08:00
parent 4b0cadd107
commit 1f8d78c340
6 changed files with 126 additions and 67 deletions
Download Patch File Download Diff File Expand all files Collapse all files
js/xb_image_prompt_preset.js
+50 -19
View File
@@ -30,10 +30,12 @@ const LANG_EN = "英文 [EN]";
const LANGS = [LANG_ZH, LANG_EN];
const MODE_TP = "常规文生图";
const MODE_3V = "人物三视图";
const MODES = [MODE_TP, MODE_3V];
const MODE_4V = "人物四视图";
const MODE_RGBA = "背景纯透明";
const MODES = [MODE_TP, MODE_3V, MODE_4V, MODE_RGBA];
const ASPECT_MAP = { "1:1": 1, "16:9": 16 / 9, "9:16": 9 / 16, "4:3": 4 / 3, "3:4": 3 / 4, "21:9": 21 / 9 };
const SIZE_STEP = 16; // width/height 两个 widget 自己的步长
const SIZE_STEP = 16; // width/height 的兜底步长（实际以「空latent类型」的官方最小步长为准）
const SIZE_MIN = 16;
const SIZE_MAX = 16384;
const BATCH_MAX = 4096;
@@ -43,24 +45,40 @@ const BATCH_MAX = 4096;
const LATENT_KINDS = [
"Anima", "Boogu", "Flux2", "Hunyuan", "Krea2", "Qwen-image", "SD3", "SDXL", "Z-image",
];
// 每项：channels(通道) / hDiv・wDiv(下采样除数) / step(尺寸步长) / min・max / batchMax / downscale / desc(悬停说明)
// 每项：channels(通道) / hDiv・wDiv(下采样除数) / step(尺寸步长 = 各模型官方最小步长) / min・max / batchMax / downscale / desc(悬停说明)
// 步长 = 下采样 × patch2：Anima/Boogu/SDXL = 8、Flux2 = 16、Krea2/SD3/Z-image = 16、Qwen-image = 32（按需求锁 32）、Hunyuan = 32
const LATENT_KIND_SPEC = {
"Anima": { channels: 16, hDiv: 8, wDiv: 8, step: 8, min: 16, max: 16384, batchMax: 4096, downscale: 8, desc: "Anima：16 通道 · /8 · 步长 8（官方模板用 4 通道 EmptyLatentImage，零 latent 会被自动补齐）" },
"Boogu": { channels: 16, hDiv: 8, wDiv: 8, step: 8, min: 16, max: 16384, batchMax: 4096, downscale: 8, desc: "Boogu：16 通道 · /8 · 步长 8（同上，官方 latent_format = Flux）" },
"Flux2": { channels: 128, hDiv: 16, wDiv: 16, step: 16, min: 16, max: 16384, batchMax: 4096, downscale: 16, desc: "Flux2：128 通道 · /16 · 步长 16（官方 EmptyFlux2LatentImage）" },
"Hunyuan": { channels: 64, hDiv: 32, wDiv: 32, step: 32, min: 64, max: 16384, batchMax: 4096, downscale: 32, desc: "Hunyuan：64 通道 · /32 · 步长 32（官方 EmptyHunyuanImageLatent / HunyuanImage 2.1）" },
"Krea2": { channels: 16, hDiv: 8, wDiv: 8, step: 16, min: 16, max: 16384, batchMax: 4096, downscale: 8, desc: "Krea2：16 通道 · /8 · 步长 16（官方 latent_format = Wan21）" },
"Qwen-image": { channels: 16, hDiv: 8, wDiv: 8, step: 16, min: 16, max: 16384, batchMax: 4096, downscale: 8, desc: "Qwen-image：16 通道 · /8 · 步长 16（官方 latent_format = Wan21，采样时自动补 T 维）" },
"Qwen-image": { channels: 16, hDiv: 8, wDiv: 8, step: 32, min: 32, max: 16384, batchMax: 4096, downscale: 8, desc: "Qwen-image：16 通道 · /8 · 步长 32（官方 latent_format = Wan21，采样时自动补 T 维；按需求锁 32）" },
"SD3": { channels: 16, hDiv: 8, wDiv: 8, step: 16, min: 16, max: 16384, batchMax: 4096, downscale: 8, desc: "SD3：16 通道 · /8 · 步长 16（官方 EmptySD3LatentImage）" },
"SDXL": { channels: 4, hDiv: 8, wDiv: 8, step: 8, min: 16, max: 16384, batchMax: 4096, downscale: 8, desc: "SDXL：4 通道 · /8 · 步长 8（官方 EmptyLatentImage）" },
"Z-image": { channels: 16, hDiv: 8, wDiv: 8, step: 16, min: 16, max: 16384, batchMax: 4096, downscale: 8, desc: "Z-image：16 通道 · /8 · 步长 16（官方 latent_format = Flux）" },
};
const DEFAULT_LATENT_KIND = "Z-image";
const THREE_VIEW_DEFAULT = {
[LANG_ZH]: "生成平行排列的角色概念设计图，画面从左到右由四个独立面板组成：第一个面板是角色面部的精细特写肖像，第二个面板是人物正面全身站姿，第三个面板是人物侧面全身站姿，第四个面板是人物背面全身站姿。",
[LANG_EN]: "Generate a character concept design sheet arranged in parallel panels, the image is composed of four separate panels from left to right: the first panel is a finely detailed close-up portrait of the character's face, the second panel is a full-body front standing pose, the third panel is a full-body side standing pose, the fourth panel is a full-body back standing pose.",
/** 各预设模式的默认预设句（可编辑字段 three_view_text）；常规文生图 = 无预设句（原样输出正文） */
const PRESET_TEXT_DEFAULT = {
[MODE_3V]: {
[LANG_ZH]: "生成平行排列的角色概念设计图，画面从左到右由四个独立面板组成：第一个面板是角色面部的精细特写肖像，第二个面板是人物正面全身站姿，第三个面板是人物侧面全身站姿，第四个面板是人物背面全身站姿。",
[LANG_EN]: "Generate a character concept design sheet arranged in parallel panels, the image is composed of four separate panels from left to right: the first panel is a finely detailed close-up portrait of the character's face, the second panel is a full-body front standing pose, the third panel is a full-body side standing pose, the fourth panel is a full-body back standing pose.",
},
[MODE_4V]: {
[LANG_ZH]: "生成四宫格排列的角色概念设计图，画面左上角面板是角色面部的精细特写肖像，画面右上角面板是角色面部侧面的的精细特写肖像，画面左下角面板是无头部的人物正面身体站姿，画面右下角面板是人物背面全身站姿。",
[LANG_EN]: "Generate a character concept design sheet arranged in a 2x2 grid, the top-left panel is a finely detailed close-up portrait of the character's face, the top-right panel is a finely detailed close-up profile portrait of the character's face, the bottom-left panel is a full-body front standing pose without the head, the bottom-right panel is a full-body back standing pose.",
},
[MODE_RGBA]: {
[LANG_ZH]: "生成一张具有透明度的 RGBA 格式图像，包含 Alpha 通道，背景为纯透明。",
[LANG_EN]: "Generate an RGBA image with an alpha channel and a fully transparent background.",
},
};
/** 某模式某语言下的默认预设句（无预设句的模式 → 空串） */
const defaultPresetOf = (mode, lang) => ((PRESET_TEXT_DEFAULT[mode] || {})[lang] || "");
/** 兼容旧引用：三视图预设句 */
const THREE_VIEW_DEFAULT = PRESET_TEXT_DEFAULT[MODE_3V];
const SEP = { [LANG_ZH]: "，", [LANG_EN]: ", " };
@@ -1487,8 +1505,8 @@ function rebuildBody(settings, index, lang) {
/** 最终成句（与后端 build_prompt 逐行一致：预设句 + 正文）—— 三个值均来自节点表面参数 */
function finalPrompt(mode, presetText, lang, body) {
const core = String(body || "").trim();
if (mode !== MODE_3V) return core;
const preset = String(presetText || "").trim() || THREE_VIEW_DEFAULT[lang];
if (!PRESET_TEXT_DEFAULT[mode]) return core; // 常规文生图 → 无预设句
const preset = String(presetText || "").trim() || defaultPresetOf(mode, lang);
if (!core) return preset;
if (lang === LANG_EN) return preset.replace(/[.\s]+$/, "") + ". " + core;
return preset.replace(/[。．.\s]+$/, "") + "。" + core;
@@ -1600,11 +1618,11 @@ function openPanel(ctx, panelId) {
const body = ctx.body.get();
if (fromEl !== preview) preview.value = body;
headCount.textContent = `${body.length} 字 → 成句 ${finalPrompt(surf.mode, surf.presetText, surf.lang, body).length} 字`;
const is3v = surf.mode === MODE_3V;
presetChip.style.display = is3v ? "block" : "none";
if (is3v) {
const t = String(surf.presetText || "");
presetChip.textContent = "📌 自动前置（人物三视图预设句，直接在节点表面「三视图预设句」框里改）：" + (t.length > 150 ? t.slice(0, 150) + "…" : t);
const hasPreset = !!PRESET_TEXT_DEFAULT[surf.mode];
presetChip.style.display = hasPreset ? "block" : "none";
if (hasPreset) {
const t = String(surf.presetText || "") || defaultPresetOf(surf.mode, surf.lang);
presetChip.textContent = `📌 自动前置（${surf.mode}预设句，直接在节点表面「预设句」框里改）：` + (t.length > 150 ? t.slice(0, 150) + "…" : t);
}
};
preview.addEventListener("input", () => { ctx.body.set(preview.value); refreshPreview(preview); });
@@ -2502,10 +2520,17 @@ function setupNode(node) {
} catch (_) {}
};
// 预设句输入框：只有「人物三视图」模式才显示（一次性隐藏/显示，不做任何 setSize，不会抖动）
/** 写预设句：同时写 widget 值 + textarea（新版前端 customtext 把值存在 DOM 上，只手写 widget 可能不刷新显示） */
const setPresetText = (txt) => {
try { setWidgetValue(w3v, txt); } catch (_) {}
try { if (w3v && w3v.element && "value" in w3v.element) w3v.element.value = txt; } catch (_) {}
try { node.setDirtyCanvas?.(true, true); } catch (_) {}
};
// 预设句输入框：常规文生图以外的 3 个模式（三视图/四视图/背景纯透明）都显示（一次性隐藏/显示，不做任何 setSize，不会抖动）
const applyPresetTextVisibility = () => {
try {
if (surfaceOf().mode === MODE_3V) { showWidget(w3v); stylePresetTextBox(); } else hideWidget(w3v);
if (PRESET_TEXT_DEFAULT[surfaceOf().mode]) { showWidget(w3v); stylePresetTextBox(); } else hideWidget(w3v);
} catch (_) {}
node.setDirtyCanvas?.(true, true);
};
@@ -2555,11 +2580,17 @@ function setupNode(node) {
hook(wW, snapByWidth);
hook(wH, snapByHeight);
hook(wKind, () => { applyKindLimits(); snapByWidth(); }); // 换类型 → 按新步长重新归一宽高
hook(wMode, () => { applyPresetTextVisibility(); }); // 换模式 → 显/隐三视图预设句框
hook(wMode, () => { // 换模式 → 显/隐预设句框 +
const txt = defaultPresetOf(surfaceOf().mode, surfaceOf().lang); // 无条件恢复该模式的预设句
if (txt) setPresetText(txt); // （用户要求：不管手改成什么都恢复）
applyPresetTextVisibility();
});
hook(wLang, () => { // 换语言 → 未改过的默认预设句跟随语言
const mode = surfaceOf().mode;
const txt = defaultPresetOf(mode, surfaceOf().lang);
const cur = String(readWidgetValue(w3v) ?? "").trim();
const prev = LANGS.find((L) => L !== surfaceOf().lang);
if (prev && cur === THREE_VIEW_DEFAULT[prev]) setWidgetValue(w3v, THREE_VIEW_DEFAULT[surfaceOf().lang]);
const prevLang = LANGS.find((L) => L !== surfaceOf().lang);
if (txt && (!cur || cur === defaultPresetOf(mode, prevLang))) setPresetText(txt);
});
hook(wB, () => { // batch 超出当前类型上限 → 就近钳制
const sp = latentSpec(surfaceOf().kind);
locales/en/nodeDefs.json
+1 -1
View File
@@ -350,7 +350,7 @@
"output_lang": { "name": "Output Language" },
"preset_mode": { "name": "Preset Mode" },
"latent_kind": { "name": "Empty Latent Type" },
"three_view_text": { "name": "3-View Preset Text" },
"three_view_text": { "name": "Preset Text (3-view/4-view/transparent)" },
"aspect_ratio": { "name": "Aspect Ratio" },
"width": { "name": "Width" },
"height": { "name": "Height" },
locales/zh/nodeDefs.json
+1 -1
View File
@@ -5829,7 +5829,7 @@
"output_lang": { "name": "输出语言" },
"preset_mode": { "name": "预设模式" },
"latent_kind": { "name": "空latent类型" },
"three_view_text": { "name": "人物三视图预设句" },
"three_view_text": { "name": "预设句（三视图/四视图/透明背景）" },
"aspect_ratio": { "name": "画幅比例" },
"width": { "name": "宽度" },
"height": { "name": "高度" },
nodes_blockswap.py
+8 -8
View File
@@ -66,12 +66,12 @@ class XB_UNetBlockSwap:
if not isinstance(unet_model, ModelPatcher):
return (unet_model,)
if is_dynamic_vram_active():
# ── 0 = 关闭分块功能：直接穿透，不做任何检测、不输出动态显存休眠警告 ──
if blocks_to_swap == 0:
print("\033[96m[XB UNet Block Swap]\033[0m: 分块数量 = 0，分块功能已关闭（节点穿透）")
return (unet_model,)
# ── blocks_to_swap=0 等同于关闭，直接穿透 ──
if blocks_to_swap == 0:
print("\033[96m[XB UNet Block Swap]\033[0m: 分块数量为 0，节点穿透（无操作）")
if is_dynamic_vram_active():
return (unet_model,)
def swap_blocks(model_patcher: ModelPatcher, device_to, lowvram_model_memory, force_patch_weights, full_load):
@@ -156,12 +156,12 @@ class XB_CheckpointBlockSwap:
if not isinstance(checkpoint_model, ModelPatcher):
return (checkpoint_model,)
if is_dynamic_vram_active():
# ── 0 = 关闭分块功能：直接穿透，不做任何检测、不输出动态显存休眠警告 ──
if blocks_to_swap == 0:
print("\033[96m[XB Checkpoint Block Swap]\033[0m: 分块数量 = 0，分块功能已关闭（节点穿透）")
return (checkpoint_model,)
# ── blocks_to_swap=0 等同于关闭，直接穿透 ──
if blocks_to_swap == 0:
print("\033[96m[XB Checkpoint Block Swap]\033[0m: 分块数量为 0，节点穿透（无操作）")
if is_dynamic_vram_active():
return (checkpoint_model,)
def swap_blocks(model_patcher: ModelPatcher, device_to, lowvram_model_memory, force_patch_weights, full_load):
nodes_blockswap_sage.py
+4 -3
View File
@@ -136,11 +136,12 @@ class XB_Sage_BlockSwap:
if not isinstance(model, ModelPatcher):
return model
if _is_dynamic_vram_active():
# ── 0 = 关闭分块功能：直接跳过，不做任何检测、不输出动态显存休眠警告 ──
if blocks_to_swap == 0:
print("\033[96m[XB Sage+分块]\033[0m: 分块数量 = 0，分块功能已关闭 (仅保留注意力加速)")
return model
if blocks_to_swap == 0:
print("\033[96m[XB Sage+分块]\033[0m: 分块数量为 0，跳过 Block Swap")
if _is_dynamic_vram_active():
return model
def swap_blocks(model_patcher: ModelPatcher, device_to, lowvram_model_memory,
nodes_image_prompt_preset.py
+62 -35
View File
@@ -3,7 +3,7 @@
一个节点顶替「提示词输入框 + 画幅比例节点 + 官方空 latent」三件套：
· 表面参数（顺序 = 节点上从上到下的显示顺序）：
空latent类型 / 输出语言 / 预设模式 / 人物三视图预设句（仅三视图模式显示）
空latent类型 / 输出语言 / 预设模式 / 预设句（三视图·四视图·背景纯透明 三个模式显示）
/ 画幅比例 / 宽度 / 高度 / 生成数量
—— 画幅比例 + 步长锁定 + 比例联动 100% 复刻本包「XB-BOX - 🖼️ 图片参数大全」
（去掉强度(小数)/强度(整数)/缩放尺寸三项）
@@ -11,12 +11,12 @@
🏷️ 风格 ｜ 🎥 视角 ｜ 👤 主体 ｜ 🎬 姿态 ｜ 👚 装扮 ｜ 🎒 道具 ｜ 💡 光影 ｜ 🏞️ 背景
每个按钮打开**该分类**的独立面板；面板顶部「分类签」切换子类
（例：风格 → 真人/动画/3D/绘画插画/特殊风格），选项行 = ➕ ➖ 选项名 添加详细描述
· 输出①「提示词」= 预设句（人物三视图模式）+ 正文（节点提示词框 ↔ 面板预览框双向同步）
· 输出①「提示词」= 预设句（人物三视图 / 人物四视图 / 背景纯透明；常规文生图无预设句）+ 正文（节点提示词框 ↔ 面板预览框双向同步）
· 输出②「空latent」= 主流模型直接可用的空 latent（选项名 = 模型名，规格按官方 latent_format；
通道数 / 下采样除数 / 步长 / 上下限 / batch 上限 / downscale 元数据逐项对齐）：
· Z-image 16 通道 · /8 · 步长 16 （官方 latent_format = Flux）
· Flux2 128 通道 · /16 · 步长 16 （官方 EmptyFlux2LatentImage）
· Qwen-image 16 通道 · /8 · 步长 16 （官方 latent_format = Wan21，采样时自动补 T 维）
· Qwen-image 16 通道 · /8 · 步长 32 （官方 latent_format = Wan21，采样时自动补 T 维；按用户要求锁 32）
· Krea2 16 通道 · /8 · 步长 16 （官方 latent_format = Wan21）
· Anima 16 通道 · /8 · 步长 8 （官方模板用 4 通道 EmptyLatentImage，零 latent 会被自动补齐）
· Boogu 16 通道 · /8 · 步长 8 （同上，官方 latent_format = Flux）
@@ -45,22 +45,27 @@ import nodes
ASPECT_RATIO_OPTIONS = ["Free", "1:1", "16:9", "9:16", "4:3", "3:4", "21:9"]
ASPECT_RATIO_MAP = {"1:1": 1.0, "16:9": 16 / 9, "9:16": 9 / 16,
"4:3": 4 / 3, "3:4": 3 / 4, "21:9": 21 / 9}
SIZE_STEP = 16 # 宽高步长（XB 同款；8 的倍数即可满足官方 VAE，16 更保险）
SIZE_STEP = 16 # 宽高步长的兜底值（实际以「空latent类型」的官方最小步长为准：8/16/32）
SIZE_MIN = 16
BATCH_MAX = 4096 # 官方 EmptyLatentImage / EmptySD3LatentImage 的 batch 上限
MAX_RESOLUTION = int(getattr(nodes, "MAX_RESOLUTION", 16384) or 16384)
# ── 面板枚举（字符串即存储值，前端面板与后端按同一份字符串对齐） ────────────
OUTPUT_LANGS = ["中文 [ZH]", "英文 [EN]"]
PRESET_MODES = ["常规文生图", "人物三视图"]
PRESET_MODES = ["常规文生图", "人物三视图", "人物四视图", "背景纯透明"]
LANG_ZH = OUTPUT_LANGS[0]
MODE_TEXT2IMG = PRESET_MODES[0]
MODE_THREE_VIEW = PRESET_MODES[1]
MODE_FOUR_VIEW = PRESET_MODES[2]
MODE_TRANSPARENT = PRESET_MODES[3]
# ── 主流模型的空 latent 规格表（逐项抄自 ComfyUI：comfy/latent_formats.py + 官方空 latent 节点）──
# 选项文字 = 模型名（干净，不带专业参数；细节放 tooltip 与日志）；规格仍完整保留以保证对得上模型：
# 每行： (选项名, 通道数, 下采样除数_h, _w, 尺寸步长, 最小, 最大, batch上限, downscale_ratio_spacial)
# · downscale_ratio_spacial = 官方 EmptyLatentImage/EmptySD3 带回的元数据（供
# 每行： (选项名, 通道数, 下采样除数_h, _w, 尺寸步长, 最小, 最大, batch上限, downscale_ratio_spacial)# · 尺寸步长 = 各模型**官方最小步长**（= 下采样 × patch2）：
# Anima/Boogu/SDXL = 8（/8）、Flux2 = 16（/16）、Krea2/SD3/Z-image = 16（/8×patch2）、
# Qwen-image = 32（用户指定：Qwen 系工作流习惯锁 32）、Hunyuan = 32（/32）。
# 不做全局统一的 32，避免把 1080 这类尺寸无谓地顶到 1088。# · downscale_ratio_spacial = 官方 EmptyLatentImage/EmptySD3 带回的元数据（供
# comfy/sample.py:fix_empty_latent_channels 判断是否需要缩放尺寸）
_OFFICIAL_LATENT_ROWS = [
("Anima", 16, 8, 8, 8, 16, MAX_RESOLUTION, 4096, 8),
@@ -68,7 +73,7 @@ _OFFICIAL_LATENT_ROWS = [
("Flux2", 128, 16, 16, 16, 16, MAX_RESOLUTION, 4096, 16),
("Hunyuan", 64, 32, 32, 32, 64, MAX_RESOLUTION, 4096, 32),
("Krea2", 16, 8, 8, 16, 16, MAX_RESOLUTION, 4096, 8),
("Qwen-image", 16, 8, 8, 16, 16, MAX_RESOLUTION, 4096, 8),
("Qwen-image", 16, 8, 8, 32, 32, MAX_RESOLUTION, 4096, 8),
("SD3", 16, 8, 8, 16, 16, MAX_RESOLUTION, 4096, 8),
("SDXL", 4, 8, 8, 8, 16, MAX_RESOLUTION, 4096, 8),
("Z-image", 16, 8, 8, 16, 16, MAX_RESOLUTION, 4096, 8),
@@ -85,18 +90,38 @@ LATENT_KIND_SPEC = {
}
# 默认值固定为 Z-image（不随选项排序变化，保证老工作流/默认体验不变）
DEFAULT_LATENT_KIND = "Z-image"
# 人物三视图预设句（面板「输出设置」里唯一可编辑的预设文本；仅三视图模式可编辑）
THREE_VIEW_TEXT = {
LANG_ZH: "生成平行排列的角色概念设计图，画面从左到右由四个独立面板组成："
"第一个面板是角色面部的精细特写肖像，第二个面板是人物正面全身站姿，"
"第三个面板是人物侧面全身站姿，第四个面板是人物背面全身站姿。",
OUTPUT_LANGS[1]: "Generate a character concept design sheet arranged in parallel panels, "
"the image is composed of four separate panels from left to right: "
"the first panel is a finely detailed close-up portrait of the character's face, "
"the second panel is a full-body front standing pose, "
"the third panel is a full-body side standing pose, "
"the fourth panel is a full-body back standing pose.",
# 各预设模式的默认预设句（可编辑字段 three_view_text 的默认值）：按「预设模式 × 输出语言」给。
# · 常规文生图 = 无预设句（原样输出正文，用户完全可控）
# · 人物三视图 / 人物四视图 / 背景纯透明 = 成句时自动把预设句拼在正文前（中文「。」/英文 ". "）
PRESET_TEXT = {
MODE_THREE_VIEW: {
LANG_ZH: "生成平行排列的角色概念设计图，画面从左到右由四个独立面板组成："
"第一个面板是角色面部的精细特写肖像，第二个面板是人物正面全身站姿，"
"第三个面板是人物侧面全身站姿，第四个面板是人物背面全身站姿。",
OUTPUT_LANGS[1]: "Generate a character concept design sheet arranged in parallel panels, "
"the image is composed of four separate panels from left to right: "
"the first panel is a finely detailed close-up portrait of the character's face, "
"the second panel is a full-body front standing pose, "
"the third panel is a full-body side standing pose, "
"the fourth panel is a full-body back standing pose.",
},
MODE_FOUR_VIEW: {
LANG_ZH: "生成四宫格排列的角色概念设计图，画面左上角面板是角色面部的精细特写肖像，"
"画面右上角面板是角色面部侧面的的精细特写肖像，"
"画面左下角面板是无头部的人物正面身体站姿，画面右下角面板是人物背面全身站姿。",
OUTPUT_LANGS[1]: "Generate a character concept design sheet arranged in a 2x2 grid, "
"the top-left panel is a finely detailed close-up portrait of the character's face, "
"the top-right panel is a finely detailed close-up profile portrait of the character's face, "
"the bottom-left panel is a full-body front standing pose without the head, "
"the bottom-right panel is a full-body back standing pose.",
},
MODE_TRANSPARENT: {
LANG_ZH: "生成一张具有透明度的 RGBA 格式图像，包含 Alpha 通道，背景为纯透明。",
OUTPUT_LANGS[1]: "Generate an RGBA image with an alpha channel and a fully transparent background.",
},
}
# 兼容旧引用（三视图预设句）
THREE_VIEW_TEXT = PRESET_TEXT[MODE_THREE_VIEW]
# 元素分类白名单（必须与 js/xb_image_prompt_preset.js 的 CATEGORIES 顺序逐字一致；
# 自测会断言两者相等）。这里只用来过滤配置里的脏数据。
@@ -297,17 +322,18 @@ def build_empty_latent(latent_kind, width, height, batch_size=1):
# 提示词拼装
# ============================================================================
def build_prompt(lang, preset_mode, three_view_text, body):
"""预设句（仅人物三视图） + 正文，按输出语言使用合适的分句符。
"""预设句（人物三视图 / 人物四视图 / 背景纯透明） + 正文，按输出语言使用合适的分句符。
正文 = 节点表面提示词框（也等于面板预览框，两者双向同步）。
常规文生图：预设句不参与 → 原样输出正文（保持用户完全可控）。
"""
core = (body if isinstance(body, str) else "").strip()
mode = _pick(PRESET_MODES, preset_mode, PRESET_MODES[0])
if mode != MODE_THREE_VIEW:
defaults = PRESET_TEXT.get(mode)
if not defaults:
return core
lg = _pick(OUTPUT_LANGS, lang, LANG_ZH)
preset = _as_str(three_view_text).strip() or THREE_VIEW_TEXT[lg]
preset = _as_str(three_view_text).strip() or defaults[lg]
if not core:
return preset
if lg == OUTPUT_LANGS[1]:
@@ -321,7 +347,7 @@ def build_prompt(lang, preset_mode, three_view_text, body):
class XB_ImagePromptPreset:
"""XB-BOX - 🖼️ 生图提示词预设：画幅参数 + 提示词拼装 + 官方空 latent 一体化。
· 表面参数顺序 = 输出语言 / 预设模式 / 空latent类型 / 三视图预设句（仅三视图模式显示）
· 表面参数顺序 = 输出语言 / 预设模式 / 空latent类型 / 预设句（三视图·四视图·背景纯透明 显示）
/ 画幅比例 / 宽度 / 高度 / 生成数量；
· 「提示词」输出 = 预设句（人物三视图）+ 节点提示词框正文；
· 「空latent」输出 = 官方空 latent（见 LATENT_KINDS，共 9 种，逐字段对齐，选项按首字母排列）。
@@ -335,24 +361,25 @@ class XB_ImagePromptPreset:
"latent_kind": (list(LATENT_KINDS), {
"default": DEFAULT_LATENT_KIND,
"tooltip": "空latent类型：选你正在用的模型即可（自动适配形状/下采样/步长）。\n"
"Z-image 16ch·/8·16　Flux2 128ch·/16·16　Qwen-image 16ch·/8·16\n"
"Z-image 16ch·/8·16　Flux2 128ch·/16·16　Qwen-image 16ch·/8·32\n"
"Krea2 16ch·/8·16　Anima 16ch·/8·8　Boogu 16ch·/8·8\n"
"SDXL 4ch·/8·8　SD3 16ch·/8·16　Hunyuan 64ch·/32·32\n"
"（通道/下采样/步长均按官方 latent_format；选错一般也能跑，但选对更稳）",
"（步长 = 各模型官方最小步长，仅 Qwen-image 按需求锁 32；通道/下采样同样按官方 latent_format）",
}),
# ── 以下 3 项由原「⚙️ 输出设置」面板上提为节点表面参数 ──
"output_lang": (list(OUTPUT_LANGS), {
"default": LANG_ZH,
"tooltip": "输出语言：影响「人物三视图」预设句、元素拼装分隔符（面板里新加入的词条也按此语言）",
"tooltip": "输出语言：影响预设句、元素拼装分隔符（面板里新加入的词条也按此语言）",
}),
"preset_mode": (list(PRESET_MODES), {
"default": PRESET_MODES[0],
"tooltip": "预设模式：常规文生图=只输出正文（完全可控）；"
"人物三视图=成句自动在正文前加三视图预设句（下方预设句框仅此模式显示）",
"人物三视图 / 人物四视图 / 背景纯透明 = 成句自动在正文前加对应预设句"
"（下方预设句框仅这三个模式显示，切模式时未改过的默认句会自动跟随）",
}),
"three_view_text": ("STRING", {
"default": THREE_VIEW_TEXT[LANG_ZH], "multiline": True,
"tooltip": "人物三视图预设句（仅「人物三视图」模式生效；切到常规文生图时本框会自动隐藏）",
"tooltip": "预设句（人物三视图 / 人物四视图 / 背景纯透明 三个模式生效；常规文生图时本框自动隐藏）",
}),
"aspect_ratio": (list(ASPECT_RATIO_OPTIONS), {
"default": "Free",
@@ -361,12 +388,12 @@ class XB_ImagePromptPreset:
}),
"width": ("INT", {
"default": 1024, "min": SIZE_MIN, "max": MAX_RESOLUTION, "step": SIZE_STEP,
"tooltip": "图片宽度（像素）。固定比例下改宽度会按比例重算高度；实际步长按「空latent类型」"
"（SDXL/Anima/Boogu=8，其余多为 16，Hunyuan=32）",
"tooltip": "图片宽度（像素）。固定比例下改宽度会按比例重算高度；步长按「空latent类型」的官方最小步长"
"（SDXL/Anima/Boogu=8，Flux2/Krea2/SD3/Z-image=16，Qwen-image/Hunyuan=32）",
}),
"height": ("INT", {
"default": 1024, "min": SIZE_MIN, "max": MAX_RESOLUTION, "step": SIZE_STEP,
"tooltip": "图片高度（像素）。固定比例下改高度会按比例重算宽度；实际步长按「空latent类型」",
"tooltip": "图片高度（像素）。固定比例下改高度会按比例重算宽度；步长按「空latent类型」的官方最小步长（8/16/32）",
}),
"batch_size": ("INT", {
"default": 1, "min": 1, "max": BATCH_MAX,
@@ -376,7 +403,7 @@ class XB_ImagePromptPreset:
"internal_prompt": ("STRING", {
"default": "", "multiline": True, "advanced": True,
"tooltip": "节点内编辑的提示词正文（与元素面板的预览框双向同步，随工作流保存）。"
"人物三视图模式下，本字段前面会自动拼上三视图预设句",
"人物三视图 / 人物四视图 / 背景纯透明模式下，本字段前面会自动拼上对应预设句",
}),
"manager_settings": ("STRING", {
"default": "", "multiline": True, "advanced": True,
@@ -392,7 +419,7 @@ class XB_ImagePromptPreset:
CATEGORY = "XB_ToolBox/Image_Params"
DESCRIPTION = ("生图提示词预设：空latent类型（主流模型一键适配 Z-image/Flux2/Qwen-image/Krea2/"
"Anima/Boogu/SDXL/SD3/Hunyuan）+ 输出语言/预设模式 + 画幅比例/宽度/高度/生成数量"
"（步长锁定 + 比例联动）＋ 提示词拼装（6 大类：风格/装扮/主体/姿态/光影/背景）。"
"（步长按各模型官方最小步长 8/16/32 + 比例联动）＋ 提示词拼装（8 大类：风格/视角/主体/姿态/穿搭/道具/光影/背景）。"
"输出：①提示词 ②空latent。")
@classmethod
@@ -413,7 +440,7 @@ class XB_ImagePromptPreset:
# ② 空 latent（官方同款张量）
latent = build_empty_latent(latent_kind, w, h, batch_size)
# ③ 提示词（三视图预设句 + 正文）
# ③ 提示词（预设句 + 正文）
prompt = build_prompt(output_lang, preset_mode, three_view_text, internal_prompt)
# ④ 控制台日志（节点表面不再有信息行，调试信息只打日志）
@@ -434,7 +461,7 @@ class XB_ImagePromptPreset:
__all__ = [
"XB_ImagePromptPreset",
"ASPECT_RATIO_OPTIONS", "ASPECT_RATIO_MAP", "SIZE_STEP", "SIZE_MIN", "MAX_RESOLUTION",
"BATCH_MAX", "OUTPUT_LANGS", "PRESET_MODES", "THREE_VIEW_TEXT",
"BATCH_MAX", "OUTPUT_LANGS", "PRESET_MODES", "PRESET_TEXT", "THREE_VIEW_TEXT",
"LATENT_KINDS", "LATENT_KIND_SPEC", "DEFAULT_LATENT_KIND", "ELEMENT_CATEGORIES",
"default_settings", "parse_settings", "round_step", "normalize_size",
"latent_kind_spec", "latent_step_of", "latent_shape_of",