Neo Nodes

ComfyUI-Neo-Nodes

一个 ComfyUI 自定义节点插件：提示词管理与 AI 增强（支持推理/thinking 模型），内置 Krea2 生图（文生图 / 参考图四视图）、素材浏览与图片或提示词一键发送、图片反推、配方保存和一键还原，以及工作流路径自动修复。

| 模块 | 类型 | 说明 | 文档 | |------|------|------|------| | 📝 Neo Prompt Encoder | 节点 | 提示词管理 + AI 增强：内置大量预设、可搜索快速筛选；输出 CLIP 编码（CONDITIONING）+ 文本，接标准 txt2img 采样器 | prompts | | ⚡ Neo Prompt Agent | 节点 | 提示词管理 + AI 生成：内置大量预设、可搜索快速筛选；仅输出文本（STRING），无需连 CLIP / 文本编码器，适合喂给下游节点（如 🎨 Krea2） | prompts | | 🖌️ 聊天生图（Krea2） | 节点内置 | 选生图 skill 后 ✨ 直接生成：文生图 / 参考图四视图角色板，LoRA 可选（依赖参考图模式），底部状态行实时显示进度/取消，结果 Markdown 预览并一键装配回 LoadImage | image-gen | | 🎨 Krea2 Generate | 节点 | 按所选生图 skill 的 workflow.json 模板同步生成，直接输出 IMAGE 张量到下游节点（进程内 mini-executor 执行，无需聊天界面；需 GPU/显存，采样期间阻塞主工作流） | image-gen | | 🖼️ Neo Gallery | 侧边栏面板 | 图片/视频素材浏览与管理：内置预设素材，支持自定义素材目录与 Civitai LORA 资源匹配；灯箱预览、一键发送到节点 | gallery | | ⭐ 收藏（书签） | 素材板块 | 本地收藏（路径记录）+ Civitai 收藏（边下边开、开关默认开启） | gallery | | 🧊 Neo Recipes | 侧边栏面板 | 配方（提示词 + 图片/视频/音频资源）管理与一键发送 | recipes | | 🔧 工作流修复 | 顶栏工具 | 换机器 / 改目录后模型路径失效时，按文件名匹配磁盘真实文件一键修复；可手动改选、记住映射、载入前自动检查 | workflow-repair |

目录

• 安装
• 依赖
• 快速上手
• 模块文档
• 许可证
• 引用参考
• 开发者文档

安装

• ComfyUI Manager（推荐）：在 Manager 中搜索 Neo Nodes 一键安装（已发布至 ComfyUI Registry）
• 手动：将本仓库克隆到 ComfyUI/custom_nodes/ 目录：

git clone https://github.com/neoneo-ai/ComfyUI-Neo-Nodes.git ComfyUI/custom_nodes/ComfyUI-Neo-Nodes

然后重启 ComfyUI

依赖

• requests, Pillow, PyYAML（随 requirements.txt 自动安装）
• llama_cpp_python（可选，仅本地 LLM 推理需要，见 docs/llm.md；只用远程 API 可跳过）

---

快速上手

1. 安装：ComfyUI Manager 搜 Neo Nodes 一键安装（或见上方手动安装），重启 ComfyUI。

2. 配置 LLM（二选一）

   • 远程：节点 Settings 里选 Provider（内置 DeepSeek、阿里云百炼(通义千问 / Token Plan)、Kimi、智谱 GLM、硅基流动，以及 OpenAI 兼容 / LM Studio / Ollama / OpenRouter 等），填 API Key + 端点。各家端点与申请入口见 docs/llm.md。
   • 本地：把 GGUF 模型放入 models/LLM/，Settings → Provider 选「Local GGUF」并选择模型后点 💾 保存（目录只有一个模型时可跳过，运行时自动使用）。安装与模型目录规范见 docs/llm.md。

3. 第一次提示词增强：添加 ⚡ Neo Prompt Agent 节点 → 在底部快捷输入框写一句简短描述 → 点 ✨ → 得到 AI 生成的提示词文本（无需连 CLIP，可直接接下游如 🎨 Krea2）。

4. 第一次生图：添加 🎨 Krea2 Generate 节点 → 选一个带 workflow.json 的生图 skill → prompt 接 ⚡ Neo Prompt Agent（常用）或手填，四视图类再连参考图 → 排队执行 → 直接输出 IMAGE 张量。

   生图需 GPU/显存，且所选 skill 必须声明 gen_image: true 并附 workflow.json。 生图模型 / Text Encoder / VAE 默认「自动」按 skill 模板匹配，无需手配；未匹配到时再到节点生图设置里手动指定。

5. 素材一键入节点：打开右侧边栏「素材」面板 → 浏览/搜索到目标图片 → 点缩略图进灯箱 → 点 ✈️ Send 选择目标节点（LoadImage 类优先）→ 图片直接写入该节点。

6. 工作流路径修复：换机器 / 改目录后模型路径失效时，点顶栏「🔧 修复工作流」→ 确认框核对候选新路径（可手动改选、可调匹配阈值）→ 点「修复」原地更新画布。

---

模块文档

各功能模块的详细文档已按模块拆分到 docs/ 目录（索引见 docs/README.md）：

| 文档 | 内容 | |------|------| | docs/prompts.md | 提示词节点：Neo Prompt Encoder / Agent、节点界面与按钮、模板与技能管理、图片反推与 @ 引用、/ 技能菜单 | | docs/llm.md | LLM 模式（远程/本地）、思考模型、本地 GGUF 安装（预编译 wheel / 源码编译 / Windows 排障）、模型目录规范 | | docs/image-gen.md | Krea2 生图：聊天生图与 Krea2 Generate 节点（IMAGE 输出） | | docs/recipes.md | 配方：保存、一键发送到工作流、示例结果 | | docs/gallery.md | Neo Gallery：浏览、灯箱、文件管理、Civitai LORA 缓存、收藏（书签） | | docs/workflow-repair.md | 工作流模型路径修复 |

---

许可证

SPDX-License-Identifier: Apache-2.0

---

引用参考

collections portrait 10000+精美提示词来源 https://civitai.com/models/2231696/sfw15000-and-qwen-and-z-image-or-15000-portrait-and-selfie-wildcards-for-qwen-and-z-image

---

开发者文档

开发相关内容（项目结构、后端模块、API 路由、节点注册、测试等）见 Developer.md。