Traduco — Cómo usar

Última actualización: 1 de enero de 2025

Requisitos

  • Autodesk Revit 2023, 2024, 2025, 2026 o 2027
  • Un modelo activo de Revit (cualquier disciplina)
  • Opcional: una clave API de Claude o OpenAI para traducción asistida por IA
  • Acceso a Internet para la traducción por IA (Revisar y Aplicar funcionan completamente offline)

Visión General del Flujo de Trabajo

1. Extraer    →   2. Traducir Automáticamente (opcional)   →   3. Revisar   →   4. Aplicar   →   5. Validar

Todos los comandos están en la pestaña Avant Leap → panel Traduco.

Paso 1 — Extraer Texto del Modelo

Botón: Extraer Texto del Modelo (icono turquesa)

Escanea el modelo activo de Revit y escribe todo el texto traducible en extraction.json.

Qué se extrae (10 categorías):

Categoría Qué captura
Información del Proyecto Nombre del Edificio, Nombre del Proyecto, Número de Proyecto, Estado, Cliente, Dirección
Niveles Nombres de niveles
Vistas Nombres de vistas (las plantillas y vistas internas se omiten)
Familias Nombres de familias y de tipos
Tipos de Elementos Nombres de tipos que no son familias, agrupados por categoría
Parámetros de Instancia Parámetros de texto seleccionados en elementos colocados (opcional — lento en modelos grandes)
Parámetros de Tipo Parámetros de texto seleccionados en tipos de elemento (opcional — lento en modelos grandes)
Materiales Nombres de materiales
Notas de Texto Contenido de los elementos de notas de texto
Encabezados de Tablas Encabezados de columna de todas las tablas que no son plantillas

Cómo ejecutar:

  1. Abre un modelo de Revit.
  2. Haz clic en Extraer Texto del Modelo.
  3. Aparece un diálogo de selección de categoría — marca las categorías deseadas (Parámetros de Instancia/Tipo no están marcados por defecto por el tiempo de escaneo).
  4. Haz clic en Extraer. Una ventana muestra el progreso por categoría.
  5. Al finalizar, un resumen indica cuántos textos se encontraron por categoría.

Archivo de salida: {MyDocuments}\AvantLeap\Tools\Traduco\{ModelName}\{Year}\extraction.json

Paso 2 — Traducir Automáticamente (opcional)

Botón: Traducir Automáticamente (icono morado)

Envía las cadenas extraídas a un proveedor de IA y rellena las traducciones automáticamente. Puedes omitir este paso y traducir manualmente en el Paso 3.

Cómo ejecutar:

  1. Haz clic en Traducir Automáticamente.
  2. Selecciona el idioma de origen y el idioma de destino de las listas desplegables.
  3. Selecciona tu proveedor de IA (Claude o OpenAI).
  4. Pega tu clave API en el campo correspondiente.
  5. Opcionalmente activa el Modo de Prueba (casilla ámbar) para ejecutar sin llamadas a la API — útil para probar el flujo.
  6. Haz clic en Traducir. Una barra muestra el progreso por lotes.

Qué ocurre:

  • Las entradas ya presentes en el diccionario global se resuelven al instante (sin llamada API, sin tokens).
  • Las entradas restantes se agrupan (50 por llamada) y se envían al proveedor de IA.
  • Cada lote exitoso actualiza el diccionario global para uso futuro.
  • Las entradas traducidas reciben el estado ai.

Archivo de salida: {MyDocuments}\AvantLeap\Tools\Traduco\{ModelName}\{Year}\{SRC}_{TGT}.json (por ej. ES_EN.json)

Diccionario global: {MyDocuments}\AvantLeap\Tools\Traduco\dictionary\{SRC}_{TGT}.json — compartido en todos los modelos. Crece con el tiempo, reduciendo costes de API.

Paso 3 — Revisar Asignaciones

Botón: Revisar Asignaciones (icono ámbar)

Abre una cuadrícula WPF donde puedes inspeccionar, editar y aprobar traducciones antes de aplicarlas al modelo.

