ComfyUI WebUI Prompt Bridge 是一个给 ComfyUI 使用的 WebUI 式提示词工作台。它把 WebUI 里顺手的提示词输入、Tag 编辑、中文翻译、自动补全、收藏、负面词管理、LoRA 浏览/加载、Styles、区域提示词控制和常用生成参数接管搬进 ComfyUI，让复杂工作流也能拥有接近 WebUI 的操作体验。

很多人用 ComfyUI 时会遇到两个问题：

ComfyUI 的普通文本框适合连接节点，但不适合大量编辑 Tag。
WebUI 的提示词体验很好，但工作流能力不如 ComfyUI 灵活。

这个节点就是把两边的优点合到一起：ComfyUI 负责工作流，WebUI Prompt Bridge 负责提示词、LoRA、区域控制和常用生成助手。

Bridge 现在更像一个完整的提示词工作台：常用的提示词编辑、模型切换、LoRA 浏览、布局控制和生成参数接管默认可用；区域控制、Styles、ADetailer、ControlNet、SAM/Inpaint、Mask、图生图和放大修复可以在 设置 里按需打开，并支持一键构建对应外置节点。

新用户可以先从中文最小工作流教程开始：docs/tutorial-minimal-workflows.md。教程分别演示 Anima 分体模型、XL 整合 checkpoint 和 XL 图生图的最小接线，并配有截图和可直接拖入 ComfyUI 的 JSON 工作流。

最新更新：v0.4.30

提示词输入更跟手：跳过未变化控件的重复回写，连续输入时合并卡片刷新和工作流状态提交，避免每个字符都克隆整份工作流。
拖动与缩放更流畅：节点宽高、侧栏和区域分隔条在拖动期间只更新界面，结束时统一保存布局。
端口标签更轻量：静止画布不再每帧扫描节点和覆盖层；平移、缩放和节点移动时仍会平滑跟随。
提示词小节点同步优化：正向、反向提示词小节点也会合并连续输入期间的卡片重建和工作流通知。
文档补全：新增完整功能说明，并明确“读图提示词”和“图生图 / 局部重绘”是两条独立流程。

完整细节见 CHANGELOG.md 和 v0.4.30 发布说明。更新后请重启 ComfyUI，并按 Ctrl+F5 强制刷新浏览器页面。

v0.4.x 更新概要

v0.4.x 的更新可以概括为一句话：Bridge 已从提示词输入节点升级成 WebUI 式提示词工作台。

它现在集中处理提示词/反向词编辑、LoRA 浏览与真实加载、模型切换、布局预设、区域控制、图生图、生成参数接管和常用高级模块入口。近期更新主要围绕四点：旧工作流兼容、节点布局稳定、LoRA/提示词编辑手感，以及宽高/Steps/Seed 与实际生图参数保持一致。

完整更新记录见 CHANGELOG.md。

节点特写

WebUI Prompt Bridge node close-up

这个节点不是普通的大文本框，而是一个完整的提示词操作面板。新版面板把 Prompt、反向词、模型切换、LoRA 卡片库、布局预设、区域控制入口和高级模块助手集中到一个节点里：

可以直接输入中文自然语言，并自动翻译成更适合模型的英文提示词。
可以把提示词拆成一个个标签块，方便编辑、删除、禁用、复制、加权和拖拽排序。
可以像 WebUI 一样浏览分类标签，例如人物、服饰、表情、动作、画面、环境、负面词等。
可以收藏常用提示词，也可以读取历史记录。
可以读取 WebUI 的 styles.csv 样式。
可以接入 WebUI 的 Prompt All in One 和 TagComplete 数据。
可以识别 <lora:name:weight>，检查 LoRA 是否存在，并真正应用到 ComfyUI 的 model / clip 链路里。
可以在节点内直接浏览 LoRA / LyCORIS 卡片库，按文件夹、分类、模型版本和整理状态过滤。
可以读取 LoRA 预览图、训练 metadata、触发词、推荐权重、说明和手动分类，并在卡片里快速插入。
可以在面板右侧切换分体 Anima/Qwen 或整合 checkpoint，并在提交生成前做常见参数检查。
可以按需显示区域表格、负向 Common、区域翻转和区域 Preset，不需要先额外添加一串区域控制节点。
可以按需显示 ADetailer、ControlNet、SAM/Inpaint、Mask 和放大修复模块，并一键构建可接入工作流的外置节点。

