← zum Handbuch   Projektseite   DEEN

Erster Live-Test mit CATIA

Kurzanleitung für den ersten Test von CadPilot auf einem Rechner mit CATIA V5 und GitHub Copilot – ohne Administratorrechte, Dauer etwa 45 Minuten (davon 5 Minuten automatisch).

Stand: 25.09.2026 · Ausdrucken und die Checkliste unten ausfüllen · Fragen an Martin

Vorher: Eigene offene Arbeit in CATIA speichern. Nur Testmodelle verwenden, keine Kunden- oder Projektdaten. Der Test legt eigene Teile an und schließt sie am Ende ohne Speichern; Speichern und Export sind nur im Arbeitsordner möglich (Safe Mode).

1. Vorbereitung (5 min)

  1. Aktuelle Version holen (neue ZIP-Datei von Martin entpacken oder git pull) und scripts\setup_user.cmd erneut ausführen. Am Ende muss stehen: ALL TESTS PASSED — 86 tools ready.
  2. CATIA normal starten (nicht „Als Administrator ausführen“). Wenn möglich englische Oberfläche; sonst trotzdem testen und die Sprache notieren.
  3. Eingabeaufforderung (cmd, nicht als Administrator) im Projektordner öffnen und einmalig das Testwerkzeug installieren:
    .venv\Scripts\python.exe -m pip install "pytest>=7.0"
    mkdir docs\live

2. Automatische Tests (15 min)

Alle Ausgaben landen im Ordner docs\live. Während die Tests laufen, CATIA nicht bedienen.

  1. Umgebung protokollieren (nur lesend – CATIA-Version, Service Pack, Python):
    .venv\Scripts\python.exe scripts\live_env_report.py --catia --out docs\live\umgebung.json
    In der Datei muss "status": "attached" stehen. Sonst: CATIA läuft nicht oder nicht mit gleichen Rechten – siehe Abschnitt 5.
  2. Abnahmetest – prüft die Punkte 2 bis 11 der Checkliste automatisch (legt eigene Teile MCP_Abnahme_* an und schließt sie ohne Speichern) und schreibt den Bericht docs\live\abnahme.md:
    .venv\Scripts\python.exe scripts\live_acceptance.py --out docs\live --record docs\live\abnahme.jsonl
    FAIL bedeutet hier „Befund gefunden“, nicht „kaputt“. Der Abnahmetest startet CATIA nie selbst – läuft keine CATIA-Sitzung, meldet C1 „no running CATIA; not launched“. Den Bericht bitte kurz ansehen: Steht bei C1 kein PASS, ist CATIA nicht erreichbar – siehe Abschnitt 5. Die Zeile „Offen gebliebene Testdokumente“ nennt Teile MCP_Abnahme_*, die sich nicht schließen ließen – diese bitte in CATIA ohne Speichern schließen.
  3. Funktionstests gegen CATIA mit Aufzeichnung der CATIA-Aufrufe (Pfade werden anonymisiert):
    set CATIA_MCP_RECORD=docs\live\aufzeichnung.jsonl
    .venv\Scripts\python.exe -m pytest tests\test_workflows.py --catia-live -rs -v > docs\live\tests.txt 2>&1
    set CATIA_MCP_RECORD=
    Fehlschläge sind hier kein Problem, sondern genau die Befunde, die wir suchen. Bei deutscher Oberfläche können Tests wegen anderer Feature-Namen scheitern – bitte trotzdem mitschicken.
  4. Flächen-Test des Ursprungsprojekts (legt ein Teil an, speichert ein Testteil und ein Bild im Projektordner):
    .venv\Scripts\python.exe scripts\gsd_smoke_test.py > docs\live\gsd.txt 2>&1

3. Test mit Copilot (20 min)

