Diagnóstico del contrato de proyección en MiniMax H3

Al intentar ejecutar un workflow en ComfyUI 0.45.0 con el modelo MiniMax H3, se encontró un error inesperado incluso activando la opción --disable-pinned-memory. El registro mostraba:

[ERROR] !!! Exception during processing !!! native MiniMax H3 FinalLayer exposes an incomplete PDD projection contract

El mensaje indicaba claramente que el problema no radicaba en la memoria RAM bloqueada, sino en la implementación interna de MiniMax H3 dentro de ComfyUI.

Esquema de error técnico en integración de modelo MiniMax H3 dentro de ComfyUI
Error en el contrato de proyección PDD detectado en la capa FinalLayer

La frase clave del error revela que la native MiniMax H3 FinalLayer no exponía el contrato de proyección PDD completo. Esto sugiere una incompatibilidad entre la implementación del modelo y algún mecanismo de ejecución o optimización.

Tras investigar, se descubrió que ese mensaje exacto aparece en el repositorio ComfyUI-Spectrum-MiniMax-H3. El sistema inspecciona la firma de FinalLayer.forward() para detectar cómo se implementan las proyecciones. ComfyUI ha cambiado esa interfaz varias veces, pasando de firmas antiguas a variantes intermedias y posteriores que utilizan parámetros como grids.

La solución identificada reside en la versión Spectrum MiniMax H3 v0.2.30, publicada el 10 de noviembre de 2026. Esta incorporación incluye compatibilidad con las tres interfaces conocidas de FinalLayer.

Los pasos para aplicar la corrección fueron:

  1. Comprobar qué versión de Spectrum se tenía instalada.
  2. Actualizarla a v0.2.30.
  3. Reiniciar ComfyUI completamente.
  4. Repetir la generación con el mismo workflow.

Una precaución importante: si existen nodos como H3-Optimizations que modifican la interfaz, podría existir una segunda incompatibilidad. La propia versión 0.2.30 advierte sobre ciertas combinaciones con optimizadores externos.

Tras aplicar la actualización, el problema desapareció. Se confirmó que era una incompatibilidad concreta en la interfaz de proyección y no un fallo de gestión de memoria. El parámetro --disable-pinned-memory podría mantenerse solo si aporta estabilidad adicional, pero no es necesario sacrificar rendimiento por este error.

Pantalla de consola confirmando la actualización correcta del paquete ComfyUI-Spectrum-MiniMax-H3
Actualización del nodo Spectrum a la versión 0.2.30 resuelve el conflicto

Conclusión: el diagnóstico inicial de memoria RAM era una falsa alarma. La actualización del paquete Spectrum a la versión correcta resolvió el contrato incompleto.