CommunityBildgithub.com

CAD-Ansicht

Löst STEP-Baugruppenvorkommen auf und exportiert zielisolierte orthografische SVG-Ansichten mit Provenienzmanifesten. Verwenden Sie es für Anfragen wie „exportieren Sie die Vorderansicht dieser Tür“, „rendern Sie nur dieses Vorkommen“ oder „erstellen Sie eine Vektorillustration für ein Dokument“. Es unterstützt räumliche Selektoren und eine explizit angenommene Frontheuristik; bewahrt Kamera- versus semantische Frontannahmen und leitet niemals Abmessungen aus Pixeln ab. PNG, fotorealistisches Rendern, VLM-Interpretation und deklarierte/funktionale Front-Erkennung sind nicht implementiert.

Was ist CAD-Ansicht?

Diese Fähigkeit steuert dieselbe lokale `facts`-CLI wie `cad-to-facts` und erstellt schreibgeschützte OCCT-Ansichten mit verdeckten Linien eines explizit ausgewählten STEP-Vorkommens. Das Quellartefakt wird niemals modifiziert. Das Rendern erfolgt offline und deterministisch; es ruft kein LLM/VLM auf und lädt weder Modell noch Bild hoch. Sie ist nützlich für Entwickler, die technische Dokumentationen oder Vektorgrafiken aus CAD-Modellen extrahieren müssen, ohne das Original zu ändern. Die Fähigkeit unterstützt Plattformen wie Claude Code, Cursor und andere KI-Agenten, die über die Befehlszeile gesteuert werden. Sie implementiert eine explizite Auflösung von Zielvorkommen, sechs Kamerapresets und eine angenommene Frontauswahl basierend auf der größten Begrenzungsbox. Wichtig: Die Kamerasemantik ist nicht mit der Designsematik gleichzusetzen, und die Ergebnisse müssen stets im Kontext der Heuristik betrachtet werden. PNG, fotorealistische Ausgabe, deklarierte Front-Erkennung und visuelle Inferenz sind nicht implementiert.

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

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

STEP-Vorkommensansichten und technische Illustrationen

Diese Fähigkeit steuert dieselbe lokale facts-CLI wie cad-to-facts. Sie erstellt schreibgeschützte OCCT-Ansichten mit verdeckten Linien eines explizit ausgewählten STEP-Vorkommens. Das Quellartefakt wird niemals modifiziert. Das Rendern erfolgt offline und deterministisch; es ruft kein LLM/VLM auf und lädt weder Modell noch Bild hoch.

Implementierter Umfang

  • facts resolve: exakte Vorkommnis-/Definitionsnamen, Teilzeichenfolgen/Aliase, Pfad, Definition, Wurzel-/Baugruppenart, Zustand und räumliche Beschränkungen der Begrenzungsbox der Welt. Gibt resolved, ambiguous, unresolved oder failed zurück; es wählt niemals einen von mehreren Kandidaten anhand der Durchlaufreihenfolge aus.
  • facts orient: sechs Kamerakandidaten und eine optionale recommended_view basierend auf der Heuristik der größten Begrenzungsboxfläche, nach außen von der Baugruppe. Eine Empfehlung hat immer semantic_status=assumed.
  • facts render auf STEP: ein aktives occurrence:N, eine explizite ViewSpecification, eine neue SVG und eine neue zugehörige .view.json-Manifestdatei.
  • Globalachsen-Kamerapresets und explizite Normal-/Rechtsvektoren, sichtbare/verdeckte Linienausgabe, begrenzte SVG-Punktanzahl, Artefakt-/Snapshot-/Ausgabe-Hashes mit exakter Zielbindung und optionale vom Benutzer ausgewählte oder angenommene Ansichtssemantik.

PNG, Schnitt-/Explosions-/Schattierungsansichten, fotorealistische Ausgabe, Bemaßungsanmerkungen, quellendeklarierte oder funktionale Front-Erkennung und visuelle Inferenz sind nicht implementiert. SVG ist ein Überprüfungs-/Dokumentations-WorkProduct, kein visueller oder geometrischer Gleichheitsbeweis und kein FactSet.

