| 模块 | 类型 | 说明 | 文档 | |------|------|------|------| | 📝 Neo Prompt Encoder | 节点 | 提示词管理 + AI 增强（预设 / 搜索 / LLM 增强），输出 CLIP 编码（CONDITIONING）+ 文本，接标准 txt2img 采样器 | prompts | | ⚡ Neo Prompt Agent | 节点 | 提示词管理 + AI 生成，无需连 CLIP；输出 PROMPT 文本 + BUNDLE 运行时包（可直连 🎨 Krea2 / 🎞️ H3） | prompts | | 🖌️ 聊天生图（Krea2） | 节点内置 | 选生图 skill 后 ✨ 直接生成（文生图 / 参考图四视图），状态行实时进度/取消，结果 Markdown 预览并一键装配回 LoadImage | image-gen | | 🎨 Neo Image Gen & Edit | 节点 | 按所选生图 skill 模板同步生成/参考编辑，直接输出 IMAGE 张量到下游（进程内 mini-executor，无需聊天界面；参考图为 Autogrow 动态槽位，Qwen Image 2.1 编辑可多图输入） | image-gen | | 🎞️ H3 Video Director | 节点 | MiniMax H3 视频生成：以 video_director 配方逐段生成（每段自带 skill/提示词/时长/首尾帧/参考素材，模式文生/图生/首尾帧/全参考/混合）并拼接为单个含原生音频 VIDEO；也可连 BUNDLE 按单片段生成。编辑器支持半自动故事拆分、统一设置（改动自动应用到所有分段）、提示词批量优化与时间轴逐段微调 | h3-video | | 📦 Neo Bundle Expand | 节点 | 把 BUNDLE 展开成 prompt + image_1..9，对齐官方 H3 Reference to Video；输出槽自动增长（默认仅 prompt + image_1，上限 9 张） | prompts | | 🔲 Neo Reference Grid (参考图宫格) | 节点 | 单节点搞定「提示词 + 最多 12 张参考图」：宫格槽位 1~12（工具条 −/+ 运行时调整），布局按节点宽度流式排布，卡片按图片真实比例自适应，随工作流持久化 → prompt + BUNDLE + image_1..image_12；宫格参与配方保存/还原，工具条 ☰ 可带预览载入已有含图配方 | prompts | | 🧩 Neo Grid Split (宫格图拆分) | 节点 | 一张带分隔条/留白的分镜宫格图（input/ 里选）→ 自动切各格（均匀间隙检测，含细白条回退与大小一致性校验：分隔条漏检切出大小悬殊的格子时按最小格等分；trim 清四边白/黑框与底部字幕条），行优先拼成一个 IMAGE 批次（统一到最大宽高，可连多图/多帧下游）+ 原图内嵌提示词 prompt | h3-video | | 🖼️ Neo Gallery | 侧边栏面板 | 图片/视频/音频素材浏览与管理：内置预设素材、自定义目录与 Civitai LORA 匹配；灯箱预览、一键发送到节点；Grid / Character 主目录（生成结果直达进入，按日期归档、远端预设只读） | gallery | | ⭐ 收藏（书签） | 素材板块 | 本地收藏（路径记录）+ Civitai 收藏（边下边开、开关默认开启） | gallery | | 🧊 Neo Recipes | 侧边栏面板 | 配方（提示词 + 图片/视频/音频资源）管理与一键发送 | recipes | | 🅝 顶栏菜单 | 顶栏入口 | 插件统一入口（🅝 按钮下拉）：🎬 新影工坊 / 🖼️ 生成素材 / 🎥 新建导演配方 / 🧩 创建节点 / ⚙️ 设置（LLM / 生图默认 / 生视频模型）/ 🗂 技能管理（左列表 + 右详情统一窗口）/ 🔧 修复工作流 / 📜 修复记录 / ℹ️ 关于插件 | workflow-repair | | 🔧 工作流修复 | 🅝 菜单项 | 换机器 / 改目录后模型路径失效时，按文件名匹配磁盘真实文件一键修复；可手动改选、记住映射、载入前自动检查 | workflow-repair |

功能演示

主要模块的交互实录（点击缩略图进入对应文档）：

| 🖼️ Neo Gallery · 灯箱 | 🧊 Neo Recipes · 一键发送 | 🎞️ H3 Video Director · 时间轴重排 | |:---:|:---:|:---:| | | | |

安装

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 可跳过）

快速上手