主要功能

中文自动翻译：输入中文后可以转成英文提示词，适合不想手写英文 Tag 的用户。
WebUI 式标签编辑：提示词以标签块显示，可视化操作比纯文本更直观。
精确排序与微调：换行后的 Tag 也能按二维位置拖放；可多选整体移动，并用按钮或 Alt+←/→ 前后移动一位。
自动补全：节点随包自带完整 Danbooru 主 Tag 数据和中文解释；输入字母即可看到 Tag、中文含义和热度数量，不需要另外安装 WebUI 或 TagComplete。
收藏提示词：常用角色、服装、画风、表情、动作可以收藏起来反复使用；支持父级/子级分类、拖放归类、全库搜索和每页 100 条分页。
负面词管理：正向提示词和反向提示词都可以分块编辑。
LoRA 真实加载：不是只把 LoRA 文本塞进 prompt，而是解析 LoRA 标签后调用 ComfyUI 的 LoRA 加载逻辑。
LoRA 缺失提醒：找不到 LoRA 时可以直接报错，避免你以为 LoRA 生效了但其实没用。
LoRA 卡片管理：读取本地 LoRA 预览图和 safetensors metadata，支持搜索、分类、整理状态、触发词和推荐权重。
模型快速切换：在 Bridge 面板里选择 diffusion_models 中的分体 UNET 或任意整合 checkpoint；切换 UNET 时沿用当前 Text Encoder/VAE，并保护节点与连线。
从图片读取 Prompt：点击主节点顶部的“读图提示词”（右侧“布局与工具”里也保留紧凑入口），从 PNG/JPEG/WebP 的原始 metadata 读回 Bridge 正反 Prompt，并兼容 A1111 parameters 回退；应用前可选择候选和覆盖方向。
生成参数接管：在侧边栏直接读取和应用出图宽高、Steps、Seed 与 Seed 模式；有上游参数时优先同步上游，没有上游时使用节点内置值。
区域控制内置：区域提示词、区域 conditioning、区域表格、负向 Common、区域翻转和区域 Preset 都在主节点里配置，不需要先额外添加一串模块节点。
样式和布局内置：尺寸快捷、布局预设和显示/隐藏设置默认放在主节点侧栏里；Styles 起手式可在设置里按需显示。
生成前检查：提交前检查空数字参数、Prompt/Negative 放反、悬空连接等常见问题，并尽量自动修复。
WebUI 数据桥接：可以复用本机 WebUI 扩展里的标签、收藏、翻译配置和样式。

更细的功能说明、全部辅助节点和高级模块能力边界，请看 WebUI Prompt Bridge 完整功能说明。

其中“读图提示词”和“图生图 / 局部重绘”是两个独立功能：前者从图片 metadata 找回正反 Prompt，后者把图片作为实际生成输入。只想恢复以前图片中的提示词时，不需要接 VAE Encode 或 KSampler。

模型切换说明

Anima workflow model switch

工作流里有一个模型模式开关：

模型模式：分体Anima/Qwen ON，关闭=整合Checkpoint

它的含义是：

开关 ON：使用分体模型，也就是 UNET + CLIP + VAE。模型下拉会列出 diffusion_models 中的 UNET；选择后只更换当前 Bridge 对应的 UNETLoader.unet_name，继续沿用现有 CLIP 和 VAE。
开关 OFF：使用普通整合 checkpoint，也就是 CheckpointLoaderSimple。适合 SD1.5、SDXL、Pony、Illustrious、Qwen-Rapid-AIO 这类整合模型。

如果当前 Bridge 无法唯一定位一个可用的 UNETLoader，切换会被拒绝并显示原因，不会批量修改工作流中的全部 Loader。分体 UNET、Text Encoder 和 VAE 的架构兼容性仍需由用户确认。

已验证：

分体 Anima/Qwen 模式可以正常生成。
整合 Checkpoint 模式可以用 waiANINSFWPONYXL_v60.safetensors 正常生成。
从分体 Anima/Qwen 切回整合 XL 后再次生成也正常。

