---

CJ-Nodes 是一套覆盖完整创作链路的 ComfyUI 节点包：从本地大模型反推提示词，到词表驱动的提示词工程，再到音乐生成/扒谱、视频生成、镜头光照姿态控制、图片画布编辑，最后到显存管理与插件管理，全部以 Luy- 前缀统一命名，开箱即用。

⚠️ AI 大模型类节点依赖 llama-cpp-python（必装），下载对应 Python 版本的预编译包： https://github.com/JamePeng/llama-cpp-python/releases

---

目录

• ✨ 亮点节点
• 📊 功能分类总览
• 🤖 AI 大模型（本地推理）
• 🎵 音乐工作台
• 🎬 视频生成（Painter 系列）
• 🎥 镜头 · 光照 · 姿态控制
• 🖼️ 图片处理
• ✍️ 提示词工具
• 🧩 Lora 与模型加载
• 🧱 Latent · Sigmas · 条件
• 🎯 目标检测（LocateAnything）
• ✂️ 字符与文件处理
• 🧰 系统工具
• 🖥️ 顶栏按钮与网页面板
• 🔗 推荐工作流
• 📦 安装
• ⚠️ 注意事项

---

✨ 亮点节点

🎤 音乐工作流：听歌 → 扒谱 → 翻唱级再生成

任意音频 → 完整乐谱 → 重新生成演唱版音乐，全流程本地推理，8GB 显存可跑。

🎯 Luy-LocateAnything 目标检测 —— 一句话框出画面里的一切

基于 LocateAnything-3B 的视觉定位：输入 person, car 这类逗号分隔目标，输出带框图像 + bbox JSON。5 种任务（detect / 单目标 / 多目标 / 文字 / 关键点），配套裁剪提取节点按框批量裁切、边缘去背景色、羽化 —— 检测 → 素材提取一步到位。

🦙 Luy-AI反推 Lite —— 单节点本地视觉反推

llama.cpp 驱动的轻量 VLM 节点：一个节点完成模型加载 + 图片反推，GGUF 模型跑在 models/LLM/。

• ngram 投机解码加速；思考模式开关（采样器级预算，任意模型可关思考）
• 分隔符 一填，输出直接变字符串数组驱动批量下游
• 全中文界面，采样参数全暴露，支持显存限额

🎬 Painter 视频系列 —— Wan2.2 运动增强全家桶

🎨 Luy-图片绘画 / 编辑 / 设计 —— 画布即节点

三个节点均内嵌浏览器画布面板：手绘草图、区域涂抹、排版设计直接在节点里完成。画布内容自动落盘 input/cj_canvas/（工作流只存引用，不膨胀草稿存储）；绘画节点还能输出颜色区域语义提示词反哺生成。

🌈 Luy-Krea2风格语义条件（改进版）

参考图通过 Krea2/Qwen3-VL 的图像 token 路径注入条件：多图独立编码实现多风格融合、轻微/平衡/强烈三档语义强度、宽高比保持 + 视觉分辨率可调 —— 只学风格，不抄主体。

🧩 Luy-插件管理 —— 不动文件夹的插件开关

顶栏一键打开：列出 custom_nodes 全部插件，点卡片即启用/关闭（.disabled 后缀机制），支持整体重载；配合「重载插件」按钮，改代码不重启 ComfyUI。

---

📊 功能分类总览

---

🤖 AI 大模型（本地推理）

全部基于 llama.cpp，GGUF 模型放 models/LLM/，节点界面已全中文化。

轻量即用型

编码器文本生成（不走 llama.cpp）

直接用 ComfyUI 的文本编码器（需带 LLM 头的 LTX-2 gemma3/gemma4 等）生成文本，典型用途是提示词扩写与图片反推。

• 多图反推：image 接 IMAGE 批次即可（如核心 Batch Images 节点把多张图合成一个批次）。gemma4 每张图一组 soft token（原生多图）；gemma3 只有一个 <image_soft_token> 占位，整批会被拼成一段连续图像 token。
• 与核心 TextGenerate 的差异：多出系统提示词下拉/自定义、去思考块、空结果回退原提示词，并把采样参数从 DynamicCombo 改成平铺控件。

进阶组合型（llama.cpp 三件套）

把「模型加载 → 采样参数 → 推理」拆成三个节点，模型与参数可分别复用：

llama_cpp_model_loader（模型对象）──┐
llama_cpp_parameters（采样参数）───┼──► llama_cpp_instruct_adv ──► 输出 / 输出列表 / 状态ID
图片（可选）───────────────────────┘

• llama_cpp_model_loader：上下文长度、显存限制、图片 token 范围、投机解码（ngram-map）、MTP 多 Token 预测
• llama_cpp_instruct_adv：one by one / images / video 三种推理模式、思考模式（off 对任意模型生效）、状态保存与清理
• Luy-llama_run：以上全部合一的单节点完整版

