ComfyUI VNCCS 工具集：新增交互式相机控制节点，简化多角度 LoRA 提示词生成

在使用多角度 LoRA（如 Qwen-Image-Edit-2511-Multiple-Angles）进行图像生成时，如何准确描述相机视角常是一大难题。传统方式需手动输入如 “front view, 30-degree elevation” 等提示词，既繁琐又难以精确控制。

• GitHub：https://github.com/AHEKOT/ComfyUI_VNCCS_Utils
• ComfyUI_VNCCS：https://github.com/AHEKOT/ComfyUI_VNCCS

ComfyUI VNCCS 工具集 提供了一种更直观的解决方案：交互式视觉相机控制节点，让视角调整像操作 3D 软件一样简单，并自动生成符合 LoRA 要求的提示词。

核心功能：所见即所得的视角控制

该节点提供三个核心交互控件：

1. 方位角（Azimuth）控制
   • 通过 圆形距离环 拖动鼠标，围绕主体旋转视角（0°=正面，90°=右侧，180°=背面等）
   • 实时反映在提示词中，如 side view、back view
2. 仰角（Elevation）调节
   • 右侧 垂直滑块 支持 -30°（俯视）到 +60°（仰视） 范围
   • 自动转换为 low angle、bird's eye view 等语义化描述
3. 触发词开关
   • 右下角 彩色方块：绿色表示启用视角提示词，红色表示仅输出空字符串
   • 方便在需要时临时禁用视角控制，不影响主提示词逻辑

💡 输出为纯文本字符串，可直接接入 CLIP Text Encode 节点，或与主提示词拼接使用。

为什么特别适合多角度 LoRA？

许多多视角 LoRA 模型（如 Qwen 系列）依赖特定关键词激活不同角度分支。VNCCS 节点内置了与这些模型对齐的触发词映射表，确保生成的提示词能被 LoRA 正确识别，避免因用词偏差导致角度失效。

例如：

• 方位角 0° → front view
• 方位角 90° → side view
• 仰角 45° → low angle shot

安装与使用

1. 安装
   将 ComfyUI_VNCCS_Utils 文件夹放入 ComfyUI/custom_nodes/，重启 ComfyUI。
2. 使用
   • 在节点菜单中搜索 “VNCCS Camera Control”
   • 调整方位角、仰角和触发开关
   • 将输出的 Prompt 连接到 CLIP 编码器

✅ 无需额外依赖，纯前端交互，轻量高效。

主要节点

VNCCS 视觉相机控制

这是一个带有可视化控件的小部件，用于交互式地控制相机位置的节点。它是进行直观角度控制的主要节点。该节点专为高级相机控制和提示词生成而设计，并针对像 Qwen-Image-Edit-2511-Multiple-Angles 这样的多角度 LoRA 进行了优化。

• 视觉控件：允许通过鼠标选择方位角（围绕主体的旋转）和距离（环）。
• 俯仰角滑块：右侧的垂直条，用于选择俯仰角（-30° 至 60°）。
• 触发词：右下角的方形指示器，用于切换提示词中是否包含触发词（绿色表示开启，红色表示关闭）。

VNCCS QWEN 细节增强器

一个强大的细节增强节点，利用 QWEN-Image-Edit2511 模型来增强检测到的区域（面部、手部、物体）。它通过使用视觉理解来指导增强过程，超越了标准的细节增强器。

• 智能裁剪：自动进行方形裁剪并处理填充，以获得最佳模型输入效果。
• 视觉引导增强：使用 QWEN 生成的指令或用户提示词来指导细节处理。
• 漂移修复：包含防止增强区域过度偏离原始构图的机制。
• 易用性功能：内置颜色匹配、泊松混合（接缝修复）和多种上采样选项。
• 修复模式：专门用于基于遮罩的编辑或填充黑色区域的模式。
• 输入：需要标准模型/CLIP/VAE 以及一个 BBOX_DETECTOR（如 YOLO）。
• 选项：支持 QWEN-Image-Edit2511 的特定优化（distortion_fix, qwen_2511 模式）。

VNCCS 模型管理器与选择器

一个强大的系统，用于直接在 ComfyUI 内部管理和选择模型（LoRA、检查点），并支持 Civitai 和 HuggingFace。

VNCCS 模型管理器

此节点充当系统的后端。它连接到一个包含 model_updater.json 配置文件的 HuggingFace 仓库，该文件定义了可用模型及其下载源。

• 仓库 ID：指定 HuggingFace 仓库 ID。
• 下载功能：在后台处理模型下载，并支持队列。
• Civitai 支持：支持使用 API 密钥进行身份验证以下载受限的 Civitai 模型。

VNCCS 模型选择器

用于选择模型的配套节点。它提供了一个丰富的图形用户界面。

• 可视化卡片 UI：以简洁的卡片格式显示所选模型的名称、版本、安装状态和描述。
• 智能搜索：点击卡片会打开一个模态窗口，其中显示仓库中所有可用模型的可搜索列表。
• 状态指示器：清晰显示"已安装"、"有更新"、"缺失"或"下载中"的状态。
• 一键安装/更新：允许直接从列表下载或更新模型。
• 通用连接：输出一个标准的相对路径字符串，该字符串完全兼容标准的 ComfyUI 节点。你可以直接连接它！

VNCCS 边界框提取器

一个辅助节点，用于简单地提取和可视化裁剪区域。当你需要提取边界框检测到的区域但不想运行完整的面部/细节增强器时非常有用。

VNCCS 姿势工作室

一个完全在 ComfyUI 节点内运行的专业的 3D 姿势和灯光环境。

• 交互式视口：带有 gizmo 控件和撤销/重做功能的复杂骨骼操控。
• 动态身体生成器：通过直观的滑块微调角色的身体属性，包括年龄、性别混合、体重、肌肉和身高。
• 高级环境灯光：环境光、方向光和点光源，带有交互式 2D 雷达和半径控制。
• 保持原始灯光：一键模式，可绕过合成灯光，生成干净、纯白的渲染图（非常适合 ControlNet）。
• 可自定义的提示词模板：使用基于标签的模板（例如 <lighting>、<user_prompt>）在设置中精确定义最终提示词的结构。
• 直接侧边栏提示：右侧边栏中的"提示词"部分，带有自动扩展的文本框，可随时添加场景细节。
• 模态姿势库：一个简洁的全屏图库，用于管理和加载保存的姿势，而不会使 UI 杂乱。
• 多姿势标签页：用于在单个节点内创建批量输出或序列的系统。
• 精确构图：集成的相机雷达和缩放控制，配有清晰的视口框可视化。
• 自然语言提示词：自动生成描述性的灯光提示词，以实现无缝的场景集成。
• 描图支持：加载背景参考图像，用于精确的角色对齐。