Einrichtung

Verwenden Sie die installierte facts-CLI des Repositorys oder uv run --project /pfad/zu/cad-to-facts facts .... Die Referenzumgebung ist Python 3.13 mit den gesperrten OCCT-Abhängigkeiten. Für das STEP-SVG-Rendering werden kein ODA, Text-zu-CAD, Blender oder Netzwerkdienst verwendet.

Vor dem Rendern auflösen

Schreiben Sie ein TargetSelector-JSON, z.B.:

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

Führen Sie dann aus:

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

Lesen Sie resolution.status, resolution.complete, resolution.discovery, Kandidaten und Diagnosen. name und name_contains durchsuchen sowohl Vorkommensnamen als auch Teildefinitionsnamen, da einige STEP-Dateien nur PRODUKTnamen deklarieren. Kandidaten name_path und path sind unterschiedlich: Ersterer dient der Anzeige, während Letzterer Snapshot-bezogene Vorkommens-IDs verbindet und die exakte Pfad-Selektorform ist.

  • resolved: genau ein entdeckter Kandidat; verwenden Sie dessen occurrence_id.
  • ambiguous: überprüfen Sie die Pfade, Namen und platzierten Begrenzungsboxen der Kandidaten, fügen Sie Beschränkungen hinzu oder bitten Sie den Benutzer, eine Auswahl zu treffen. Wählen Sie niemals stillschweigend den ersten aus.
  • unresolved: Es wurde kein passender Kandidat entdeckt. Dies ist kein Beweis für das Fehlen im Engineering.
  • failed: Der Snapshot konnte nicht gelesen werden; rendern Sie nicht daraus.

complete bedeutet vollständige Vorkommensentdeckung plus eine messbare platzierte Begrenzungsbox für jeden zurückgegebenen Kandidaten. Es bedeutet keine vollständige Formvalidierung, keine Diagnosen, erfolgreiche Auflösung oder globale Eindeutigkeit. Ein mehrdeutiges oder nicht aufgelöstes Ergebnis kann vollständig sein, wenn die Entdeckung vollständig ist. Bei teilweiser oder unbekannter Entdeckung ist die Eindeutigkeit nur entdeckt und complete=false.

Optionale angenommene Frontauswahl

Für ein eindeutig aufgelöstes Ziel gibt facts orient assembly.step --selector selector.json sechs Welt-Begrenzungsbox-Projektionskandidaten zurück. Es wählt nur eine eindeutige Achse mit der größten Fläche aus, deren Vorzeichen weg vom Baugruppenzentrum eindeutig ist. Andernfalls wird ambiguous zurückgegeben und keine Ansicht. Kopieren Sie eine erfolgreiche recommended_view wortwörtlich in eine JSON-Datei zum Rendern; sie hat bereits semantic_intent.basis=assumed. Benennen Sie sie nicht in user_selected um, es sei denn, der Benutzer wählt sie tatsächlich aus, und nennen Sie sie niemals eine quellendeklarierte Front. Begrenzungsbox-Heuristiken können die falsche Dokumentationsseite auswählen, daher legen Sie die Annahme offen.

Ansicht exportieren

Schreiben Sie eine ViewSpecification, z.B. tuer-frontansicht.json:

{
  "title": "Türfront",
  "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": "Der Benutzer hat die Außenseite als Front ausgewählt"
  }
}

Rendern Sie das aufgelöste Ziel:

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

Dies erstellt tuer-front.svg und tuer-front.view.json. Beide Pfade müssen neu sein; keiner wird überschrieben. Wenn einer bereits existiert, wird kein neues Paar geschrieben. Das Manifest bindet die Artefakt-/Snapshot-Identität, das exakte Ziel, die vollständige Ansichtsspezifikation, den Renderer/die Version, die projizierten Ausdehnungen, die Kanten-/Punktanzahlen, den Bild-SHA-256/die Größe und die Diagnosen. Überprüfen Sie diese Bytes vor der Verwendung nachgelagert.