工具节点（llama-cpp-vlm 分类）

bbox_to_mask、bbox_to_segs、bboxes_to_bbox、json_to_bbox、parse_json_node、remove_code_block、PromptEnhancerPreset、llama_cpp_clean_states（清理状态）、llama_cpp_unload_model（卸载模型）—— 配合检测/反推链路使用。

📖 llama-cpp 域版本兼容与调试备忘见 service/llama-cpp/AGENTS.md。

---

🎵 音乐工作台

本地音乐生成 + 扒谱双引擎（YuE2 NF4 量化），模型放 models/YuE2/。

生成线：风格 + 歌词 → 歌曲

扒谱线：任意音频 → 乐谱与信息

风格辅助

词表在 service/music/style_tags/*.txt：一行一条 中文 | English，加文件即加分类，文件名中文部分就是界面控件名。 预制风格在 service/music/style_presets/*.json（{label, note, bpm, style}）：加文件即加预设，style 里写词表的英文原文即可，bpm 是推荐速度（选预设自动写入 BPM 框，可手改/改回 0）； 演绎变体在 service/music/style_presets/_variants.json（{label, bpm_scale, note, tags}）：每个变体按情绪/节奏/速度感/唱法整体替换预设的对应类别，其余类别照旧，加一条即多一种演绎。改完 F5 生效。

---

🎬 视频生成（Painter 系列）

围绕 Wan2.2 / InfiniteTalk / Flux2 的运动增强与音频驱动视频节点集。

运动增强

多段与音频驱动

图像编辑条件

---

🎥 镜头 · 光照 · 姿态控制

3D 交互面板 → 自然语言提示词，前端拖拽即所得。

---

🖼️ 图片处理

加载与保存

画布三兄弟（内嵌网页面板）

画布数据自动落盘 input/cj_canvas/，工作流只存文件引用，不会撑爆草稿存储。

遮罩工作流五件套

遮罩转PNG → (外部重绘) → 提取最小遮罩区域(offset) → 合成重绘图(羽化) → 回贴原图

裁剪与变换

---

✍️ 提示词工具

词表驱动选择器（加 txt 即加下拉）

前端联动选择器（网页面板点选）

输出工具

---

🧩 Lora 与模型加载

---

🧱 Latent · Sigmas · 条件

---

🎯 目标检测（LocateAnything）

模型放 models/LocateAnything-3B/{nf4,fp8}。

---

✂️ 字符与文件处理

---

🧰 系统工具

---

🖥️ 顶栏按钮与网页面板

顶栏按钮（ComfyUI 主界面）

独立网页面板（节点内嵌 iframe 打开）

---

🔗 推荐工作流

音乐翻唱线（扒谱 → 重新生成）

LoadAudio ──► Luy-SheetSage2扒谱 ──┬─ 旋律谱ABC ──► Luy-YuE2音乐生成.乐谱ABC （生成模式=melody）
                                   ├─ 风格底稿 ──► Luy-风格标签替换.风格 ──► 生成.风格
                                   └─ 扒谱信息（看调性/结构，自己写歌词）
Luy-YuE2音乐模型加载 ──► Luy-YuE2音乐生成 ──► SaveAudio

检测 → 素材提取线

Luy-加载图片 ──► Luy-LocateAnything目标检测 ──┬─ image（标注图）
   "person, car"                              └─ bbox_json ──► Luy-LocateAnything裁剪提取 ──► 素材图

本地反推 → 提示词加工线

Luy-加载图片 ──► Luy-AI反推Lite（分隔符=","）──► 输出列表 ──► Luy-读取数组值 ──► 采样提示词

---

📦 安装

1. 将 CJ-Nodes 文件夹放入 ComfyUI 的 custom_nodes/ 目录
2. 安装 llama-cpp-python（按 Python 版本选预编译包，已验证 0.3.49）—— AI 大模型类节点必需
3. 重启 ComfyUI，节点菜单搜索 Luy- 即可找到全部节点
4. 按需准备模型：

---

⚠️ 注意事项

• 提示词词表：service/prompttools/prompt_options/ 等目录的 txt 文件即词表，加文件 = 加下拉分类，改完刷新页面生效
• 音乐词表：service/music/style_tags/ 同理，文件名中文部分就是界面控件名；预制风格在 service/music/style_presets/*.json，加 json 即加预设
• 显存建议：LocateAnything 8GB 卡输入最长边 ≤640；SheetSage2 默认转写完自动释放显存；YuE2 与 SheetSage2 已做互斥卸载避免 OOM
• 改代码热重载：service/ 下的改动用顶栏「重载插件」+ F5；改 __init__.py / nodes.py / plugin_manager.py 需重启
• 视频生成节点（Painter 系列）需配合 Wan2.2 / InfiniteTalk / Flux2 模型使用
• 节点加载失败只打印日志不中断，节点「消失」先看 ComfyUI 启动日志中的 ❌ 加载文件 输出

---