Node packÜberprüftExtern
ComfyUI-NovelAI-GENYTOOLS
模块化 NovelAI 全功能 ComfyUI 节点:角色分区、Vibe/精准参考、局部重绘、Director Tools、批量任务与分块精修。
Betreuer@XTOGENYB · adoptionBewertung
Paketprofil
- Status
- Überprüft
- Verleger
- @XTOGENY
- Quelle
- GitHub
README
ComfyUI-NovelAI-GENYTOOLS
ComfyUI-NovelAI-GENYTOOLS 项目封面
一个面向 ComfyUI 的 NovelAI 图像生成与编辑节点包。它把 NovelAI 的模型、提示词、生成参数、角色分区、Vibe、精准参考和采样器拆成可自由连接的模块，并补充批量任务、XY 参数对比、分块放大、图片保存和元数据读取能力。
这是项目的首次公开发布，本文档集中介绍当前可用功能与使用方式。
现已支持 NovelAI Diffusion V5 Curated / Full，包括 Standard / Light 质量模式、Anime / Furry 数据集、透明背景、最多 32 个角色与自由定位、自动 teXt: 文字块、Max✨ Enhance 和 Opus 免费生成额度显示。V5 当前不支持 Vibe Transfer 与精准参考，插件会在发送请求前明确提示。为获得更好的节点界面显示效果，建议开启 ComfyUI Node 2.0。
本项目是社区开发的非官方 ComfyUI 扩展，与 NovelAI 官方无隶属关系。调用 NovelAI API 需要用户自己的 Persistent API Token；生成、编码、增强和部分编辑操作可能消耗 Anlas。
主要优势
- ComfyUI 原生模块化设计：工作流结构接近
模型加载器 → LoRA/参考 → KSampler，模型、提示词、参数和参考图均可独立复用。 - 中文节点与参数界面：常用选项、错误说明、费用统计和节点名称均为中文。
- 覆盖常用 NovelAI 生图能力：文生图、图生图、局部重绘、角色分区、Vibe Transfer、精准参考、Enhance、Variations 和 Director Tools。
- 角色分区编辑器：V5 最多添加 32 个角色并支持连续自由坐标；V4/V4.5 最多 6 个角色并使用 5×5 网格。每个角色都可分别设置正负提示词或交给 AI 决定位置。
- Vibe 完整工作流：支持图片编码、多个 Vibe 串联、本地 Vibe/Bundle 加载、预览和文件保存。
- 面向大图的分块精修：先在本地放大，再把画面分块交给 NovelAI 重绘，使用重叠区域、余弦羽化、稳定 Seed 和缓存恢复完成拼接。
- 批量与参数研究工具：逐条替换提示词生成同风格系列图片，或生成带标签的 XY 参数对比图。
- 费用与隐私保护：支持 Anlas 上限、缓存续跑和余额显示；Token 不进入工作流 JSON、节点输入、图片元数据或日志。
功能总览
模型、提示词与生成参数
NAI 模型加载器：选择 V5 Full/Curated、V4.5 Full/Curated、V4 Full/Curated、Anime V3 或 Furry V3，输出可继续串联的NAI_PIPE。节点可显示订阅与 Anlas 余额；选择 V5 时还会显示 Opus 免费额度、估算剩余张数和每日恢复速度。NAI 正面提示词/NAI 负面提示词：使用不同端口类型，避免把正负提示词接反。NAI 正面提示词拼接/NAI 负面提示词拼接：把人物、服装、场景、画风等文本模块组合起来。NAI 正面提示词处理器/NAI 负面提示词处理器：处理随机化、Prompt Chunks、强调和文本片段；V5 会为引号中的文字自动生成官方teXt:文本块，并避免重复处理已手写的文本块。NAI 核心参数：设置分辨率、宽高、Steps、Guidance、采样器和噪声调度。NAI 高级参数：设置 CFG Rescale、CFG Delay、Decrisper、SMEA、动态阈值、质量标签、UC 预设、数据集模式、透明背景、Vibe 归一化和输出格式；V5 支持 Standard / Light / 关闭质量标签以及 Anime / Furry 模式。
文生图、图生图与局部重绘
NAI 文生图采样器：使用模块化模型管线、正负提示词和参数卡生成图片。NAI 图生图采样器：接收 ComfyUIIMAGE，通过 Strength 与 Noise 控制保留原图和重新构图的程度。NAI 局部重绘采样器：接收IMAGE + MASK，使用 NovelAI Inpainting 模型与官方局部重绘请求结构；未遮罩区域在回贴时保留原图。V5 Full 使用原生 V5 Inpainting；V5 Curated 当前按官网行为使用 V4.5 Curated Inpainting，因此该模式最多保留 6 个角色。- 单次生成张数支持 1–4 张，与 NovelAI 单次请求上限一致。
- 采样器返回标准 ComfyUI
IMAGE批次、实际 Seed 列表以及费用和调用统计。
NAI 模型加载器 ───────────────────────────────┐
NAI 正面提示词 ───────────────────────────────┤
NAI 负面提示词 ───────────────────────────────┤→ NAI 文生图采样器 → Preview / NAI 图片保存器
NAI 核心参数 ─────────────────────────────────┤
NAI 高级参数 ─────────────────────────────────┘
V5 与 V4/V4.5 角色分区
NAI 角色分区编辑器可以直接插入模型管线：
NAI 模型加载器 → NAI 角色分区编辑器 → NAI 文生图/图生图采样器
↑
NAI 核心参数
- V5 一个节点最多添加 32 个角色；V4/V4.5 最多添加 6 个角色。
- 每个角色拥有独立的正面提示词、负面提示词和启用开关。
- 可以选择“由 AI 决定位置”；V5 手动位置使用连续自由坐标，V4/V4.5 仍使用 5×5 网格中心点。
- 位置编辑器会读取核心参数的宽高，以横图、竖图或方图的真实比例显示。
- 角色顺序、提示词和位置会随工作流保存，但不会保存 Token。
- 角色分区适用于 V5 与 V4/V4.5 模型；V5 Curated 局部重绘因模型回退限制为最多 6 个角色。
Vibe Transfer 与精准参考
NAI 图片 Vibe 编码器：把输入图片编码为 Vibe，Information Extracted 默认0.7，编码结果可以缓存并加入模型管线。NAI Vibe 文件加载器：加载.naiv4vibe或.naiv4vibeBundle，像 LoRA 加载器一样连续串联多个 Vibe。NAI Vibe 文件保存器：保存当前管线中的 Vibe；单个导出为.naiv4vibe，多个自动导出为.naiv4vibeBundle。NAI 精准参考应用器：V4.5 可使用角色、风格或角色与风格参考，并设置 Strength 与 Fidelity。- Vibe 与精准参考遵循 NovelAI 模型能力限制。NovelAI 当前尚未向 V5 开放这两项能力；插件会在发送付费请求前给出中文错误，不会静默忽略参数或自动更换模型。
NAI 模型加载器 → Vibe 文件加载器 → Vibe 文件加载器 → 采样器
NAI 模型加载器 → 图片 Vibe 编码器 → 采样器
└────────→ Vibe 文件保存器
NAI 模型加载器 → 精准参考应用器 → 采样器
分块放大与大图精修
NAI 模块化分块放大用于处理已经由本地 ESRGAN、AnimeSharp 等模型放大的图片：按照指定尺寸裁成多个有重叠的图块，逐块执行 NovelAI Img2Img，再通过二维余弦权重融合回完整画布。
Tile 分块放大效果对比
核心能力：
- 图块宽高可自定义，也可跟随原始小图尺寸。
- 横向/纵向重叠与实际融合带宽分别控制。
- 每个图块使用稳定派生 Seed，重复运行能够复现。
- 每块完成后写入缓存；网络中断或手动停止后，重新运行只补缺失图块。
- 支持彩色噪点抑制，降低低 Noise 重绘时出现的零星彩色像素。
- 可连接角色分区、Vibe 或精准参考管线；其中 Vibe 与精准参考仅用于当前支持它们的模型，不能与 V5 组合。
原始小图 ───────────────────────────────────┐
原始小图 → 本地放大模型 → 本地放大图 ───────┤
NAI 模型管线 + 正负提示词 + 参数卡 ─────────┤→ NAI 模块化分块放大 → NAI 图片保存器
插件同时保留经典分阶段节点
Knoten in diesem Paket
62 Knoten (Plural)
Knoten in diesem Paket
62 Knoten (Plural)- ai_choice
- enabled
- encoding
- links
- NAIAdvancedSettingsV2
- NAIBatchPromptTasksV2
- NAIBatchTextToImageTaskV2
- NAICharacter
- NAICharacterGroup
- NAICharacterRegionEditorV2
- NAIColorize
- NAICoreSettingsV2
- NAIDeclutter
- NAIEmotion
- NAIEnhance
- NAIEnhanceModularV2
- NAIGenerationSettings
- NAIImageMetadataReader
- NAIImageMetadataReaderV2
- NAIImageSaverV2
- NAIImageToImage
- NAIImageToImageSamplerV2
- NAIImageToVibeFileV2
- NAIImageVibeEncoderV2
- NAIInpaint
- NAIInpaintSamplerV2
- NAILineArt
- NAIModelLoaderV2
- NAIModularTiledRefineV2
- NAINegativePromptJoinV2
- NAINegativePromptProcessorV2
- NAINegativePromptV2
- NAIOfficialUpscale
- NAIPositivePromptJoinV2
- NAIPositivePromptProcessorV2
- NAIPositivePromptV2
- NAIPreciseReference
- NAIPreciseReferenceApplyV2
- NAIPreciseReferenceGroup
- NAIPromptProcessor
- NAIRemoveBackground
- NAISeamFix
- NAISketch
- NAITagSuggestions
- NAITextToImage
- NAITextToImageSamplerV2
- NAITiledRefineAdvanced
- NAITiledRefineAllInOne
- NAITileMerge
- NAITilePlanner
- NAIV45TileRefine
- NAIVariations
- NAIVariationsModularV2
- NAIVibeEncode
- NAIVibeFileLoaderV2
- NAIVibeFileSaverV2
- NAIVibeGroup
- NAIXYAxisV2
- NAIXYPlotV2
- name
- slot_index
- type
Quellen
3 Quellen
Quellen
3 QuellenGitHubQuelleVersion e3c99d8fe957a3f4e1c11d9d6d7273ab3da3020d
github.com/XTOGENY/ComfyUI-NovelAI-GENYTOOLSVerifiziert 7. Okt.
Quellenauszüge
2 Auszüge
Quellenauszüge
2 AuszügeSource context: Repo XTOGENY/ComfyUI-NovelAI-GENYTOOLS
Source context: Repo XTOGENY/ComfyUI-NovelAI-GENYTOOLS