Cómo usar:

  1. Haz clic en Revisar Asignaciones.
  2. Selecciona el par de idiomas a revisar (por ej. ES → EN).
  3. La cuadrícula muestra todas las entradas: texto original, traducción sugerida por la IA, categoría y estado.
  4. Edita traducciones directamente haciendo clic en una celda de la columna de Traducción.
  5. Marca entradas como Omitidas para excluirlas de la aplicación.
  6. Utiliza los filtros de Categoría y Estado para centrarte en entradas específicas.
  7. Cierra la ventana — los cambios se guardan automáticamente.

Estados de las entradas:

Estado Significado
pending Aún no traducido
ai Rellenado por IA (se recomienda revisión)
dict Resuelto desde el diccionario global
manual Editado por ti
skipped Excluido de la Aplicación

Paso 4 — Aplicar Traducción

Botón: Aplicar Traducción (icono rojo)

Escribe las traducciones del archivo de asignaciones de vuelta en el modelo de Revit. Este es el único paso que modifica el modelo.

Cómo ejecutar:

  1. Haz clic en Aplicar Traducción.
  2. Selecciona el par de idiomas a aplicar.
  3. Confirma la operación. Un resumen muestra cuántos elementos se renombrarán.
  4. Haz clic en Aplicar. Todos los cambios se agrupan en un solo TransactionGroup — un solo paso de Deshacer en el historial de Revit.

Qué se escribe:

  • Se aplican las entradas con estado ai, dict o manual (traducción no vacía).
  • Las entradas con estado pending o skipped no se modifican.
  • Cada entrada apunta al elemento exacto de Revit mediante ElementId almacenado — sin ambigüedad por nombre.

Limitación conocida — Parámetros compartidos: Cambiar el nombre visible de un parámetro compartido requiere recrearlo. Traduco lo advierte y omite esas entradas para evitar errores silenciosos.

Paso 5 — Validar Cobertura

Botón: Validar Cobertura (icono azul)

Muestra un informe de cobertura comparando lo extraído frente a lo traducido, por categoría.

Columnas del informe:

Columna Significado
Categoría La categoría de extracción
Total Total de entradas extraídas
Traducido Entradas con traducción no vacía
Pendientes Entradas aún sin traducir
Omitidas Entradas marcadas como omitidas
% de Cobertura Traducido / (Total − Omitidas)

Utiliza este informe para identificar vacíos antes de compartir el modelo o ejecutar de nuevo Aplicar.

Almacenamiento de Datos

Todos los datos de Traduco se almacenan localmente — sin sincronización en la nube, sin servidores externos.

{MyDocuments}\AvantLeap\Tools\Traduco\
  {ModelName}\
    {Year}\
      extraction.json        ← textos fuente (se regenera al Extraer)
      ES_EN.json             ← asignación de traducción para Español → Inglés
      ES_PT.json             ← asignación de traducción para Español → Portugués
      config.json            ← último par de idiomas usado, proveedor preferido
  dictionary\
    ES_EN.json               ← diccionario global (compartido entre todos los modelos)
    ES_PT.json

Las claves API se mantienen únicamente en memoria y nunca se escriben en disco.

Consejos

  • Ejecuta Extraer nuevamente después de editar el modelo para actualizar extraction.json. Tus traducciones existentes en {SRC}_{TGT}.json se conservan — solo se agregan nuevas cadenas como pending.
  • El diccionario crece con el tiempo. Cuantos más modelos traduzcas, menos tokens de API se usan en ejecuciones futuras.
  • Utiliza el Modo de Prueba para verificar el flujo completo (Extraer → Traducir Automat. → Revisar → Aplicar → Validar) sin gastar tokens de API.
  • Un solo paso de Deshacer. Toda la operación de Aplicar es un solo TransactionGroup en Revit — puedes deshacer todos los cambios con Ctrl+Z.

Solución de Problemas

Problema Solución
El complemento no aparece en la cinta Verifica que el archivo .addin esté en %APPDATA%\Autodesk\Revit\Addins\{Year}\
Error de DLL no encontrada al iniciar Revit Ejecuta deploylocal.bat después de compilar
La traducción por IA excede el tiempo de espera Reduce el lote seleccionando menos categorías; los escaneos grandes de parámetros pueden ser lentos
No se aplican encabezados de tabla El comportamiento del setter ColumnHeading varía según la versión de Revit — verifica el informe de Validar
Traducciones faltantes tras Aplicar Revisa Validar Cobertura — puede haber entradas pending u skipped