Auflösung und Rendern lesen die STEP-Datei unabhängig voneinander; das Rendern erzwingt keine vorherige Auflösungs-ID. Bevor Sie sich auf die Auswahl verlassen, vergleichen Sie den artifact.sha256 und snapshot.snapshot_id der Auflösung mit dem artifact.sha256 und snapshot_id des Renderings. Wenn einer abweicht, verwerfen Sie die vorherige Auswahl und lösen Sie erneut auf. Das Manifest zeichnet den tatsächlich gerenderten Snapshot und das Ziel auf.

Kamerasemantik ist nicht Designsematik

Das front-Preset bedeutet nur: Betrachter auf globaler -Y, in Richtung +Y schauend, Bildschirm rechts +X und Bildschirm oben +Z. Es beweist nicht die funktionale Front des Teils. Andere Presets sind in View contract dokumentiert.

Für eine benutzerdefinierte Richtung verwenden Sie explizite normal- und right-Vektoren. normal zeigt vom Modell zum Betrachter; normal × right bestimmt die Bildschirm-oben-Richtung. semantic_intent.basis ist nur:

  • user_selected: Der Benutzer hat diese Bedeutung bereitgestellt/bestätigt;
  • assumed: eine explizite Agentenannahme, die offengelegt werden muss.

Der aktuelle Vertrag akzeptiert keine declared-Basis: Quellendatei-Frontseitendeklarationen werden nicht extrahiert. Lassen Sie semantic_intent für eine rein geometrische Kamera weg. Verwandeln Sie niemals ein Preset oder eine angenommene Front in eine Behauptung, dass die Quelldesign diese Seite deklariert.

Ehrliche Grenzen

  • Entitäts-/Vorkommens-IDs und Pfade sind Snapshot-bezogen, nicht persistent revisionsübergreifend.
  • Die Zielauflösung filtert nach deklarierten IDs, Pfaden, Namen/Aliasen, Definition, Wurzel-/Baugruppenart, Zustand und räumlichen Beziehungen der weltweiten Begrenzungsbox. Platzierte Begrenzungsboxen und räumliche Beweise werden zurückgegeben. Richtungsbeziehungen vergleichen Mittelpunkte in einer expliziten Kamera; near benötigt eine explizite Bbox-Lückengrenze. Dies sind keine Kontakt-, Einschluss-, exakten Abstands- oder funktionalen Merkmalsbeweise. Flächen-/Kantenselektoren und Quellcode-made_by-Zuordnung sind nicht implementiert.
  • Das Auflösen von Geometrie lokalisiert keinen bearbeitbaren Quellparameter. Vorhandene Änderungsbefehle erfordern weiterhin ihre explizite ChangePreparationSpec- und SourceManifest-Nachweise.
  • OCCT HLR liefert projizierte Kanten; Kurven werden in SVG-Polylinien diskretisiert. skipped_edge_count und VIEW_EDGES_NOT_DISCRETIZED legen ausgelassene Pfade offen. Die Punktanzahl ist begrenzt, aber die HLR-Laufzeit ist keine allgemeine Garantie für große Baugruppen. Projizierte Ausdehnungen beschreiben die ausgegebene diskretisierte Punktmenge, nicht exakte Quellmaße.
  • Ein Rendering kann bei teilweiser Entdeckung oder Parser-Diagnosen erfolgreich sein; diese bleiben im Manifest und verhindern Ganzmodell-Vollständigkeitsbehauptungen.
  • Lesen Sie niemals Abmessungen aus Pixeln. Verwenden Sie Facts für implementierte Messungen oder semantische PMI für deklarierte Anmerkungswerte.
  • Fokussierte Tests verwenden analytische, mit OCCT erstellte STEP-Fixtures. Diese Tests und isolierte Beobachtungen realer Dateien begründen keine Exporteur-Interoperabilität oder allgemeines Rendern großer Baugruppen.
  • Senden Sie die Quelle oder das abgeleitete SVG nicht ohne separate Autorisierung an ein externes visuelles Modell.

Siehe View contract für alle Selektor-, Kamera- und Manifestsfelder.

Verwandte Skills