Nodo — Cómo usar

Última actualización: 1 de enero de 2026

Nodo es un complemento de Revit que genera paquetes de nodos Dynamo ZeroTouch a partir de cualquier DLL de AvantLeap C# compilada en solo cuatro clics en la cinta — sin necesidad de escribir archivos stub manualmente.

Requisitos previos

  • Autodesk Revit 2023–2027 instalado
  • Dynamo para Revit (incluido con Revit) presente
  • Una DLL de complemento de AvantLeap C# compilada (o cualquier DLL .NET con clases públicas)

Paso 1 — Analizar DLL

  1. En Revit, abre la pestaña Avant Leap → panel Nodo.
  2. Haz clic en Analizar DLL.
  3. Selecciona el archivo .csproj de tu proyecto de complemento (o directamente una .dll compilada).
  4. Se abrirá una ventana de selección mostrando cada método público, pre-evaluado según su idoneidad:
    • Recomendado — tipos puros .NET/Dynamo; nodos ideales
    • Mixto — algunos tipos de API de Revit; útiles pero pueden requerir entradas de Element.Id
    • Revit-Pesado — todos tipos de API de Revit; uso avanzado
    • Omitir — métodos heredados de Object, métodos de ciclo de vida; pre-deseleccionados
  5. Marca o desmarca métodos usando las pestañas, la barra de búsqueda y las casillas.
  6. (Opcional) Haz clic en Mejorar con IA para reescribir descripciones en un lenguaje amigable para arquitectos. Configura tu clave de Claude o OpenAI primero mediante Claves API....
  7. Haz clic en Confirmar selección.

El archivo de manifiesto {ProjectName}_nodes.json se guarda en:

Documents\AvantLeap\Tools\Nodo\

Paso 2 — Generar nodos

  1. Haz clic en Generar nodos.
  2. Selecciona el archivo JSON de manifiesto guardado en el Paso 1.
  3. Elige una carpeta de salida (o acepta la opción predeterminada).
  4. Nodo genera un proyecto listo para compilar:
    • {ClassName}Nodes.cs — métodos stub ZeroTouch
    • {ProjectName}Nodes.csproj — referencias a paquetes NuGet de Dynamo
    • pkg.json — manifiesto del paquete Dynamo
    • version.json — control de versión
    • CLAUDE.md — archivo de contexto para que Claude Code ayude con el proyecto generado

Abre la carpeta de salida en VS Code. Claude lee CLAUDE.md y puede ayudar a completar cualquier aspecto faltante.

Paso 3 — Desplegar nodos

  1. Haz clic en Desplegar nodos.
  2. Selecciona la carpeta del proyecto generado en el Paso 2.
  3. Nodo ejecuta dotnet build -c Release y copia la DLL + pkg.json en:
    %APPDATA%\Dynamo\Dynamo Revit\3.x\packages\{ProjectName} Nodes\bin\
  4. Reinicia Revit y abre Dynamo — los nuevos nodos aparecerán en el navegador de la biblioteca bajo la categoría del proyecto.

Paso 4 — Actualizar nodos

Cuando tu DLL de complemento original se actualice con nuevos métodos:

  1. Ejecuta nuevamente Analizar DLL sobre la DLL actualizada para obtener un nuevo manifiesto.
  2. Haz clic en Actualizar nodos.
  3. Selecciona el nuevo manifiesto y la carpeta del proyecto generado existente.
  4. Nodo compara por ID de método, agrega nuevos métodos stub y actualiza la versión.
  5. Ejecuta nuevamente Desplegar nodos para aplicar la actualización en Dynamo.

Mejora de descripciones con IA

Nodo puede reescribir descripciones técnicas de métodos con lenguaje BIM/AEC claro usando Claude u OpenAI.

Para configurar:

  1. En la ventana Analizar DLL, haz clic en Claves API....
  2. Introduce tu clave de API de Anthropic Claude y/o tu clave de API de OpenAI.
  3. Selecciona tu proveedor preferido.
  4. Haz clic en Guardar.

Las claves se almacenan localmente en Documents\AvantLeap\Tools\Nodo\nodo-settings.json.

Consejos

  • Edita {ProjectName}_nodes.json en VS Code para refinar descripciones, renombrar nodos (nodeName) o cambiar anulaciones de tipo de salida (output.overriddenTypeName) antes de generar.
  • Define include: false en cualquier función para excluirla de la generación de stubs.
  • La ruta de paquetes de Dynamo se detecta automáticamente. Para sobrescribirla, configura DynamoPackagesPath en nodo-settings.json.

Soporte

Visita avantleap.com/nodo/how-to-use para ver recorridos en video y la documentación más reciente.