%20(1).png)
WeiLin-Comfyui-Tools 插件保姆级教程
1. 插件简介
插件地址： https://github.com/weilin9999/WeiLin-Comfyui-Tools
WeiLin-Comfyui-Tools 是一个超级强大的提示词管理工具！它就像一个贴心的小助手，专门帮你管理和编辑 AI 绘画时用的提示词。想象一下，你有一个专门的秘书，帮你整理所有的绘画想法、管理你收集的各种风格模型（Lora），还能自动翻译和补全你的想法 - 这就是这个插件能为你做的事情！
这个插件能给我们带来什么效果？
- 智能提示词编辑器（就像一个会思考的记事本，能自动补全你的想法）
- Lora 模型管理器（就像一个模型收藏夹，帮你整理各种风格）
- 自动翻译功能（中英文随意切换，不用担心语言障碍）
- 历史记录功能（记住你之前用过的好提示词）
- 云端同步功能（和朋友分享你的创意想法）
- 随机标签生成（当你没灵感时，帮你随机生成创意点子）
2. 如何安装
2.1 下载插件
在你的 ComfyUI 安装目录下的 custom_nodes 文件夹里，打开命令行工具，输入：
git clone https://github.com/weilin9999/WeiLin-Comfyui-Tools.git
2.2 自动安装依赖
插件会自动安装所需的依赖包，第一次启动 ComfyUI 时会自动处理。
2.3 重启 ComfyUI
安装完成后重启 ComfyUI，你就能在节点列表中看到 WeiLin 相关的节点了。
3. 节点详细解析
3.1 WeiLinPromptUI 节点（全能提示词编辑器）
这个节点是干嘛的？
这是插件的核心节点，就像一个超级智能的文本编辑器。它不仅能帮你写提示词，还能管理 Lora 模型，就像一个全能的创作助手。你可以在这里输入你的创意想法，它会帮你整理、翻译、补全，甚至还能加载各种风格模型。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| positive | positive | 多行文本 | "" | 这是你写创意想法的地方，就像一个智能记事本 | 正向提示词输入框，支持多行文本输入 | 输入"美丽的女孩，长发飘飘"，系统会自动处理和优化 |
| auto_random | auto_random | 开关按钮 | False | 自动随机生成创意点子的开关，就像掷骰子获得灵感 | 是否启用自动随机标签生成功能 | 开启后会根据模板随机生成提示词，适合没灵感时使用 |
| lora_str | lora_str | 多行文本 | "" | Lora 模型信息存储框，就像一个模型收藏夹 | 存储 Lora 模型配置信息的 JSON 格式文本 | 系统自动填充，不需要手动输入，通过界面操作即可 |
| temp_str | temp_str | 多行文本 | "" | 临时提示词存储区，就像草稿纸 | 临时提示词存储区域 | 存储临时的提示词片段，可以随时调用 |
| temp_lora_str | temp_lora_str | 多行文本 | "" | 临时 Lora 信息存储区，就像临时收藏夹 | 临时 Lora 配置信息存储区域 | 存储临时选择的 Lora 配置，可以随时应用 |
| random_template | random_template | 多行文本 | "" | 随机模板路径，就像抽奖箱的规则设定 | 随机标签生成的模板路径名称 | 填入模板名称，如"人物模板"，系统会根据此模板随机生成 |
| opt_text | opt_text | 任意类型 | "" | 额外文本输入，就像添加调料 | 可选的额外文本输入，支持任意类型 | 可以输入额外的修饰词，会自动合并到主提示词中 |
| opt_clip | opt_clip | CLIP模型 | - | CLIP 文本编码器，就像翻译官 | CLIP 模型输入，用于文本编码 | 连接 CLIP 模型节点，用于将文本转换为 AI 能理解的格式 |
| opt_model | opt_model | 模型 | - | 主模型输入，就像画家的画笔 | 主要的 AI 模型输入 | 连接你要使用的 AI 绘画模型 |
3.2 WeiLinPromptUIWithoutLora 节点（提示词编辑器）
这个节点是干嘛的？
这是一个精简版的提示词编辑器，专门用来处理文字创意，不包含 Lora 模型管理功能。就像一个专门的文字处理器，让你专注于创意文字的编写和优化，界面更简洁，操作更轻便。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| positive | positive | 多行文本 | "" | 创意想法输入区，就像一个专门的创作本 | 正向提示词输入框，专注于文本处理 | 输入你的绘画想法，如"夕阳下的城市街道" |
| auto_random | auto_random | 开关按钮 | False | 随机创意生成器开关，就像创意骰子 | 自动随机标签生成功能开关 | 开启后根据设定的模板自动生成随机提示词 |
| temp_str | temp_str | 多行文本 | "" | 临时想法存储区，就像便签纸 | 临时提示词存储区域 | 保存临时的创意片段，可以随时取用 |
| random_template | random_template | 多行文本 | "" | 随机创意模板设定，就像创意规则书 | 随机生成使用的模板路径 | 设定随机生成的规则，如"风景模板"、"人物模板" |
| opt_text | opt_text | 任意类型 | "" | 额外修饰词输入，就像添加香料 | 可选的额外文本输入 | 添加额外的描述词，会自动与主提示词合并 |
| opt_clip | opt_clip | CLIP模型 | - | 文本理解器，就像 AI 的眼睛 | CLIP 模型输入，用于文本编码处理 | 连接 CLIP 模型，让 AI 理解你的文字描述 |
| unique_id | unique_id | 隐藏参数 | - | 节点唯一标识符，就像身份证号 | 节点的唯一标识符 | 系统自动生成，用于区分不同的节点实例 |
| extra_pnginfo | extra_pnginfo | 隐藏参数 | - | 额外图片信息，就像照片的拍摄信息 | 额外的 PNG 图片信息 | 系统自动处理，包含图片的元数据信息 |
3.3 WeiLinPromptUIOnlyLoraStack 节点（Lora堆）
这个节点是干嘛的？
这是一个专门的 Lora 模型管理器，就像一个专业的模型收藏柜。它只负责管理和应用各种 Lora 模型，不处理文字内容。当你有很多风格模型需要组合使用时，这个节点就像一个调色盘，帮你混合不同的艺术风格。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| clip | clip | CLIP模型 | - | 文本编码器输入，就像语言翻译器 | CLIP 模型输入，必需参数 | 连接 CLIP 模型节点，用于处理文本编码 |
| model | model | 模型 | - | 主模型输入，就像画家的基础技能 | 主要的 AI 模型输入，必需参数 | 连接你要使用的基础 AI 绘画模型 |
| lora_str | lora_str | 多行文本 | "" | Lora 配置信息存储，就像配方单 | Lora 模型配置信息的 JSON 格式存储 | 系统自动管理，通过界面操作添加和调整 Lora |
| temp_lora_str | temp_lora_str | 多行文本 | "" | 临时 Lora 配置，就像试验配方 | 临时 Lora 配置信息存储 | 存储临时选择的 Lora 组合，可以随时应用或修改 |
3.4 JavaScript 前端组件（weilin_prompt_ui_node.js）
这个组件是干嘛的？
这是插件的前端界面控制器，就像一个智能遥控器。它负责让你能够通过点击按钮打开各种编辑窗口，处理界面交互，管理数据传输等。虽然你看不到它，但它在背后默默工作，让整个插件的界面变得友好易用。
主要功能说明：
| 功能名称 | 功能说明 | 通俗解释 | 使用场景 |
|---|---|---|---|
| 节点按钮生成 | 在节点上添加"打开提示词编辑器"按钮 | 就像在遥控器上添加快捷键 | 点击按钮直接打开编辑界面 |
| 界面通信管理 | 处理节点和编辑窗口之间的数据传输 | 就像邮递员传递信件 | 确保编辑的内容能正确保存到节点 |
| 语言自动识别 | 根据浏览器语言自动切换中英文界面 | 就像智能翻译助手 | 中文用户看中文界面，英文用户看英文界面 |
| 节点状态监控 | 监控节点的创建、删除、修改等状态 | 就像安全监控系统 | 确保数据同步和界面更新 |
| Lora 堆可视化 | 在节点内直接显示 Lora 模型列表 | 就像在收藏夹里直接看到所有收藏 | 直观管理和调整 Lora 模型组合 |
| 随机模板管理 | 处理随机标签生成的模板设置 | 就像抽奖机的规则设定 | 设置和使用随机生成功能 |
| 历史记录同步 | 管理提示词的历史记录和收藏 | 就像浏览器的历史记录 | 快速找回之前使用过的提示词 |
4. 使用技巧和建议
4.1 新手入门建议
- 从简单开始：先使用 WeiLinPromptUIWithoutLora 节点熟悉基本操作
- 多用按钮：点击节点上的"打开提示词编辑器"按钮，在可视化界面中操作更直观
- 善用翻译：不懂英文提示词时，可以用中文输入，系统会自动处理
- 保存常用词：把经常用的提示词保存到收藏夹，下次直接调用
4.2 进阶使用技巧
- 组合使用节点：用 WeiLinPromptUIOnlyLoraStack 专门管理 Lora，用其他节点处理文字
- 利用随机功能：设置好随机模板，在没灵感时让系统帮你生成创意
- 云端同步：加入官方 QQ 群，使用云端功能与其他用户分享创意
- 批量操作：使用批量导入功能快速添加大量标签
4.3 Lora 管理技巧
- 分类整理：给 Lora 模型添加标签和分类，方便查找
- 权重调节：合理设置 Lora 的模型权重和文本权重，通常在 0.5-1.0 之间
- 组合使用：多个 Lora 可以叠加使用，创造独特的艺术风格
- 预览功能：使用悬浮预览功能快速查看 Lora 的效果示例
5. 常见问题解答
Q1：为什么点击按钮没有反应？
A1： 检查以下几点：
- 确认 ComfyUI 已完全启动
- 检查浏览器是否阻止了弹窗
- 尝试刷新页面重新加载
- 查看控制台是否有错误信息
Q2：中文输入的提示词不生效怎么办？
A2： 可能的解决方法：
- 检查翻译功能是否正常工作
- 尝试手动翻译成英文再使用
- 在设置中检查翻译服务配置
- 使用离线翻译库功能
Q3：Lora 模型加载失败怎么办？
A3： 排查步骤：
- 确认 Lora 文件路径正确
- 检查 Lora 文件是否损坏
- 查看 Lora 文件格式是否为 .safetensors
- 重新扫描 Lora 目录
Q4：如何备份我的提示词和设置？
A4： 备份方法：
- 找到插件目录下的
user_data文件夹 - 复制整个文件夹到安全位置
- 恢复时将备份文件夹覆盖回去即可
Q5：插件更新后数据丢失了怎么办？
A5： 数据恢复：
- 查看是否有
user_data_old文件夹 - 按照更新说明进行数据迁移
- 联系官方 QQ 群获取技术支持
6. 高级功能详解
6.1 云端同步功能
- 共享提示词：将你的创意提示词分享给其他用户
- 下载资源：从云端获取其他用户分享的优质提示词
- 数据备份：将本地数据同步到云端，防止丢失
- 协作创作：与朋友一起创建和维护提示词库
6.2 AI 翻译功能
- 实时翻译：输入中文自动翻译成英文提示词
- 批量翻译：一次性翻译多个提示词
- 离线翻译：安装离线翻译库，无需网络也能翻译
- 翻译优化：针对 AI 绘画优化的专业翻译
6.3 智能补全功能
- 自动补全：输入时自动提示相关词汇
- 上下文感知：根据已输入内容智能推荐
- 学习功能：记住你的使用习惯，提供个性化建议
- 快捷输入：支持快捷键快速选择补全内容
6.4 随机生成功能
- 模板系统：创建不同类型的随机模板
- 权重控制：设置不同标签的出现概率
- 组合生成：智能组合不同类型的标签
- 灵感激发：在创作瓶颈时提供新思路
7. 工作流程示例
7.1 基础创作流程
- 添加节点：在 ComfyUI 中添加 WeiLinPromptUI 节点
- 连接模型：连接你的 AI 模型和 CLIP 模型
- 打开编辑器：点击"打开提示词编辑器"按钮
- 输入创意：在编辑器中输入你的创作想法
- 添加风格：选择合适的 Lora 模型增加风格
- 生成图片：运行工作流生成最终图片
7.2 专业创作流程
- 规划创作：先在 Tag 管理器中整理相关标签
- 设置模板：创建随机生成模板备用
- 组合节点：使用多个节点分别处理不同部分
- 批量测试：使用随机功能生成多个变体
- 优化调整：根据效果调整提示词和 Lora 权重
- 保存收藏：将满意的配置保存到收藏夹
7.3 团队协作流程
- 建立规范：团队统一提示词格式和命名规则
- 共享资源：通过云端功能分享优质提示词
- 分工创作：不同成员负责不同类型的提示词
- 版本管理：使用历史记录功能管理不同版本
- 质量控制：定期整理和优化共享的提示词库
8. 性能优化建议
8.1 提高响应速度
- 定期清理：清理不用的历史记录和临时文件
- 合理分类：给提示词和 Lora 建立清晰的分类体系
- 控制数量：避免同时加载过多的 Lora 模型
- 网络优化：使用稳定的网络连接进行云端同步
8.2 内存管理
- 及时关闭：不用的编辑窗口及时关闭
- 批量操作：避免频繁的单个操作，尽量批量处理
- 缓存清理：定期清理浏览器缓存
- 重启刷新：长时间使用后重启 ComfyUI 刷新内存
8.3 数据安全
- 定期备份：定期备份 user_data 文件夹
- 版本控制：重要的提示词库使用版本控制
- 多地备份：将备份文件存储在多个位置
- 云端同步：利用云端功能作为额外备份
9. 故障排除指南
9.1 安装问题
- 依赖缺失：检查 requirements.txt 中的依赖是否全部安装
- 权限问题：确保 ComfyUI 有足够的文件读写权限
- 路径问题：检查插件是否安装在正确的 custom_nodes 目录
- 版本冲突：确认 ComfyUI 版本与插件兼容
9.2 运行问题
- 界面无法打开：检查浏览器的弹窗拦截设置
- 数据不同步：尝试刷新页面或重启 ComfyUI
- 功能异常：查看 ComfyUI 控制台的错误信息
- 性能问题：检查系统资源使用情况
9.3 数据问题
- 数据丢失：查找备份文件或 user_data_old 文件夹
- 格式错误：检查导入的数据格式是否正确
- 编码问题：确保文本文件使用 UTF-8 编码
- 同步失败：检查网络连接和云端服务状态
10. 社区支持
10.1 官方支持
- QQ 群：1018231382（官方技术支持群）
- GitHub：提交 Issue 报告问题或建议
- 视频教程：B站搜索"WeiLin-Comfyui-Tools"
- 文档更新：关注 GitHub 仓库的文档更新
10.2 社区资源
- 提示词分享：群内定期分享优质提示词
- 技巧交流：与其他用户交流使用技巧
- 问题互助：遇到问题可以在群内求助
- 功能建议：向开发者提出新功能建议
10.3 贡献方式
- 报告 Bug：发现问题及时反馈
- 提供建议：提出改进意见和新功能想法
- 分享资源：分享优质的提示词和 Lora
- 帮助新手：在社区中帮助新用户解决问题
11. 总结
WeiLin-Comfyui-Tools 是一个功能丰富、操作友好的提示词管理插件。通过 3 个核心节点和 1 个前端组件的完美配合，为用户提供了从基础到专业的全方位提示词管理解决方案。
核心优势回顾：
- 4 个组件各司其职，满足不同使用需求
- 智能化的编辑和管理功能
- 完善的云端同步和分享机制
- 活跃的社区支持和持续更新
无论你是 AI 绘画新手还是专业创作者，这个插件都能显著提升你的创作效率和作品质量。记住多使用可视化界面操作，善用社区资源，你会发现 AI 创作原来可以如此简单高效！