CommunityImagegithub.com

cad-view

Résout les occurrences d'assemblage STEP et exporte des vues orthographiques SVG isolées pour la cible, avec des manifests de provenance. Utilisé pour des demandes telles que « exporter la vue de face de cette porte », « afficher uniquement cette occurrence » ou « créer une illustration vectorielle pour un document ». Prend en charge les sélecteurs spatiaux et une heuristique de face avant explicitement supposée ; préserve les hypothèses de caméra et de face sémantique et n'infère jamais les dimensions à partir des pixels. Le rendu PNG, photoréaliste, l'interprétation VLM et la reconnaissance de face déclarée/fonctionnelle ne sont pas implémentés.

Qu'est-ce que cad-view ?

Cette compétence permet d'exporter des vues techniques vectorielles (SVG) à partir de fichiers STEP, en ciblant des occurrences spécifiques. Elle repose sur le CLI local `facts`, qui résout les occurrences via des sélecteurs (nom, chemin, boîte englobante, etc.), oriente la caméra selon des préréglages ou des vecteurs explicites, et génère un SVG avec un manifeste de provenance. Elle est utile pour la documentation technique, les illustrations dans des rapports, ou toute demande nécessitant une vue isolée d'un composant. La compétence fonctionne de manière déterministe et hors ligne, sans appels à des modèles de langage ou de vision. Elle ne prend pas en charge le rendu PNG, photoréaliste, les vues éclatées, la reconnaissance de faces déclarées, ni l'inférence visuelle. Les limites incluent la portée des identifiants d'occurrence (non persistants entre révisions), la discrétisation des courbes en polylignes SVG, et l'absence de preuve de contact ou de dimensions exactes. La compétence insiste sur l'honnêteté : une vue de face n'implique pas une face fonctionnelle, et les dimensions ne doivent jamais être lues à partir des pixels.

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

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Vues d'occurrences STEP et illustrations techniques

Cette compétence utilise le même CLI local facts que cad-to-facts. Elle crée des vues en lignes cachées OCCT en lecture seule d'une occurrence STEP explicitement sélectionnée. L'artefact source n'est jamais modifié. Le rendu est hors ligne et déterministe ; il n'appelle pas de LLM/VLM et ne télécharge ni le modèle ni l'image.

Périmètre implémenté

  • facts resolve : nom d'occurrence/définition exact, sous-chaîne/alias, chemin, définition, type racine/assemblage, état et contraintes spatiales de la boîte englobante mondiale. Retourne resolved, ambiguous, unresolved ou failed ; il ne choisit jamais un candidat parmi plusieurs par ordre de parcours.
  • facts orient : six candidats de caméra et une recommended_view facultative basée sur l'heuristique de la plus grande face de la boîte englobante, orientée vers l'extérieur de l'assemblage. Une recommandation a toujours semantic_status=assumed.
  • facts render sur STEP : une occurrence active occurrence:N, une ViewSpecification explicite, un nouveau SVG et un nouveau manifeste .view.json associé.
  • Préréglages de caméra d'axe global et vecteurs normal/droit explicites, sortie en lignes visibles/cachées, nombre de points SVG limité, hachages d'artefact/capture/sortie avec liaison de cible exacte, et sémantique de vue optionnelle sélectionnée par l'utilisateur ou supposée.

Le rendu PNG, les vues en coupe/éclatées/ombrées, la sortie photoréaliste, l'annotation de dimensions, la reconnaissance de face avant déclarée ou fonctionnelle et l'inférence visuelle ne sont pas implémentés. Le SVG est un WorkProduct de révision/documentation, pas une preuve d'équivalence visuelle ou géométrique, ni un FactSet.

Configuration

Utilisez le CLI facts installé du dépôt, ou uv run --project /path/to/cad-to-facts facts .... L'environnement de référence est Python 3.13 avec les dépendances OCCT verrouillées. Aucun ODA, text-to-cad, Blender ou service réseau n'est utilisé pour le rendu SVG STEP.

Résoudre avant de rendre

Écrivez un TargetSelector JSON tel que :

{"name_contains": "DOOR", "is_assembly": false}

Exécutez ensuite :

facts resolve assembly.step --selector door-selector.json

Lisez resolution.status, resolution.complete, resolution.discovery, les candidats et les diagnostics. name et name_contains inspectent à la fois les noms d'occurrence et les noms de définition de pièce, car certains fichiers STEP ne déclarent que des noms de PRODUIT. Les name_path et path du candidat sont différents : le premier est destiné à l'affichage, tandis que le second relie les ID d'occurrence à portée de capture et est la forme exacte du sélecteur de chemin.

  • resolved : exactement un candidat découvert ; utilisez son occurrence_id.
  • ambiguous : inspectez les chemins, noms et boîtes englobantes placées des candidats, ajoutez des contraintes ou demandez à l'utilisateur de choisir. Ne sélectionnez jamais silencieusement le premier.
  • unresolved : aucun candidat correspondant n'a été découvert. Ceci ne prouve pas l'absence technique.
  • failed : la capture n'a pas pu être lue ; ne faites pas de rendu à partir de celle-ci.

