ComfyUI-CrosshairGuidelines

ComfyUI-CrosshairGuidelines
★ 33

对齐辅助移动与缩放视觉聚焦可配置外观
在移动或缩放节点与分组时显示十字参考线，便于精确对齐；支持 CTRL 可见性模式、线色线宽与不透明度/边框淡出等配置。
💡 移动或缩放节点/组时实时显示十字对齐参考
🍴 2 Forks💻 JavaScript🔄 2026-02-07
📦
网盘下载
复制链接后前往夸克网盘下载
https://pan.quark.cn/s/a9fb3a59e10c
📄 README

ComfyUI-CrosshairGuidelines

https://github.com/user-attachments/assets/94340d82-08f5-41cd-9a0d-37e0e9b56d1a

Crosshair guidelines for ComfyUI to help align nodes and groups while moving or resizing.

Installation

Install via ComfyUI Manager or clone this repo into ComfyUI/custom_nodes/ComfyUI-CrosshairGuidelines.

[!NOTE]

Nodes 2.0 support is best-effort and may vary slightly between ComfyUI releases.

  • * *

    • Features

  • Crosshair guidelines on move and resize (nodes and groups).
  • Adjustable move, resize, and idle modes.
  • CTRL behavior mode (show, hide, off) for modifier-key-driven visibility.
  • Customizable color and line thickness.
  • Link and node opacity dimming so the active object stays visually prominent.
  • Optional hiding of the active outline during move/resize.

  • * *

    • Settings

    All settings appear under Crosshair Guidelines in ComfyUI settings.

  • move_mode: off or all.
  • resize_mode: off, selected, or all.
  • idle_mode: off or all.
  • ctrl_behavior:
  • show: hide crosshairs during node/group interactions unless Ctrl/Meta is held.
  • hide: show crosshairs normally, but hide while Ctrl/Meta is held.
  • off: ignore Ctrl/Meta.
  • Does not affect marquee multi-select (marquee always suppresses crosshairs).
  • color: Any CSS color value (including hex with alpha like #RRGGBBAA, plus rgb/rgba/hsl and named colors).
  • thickness: Line width in pixels.
  • link_opacity: Multiplier for link opacity during move/resize (0–1).
  • node_opacity: Multiplier for node/group opacity during move/resize (0–1).
  • hide_active_outline: Hides the active node/group outline while moving or resizing.

  • * *

    • Notes

  • The JavaScript is unavoidably large (6k+ lines!) because it contains a lot of defensive compatibility logic for different ComfyUI / LiteGraph / Nodes 2.0 variants, plus input handling and rendering edge cases.
  • link_opacity and node_opacity affect all objects except the active one.
  • Link creation drags (including slot-handle/slot-label starts) suppress crosshairs.
  • Tested on Microsoft Edge.