Desktop app for designing parametric 3D models in CadQuery together with the coding agent of your choice
TypeScript 3d-modeling3d-printing3d-printing-toolsagentagentic-aiai-cadcadcadqueryclaude-codecodexelectronfemllmmacdmakeropencodeparametric-designpythonsteptext-to-cad
Doku: CalculiX und Kontakt in der FEM (E84)
Kai-Jungsthoefelb9f852dabdfc
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 86957ae..3add383 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -6,6 +6,17 @@ eigenen Abschnitt mit Datum und Git-Tag.## [Unveröffentlicht]+### Neu++- FEM mit Kontakt: `study.contact("Deckel", "Gehäuse")` macht die Berührfläche zweier Teile zu einem Kontakt, der abheben und gleiten kann, mit `friction=` auch mit Reibung. Das Ergebnis nennt je Kontakt die getragene Kraft, die höchste Pressung, wo er offen ist und wo er gleitet. Im Bild gibt es die Größe „Contact pressure“, im Bericht je Kontakt eine Zeile (E84).+- FEM nennt alle Teile, die sich berühren, mit Fläche und ob sie verklebt sind, und weist auf `contact()` hin (E84).+- Die FEM rechnet mit CalculiX statt mit dem eigenen Solver, bei üblichen Modellgrößen zwei- bis dreimal schneller mit denselben Zahlen. CalculiX kommt mit SOMA (Windows: 53 MB), ohne CalculiX rechnet der eigene Solver weiter, nur ohne Kontakt (E84).+- Einstellungen, Reiter „About“: nennt gmsh und CalculiX mit Version.++### Geändert++- FEM: Der Hinweis, dass die Spitzenspannung vom Netz abhängt, entfällt bei kaum belasteten Teilen (unter 2 % der Festigkeit).+## [0.4.1] - 2026-10-10Hilfe mit nummerierten Screenshots, die der Agent als Skill kennt, dazu Verbesserungen aus der Kritik eines Agenten: `soma render` mit freier Richtung und Ausblenden, PDFs lesen, Zeichnungen mit Textmaß.diff --git a/CLAUDE.md b/CLAUDE.mdindex 798f4a3..5c59c84 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -19,7 +19,7 @@ Eine Desktop-App (Electron, TypeScript), in der ein Nutzer mit einem CLI-Agenten| `design/strukturbaum-entwurf.html` | Freigegebener Entwurf für den Strukturbaum im Viewer und die Reiter Analysis und Animation (E82), umgesetzt. Ersetzt in Entwurf 2 den Reiter Bauteile und den Umschalter oben links, enthält den ruhigen Bericht der Analyse. Maßstab für Baum, Reiter und Bericht || `design/ui-entwurf.html` | Erster Oberflächenentwurf (E38), Farben und Bausteine gelten weiter, der Aufbau ist durch Entwurf 2 ersetzt || `design/icon-vorschlaege.html` | Die fünf Icon-Entwürfe, aus denen „Dialog“ gewählt wurde (E44). Nur noch Referenz |-| `python/soma/` | Hilfsbibliothek und CLI: `add_part` (mit `group=` und `role=`), `param` (`params.py`, Werte für das Parameter-Panel, E74), `import_step`, `import_assembly`, `fasteners.py` (Normteile, Maßtabellen aus bd_warehouse in `data/fasteners/`), `soma build`, `soma export`, `soma glb`, `soma serve` (Messdienst, `measure.py`), `soma anim` (`anim.py`, `animrun.py`), `soma analyze` (`analysis.py`, FEM in `fem.py`), `soma drawing` (`drawing.py`, `drawrun.py`, technische Zeichnungen, E76), `soma dxfview` (`dxfview.py`, DXF für die Ansicht der App, E80), `soma render` (`render.py`, über die App), `soma env` (`env.py`, Projektumgebung `.soma/env` und `requirements.txt`, E67) |+| `python/soma/` | Hilfsbibliothek und CLI: `add_part` (mit `group=` und `role=`), `param` (`params.py`, Werte für das Parameter-Panel, E74), `import_step`, `import_assembly`, `fasteners.py` (Normteile, Maßtabellen aus bd_warehouse in `data/fasteners/`), `soma build`, `soma export`, `soma glb`, `soma serve` (Messdienst, `measure.py`), `soma anim` (`anim.py`, `animrun.py`), `soma analyze` (`analysis.py`, FEM in `fem.py`, gerechnet mit CalculiX über `ccx.py`, E84), `soma drawing` (`drawing.py`, `drawrun.py`, technische Zeichnungen, E76), `soma dxfview` (`dxfview.py`, DXF für die Ansicht der App, E80), `soma render` (`render.py`, über die App), `soma env` (`env.py`, Projektumgebung `.soma/env` und `requirements.txt`, E67) || `prototype/phase0/` | Abgeschlossener technischer Prototyp mit `ERGEBNISSE.md`. Nur noch Referenz |Details: `app/README.md`.@@ -27,7 +27,7 @@ Details: `app/README.md`.## Befehle```-# einmalig: Python-Umgebung (lokal) und soma darin+# einmalig: Python-Umgebung (lokal) und soma darin, das Skript holt auch CalculiX (python/scripts/fetch_ccx.py nach venv-full/ccx)powershell -File prototype/phase0/setup_env.ps1uv pip install --python "$LOCALAPPDATA/cadide-phase0/venv-full/Scripts/python.exe" -e pythondiff --git a/PLAN.md b/PLAN.mdindex a572d3f..fc0a599 100644--- a/PLAN.md+++ b/PLAN.md@@ -556,6 +556,19 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- **Zeichnungen:** `sh.text_width(text, height)` misst mit der Schrift der Zeichnung (probeweise angelegter TEXT, wieder entfernt). `leader(..., side="left"/"right")`, ohne `side` wie bisher vom Punkt weg, jetzt im Docstring beschrieben. `sh.table(rows, at)` ohne `widths` oder mit `None` je Spalte: längster Text plus 4 mm, mindestens 8 mm. Der Docstring von `Sheet` und der Skill nennen das Bild richtig als `.soma/drawings/<id>.png`.- **Grenzen:** Getestet unter Windows. pdfplumber liest Vektor-PDFs, eingescannte Pläne bleiben Bilder.+*CalculiX und Kontakt in der FEM (E84, Wunsch des Nutzers nach Vergleichsrechnung und Brainstorming; Prüfungen in `app/test/fem.mjs`):*++- **Rechenwerk:** `python/soma/ccx.py` schreibt Netz, Werkstoffe, Lager und die Knotenlasten von `fem.py` als Eingabedatei für CalculiX (C3D10, Knotenfolge von gmsh umgestellt), rechnet in einem Temp-Ordner und liest Verschiebungen und Kontaktgrößen aus der frd. Die Lagerkräfte rechnet `fem.py` aus den Verschiebungen (K u − f, nur Elemente an Lagern): Die Knotenkräfte (RF) aus der frd lagen beim Winkel aus dem Skill 5 % neben dem Gleichgewicht. Die Spannungen rechnet `fem.py` weiter selbst aus den Verschiebungen (je Teil, CalculiX mittelt über Werkstoffgrenzen: im Winkel aus Stahl und Aluminium 45 statt 61 MPa). Ohne Steifigkeitsmatrix prüft `_check_jacobians` die Elemente. Vergleich auf demselben Netz: Verschiebungen gleich bis auf 1e-6, bei 10 000 bis 250 000 Unbekannten 2- bis 3-mal schneller als pyamg, bei 440 000 etwa gleich (CalculiX 3 GB Speicher). Der eigene Solver bleibt als Rückfallweg (ccx fehlt oder scheitert, nur ohne Kontakt, mit Hinweis) und lässt sich mit `SOMA_FEM_SOLVER=builtin` wählen. `SOMA_CCX_KEEP=1` lässt die Dateien von CalculiX zur Fehlersuche liegen.+- **Auslieferung:** `python/scripts/fetch_ccx.py` holt mit micromamba calculix 2.23 und OpenBLAS von conda-forge (ohne Vorgabe nimmt conda unter Windows MKL, 680 MB) und kopiert nur das Nötige nach `<sys.prefix>/ccx`: unter Windows `ccx.exe` und die DLLs aus den Importtabellen (11 Dateien, 53 MB, gezippt 16 MB), unter Linux und macOS `bin/` und `lib/`. Dazu `PACKAGES.txt` und die Lizenztexte. `setup_env.ps1` ruft es auf. Gefunden wird ccx über `SOMA_CCX`, neben der Umgebung oder im PATH. ccx läuft mit der Hälfte der logischen Kerne (höchstens 8) und unter Windows mit einem PATH nur aus dem eigenen Ordner und System32.+- **Berührende Teile:** gmsh vernetzt die Teile weiter gemeinsam, gemeinsame Elementflächen verschiedener Teile sind die Berührflächen (`_interfaces`). Das Ergebnis nennt jedes Paar mit Fläche (`touching: Fuss – Wand (200.0 mm²), bonded`), verklebt bleibt der Standard.+- **Kontakt:** `study.contact(a, b, friction=0)`. Die Knoten der Berührfläche werden für das weichere Teil (bei gleichem E das zweite) verdoppelt (`_split`), Lasten und Lager dieses Teils ziehen mit. CalculiX rechnet Fläche auf Fläche, Steifigkeit das Zehnfache des kleineren E-Moduls, Haftsteigung gleich dem E-Modul, die ganze Last im ersten Schritt (mit Vierteln 18 statt 5 Iterationen). Vor der Rechnung prüft `_check_held` auch Kontakte: mit Reibung halten sie wie verklebt, ohne Reibung nur senkrecht zur Fläche (Block auf Block ohne Reibung: „held only by a contact without friction“).+- **Überwachung:** CalculiX bricht bei einem Teil, das wegrutscht, nicht von selbst ab (Verschiebungen bis 1e11 mm, minutenlang). `ccx.py` liest die Ausgabe mit und bricht ab, wenn eine Verschiebung das Zehnfache der Modellgröße erreicht (Meldung: rutscht oder hebt ab) oder eine Laststufe mehr als 12 Iterationen braucht (insgesamt 80). Pendelt der Kontakt so (zwei Platten, die abheben: über 40 Iterationen), rechnet `fem.py` mit einem weichen exponentiellen Kontaktgesetz neu (Spalt c0 = 1e-4 der Modellgröße, 2 µm bis 0,05 mm, Druck bei Spalt 0 von 0,1 MPa oder E/70000) und meldet das. Mortar-Kontakt konvergierte dort nicht.+- **Kennzahlen:** Pressung und Schub von CalculiX. Spalt und Gleitweg rechnet `fem.py` aus den Verschiebungen gegenüberliegender Knoten (CalculiX gibt die Öffnung nur nahe der Fläche aus). Die getragene Kraft kommt aus dem Gleichgewicht des Teils, wenn es nur diesen Kontakt hat und die Fläche eben ist (das Integral der Knotenpressungen lag 6 % daneben), sonst aus dem Integral. Offen heißt mehr als 2 c0 Spalt, gleitend heißt Schub ab 95 % der Haftgrenze. Hinweise ab 50 % offen oder gleitend.+- **In der App:** Größe „Contact pressure“ (Knopf „Contact“, ausgeschrieben passte die Leiste mit dem × nicht mehr ins Bild; Attribut `_PRESS`, beide Seiten der Fläche, kein Grenzwert, Verlauf bis zur größten). Die Flächen liegen zwischen den Teilen: Beim Wählen sagt ein Hinweis, dass man ein Teil ausblenden oder schneiden muss, der Baum bleibt unverändert, „Max“ an der höchsten Pressung, Pressung im Schild unter dem Zeiger und in „Send to agent“. Im Bericht je Kontakt eine Zeile (Reibung, Kraft, Pressung, offen, gleitet, Gleitweg) und eine Zeile „Touching · Bonded“ für die verklebten Paare, beim Netz das Rechenwerk.+- **Für den Agenten:** Skill „Strength with FEM“ mit Abschnitt „Parts that touch“ (Tabelle verklebt, `contact()`, mit Reibung, Reibwerte), die Grenzen nennen kleine Gleitwege statt „kein Kontakt“.+- **Zeiten (8 Threads):** Block auf Block mit Reibung, 51 000 Unbekannte: rund 70 s (unsymmetrisches Gleichungssystem, rund 10 s je Iteration). Zwei Platten, die abheben: 38 s mit dem Rückfall. Ohne Kontakt wie vorher oder schneller.+- **Grenzen:** Kontakt nur, wo Flächen im Modell aufeinanderliegen (kein Anfangsspalt), kleine Gleitwege. Teilen sich drei Teile eine Kante der Kontaktfläche, hängt das dritte dort am anderen Teil. Linux und macOS: `fetch_ccx.py` ungetestet. Getestet unter Windows.+*Offen in Phase 1:* Auto-Start des Agenten ohne Resume, Agent-Test mit weiteren Agenten und längeren Sitzungen, Bündelung von Python und Installer, macOS und Linux.**Danach:** Zukaufteile wie NEMA-17-Motoren und V-Slot-Profile (E48, Wunsch des Nutzers), Versions-Schieber, `soma check` und Projekt-Check, MCP-Server. **Später:** Volumen/Gewicht, Versionsvergleich, weitere Bereiche der Einstellungen, maßhaltiger Sketcher (nur bei Bedarf).@@ -673,6 +686,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- Bei der Umsetzung von E82 ohne Rückfrage entschieden: Die Seitenleiste startet zu (vorher mit den Bauteilen), eine gemerkte Ansicht „Bauteile“ älterer Versionen öffnet nichts, Analysis und Animation werden nicht über einen Neustart gemerkt (ein Ergebnis zeigt sich nur auf Wunsch). Bericht und Ablauf machen die Seitenleiste mindestens 352 px breit wie im Entwurf. Gruppen beginnen zugeklappt, Aufklappen zeigt eine Ebene (Wunsch des Nutzers nach der ersten Durchsicht). Der Punkt am Reiter verschwindet beim Öffnen des Reiters, „new“ in der Liste erst beim Öffnen des Eintrags. „Show the spot“ verschiebt die Ansicht zur Stelle, ohne zu zoomen, ein ausgeblendetes Teil bleibt ausgeblendet (Meldung statt Einblenden). In der Leiste kommt Displacement als dritte Größe dazu (im Entwurf gezeigt, vorher nicht vorhanden), ohne Grenzwert, Farbe über die Spanne. Die Beschriftung im Bild folgt der Größe („Min“ Sicherheit, „Max“ Spannung oder Verschiebung). Schritte der Animation aus den Untertiteln, ohne Untertitel aus dem Ablauf der Datei. Zu einer Animation gehören die Videos in `renders/`, deren Name mit ihrer Kennung beginnt. Das Menü „…“ im Bericht enthält „Copy command“ und „Show the model“. Die angeklickte Stelle steht unten im Bericht über den Knöpfen- `npm test` läuft über `test/run-all.mjs` mit vier Suiten gleichzeitig und freien Ports (5,5 bis 7 statt 8,5 Minuten, die Animation bestimmt die Dauer und wird unter Last 2 bis 3 Mal langsamer), Watchdog dann 15 Minuten. `soma` lädt cadquery erst in Befehlen, die es brauchen (`soma --version` 0,7 statt 4,4 s)- Markup-Ansicht: Die Zeichenfläche behält Größe und Seitenverhältnis von der Aufnahme (das Bild für den Agenten ändert sich nicht), wird aber in den Viewer eingepasst und wächst mit ihm. Mausrad zoomt um den Zeiger von eingepasst bis 8-fach, rechte oder mittlere Maustaste verschiebt (die linke bleibt dem Zeichnen), Ctrl+0 passt wieder ein. Die Fangradien der Griffe gelten in Bildschirmpixeln, Strichstärke und Schrift in Pixeln der Zeichenfläche (sie wachsen beim Zoomen also mit)+- FEM mit CalculiX (E84): Kontaktgesetz linear mit dem Zehnfachen des kleineren E-Moduls (CalculiX empfiehlt 5 bis 50), Haftsteigung gleich dem E-Modul, Rückfall auf das exponentielle Gesetz bei mehr als 12 Iterationen je Laststufe (gemeldet), das weichere Teil als Slave-Seite, Spalt und Gleitweg aus den Verschiebungen, Kraft aus dem Gleichgewicht, Hälfte der logischen Kerne für CalculiX, Ablage neben der Python-Umgebung (`<sys.prefix>/ccx`), Hinweis zur Netzabhängigkeit erst ab 2 % der Festigkeit, Kontaktpressung im Bild als eigene Größe statt in der Sicherheit, `SOMA_FEM_SOLVER=builtin` und `SOMA_CCX_KEEP=1` als Schalter- Nutzeranleitung (E83): Quelle in Markdown statt HTML (Gegenvorschlag, mit „Ja klingt gut“ freigegeben). Die Quelle ist der Skill selbst statt einer eigenen Datei, aus der der Skill erst erzeugt würde: So gibt es nichts zu erzeugen und nichts zu vergessen. Skill ab Werk „Bei Bedarf“ in „Way of working“, nicht „Immer“ (Bedienfragen sind selten, der Text wäre sonst bei jeder Änderung im Kontext). Anleitung auf Englisch wie die App (E73). Hilfe als Fenster über der App wie die Einstellungen statt als Reiter im Code-Panel, F1 als Taste. Bilder per Skript aus der echten App, eingecheckt in `app/resources/help/` (rund 2.3 MB), statt beim Bauen oder Start erzeugt. Im Projekt unter `.soma/help/`, nicht im Verlauf, damit jedes Modell nicht um die Bilder wächst. Die Bilder bleiben im Projekt, wenn der Skill ausgeschaltet wird (stören nicht, Zwischenergebnis)- Rolle `reference` und ihre Standardwerte (E34)@@ -685,7 +699,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch**Zu klären**- **Namen:** Notizdatei `NOTES.md`, Ordner `exports/` (Ort, getrackt oder nicht)-- **Lizenzen der Komponenten:** Hinweise und Texte aller mitgelieferten Teile (Git, Python-Pakete, gmsh, pdf.js, IBM Plex, Tabellen aus bd_warehouse) für den Installer sammeln. Die Lizenz von SOMA selbst ist entschieden (GPL-3.0, E71)+- **Lizenzen der Komponenten:** Hinweise und Texte aller mitgelieferten Teile (Git, Python-Pakete, gmsh, CalculiX mit OpenBLAS, arpack und GCC-Laufzeit (Lizenztexte legt `fetch_ccx.py` bei), pdf.js, IBM Plex, Tabellen aus bd_warehouse) für den Installer sammeln. Die Lizenz von SOMA selbst ist entschieden (GPL-3.0, E71)- **Mittelbereich:** Tab-Umschaltung oder geteilte Ansicht zwischen Viewer und Sketch (E15)- **Build:** Auto-Build standardmäßig an oder aus, Statusanzeige, Fehlerpanel, Verhalten bei erneuter Änderung während des Builds (E20)- **Speichern/Öffnen:** mehrere Projekte parallel (bisher eines pro Fenster), Aufräumen alter Workspaces und Sicherungen, ZIP auf Netzlaufwerk (Speichern dorthin geht, Verhalten bei Verbindungsverlust ungetestet), ZIP-Größe bei langen Verläufen (seit E75 gepackt, jede STEP-Fassung bleibt aber im Verlauf) und vielen Markierungen (je Bild einige hundert KB) (E21)@@ -702,7 +716,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- **Auswahlen des Agenten:** Flächen-IDs gelten nur pro Build, Verweise brauchen Bauteilname plus Geometrieangabe- **Inhalte** von `AGENTS.md` und den Skills, mit einem echten Agenten zu testen. Vor allem (E55): Liest ein Agent einen Skill „Bei Bedarf“ von selbst, wenn das Gespräch das Thema wechselt (etwa „jetzt für den 3D-Druck“), und hält er das in `NOTES.md` fest? Mit Claude Code und einem kleineren Modell prüfen- **Projekt-Check:** Umfang und Spezifikation, Abdeckung aller Störfälle-- **Animation und Analyse (E58):** Montage Schritt für Schritt aus der Demontage-Analyse der Explosion (E59) als Animation erzeugen? CFD als weitere Auswertung. FEM (E65): gmsh (GPL) passt seit E71 zur Lizenz von SOMA, Netgen (LGPL) bleibt eine Alternative als Vernetzer. Kontakt zwischen Teilen und Schrauben (CalculiX?), Eigenfrequenzen, Lasten aus einem Klick im Viewer, Lastfall im Viewer bearbeiten. Längere Videos (heute ganz im Speicher), Ton. Agent-Test: Liest ein Agent die Skills und öffnet er die Bilder von `soma render` von selbst? Zurückgestellt (E64): gekoppelte Gelenke (ein Wert treibt mehrere Gelenke, wie `ValueTracker` in manim) sowie Zahnräder, Lager und Federn als Bausteine, bis Mechanik öfter vorkommt. Analyseergebnisse sind noch rund 30 MB je Auswertung (drei eigene Ecken mit Normale je Dreieck), kleiner, wenn der Viewer flache Normalen selbst rechnet+- **Animation und Analyse (E58):** Montage Schritt für Schritt aus der Demontage-Analyse der Explosion (E59) als Animation erzeugen? CFD als weitere Auswertung. FEM (E65): gmsh (GPL) passt seit E71 zur Lizenz von SOMA, Netgen (LGPL) bleibt eine Alternative als Vernetzer. Nach E84 (CalculiX, Kontakt): `bolt()` für Normteile mit Vorspannung, `Modes` (Eigenfrequenzen) und `Buckling` als eigene Studien, große Verformung und Plastizität über Hinweise, Kontakt mit Anfangsspalt, schnellerer Löser für Reibung (PaStiX oder PARDISO fehlen im Paket von conda-forge), `fetch_ccx.py` unter Linux und macOS im Installer, Lasten aus einem Klick im Viewer, Lastfall im Viewer bearbeiten. Längere Videos (heute ganz im Speicher), Ton. Agent-Test: Liest ein Agent die Skills und öffnet er die Bilder von `soma render` von selbst? Zurückgestellt (E64): gekoppelte Gelenke (ein Wert treibt mehrere Gelenke, wie `ValueTracker` in manim) sowie Zahnräder, Lager und Federn als Bausteine, bis Mechanik öfter vorkommt. Analyseergebnisse sind noch rund 30 MB je Auswertung (drei eigene Ecken mit Normale je Dreieck), kleiner, wenn der Viewer flache Normalen selbst rechnet## 12. Größte Risikendiff --git a/README.md b/README.mdindex 2348db0..d52901d 100644--- a/README.md+++ b/README.md@@ -44,7 +44,7 @@ Any CLI agent that can read files and run commands works: Claude Code, OpenCode,- Mouse navigation like in SolidWorks, Fusion 360, Onshape, Creo or Rhino, perspective or orthographic view- Exact measurements on the B-rep, not on the mesh: faces, edges, distances, hole spacing- Section views, exploded views with a disassembly analysis, transparency and isolation per group-- Analysis: overhangs, wall thickness, clearance between parts, strength with FEM+- Analysis: overhangs, wall thickness, clearance between parts, strength with FEM (CalculiX), also with contact between parts- Animations written in Python, rendered to images and MP4**Feedback to the agent**@@ -132,4 +132,4 @@ SOMA is free software under the [GNU General Public License v3.0](LICENSE) or anWhat you design with SOMA is yours. The [SOMA Model Exception](MODEL-EXCEPTION.md) lets you license your model files under any terms you like, even though they import `soma`. Exported files like STEP or STL are not affected by the GPL at all.-Third-party components keep their own licenses. Among them are CadQuery (Apache-2.0), OpenCascade (LGPL-2.1), Git (GPL-2.0), gmsh (GPL-2.0-or-later) and pdf.js (Apache-2.0).+Third-party components keep their own licenses. Among them are CadQuery (Apache-2.0), OpenCascade (LGPL-2.1), Git (GPL-2.0), gmsh (GPL-2.0-or-later), CalculiX (GPL-2.0-or-later) and pdf.js (Apache-2.0).diff --git a/app/README.md b/app/README.mdindex b326fa3..42678be 100644--- a/app/README.md+++ b/app/README.md@@ -5,7 +5,7 @@ Electron-App (TypeScript) für 3D-Modelle mit einem Coding-Agenten im Terminal.## Voraussetzungen- Node.js 22 oder neuer, Python 3.12 mit CadQuery (Basisumgebung), `soma` darin installiert.-- Entwicklung: die Umgebung aus Phase 0 (`prototype/phase0/setup_env.ps1`, enthält seit E67 auch pip) und darin `uv pip install -e ../python`. Die App findet sie unter `%LOCALAPPDATA%\cadide-phase0\venv-full` oder über `SOMA_PYTHON`. Jedes Modell bekommt daneben eine kleine Projektumgebung unter `.soma/env` für Zusatzpakete (E67).+- Entwicklung: die Umgebung aus Phase 0 (`prototype/phase0/setup_env.ps1`, enthält seit E67 auch pip und holt seit E84 CalculiX mit `python/scripts/fetch_ccx.py` nach `venv-full\ccx`) und darin `uv pip install -e ../python`. Die App findet sie unter `%LOCALAPPDATA%\cadide-phase0\venv-full` oder über `SOMA_PYTHON`. Jedes Modell bekommt daneben eine kleine Projektumgebung unter `.soma/env` für Zusatzpakete (E67).- Hinter einem Proxy lädt Node den Electron-Download nur mit `NODE_USE_ENV_PROXY=1`:`NODE_USE_ENV_PROXY=1 node node_modules/electron/install.js` (falls `npm install` das Binary nicht geholt hat).@@ -56,7 +56,7 @@ npm run help:shots # Bilder der Anleitung neu aufnehmen (resources/help/),| `resources/skills/` | Mitgelieferte Skills (E17), je eine Markdown-Datei: Kopf mit `title`, `summary`, `topics`, `category` (deutsch, Oberfläche), `name` und `when` (englisch, für `AGENTS.md`: Name und Anlass), `order`, `default:` (Stufe bei neuen Modellen: `always`, `on-demand` oder `off`) und optional Einstellungen als `var name: Standard \| Einheit \| Bezeichnung \| 10..85` oder `\| a, b=Anzeige`, darunter die Regeln für den Agenten auf Englisch mit Platzhaltern `{{name}}` || `resources/help/` | Bilder der Anleitung (E83) mit nummerierten Markierungen, erzeugt mit `npm run help:shots` (`test/helpshots.mjs`, Ausschnitte und Nummern in `test/helpshots-spec.mjs`). Der Text ist der Skill `resources/skills/soma-app.md`, die Liste unter jedem Bild nennt dieselben Bezeichnungen wie die Markierungen (`npm run test:unit` prüft das) || `resources/icon.*` | App-Icon (E44) für Fenster und Taskleiste: `icon.svg` als Vorlage, `icon.ico` (16 bis 256 px) und `icon.png`. Neu erzeugen mit `python scripts/make-icon.py` (braucht Edge und Pillow, kleine Größen bekommen einen dickeren Strich) |-| `../python/soma/` | Hilfsbibliothek und Kommandozeile (`soma build`, `soma export`, `soma glb` für Vorschauen, `soma serve` Messdienst, `soma warm` vorgewärmter Prozess der App, `soma env` und `env.py` Projektumgebung und `requirements.txt` (E67), `measure.py` exakte Werte mit OCC, `fasteners.py` Normteile mit Tabellen aus bd_warehouse in `data/fasteners/`, `anim.py` und `animrun.py` Animationen mit `soma anim`, `analysis.py` Auswertungen mit `soma analyze`, `fem.py` Festigkeit mit `soma analyze fem` (gmsh, pyamg), `render.py` Auftrag an die App für `soma render`, `drawing.py` und `drawrun.py` technische Zeichnungen mit `soma drawing` (E76: HLR aus OCP, DXF mit ezdxf, PDF und PNG über matplotlib, Prüfung), `dxfview.py` DXF für die Ansicht der App mit `soma dxfview` (E80, Zeichenmodul von ezdxf), `gltf.py` GLB-Schreiber, `progress.py` Fortschritt langer Befehle) |+| `../python/soma/` | Hilfsbibliothek und Kommandozeile (`soma build`, `soma export`, `soma glb` für Vorschauen, `soma serve` Messdienst, `soma warm` vorgewärmter Prozess der App, `soma env` und `env.py` Projektumgebung und `requirements.txt` (E67), `measure.py` exakte Werte mit OCC, `fasteners.py` Normteile mit Tabellen aus bd_warehouse in `data/fasteners/`, `anim.py` und `animrun.py` Animationen mit `soma anim`, `analysis.py` Auswertungen mit `soma analyze`, `fem.py` Festigkeit mit `soma analyze fem` (gmsh, Kontakt, eigener Solver mit pyamg als Rückfall), `ccx.py` CalculiX als Rechenwerk (E84), `render.py` Auftrag an die App für `soma render`, `drawing.py` und `drawrun.py` technische Zeichnungen mit `soma drawing` (E76: HLR aus OCP, DXF mit ezdxf, PDF und PNG über matplotlib, Prüfung), `dxfview.py` DXF für die Ansicht der App mit `soma dxfview` (E80, Zeichenmodul von ezdxf), `gltf.py` GLB-Schreiber, `progress.py` Fortschritt langer Befehle) || `test/` | `smoke.mjs`, `versions.mjs`, `editor.mjs`, `measure.mjs`, `groups.mjs`, `section.mjs`, `explode.mjs`, `skills.mjs`, `params.mjs`, `fasteners.mjs`, `drawing.mjs`, `dxf.mjs`, `animation.mjs` (Ende-zu-Ende), `unit.mjs` (ohne Electron), `harness.mjs` (App starten und steuern), `cdp.mjs` (kleiner DevTools-Client, puppeteer scheitert an Electron 44) |## Noch nicht enthalten (siehe PLAN.md, Abschnitt 10)