注意：切到普通 SDXL / Pony / Illustrious checkpoint 时，需要关闭参考图、Qwen Union 姿势控制等 Qwen 专用分支，避免编码器或模型结构不兼容。

需要准备的模型

推荐工作流默认会用到这些文件名：

anima_baseV10.safetensors
anima_baseV10_txt.safetensors
qwen_image_vae.safetensors
RealESRGAN_x4plus_anime_6B.pth
可选整合模型：Qwen-Rapid-AIO-NSFW-v16.safetensors
可选姿势 LoRA：qwen_image_union_diffsynth_lora.safetensors
可选 DWPose 检测器：yolox_l.torchscript.pt

仓库不包含任何模型、LoRA、VAE、放大模型或检测器文件。你需要自己下载并放到 ComfyUI 对应模型目录里。发布或分享工作流时也要注意每个模型自己的授权协议。

安全注意事项

这个节点会读取本机 WebUI/ComfyUI 的样式、提示词词库、LoRA metadata 和预览图，也会在用户主动操作时写入 config.local.json、styles.csv、Prompt-All-in-One storage 以及 LoRA 旁边的 metadata/preview 文件。请只接入你信任的 WebUI 目录，不要把未加认证的 ComfyUI 暴露到公网或不可信局域网。

后端接口会校验请求来源和 Host，并限制上传图片类型、体积、像素数、动画帧数和文本字段长度。默认只信任本机名、localhost 和 IP 地址；如果你通过自定义域名反向代理 ComfyUI，请用 WEBUI_PROMPT_BRIDGE_ALLOWED_HOSTS=你的域名 显式加入允许列表，并确保代理正确传递 Host、Origin 或 Referer 头。

Windows 下保存的 AI API Key 会使用当前用户的 DPAPI 凭据保护，同时收紧 config.local.json 文件权限；更换 AI Base URL 时需要重新输入 Key，避免旧 Key 被发送到新地址。非本机的 AI HTTP 地址默认被拒绝，可信内网服务可显式设置 WEBUI_PROMPT_BRIDGE_ALLOW_INSECURE_AI_HTTP=1。WebUI/模型数据路径默认拒绝 UNC、设备路径和映射网络盘，防止远程共享触发凭据泄露或代码加载；确有可信网络盘需求时可显式设置 WEBUI_PROMPT_BRIDGE_ALLOW_REMOTE_PATHS=1。

安装方法

方法一：ComfyUI-Manager 安装

本节点已经注册到 Comfy Registry，节点 ID 为：

comfyui-webui-prompt-bridge

在 ComfyUI-Manager 中搜索下面任意关键词：

ComfyUI WebUI Prompt Bridge

comfyui-webui-prompt-bridge

点击安装并重启 ComfyUI。

方法二：通过 Git URL 安装

如果 ComfyUI-Manager 的本地索引还没有刷新，可以在 Manager 里使用 Install via Git URL，填入：

https://github.com/dianfangsihuo/ComfyUI-WebUI-Prompt-Bridge.git

安装完成后重启 ComfyUI。

方法三：手动安装

把仓库克隆到 ComfyUI/custom_nodes：

git clone https://github.com/dianfangsihuo/ComfyUI-WebUI-Prompt-Bridge.git

如果你的 ComfyUI 环境缺依赖，再安装：

pip install -r ComfyUI-WebUI-Prompt-Bridge/requirements.txt

重启 ComfyUI 后，在节点菜单里添加：

conditioning/webui -> WebUI Prompt Bridge

Registry 页面：

https://registry.comfy.org/nodes/comfyui-webui-prompt-bridge

接入本机 WebUI 数据

没有本机 WebUI 也可以直接使用节点。GitHub 下载包已经包含自动补全所需的完整 Danbooru 主 Tag 数据和中文解释；首次打开时即使在启动向导里选择 使用内置数据，主节点和正向/负向提示词小节点也会显示英文 Tag、中文含义与热度数量，全程不需要联网。也可以选择 导入词库，从 JSON / CSV / TSV 加入自己的 tag 映射。

