# ComfyUI-PersianText 插件新手保姆级教程 ## 1. 插件简介 ComfyUI-PersianText 是一个专门为 ComfyUI 设计的文字渲染插件，它的神奇之处在于能够完美支持波斯语（法尔西语）、阿拉伯语和英语等多种语言的文字生成。 插件地址：https://github.com/shahkoorosh/ComfyUI-PersianText 这个插件就像一个超级强大的"文字工厂"，能够： - 生成漂亮的波斯语、阿拉伯语文字（这些语言的文字是从右到左写的，跟中文英文相反） - 同时支持英文和拉丁文字 - 给文字添加各种炫酷的样式，比如阴影、旋转、颜色等 - 制作海报、多语言设计时特别好用 简单来说，就是把你输入的文字变成美美的图片，而且特别擅长处理那些"反向书写"的语言。 ## 2. 如何安装 有两种安装方法，推荐第一种： ### 方法一：使用 Comfy Manager（推荐） 1. 打开 ComfyUI 2. 在 Comfy Manager 中搜索 "PersianText" 3. 点击安装即可 ### 方法二：手动安装 1. 找到你的 ComfyUI 文件夹中的 `custom_nodes` 文件夹 2. 在命令行中输入：`git clone https://github.com/shahkoorosh/ComfyUI-PersianText.git` 3. 进入插件文件夹，运行：`pip install -r requirements.txt` 4. 重启 ComfyUI ### 特别注意 这个插件需要安装一个叫 `python-bidi` 的依赖包，这个包就像是"文字方向管理器"，专门处理从右到左的文字排列。如果安装过程中遇到问题，按照插件页面的详细指导操作即可。 ## 3. 节点详解 ### 3.1 PersianText 节点是干嘛的？ PersianText 节点就像一个"万能文字美化器"，你把想要的文字、样式要求告诉它，它就能给你生成一张漂亮的文字图片。这个节点在 ComfyUI 的节点菜单中位于 `🎨KG` 分类下。 ### 3.2 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | |:---|:---|:---|:---|:---|:---|:---| | Text | text | 文本字符串 | 你想要的文字 | 就是你要写在图片上的话 | 输入待渲染的文本内容 | 输入"سلام"（波斯语你好）或"Hello World" | | Farsi/Arabic Font | farsi_font | 下拉菜单选项 | 看你喜欢哪个 | 选择波斯语和阿拉伯语用什么字体 | 设置波斯语/阿拉伯语文本的字体样式 | 选择你放在Fonts文件夹里的.ttf字体文件 | | English/Latin Font | english_font | 下拉菜单选项 | 看你喜欢哪个 | 选择英文用什么字体 | 设置英文/拉丁文本的字体样式 | 选择Arial或者其他英文字体 | | Size | size | 整数 1-256 | 32-64 | 文字大小，就像调节字号 | 设置字体大小 | 想要大标题就设置128，小字就设置16 | | Text Color | text_color | 颜色选择 | 黑色/白色 | 文字是什么颜色的 | 从预设调色板中选择文字颜色 | 选择"black"让文字是黑色 | | Text Color Hex | text_color_hex | 颜色代码 | #000000 | 用颜色代码精确设置文字颜色 | 使用十六进制颜色代码自定义文字颜色 | 输入"#FF0000"让文字变红色 | | Background Color | bg_color | 颜色选择 | 白色/透明 | 文字背景是什么颜色 | 从预设调色板中选择背景颜色 | 选择"white"给文字加白色背景 | | Background Color Hex | bg_color_hex | 颜色代码 | #FFFFFF | 用颜色代码精确设置背景颜色 | 使用十六进制颜色代码自定义背景颜色 | 输入"#00FF00"让背景变绿色 | | Horizontal Align | h_align | left/center/right | center | 文字在画布上左中右哪个位置 | 设置文本的水平对齐方式 | 选择"center"让文字居中显示 | | Vertical Align | v_align | top/center/bottom | center | 文字在画布上上中下哪个位置 | 设置文本的垂直对齐方式 | 选择"top"让文字靠上显示 | | Image Width | width | 整数 1-4096 | 512 | 生成图片的宽度，像素单位 | 设置画布宽度 | 设置512生成512像素宽的图片 | | Image Height | height | 整数 1-4096 | 512 | 生成图片的高度，像素单位 | 设置画布高度 | 设置512生成512像素高的图片 | | Rotation | rotation | 浮点数 -360到360 | 0 | 文字旋转角度，0是不转 | 设置文字围绕中心旋转的角度 | 设置45让文字倾斜45度 | | Offset X | offset_x | 整数 -256到256 | 0 | 文字左右微调位置 | 设置文字的水平偏移量 | 设置10让文字向右移动10像素 | | Offset Y | offset_y | 整数 -256到256 | 0 | 文字上下微调位置 | 设置文字的垂直偏移量 | 设置-10让文字向上移动10像素 | | Shadow Distance | shadow_distance | 浮点数 0-256 | 2 | 阴影离文字多远 | 设置阴影的偏移距离 | 设置5让阴影离文字远一点 | | Shadow Blur | shadow_blur | 浮点数 0-256 | 2 | 阴影模糊程度，0最清晰 | 设置阴影的模糊强度 | 设置10让阴影很模糊很柔和 | | Shadow Color | shadow_color | 颜色选择 | 灰色/黑色 | 阴影是什么颜色 | 从预设调色板中选择阴影颜色 | 选择"gray"让阴影是灰色 | | Shadow Color Hex | shadow_color_hex | 颜色代码 | #808080 | 用颜色代码精确设置阴影颜色 | 使用十六进制颜色代码自定义阴影颜色 | 输入"#000000"让阴影是纯黑色 | | Padding | padding | 整数 0-256 | 20 | 文字周围留多少空白 | 设置文字周围的边距 | 设置50让文字周围有很多空白 | | Transparent Background | transparent_bg | 布尔值 | false | 要不要透明背景 | 启用透明背景选项 | 设置true生成无背景的文字图片 | ## 4. 使用技巧和建议 ### 4.1 字体选择技巧 - 波斯语和阿拉伯语：推荐使用专门的RTL字体，比如Noto Sans Arabic - 英文：任何常见的英文字体都可以，Arial、Times New Roman等都不错 - 把你的字体文件（.ttf或.otf格式）放到插件的Fonts文件夹里 ### 4.2 颜色搭配建议 - 文字和背景要有足够的对比度，比如白底黑字、黑底白字 - 阴影颜色通常比文字颜色深一些 - 用颜色代码(Hex)可以获得更精确的颜色控制 ### 4.3 尺寸设计要点 - 制作海报：建议画布设置为1024x1024或更大 - 普通用途：512x512通常够用 - 文字大小要根据画布大小调整，大画布用大字号 ### 4.4 特效使用心得 - 适度的阴影能让文字更有层次感 - 旋转功能适合制作艺术感强的设计 - 偏移功能适合微调文字位置 ## 5. 常见问题解答 ### Q1：为什么我的波斯语/阿拉伯语文字显示不正确？ A：检查是否正确安装了python-bidi依赖包，这个包专门处理从右到左的文字排列。 ### Q2：字体下拉菜单是空的怎么办？ A：需要在插件的Fonts文件夹里添加字体文件（.ttf或.otf格式）。 ### Q3：颜色代码不生效怎么办？ A：确保颜色代码格式正确，比如#FF0000，有或没有#号都可以。 ### Q4：生成的图片太小/太大？ A：调整Image Width和Image Height参数，同时相应调整字体大小。 ### Q5：阴影效果不明显？ A：增加Shadow Distance和Shadow Blur的值，同时确保阴影颜色与背景有足够对比度。 ## 6. 高级应用场景 ### 6.1 多语言海报制作 结合不同的字体和颜色，制作包含多种语言的精美海报。 ### 6.2 社交媒体图文 为Instagram、Facebook等平台制作带有多语言文字的图片。 ### 6.3 教育材料 制作语言学习相关的图文材料，特别适合阿拉伯语、波斯语教学。 ### 6.4 品牌设计 为面向中东市场的品牌制作带有阿拉伯语或波斯语的宣传材料。 这个插件简单易用，功能强大，特别适合需要处理多语言文字的设计工作。通过合理搭配各种参数，你可以创造出专业级的文字效果图片。
ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44 ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件，就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址：https://github.com/LingSss9/com
%20(1).png)
