Text-to-CAD: fuente paramétrica, evidencia geométrica y entrega responsable
Arquitectura Text-to-CAD: actualidad de fuente y compilación del documento
Traza llamadas, salidas y estados del visor, incluidas actualizaciones de ensamblaje bajo demanda e inputs no observados por la comprobación de actualidad.
Qué aprenderás
- Seguir la construcción desde fuente
- Un documento puede renderizar aunque cambie la fuente
- Explicitar los inputs geométricos
Antes de empezar
- Funciones, módulos y rutas Python básicos
- Unidades y diferencia entre diseño y pieza física
Planificar un ejercicio acotado y distinguir actualidad, inspección, revisión visual y fabricación.
Conclusiones clave
- El padre consume cambios del hijo al reconstruirse.
- Renderizar un documento no prueba actualidad de fuente.
- Los inputs que cambian geometría deben ser explícitos.
Seguir la construcción desde fuente
La guía identifica modelos por archivo y función, obtiene geometría del cuerpo y salidas de decoradores. Los padres llaman a modelos hijos y colocan su geometría. Un cambio de hijo no actualiza automáticamente todos los artefactos de ensamblaje; el padre debe reconstruirse para consumir el resultado nuevo.
El almacén documentado contiene geometría derivada direccionada por contenido y registros. La actualidad considera fuente, constantes importadas, resultados hijos y salidas declaradas. Es un contrato descrito, no una implementación completa de concurrencia o caché que hayamos probado.
Un documento puede renderizar aunque cambie la fuente
Inspección y visualización comienzan desde STEP o malla, no desde su generador Python. Si falta representación en el almacén, se compilan los bytes existentes. Eso explica qué contiene el archivo ahora, no si una edición posterior del código debería haber producido otros bytes.
Los estados del visor describen compilación, renderizado o fallo del documento. Para actualidad de fuente, utiliza store why y reconstruye el objetivo correspondiente. Reabrir el STEP antiguo no aplica automáticamente una dimensión editada en Python.
Explicitar los inputs geométricos
La guía advierte que entorno, hora, directorio y aleatoriedad no son inputs geométricos rastreados. Usa constantes o argumentos de fábrica explícitos en lugar de estado ambiental. De otro modo, un valor externo cambiante puede dejar una comprobación engañosamente actual.
Se recomienda un modelo por archivo porque varios modelos comparten el cierre de fuente del archivo. Define límites por piezas y dependencias significativas. No probamos carreras del daemon, invalidación entre versiones ni reconstrucciones completas; el diagrama no establece esas garantías.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Identifica modelo, hijos y salidas.
- 2
Distingue fuente de bytes del documento.
- 3
Consulta actualidad antes de reconstruir.
- 4
Elimina inputs ocultos de tiempo, entorno o azar.
Ejemplo para copiar
{
"diagnostico": true,
"fuenteEditada": true,
"documentoRenderizado": true,
"actualidadConocida": false,
"siguienteComprobacion": "cadgen store why sample.py",
"objetivo": "sample.py"
}Preguntas frecuentes
¿Reconstruir un hijo actualiza todos los ensamblajes?
El contrato es bajo demanda: reconstruye el padre para consumir el hijo cambiado.
¿Rendered significa fuente actual?
No. Es un estado del documento en el visor.
Fuentes
- Text-to-CAD / skills/cad/SKILL.mdFuente verificada 2026-09-14
- Text-to-CAD / skills/cad-viewer/SKILL.mdFuente verificada 2026-09-14