feat: Add search_aliases field to node schema

[christian-byrne]

Adds search_aliases field to improve node discoverability. Users can define alternative search terms for nodes (e.g., "text concat" → StringConcatenate).

Changes

• Add search_aliases: list[str] to V3 Schema in comfy_api/latest/_io.py
• Add SEARCH_ALIASES class attribute support for V1 nodes
• Include field in /object_info response via server.py
• Add aliases to high-priority core nodes based on failed search analytics

V1 usage

class MyNode:
    SEARCH_ALIASES = ["alt name", "synonym"]

V3 usage

io.Schema(
    node_id="MyNode",
    search_aliases=["alt name", "synonym"],
    ...
)

Related PRs

• Frontend: feat: Add search_aliases to node search ComfyUI_frontend#8223
• Docs: docs: Document search_aliases node field docs#729

Nodes with aliases added

Node	Aliases
CLIPTextEncode	text, prompt, positive prompt, negative prompt, encode text
CheckpointLoaderSimple	load model, checkpoint, model loader, ckpt, model
LoraLoader	lora, load lora, apply lora, lora loader
KSampler	sampler, sample, generate, denoise, txt2img, img2img
VAEDecode	decode, decode latent, latent to image
VAEEncode	encode, encode image, image to latent
EmptyLatentImage	empty, empty latent, new latent, blank
SaveImage	save, save image, export image, download
LoadImage	load image, open image, import image, upload image
ImageScale	resize, scale, zoom, zoom in
PreviewImage	preview, show image, view image, display image
PreviewAny	preview, show, display, view, inspect, debug
ControlNetLoader	controlnet, control net, cn, load controlnet
ControlNetApplyAdvanced	controlnet, apply controlnet, use controlnet
ImageUpscaleWithModel	upscale, upscaler, upsc, hires, superres
StringConcatenate	text concat, join text, concat, string
BatchImagesNode	batch, image batch, combine images, merge images
ConditioningCombine	combine, merge conditioning, mix prompts

[Kosinkadink]

Cinema. I'll do a lil cheeky test locally and then merge.

[Kosinkadink]

V1 json looks good.

For V3, you'll need to modify NodeInfoV1 dataclass to have a search_aliases field, and apply it from the node schema in Schema class' get_v1_info.

There technically is a NodeInfoV3 class and corresponding get_v3_info function on Schema, but that was made back when we had the assumption we would at some point change how the frontend consumes the V3 schema. I think we are at the point where we will simply keep using the V1 formatting so implementing the change there is not necessary. I will likely do a small PR later to just eradicate all references to that code path.

[christian-byrne]

Fixed in dcde864. Added search_aliases field to NodeInfoV1 dataclass and propagated it through Schema.get_v1_info.

[Kosinkadink]

Alrighty, json is as expected now for V3. Looks good to me.