如果你还想使用完整的 Prompt All in One 分类等配套数据，可以在节点右侧点 设置 -> 下载本地数据包。节点会把缺少的数据下载到本插件自己的 data 目录，并自动切到可用的数据来源，不需要安装 A1111 或 Forge。

接入的 WebUI 如果没有安装这两个扩展，Bridge 会自动继续使用插件本地已下载的完整数据包，不再退回精简内置词库。分类面板里的 全库搜索 会检索完整 TagComplete 数据；从提示词市场或本地文件导入的词条，可在 设置 -> 编辑词库 中点 清空自定义/市场 一次删除。

默认情况下，Bridge 主节点只显示基础提示词操作、模型切换、尺寸快捷、布局预设和 LoRA 浏览区，侧栏会尽量保持清爽。Styles、区域控制、区域表格、负向 Common、区域翻转和区域 Preset 都是主节点内置能力，不需要额外添加模块节点；需要时可以在 设置 里打开显示。ADetailer、ControlNet、SAM、Ultimate SD Upscale 这类会涉及图片、Mask 或二次处理链路的功能仍作为高级扩展按需打开和下载。

高级扩展模块打开显示后，侧栏里会出现 一键构建...节点 按钮。点击后会在 Bridge 主节点右侧自动创建对应外置节点，并连接 module_config、positive、negative、model、clip 等 Bridge 已知输出。图片、VAE、Mask、ControlNet 模型这类必须由工作流提供的输入，仍需要按当前工作流手动接上。

如果你想要更接近 WebUI 的体验，可以连接你本机的 AUTOMATIC1111 WebUI 目录。推荐安装这两个 WebUI 扩展：

sd-webui-prompt-all-in-one
a1111-sd-webui-tagcomplete

最简单的方法：在节点右侧点击 一键接入 WebUI，只选择或填写 WebUI 根目录，例如 H:/sd-webui-aki-v4.9。节点会自动接入 styles.csv、Prompt All in One、TagComplete、LoRA、checkpoint、VAE、embeddings、ControlNet 等常用数据，不需要用户自己找 CSV 或复制多个路径。

如果你已经有 WebUI，并且 WebUI 里已经装了这两个扩展，不需要下载任何东西，直接 一键接入 WebUI 即可。只有 WebUI 缺少扩展时，才需要在 一键接入 WebUI 窗口点 补齐缺失扩展，或在 设置 里点 补齐 WebUI 扩展。节点会下载缺失项：

https://github.com/Physton/sd-webui-prompt-all-in-one
https://github.com/DominikDoom/a1111-sd-webui-tagcomplete

已存在的扩展会自动跳过，不会重复下载。安装到 WebUI 的 extensions 后，Bridge 会立即刷新可用词库；如果也想在 WebUI 页面里使用这些扩展，重启一次 WebUI。

如果你想在 ComfyUI 里用上修脸、修手、局部重绘、ControlNet、SAM 或放大修复这些能力，也可以在 设置 里按卡片单独下载对应扩展：Impact Pack、Impact Subpack、ControlNet Aux、SAM、Ultimate SD Upscale。这些扩展也是按需下载，不会默认一次全装；装完后重启 ComfyUI，就能继续使用对应功能。ADetailer 主要用于脸部、手部和人物局部修复，属于常见的细节增强工具。

One-click WebUI auto detection

看到 WebUI: ... (9/9) 就表示接入成功。接入后会立即刷新提示词、样式、LoRA 和模型列表。如果按钮提示“后端接口未加载”，重启一次 ComfyUI 再打开节点即可。

如果要手动配置，也可以复制 config.local.example.json 为 config.local.json，然后改成本机路径：

