CommunityImagengithub.com

cad-view

Resuelve ocurrencias de ensamblajes STEP y exporta vistas ortográficas SVG aisladas del objetivo con manifiestos de procedencia. Útil para solicitudes como 'exporta la vista frontal de esta puerta', 'renderiza solo esta ocurrencia' o 'crea una ilustración vectorial para un documento'. Soporta selectores espaciales y una heurística explícita de frente asumido; preserva los supuestos de cámara versus frente semántico y nunca infiere dimensiones a partir de píxeles. No están implementados los formatos PNG, renderizado fotorrealista, interpretación VLM ni el reconocimiento declarado/funcional del frente.

¿Qué es cad-view?

Este skill permite a agentes de IA (como Claude Code, Cursor o Codex) trabajar con modelos STEP mediante la línea de comandos `facts`, ofreciendo resolución de ocurrencias, orientación de vistas y renderizado a SVG técnico. Es especialmente útil para tareas de documentación técnica donde se necesita aislar componentes específicos de un ensamblaje y generar ilustraciones vectoriales de alta calidad. La resolución admite selectores por nombre, ruta, definición o restricciones espaciales como cajas delimitadoras, devolviendo resultados precisos o ambiguos para que el agente o usuario decida. La orientación propone vistas candidatas basadas en la cara de mayor área, y el renderizado produce un SVG determinista con un manifiesto `.view.json` que garantiza la trazabilidad del artefacto, la instantánea y el objetivo. El sistema es offline, no modifica el archivo fuente, y es compatible con Python 3.13 y dependencias OCCT. No se admiten formatos como PNG, renderizado fotorrealista, interpretación visual por VLM ni reconocimiento funcional de frentes declarados en el archivo.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/EthanLoveQueen/cad-to-facts/tree/HEAD/skills/cad-view

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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). Devuelve resolved, ambiguous, unresolved o failed; nunca elige uno de varios candidatos por orden de recorrido.
  • facts orient: seis candidatos de cámara y un recommended_view opcional basado en la heurística de la cara de mayor bbox, hacia afuera del ensamblaje. Una recomendación siempre tiene semantic_status=assumed.
  • facts render sobre STEP: una ocurrencia activa occurrence:N, una ViewSpecification explí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 su occurrence_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; near necesita 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ón made_by del 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_count y VIEW_EDGES_NOT_DISCRETIZED divulgan 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.

Skills relacionados