Vistas de ocurrencias STEP e ilustraciones técnicas
Este skill utiliza la misma CLI local facts que cad-to-facts. Crea vistas de líneas ocultas OCCT de solo lectura de una ocurrencia STEP seleccionada explícitamente. El artefacto fuente nunca se modifica. El renderizado es offline y determinista; no llama a un LLM/VLM ni sube el modelo o la imagen.
Alcance implementado
facts resolve: nombre exacto de ocurrencia/definición, subcadena/alias, ruta, definición, tipo raíz/ensamblaje, estado y restricciones espaciales de caja delimitadora mundial (bounded world-bbox). Devuelveresolved,ambiguous,unresolvedofailed; nunca elige uno de varios candidatos por orden de recorrido.facts orient: seis candidatos de cámara y unrecommended_viewopcional basado en la heurística de la cara de mayor bbox, hacia afuera del ensamblaje. Una recomendación siempre tienesemantic_status=assumed.facts rendersobre STEP: una ocurrencia activaoccurrence:N, unaViewSpecificationexplícita, un nuevo SVG y un nuevo manifiesto hermano.view.json.- Presets de cámara de ejes globales y vectores normales/derechos explícitos, salida de líneas visibles/ocultas, recuento de puntos SVG acotado, hashes de artefacto/instantánea/salida con vinculación exacta al objetivo, y semántica de vista opcional seleccionada por el usuario o asumida.
No están implementados PNG, vistas en sección/explosionadas/sombreadas, salida fotorrealista, anotaciones de dimensiones, reconocimiento declarado de frente en la fuente o inferencia visual. Un SVG es un WorkProduct de revisión/documentación, no una prueba de equivalencia visual o geométrica ni un FactSet.
Configuración
Usa la CLI facts instalada del repositorio, o uv run --project /path/to/cad-to-facts facts .... El entorno de referencia es Python 3.13 con las dependencias OCCT bloqueadas. No se utiliza ODA, text-to-cad, Blender ni ningún servicio de red para el renderizado SVG de STEP.
Resolver antes de renderizar
Escribe un JSON TargetSelector como:
{"name_contains": "DOOR", "is_assembly": false}
Luego ejecuta:
facts resolve assembly.step --selector door-selector.json
Lee resolution.status, resolution.complete, resolution.discovery, los candidatos y los diagnósticos. name y name_contains inspeccionan tanto los nombres de ocurrencia como los nombres de definición de pieza porque algunos archivos STEP declaran solo nombres de PRODUCT. name_path y path del candidato son diferentes: el primero es para visualización, mientras que el segundo une los IDs de ocurrencia con alcance de instantánea y es la forma exacta del selector de ruta.
resolved: exactamente un candidato descubierto; usa suoccurrence_id.ambiguous: inspecciona las rutas, nombres y cajas delimitadoras colocadas de los candidatos, agrega restricciones o pide al usuario que elija. Nunca selecciones el primero en silencio.unresolved: no se descubrió ningún candidato coincidente. Esto no es prueba de ausencia en la ingeniería.failed: no se pudo leer la instantánea; no renderices a partir de ella.
complete significa descubrimiento completo de ocurrencias más una caja delimitadora colocada medible para cada candidato devuelto. No significa validación completa de la forma, ausencia de diagnósticos, resolución exitosa o unicidad global. Un resultado ambiguo o no resuelto puede ser completo cuando el descubrimiento es completo. Con descubrimiento parcial o desconocido, la unicidad es solo descubierta y complete=false.
Selección opcional de frente asumido
Para un objetivo resuelto de forma única, facts orient assembly.step --selector selector.json devuelve seis candidatos de proyección de la caja delimitadora mundial. Selecciona solo un eje único de mayor área cuyo signo hacia afuera del centro del ensamblaje sea inequívoco. De lo contrario, devuelve ambiguous y ninguna vista. Copia un recommended_view exitoso textualmente a un archivo JSON para renderizarlo; ya tiene semantic_intent.basis=assumed. No lo reetiquetes como user_selected a menos que el usuario realmente lo elija, y nunca lo llames frente declarado en la fuente. Las heurísticas de caja delimitadora pueden elegir el lado de documentación incorrecto, por lo tanto, divulga la suposición.
Exportar una vista
Escribe una ViewSpecification, por ejemplo door-front-view.json:
{
"title": "Door front",
"camera": {"preset": "front"},
"display": {"show_hidden_lines": false},
"image": {
"width": 1200,
"height": 900,
"padding": 24,
"curve_deflection_mm": 0.1,
"max_points": 200000
},
"semantic_intent": {
"label": "front",
"basis": "user_selected",
"note": "The user selected the exterior side as front"
}
}
Renderiza el objetivo resuelto:
facts render assembly.step \
--target occurrence:12 \
--view-spec door-front-view.json \
--output door-front.svg
Esto crea door-front.svg y door-front.view.json. Ambas rutas deben ser nuevas; ninguna se sobrescribe. Si alguna ya existe, no se escribe ningún par nuevo. El manifiesto vincula la identidad del artefacto/instantánea, el objetivo exacto, la especificación completa de la vista, el renderizador/versión, las extensiones proyectadas, los recuentos de bordes/puntos, el SHA-256/tamaño de la imagen y los diagnósticos. Verifica esos bytes antes de usarlos downstream.
Resolver y renderizar releen el archivo STEP de forma independiente; render no exige un ID de resolución previo. Antes de confiar en la selección, compara artifact.sha256 y snapshot.snapshot_id de resolve con artifact.sha256 y snapshot_id de render. Si alguno difiere, descarta la selección anterior y resuelve de nuevo. El manifiesto registra la instantánea y el objetivo realmente renderizados.
La semántica de cámara no es semántica de diseño
El preset front significa solo: observador en -Y global, mirando hacia +Y, derecha de pantalla +X y arriba de pantalla +Z. No prueba el frente funcional de la pieza. Otros presets están documentados en View contract.
Para una dirección definida por el usuario, usa vectores normal y right explícitos. normal apunta del modelo hacia el observador; normal × right determina la dirección hacia arriba de la pantalla. semantic_intent.basis solo puede ser:
user_selected: el usuario proporcionó/confirmó este significado;assumed: una suposición explícita del agente que debe divulgarse.
El contrato actual no acepta una base declared: las declaraciones de frente en el archivo fuente no se extraen. Omite semantic_intent para una cámara puramente geométrica. Nunca conviertas un preset o un frente asumido en una afirmación de que el diseño fuente declara ese lado.
Límites honestos
- Los IDs de entidad/ocurrencia y las rutas tienen alcance de instantánea, no son identidad persistente entre revisiones.
- La resolución de objetivos filtra IDs declarados, rutas, nombres/alias, definición, tipo raíz/ensamblaje, estado y relaciones espaciales acotadas de caja delimitadora mundial. Se devuelven cajas delimitadoras colocadas y evidencia espacial. Las relaciones direccionales comparan centros en una cámara explícita;
nearnecesita un límite de brecha de bbox explícito. Estas no son pruebas de contacto, contención, distancia exacta o características funcionales. Los selectores de cara/borde y la asignaciónmade_bydel código fuente no están implementados. - Resolver geometría no localiza un parámetro fuente editable. Los comandos de cambio existentes aún requieren su ChangePreparationSpec y SourceManifest de evidencia explícitos.
- El HLR de OCCT proporciona bordes proyectados; las curvas se discretizan en polilíneas SVG.
skipped_edge_countyVIEW_EDGES_NOT_DISCRETIZEDdivulgan rutas omitidas. El recuento de puntos está acotado, pero el tiempo de ejecución del HLR no es una garantía general para ensamblajes grandes. Las extensiones proyectadas describen el conjunto de puntos discretizados emitidos, no las dimensiones exactas de la fuente. - Un renderizado puede tener éxito con descubrimiento parcial o diagnósticos del analizador; estos permanecen en el manifiesto y evitan afirmaciones de integridad del modelo completo.
- Nunca leas dimensiones a partir de píxeles. Usa Facts para mediciones implementadas o PMI semántico para valores de anotación declarados.
- Las pruebas enfocadas usan fixtures STEP generados por OCCT analíticos. Esas pruebas y observaciones aisladas de archivos reales no establecen interoperabilidad de exportadores ni renderizado general de ensamblajes grandes.
- No envíes la fuente ni el SVG derivado a un modelo visual externo sin autorización separada.
Consulta View contract para todos los campos de selector, cámara y manifiesto.