ComfyUI-Speech-Bubble 是一款漫画风格对话气泡自定义节点，用于图像生成之后叠加漫画文本框，主打日系漫画排版，支持日语竖排、多语言横排文本，自带多种气泡形态，细节贴合漫画出版规范。
- GitHub：https://github.com/miya805843/ComfyUI-Speech-Bubble
核心排版特色
- 日语竖排原生支持：传统从右至左竖列阅读；日语逗号「、」句号「。」自动吸附到前一字右下角，标点位置符合日系漫画规范；括号、破折号、长音符号自动旋转适配竖排。用全角空格、空行即可控制缩进换行。
- 文本两种模式：vertical 竖排、horizontal 横排。
四种程序化气泡样式，seed控制随机形态
ellipse：经典椭圆对话气泡rounded_rect：圆角矩形旁白框thought：云朵思考气泡，附带点状拖尾shout：爆炸喊叫气泡，带尖锐手绘尖刺
思考气泡的云朵起伏、喊叫气泡的尖刺都由 seed 控制随机生成，每次可以得到不一样的有机手绘感造型。
气泡与布局控制
- 气泡尾巴方向可选：bottom_left / bottom_right / top_left / top_right / none，tail_length 滑块调节尾巴长度，方便对准角色嘴巴；
- 独立气泡透明度：
bubble_opacity单独控制气泡背景，文字和描边可以保持完全清晰； - 位置使用归一化坐标 pos_x / pos_y（0~1），方便适配不同分辨率画布；
- 2倍超采样 + Lanczos 缩小渲染，抗锯齿效果优秀。
字体能力
自动读取 Windows / macOS / Linux 系统内安装的 TrueType/OpenType 字体，读取字体Name Table显示字体官方名称；也可以把 ttf/otf/ttc 字体放进节点内部 fonts/ 文件夹直接加载，适配各类日系漫画字体。
安装与依赖
cd ComfyUI/custom_nodes/
git clone https://github.com/miya805843/ComfyUI-Speech-Bubble.git
重启 ComfyUI 即可加载。
依赖：Pillow >=9.5.0、numpy，torch 随 ComfyUI 自带。
主要可调参数
气泡位置、字号、文字/气泡/边框色、边框粗细、内边距、单行最大字符、行间距、云朵/尖刺凸起强度、整体透明度、随机种子等。
| 参数 | 类型 | 默认 | 描述 |
|---|---|---|---|
| image | IMAGE | – | 来自生成器节点（如 KSampler）的输入图像张量。 |
| text | STRING | 多行 | 对话或标题文本。全角空格（ ）可用于缩进。 |
| direction | ENUM | vertical | 文本方向：vertical（日本漫画风格）或 horizontal。 |
| bubble_type | ENUM | ellipse | 气泡形状：ellipse、rounded_rect、thought 或 shout。 |
| tail_direction | ENUM | bottom_left | 尾巴方向：bottom_left、bottom_right、top_left、top_right 或 none。 |
| tail_length | FLOAT | 0.7 | 尾巴长度乘数（0.0 到 3.0）。设为 0.0 表示无尾巴。 |
| pos_x / pos_y | FLOAT | 0.5, 0.35 | 图像上归一化的气泡中心位置（0.0 到 1.0）。 |
| font_name | ENUM | 系统默认 | 从系统字体或本地 fonts/ 文件夹选择的字体。 |
| font_size | INT | 36 | 字体大小（像素）。 |
| text_color | STRING | #000000 | 对话文本的十六进制代码或颜色名称。 |
| bubble_color | STRING | #FFFFFF | 气泡背景的十六进制代码或颜色名称。 |
| border_color | STRING | #000000 | 轮廓边框颜色。 |
| border_width | INT | 3 | 边框厚度（像素）。 |
| bubble_opacity | FLOAT | 1.0 | 背景不透明度（0.0 到 1.0），以透过气泡显露头发或背景。 |
| padding | INT | 24 | 文本和气泡边界之间的内边距。 |
| max_chars_per_line | INT | 10 | 每列/行的自动换行字符限制。 |
| line_spacing | INT | 6 | 行或竖列之间的间距。 |
| thought_bump_size | FLOAT | 1.0 | 思考（云）凸起和喊叫（尖刺）峰高的大小乘数（0.2 到 3.0）。调整云朵蓬松度或喊叫尖刺强度。 |
| opacity | FLOAT | 1.0 | 整个对话气泡和文本的总体不透明度（0.0 到 1.0）。 |
| seed | INT | 0 | 思考（云）和喊叫（尖刺）程序化形状的随机种子。 |
© 版权声明
文章版权归作者所有，未经允许请勿转载。