安装：ComfyUI Manager 搜 Neo Nodes 一键安装（或见上方手动安装），重启 ComfyUI。
配置 LLM（二选一）
- 远程：节点 Settings 里选 Provider（内置 DeepSeek、阿里云百炼(通义千问 / Token Plan)、Kimi、智谱 GLM、硅基流动，以及 OpenAI 兼容 / LM Studio / Ollama / OpenRouter 等），填 API Key + 端点。各家端点与申请入口见 docs/llm.md。表单底部「🔌 测试连接」会用当前填写的 Provider/密钥/端点/模型发送「你好」，能正常回复即表示连通（无需先保存；留空字段沿用已存配置）。
- 本地：把 GGUF 模型放入 models/LLM/，Settings → Provider 选「Local GGUF」并选择模型后点 💾 保存（目录只有一个模型时可跳过，运行时自动使用）。安装与模型目录规范见 docs/llm.md。
第一次提示词增强：添加 ⚡ Neo Prompt Agent 节点 → 在底部快捷输入框写一句简短描述 → 点 ✨ → 得到 AI 生成的提示词文本（无需连 CLIP，可直接接下游如 🎨 Krea2）。
第一次生图：添加 🎨 Neo Image Gen & Edit 节点 → 选一个带 workflow.json 的生图 skill → prompt 接 ⚡ Neo Prompt Agent（常用）或手填，参考编辑类（四视图 / Qwen Image 2.1 编辑）再连参考图槽位 → 排队执行 → 直接输出 IMAGE 张量。

生图需 GPU/显存，且所选 skill 必须声明 gen_image: true 并附 workflow.json。生图模型 / Text Encoder / VAE 默认「自动」按 skill 模板匹配，无需手配；未匹配到时再到节点生图设置里手动指定。
素材一键入节点：打开右侧边栏「素材」面板 → 浏览/搜索到目标图片 → 点缩略图进灯箱 → 点 ✈️ Send 选择目标节点（LoadImage 类优先）→ 图片直接写入该节点。
工作流路径修复：换机器 / 改目录后模型路径失效时，点顶栏 🅝 菜单「🔧 修复工作流」→ 确认框核对候选新路径（可手动改选、可调匹配阈值）→ 点「修复」原地更新画布。

新影工坊（Neo Studio · 独立应用）

不依赖画布的独立页面：运行插件目录下 neo-studio.bat（自动拉起 ComfyUI），或手动启动后打开 http://127.0.0.1:8188/neo-studio。含四个页签：

素材：完整 Neo Gallery（浏览 / 灯箱 / 文件管理）
导演：配方列表（只列多段导演配方）+ 导演编辑器（与画布内一致）+ 整片生成面板（把 NeoH3VideoDirector 提交执行队列，带进度 / 取消；只读时间轴显示配方分段，段块悬停出现勾选框：勾选后只生成勾选的段（运行期临时状态，换配方即清空），点分段块打开编辑器并跳到该段，采样中实时预览与节点同款，成片自动记进配方「结果」区）
技能：统一技能管理（与顶栏「🗂 技能管理」同组件，左列表 + 右详情直接展开，无弹窗）
设置：生图 / 生视频 / LLM 设置

依赖画布的功能（如「发送到节点」）在 Studio 内自动降级为提示。

示例工作流

example_workflows/ 下提供可直接加载的 UI 格式模板，ComfyUI 会自动将它们暴露在顶栏 Templates（模板） 面板中，选择后一键载入画布：

基础概念

skill：

这里的Skill不仅仅是提示词模板，而是包含了内置模型配置信息（model，vae，clip等），内置工作流程和默认基础参数，Skill选择列表可以进入详情页查看，系统预设的不可编辑，复制之后可自定义编辑

bundle：

包含了运行时需要的参数：提示词和图片（可选）

recipe

分为基础配方和导演配方

基础配方：

仅是把当前的提示词和图片资源保存下来，便于复用

导演配方：

支持多段连续生成，由导演台进行编辑生成并保存，director节点运行时选择对应的配方。点击节点上timeline可以直接进入编辑。故事板分镜页支持主题/脚本一键 LLM 生成分段分镜（角色参考图锁身份），也支持宫格图自动拆分（各格作分段首帧）与逐格 LLM 描述提示词。

model：

虽然内置了模型，如果觉得常修改也可以直接接入加入的model和lora，可以覆盖掉skill内置的主模型配置

模块文档

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

| 文档 | 内容 | |------|------| | docs/prompts.md | 提示词节点：Neo Prompt Encoder / Agent、节点界面与按钮、模板与技能管理、图片反推与 @ 引用、/ 技能菜单 | | docs/llm.md | LLM 模式（远程/本地）、思考模型、本地 GGUF 安装（预编译 wheel / 源码编译 / Windows 排障）、模型目录规范 | | docs/image-gen.md | 生图：聊天生图与 Neo Image Gen & Edit 节点（文生图 + 参考编辑，IMAGE 输出） | | docs/recipes.md | 配方：保存、一键发送到工作流、示例结果、分镜视频导演配方（video_director） | | 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。