complete signifie une découverte complète des occurrences plus une boîte englobante placée mesurable pour chaque candidat retourné. Cela ne signifie pas une validation complète de la forme, l'absence de diagnostics, une résolution réussie ou une unicité globale. Un résultat ambigu ou non résolu peut être complet lorsque la découverte est complète. Avec une découverte partielle ou inconnue, l'unicité est uniquement basée sur la découverte et complete=false.

Sélection de face avant optionnelle

Pour une cible résolue de manière unique, facts orient assembly.step --selector selector.json retourne six candidats de projection de la boîte englobante mondiale. Il sélectionne uniquement un unique axe de plus grande surface dont le signe sortant du centre de l'assemblage est non ambigu. Sinon, il retourne ambiguous et aucune vue. Copiez un recommended_view réussi textuellement dans un fichier JSON pour le rendu ; il a déjà semantic_intent.basis=assumed. Ne le renommez pas user_selected sauf si l'utilisateur le choisit réellement, et ne l'appelez jamais une face avant déclarée dans la source. Les heuristiques de boîte englobante peuvent choisir le mauvais côté de documentation, divulguez donc l'hypothèse.

Exporter une vue

Écrivez une ViewSpecification, par exemple 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"
  }
}

Faite le rendu de la cible résolue :

facts render assembly.step \
  --target occurrence:12 \
  --view-spec door-front-view.json \
  --output door-front.svg

Ceci crée door-front.svg et door-front.view.json. Les deux chemins doivent être nouveaux ; aucun n'est écrasé. Si l'un d'eux existe déjà, aucune nouvelle paire n'est écrite. Le manifeste lie l'identité de l'artefact/capture, la cible exacte, la spécification de vue complète, le rendu/version, les étendues projetées, les nombres d'arêtes/points, le SHA-256/taille de l'image et les diagnostics. Vérifiez ces octets avant une utilisation en aval.

Résoudre et rendre relisent indépendamment le fichier STEP ; le rendu n'impose pas d'ID de résolution préalable. Avant de vous fier à la sélection, comparez artifact.sha256 et snapshot.snapshot_id de resolve avec artifact.sha256 et snapshot_id de render. Si l'un ou l'autre diffère, jetez la sélection précédente et résolvez à nouveau. Le manifeste enregistre la capture et la cible réellement rendues.

Les sémantiques de caméra ne sont pas des sémantiques de conception

Le préréglage front signifie uniquement : observateur sur le -Y global, regardant vers +Y, écran-droite +X et écran-haut +Z. Il ne prouve pas la face fonctionnelle de la pièce. Les autres préréglages sont documentés dans View contract.

Pour une direction définie par l'utilisateur, utilisez les vecteurs explicites normal et right. normal pointe du modèle vers l'observateur ; normal × right détermine l'écran-haut. semantic_intent.basis est uniquement :

  • user_selected : l'utilisateur a fourni/confirmé cette signification ;
  • assumed : une hypothèse explicite de l'agent qui doit être divulguée.

Le contrat actuel n'accepte pas de base declared : les déclarations de face avant dans le fichier source ne sont pas extraites. Omettez semantic_intent pour une caméra purement géométrique. Ne transformez jamais un préréglage ou une face avant supposée en affirmation que la conception source déclare cette face.

Limites honnêtes

  • Les ID d'entité/occurrence et les chemins sont limités à la capture, pas une identité persistante entre révisions.
  • La résolution de cible filtre les ID déclarés, les chemins, les noms/alias, la définition, le type racine/assemblage, l'état et les relations spatiales de la boîte englobante mondiale placée. Les boîtes englobantes placées et les preuves spatiales sont retournées. Les relations directionnelles comparent les centres dans une caméra explicite ; near nécessite une limite d'écart de boîte explicite. Ce ne sont pas des preuves de contact, de contenu, de distance exacte ou de caractéristique fonctionnelle. Les sélecteurs de face/arête et le mappage made_by du code source ne sont pas implémentés.
  • Résoudre la géométrie ne localise pas un paramètre source modifiable. Les commandes de modification existantes nécessitent toujours leur ChangePreparationSpec et SourceManifest de preuve explicites.
  • L'HLR OCCT fournit des arêtes projetées ; les courbes sont discrétisées en polylignes SVG. skipped_edge_count et VIEW_EDGES_NOT_DISCRETIZED divulguent les chemins omis. Le nombre de points est limité, mais le temps d'exécution HLR n'est pas une garantie générale pour les grands assemblages. Les étendues projetées décrivent l'ensemble de points discrétisés émis, pas les dimensions source exactes.
  • Un rendu peut réussir avec une découverte partielle ou des diagnostics d'analyseur ; ceux-ci restent dans le manifeste et empêchent les affirmations d'exhaustivité complète du modèle.
  • Ne lisez jamais les dimensions à partir des pixels. Utilisez Facts pour les mesures implémentées ou le PMI sémantique pour les valeurs d'annotation déclarées.
  • Les tests ciblés utilisent des bancs STEP générés analytiquement par OCCT. Ces tests et les observations isolées de fichiers réels n'établissent pas l'interopérabilité des exportateurs ou le rendu général de grands assemblages.
  • N'envoyez pas la source ou le SVG dérivé à un modèle visuel externe sans autorisation séparée.

Voir View contract pour tous les champs de sélecteur, caméra et manifeste.

Skills associés