{
  "webui_root": "X:/path/to/stable-diffusion-webui",
  "prompt_all_in_one_dir": "X:/path/to/stable-diffusion-webui/extensions/sd-webui-prompt-all-in-one",
  "tagcomplete_dir": "X:/path/to/stable-diffusion-webui/extensions/a1111-sd-webui-tagcomplete",
  "webui_python_site_packages": "X:/path/to/stable-diffusion-webui/python/Lib/site-packages",
  "styles_file": "X:/path/to/stable-diffusion-webui/styles.csv",
  "model_paths": {
    "loras": "X:/path/to/stable-diffusion-webui/models/Lora",
    "checkpoints": "X:/path/to/stable-diffusion-webui/models/Stable-diffusion",
    "vae": "X:/path/to/stable-diffusion-webui/models/VAE",
    "embeddings": "X:/path/to/stable-diffusion-webui/embeddings",
    "controlnet": "X:/path/to/stable-diffusion-webui/models/ControlNet",
    "upscale_models": "X:/path/to/stable-diffusion-webui/models/ESRGAN",
    "hypernetworks": "X:/path/to/stable-diffusion-webui/models/hypernetworks"
  }
}

config.local.json 不会被提交到 GitHub，所以你的本机路径不会被公开。

LoRA 怎么写

直接在正向提示词里写：

1girl, blue dress, standing by the sea, <lora:my-style-lora:0.75>

节点会做几件事：

从提示词里解析出 LoRA 标签。
到 ComfyUI 的 loras 目录里查找对应文件。
找到后把 LoRA 应用到 model 和 clip。
把 LoRA 标签从最终文本提示词里移除，避免污染编码文本。
如果找不到 LoRA，并且开启了 Missing LoRA stops，就停止生成并报错。

这样可以避免一个很常见的问题：提示词里写了 LoRA，但实际模型根本没加载。

常见问题

怎么从以前生成的图片里找回提示词？

点击主节点顶部的 读图提示词，选择 PNG、JPEG 或 WebP 图片，然后在确认窗口中选择 Prompt 候选和覆盖方向。Bridge 会读取图片原始 metadata，并兼容 A1111 / WebUI parameters；它只恢复正反 Prompt，不会修改模型、Seed、采样器、节点或连线。这个入口和“图生图 / 局部重绘”不同，单纯读提示词不需要连接 VAE Encode 或 KSampler。

为什么我写了 LoRA 但没有效果？

先确认 LoRA 文件真的在 ComfyUI 的 models/loras 目录里，并且名字能被节点匹配到。开启 Missing LoRA stops 后，找不到 LoRA 会直接报错，方便定位问题。

为什么切到普通 checkpoint 后姿势或参考图报错？

有些参考图和姿势分支是给 Qwen / Anima 结构准备的。普通 SDXL、Pony、Illustrious 模型不一定兼容。先关闭这些分支，只保留基础生图，确认能跑后再逐个打开。

为什么自动翻译不完整？

如果没有连接本机 WebUI 的 Prompt All in One 翻译接口，就只能使用内置兜底逻辑。想要更完整的联网翻译，请配置 config.local.json 指向本机 WebUI 扩展目录。

为什么仓库不带模型？

模型、LoRA、VAE、放大模型都有自己的授权协议，不能随便打包进插件仓库。这个项目只发布节点和示例工作流。

参与贡献

欢迎提交可复现的 Bug、性能数据、文档和代码。请先阅读 CONTRIBUTING.md，并使用仓库提供的 Issue / PR 模板。收藏性能问题请使用合成数据说明数量、操作步骤和测量结果，不要上传真实收藏或敏感配置。

大型功能建议先开 Issue 对齐范围；一个 PR 尽量只处理一个主题。代码合入后会保留贡献者署名，问题报告和设计贡献也会在更新日志中致谢。

English Summary

ComfyUI WebUI Prompt Bridge is a WebUI-style prompt workspace for ComfyUI. It combines visual prompt chips, Chinese-to-English translation, tag autocomplete, favorites, styles, prompt history, LoRA browsing/loading, regional prompts, layout presets and optional helper modules inside one Bridge node.

The default UI stays clean for everyday prompt editing, model switching, image size controls and LoRA browsing. Regional controls and advanced helpers such as ADetailer, ControlNet, SAM/Inpaint, Mask and upscale workflows can be shown only when needed. Advanced helper panels can also build external workflow nodes and connect the known Bridge outputs automatically.

The repository includes a recommended Anima workflow, a detailed feature reference, and minimal tutorial workflows for Anima, XL txt2img and XL img2img. The included workflows have been updated for the current v0.4.30 Bridge schema.

License

MIT. See LICENSE.

ComfyUI-WebUI-Prompt-Bridge

Nodes (15)