VS Code mit dem Projektordner öffnen, in .vscode\mcp.json den Server catia-v5 starten, Copilot-Chat im Modus Agent. Die Aufträge nacheinander eingeben, jeden Werkzeugaufruf bestätigen und das Ergebnis in die Checkliste eintragen – zusätzlich in CATIA nachsehen.

  1. „Lege ein neues Teil an: Platte 100 × 60 × 5 mm auf der XY-Ebene, mittig im Ursprung. Nenne Volumen, Schwerpunkt und Hüllquader.“
  2. „Skizziere auf XY einen Kreis mit Radius 10 in der Mitte und setze eine Radius-Bemaßung von 12 mm.“ → in CATIA prüfen: Ist es eine Radius-Bemaßung und hat sich der Kreis auf R12 geändert?
  3. „Neues Teil: Rechteck 100 × 60 auf XY, dann Pad 10 mm symmetrisch. Nenne das Volumen.“
  4. „Zeig das Journal und mach die letzte Änderung rückgängig.“ → in CATIA prüfen: Ist das letzte Feature weg?
  5. „Speichere das aktive Teil.“ → Erwartet: wird abgelehnt (Original/ungespeichert). Dann: „Speichere eine Arbeitskopie als Livetest_Platte.CATPart im Arbeitsordner.“
  6. „Exportiere die Arbeitskopie als STEP in den Arbeitsordner.“

4. Checkliste

Die Zeilen 2–9 prüft der Abnahmetest bereits automatisch (siehe abnahme.md). Bitte trotzdem im Copilot-Test (Abschnitt 3) in CATIA hinsehen und eintragen – der Mensch sieht mehr als die Messwerte.

#PrüfungErwartungErgebnisklärt
1Umgebungsbericht"status": "attached", CATIA-Release sichtbarokAnbindung
2Volumen Platte30 000 mm³ (30 cm³)okGrundfunktion
3Schwerpunkt Plattex = 0, y = 0, z = 2,5 mm (bzw. −2,5 bei Extrusion nach −Z) – oder Hinweis „could not be measured“; auf keinen Fall 0/0/0 ohne HinweisokK9, K16
4Hüllquader Platte100 × 60 × 5 mm – oder Fehler „could not be measured“okK9, K16
5Radius-BemaßungRadius-Bemaßung R12 in CATIA, Kreis geändertokK8
6Pad symmetrisch 10 mm60 000 mm³ (Gesamthöhe 10) oder 120 000 mm³ (10 je Seite) – bitte genauen Wert notieren____ mm³K15
7Rückgängigletztes Feature gelöscht, Rest unverändertokJournal
8Speichern des Originalsabgelehnt mit Hinweis auf ArbeitsordnerokSafe Mode
9Arbeitskopie + STEPbeide Dateien im Arbeitsordner, sonst nirgendsokSafe Mode, Export
10Dialoge / Hängerkeine; falls doch: welcher Dialog, bei welchem SchrittkeineZeitlimit

5. Wenn etwas nicht geht

„no running CATIA instance“CATIA starten; CATIA und Eingabeaufforderung beide ohne Adminrechte.
„Ungültige Klassenzeichenfolge“CATIA ist nicht für die Automation registriert – das muss die IT einmalig machen (siehe docs\ANLEITUNG_COPILOT.md).
Copilot zeigt keine CATIA-WerkzeugeAgent-Modus? Server gestartet? Bei Firmenlizenz: Richtlinie „MCP servers in Copilot“ (IT/GitHub-Admin).
COM_TIMEOUTIn CATIA nach einem offenen Dialog sehen und ihn schließen; dann weiter.
Programm durch Richtlinie blockiertPython im Benutzerprofil ist gesperrt (AppLocker) – nur über die IT lösbar.

6. Ergebnis zurückschicken

  1. Ordner docs\live als ZIP an Martin schicken (enthält umgebung.json, abnahme.md/abnahme.json, abnahme.jsonl, tests.txt, gsd.txt, aufzeichnung.jsonl). Die Unterordner work-* mit den Testteilen bitte nicht mitschicken.
  2. Die ausgefüllte Checkliste (Foto genügt) und die Copilot-Antworten zu den Aufträgen 1, 3 und 4 (kopieren).
  3. Keine CATPart-, STEP- oder Bilddateien mitschicken. Die Aufzeichnung enthält Namen und Maße der Testteile, aber keine Pfade.

Aufräumen danach: Testteil und Bild des Flächen-Tests im Projektordner (GSD_SmokeTest*.CATPart, gsd_smoke_test.jpg) und die Dateien im Arbeitsordner dürfen gelöscht werden.