Azornes/Comfyui-Resolution-Master

Custom node for total control over resolution and aspect ratio. It provides an intuitive interface with an interactive canvas, advanced scaling options, extensive presets (SDXL, Flux, WAN), and a manager for custom presets, as well as model-specific optimizations for high-quality AI image generation.

什么是 ResolutionMaster？

ResolutionMaster 是一个 ComfyUI 的自定义节点，用于 AI 图像生成工作流的可视化工作流工具。该节点的唯一用途是 计算和设置图像尺寸——它本身不执行任何图像处理。它提供了一个图形化“画布”，您可以在上面拖动一个矩形来选择宽度和高度，然后将这些数值（以及推导出的 缩放因子）输出到工作流的其余部分。

核心功能

功能	作用	为何重要
2D 画布控制	在网格上拖动一个点来设置宽度 × 高度；使用 Shift、Ctrl 键可保持宽高比或禁用吸附。	无需输入数字即可快速选择精确分辨率。
智能缩放	计算一个缩放因子（例如 2.0×），可输入到上采样节点中。	保持工作流中数学的一致性。
吸附按钮与吸附步长滑块	将当前尺寸四舍五入到最近的倍数（16–256 像素）。	确保尺寸与大多数扩散模型兼容（它们通常要求尺寸能被 8、16 或 32 整除）。
实时信息面板	编辑时实时显示当前像素数、兆像素、p 值和宽高比。	可一眼判断尺寸是否符合目标（例如，某模型需要 4 MP）。
预设库	数百个按用途分类的现成分辨率（标准、SDXL、Flux、社交媒体、印刷、电影等）。	无需记住精确数值——选择如 1080p 或 16:9 的预设，节点会自动填入数值。
模型特定优化	选择预设类别后，节点可自动强制执行该模型所需的约束（例如，SDXL 仅接受某些固定尺寸，Flux 使用 32 像素步长且上限为 4 MP）。	防止“无效分辨率”错误，避免生成中断。
自动检测	若连接图像到节点，它可每秒读取该图像的尺寸并自动更新输出。	适用于需要重设现有图片尺寸或保持原始宽高比的工作流。
预设管理器	用于创建、编辑、重命名和批量删除自定义预设的 UI。	可构建个人库（例如公司专用横幅尺寸）。
全面属性面板	所有数值限制（画布大小、吸附步长、缩放范围等）均作为节点属性暴露在 ComfyUI 中，可调整。	适用于 8K 图像等高分辨率工作。

在典型 ComfyUI 工作流中的使用方式

添加节点 – “Resolution Master” 出现在节点面板中。
连接输出 – width 和 height 输入到任意图像生成或重设节点；rescale_factor 可连接到上采样器。
选择预设或在画布上拖动 – 选择如 SDXL 类别和 1024×1024 预设，或手动拖动蓝色矩形到所需精确尺寸。
（可选）自动检测 – 连接一个“加载图像”节点；启用自动检测开关，节点将读取源图像尺寸并建议最接近的预设。
重设尺寸 – 添加“重设图像”节点，将 ResolutionMaster 的尺寸连接，即可获得与下游模型要求完全匹配的图像。

谁会受益？

艺术家与爱好者：构建稳定扩散管道，需要满足严格尺寸限制的人。
开发者：创建可复用的 ComfyUI 模板——该节点确保生成图像始终符合模型限制。
内容创作者：频繁输出到特定平台（Instagram、YouTube、印刷）的人，希望一键设置正确尺寸。

安装方法

通过 ComfyUI-Manager – 搜索 Comfyui-Resolution-Master 并点击 Install。
手动安装 – 将仓库克隆到 ComfyUI/custom_nodes/ 目录，并重启 ComfyUI。

快速入门检查清单

安装该节点。
将其拖入你的图中。
选择一个预设或在画布上拖动。
将 width/height 连接到生成器或重设节点。
（可选）为图像工作流启用自动检测。

总结

ResolutionMaster 是 ComfyUI 的一个 高精度控制辅助工具，它消除了设置图像尺寸的猜测，强制执行模型特定限制，并简化了可复现 AI 图像管道的创建。