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: Installationspakete in README, CLAUDE.md und Changelog
Kai-Jungsthoefel463d99eda53d
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex ece4863..c6581e1 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -8,6 +8,7 @@ eigenen Abschnitt mit Datum und Git-Tag.### Neu+- Installationspakete: Installer für Windows, AppImage und tar.gz für Linux, dmg für macOS mit Apple Silicon, mit Python, CadQuery, `soma`, CalculiX und Git an Bord. Bisher nur unter Windows getestet, die Pakete sind noch nicht signiert.- FEM mit Schrauben: `study.bolt("Schraube 1")` spannt eine Schraube aus `soma.fasteners` vor, dann wirken die Lasten. Das Ergebnis nennt je Schraube Vorspannung, Zug und Querkraft am Ende und die Auslastung der Streckgrenze, der Kontakt der Fuge zeigt, ob sie klafft oder rutscht. Ohne Angabe 70 % der Streckgrenze, bei Kunststoffteilen begrenzt auf das, was die Fläche unter dem Kopf trägt. Mutter, Scheibe und verschraubte Teile rechnen von selbst mit (E84).### Geändertdiff --git a/CLAUDE.md b/CLAUDE.mdindex 0538aa5..f16c796 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -24,12 +24,13 @@ Details in `app/README.md`.- `src/renderer/` Oberfläche, verdrahtet in `main.ts`. Viewer: `viewer.ts`, `viewcube.ts`, `tree.ts` (Strukturbaum, E82), Werkzeuge `sectiontool.ts`, `explodetool.ts`, `measuretool.ts`, `markup.ts`. Panels: `code.ts`, `pdfview.ts`, `dxfview.ts`, `markdown.ts`, `filetree.ts`, `versions.ts`, `terminals.ts`, `params.ts`, `skills.ts`, `help.ts`, `settings.ts` + `settingspages.ts`. Animation und Analyse: `animtool.ts`, `animpanel.ts`, `animdata.ts`, `overlay.ts`, `resulttool.ts`, `resultview.ts`, `analysispanel.ts`, `videoview.ts`. Render-Fenster: `render.ts`/`render.html`. Allgemein: `ui.ts`, `icons.ts`, `busy.ts`, `shortcuts.ts`, `style.css`.- `src/shared/` `types.ts` (IPC-Vertrag), `settings.ts` (Vorgaben, Prüfung, Mausbelegungen, E81), `editable.ts`, `help.ts`, `skillname.ts`, `version.ts`.- `resources/` `template/` (Vorlage für Nutzerprojekte inkl. `AGENTS.md`), `skills/` (mitgelieferte Skills, darunter `soma-app.md` als Nutzeranleitung für Hilfe und Agent, E83), `help/` (Bilder der Anleitung), `icon.*` (erzeugt mit `scripts/make-icon.py`).-- `test/` Testsuiten, CDP-Client, Screenshots.+- `test/` Testsuiten, CDP-Client, Screenshots. `SOMA_TEST_EXE` lässt sie gegen eine gepackte App laufen.+- `electron-builder.config.cjs` Installationspakete, `build-resources/` großes Icon dafür. CI für alle drei Systeme in `.github/workflows/dist.yml`.**`python/soma/`** Hilfsbibliothek und CLI- API: `add_part` (mit `group=`, `role=`), `param` (`params.py`, E74), `import_step`, `import_assembly`, Normteile in `fasteners.py` (Maßtabellen aus bd_warehouse in `data/fasteners/`).- CLI: `soma build`, `export`, `glb`, `serve` (Messdienst, `measure.py`), `anim` (`anim.py`, `animrun.py`), `analyze` (`analysis.py`, FEM in `fem.py`, CalculiX über `ccx.py`, E84), `drawing` (`drawing.py`, `drawrun.py`, E76), `dxfview` (E80), `render` (nur über die App), `env` (`env.py`, `.soma/env` und `requirements.txt`, E67).-- `python/scripts/`: `setup_env.ps1` (Entwicklungsumgebung aus `python/requirements-base.txt`), `fetch_ccx.py` (CalculiX).+- `python/scripts/`: `setup_env.ps1` (Entwicklungsumgebung aus `python/requirements-base.txt`), `fetch_ccx.py` (CalculiX), `build_runtime.py` (eigenständige Basisumgebung für die Installationspakete).**`design/`** freigegebene Oberflächenentwürfe, im Browser öffnen, Pfeiltasten blättern- `ui-entwurf-2.html` „Aufgeräumt“ (E62): Maßstab für Aufbau, Farben und Texte. Bild 6 ist das Parameter-Panel (E74).@@ -52,6 +53,7 @@ npm test # baut, dann alle Suiten parallel über tesnode test/run-all.mjs smoke editor # einzelne Suiten parallel, nach npm run buildnpm run test:unit # ohne Build, prüft u. a. die Versionsnummernpm run help:shots # Bilder der Nutzeranleitung neu erzeugen+npm run dist # Installationspaket für dieses System, vorher build_runtime.py (app/README.md)# soma direkt"$LOCALAPPDATA/soma-dev/venv/Scripts/soma.exe" build --project <ordner>diff --git a/app/README.md b/app/README.mdindex f15b763..83aecf7 100644--- a/app/README.md+++ b/app/README.md@@ -43,6 +43,28 @@ npm run help:shots # Bilder der Anleitung neu aufnehmen (resources/help/),**Windows und Netzlaufwerk:** Liegt `node_modules` auf einem Netzlaufwerk, starten die sandboxed Prozesse von Electron nicht (`launch-failed`, Code 18, schwarzes Fenster). `npm start` und der Test nutzen deshalb automatisch eine lokale Kopie von Electron unter `%LOCALAPPDATA%\soma-dev\` (`scripts/electron-local.mjs`, einmalig rund 370 MB). Die App selbst darf auf dem Netzlaufwerk liegen. Eine installierte App muss lokal liegen, sonst zeigt sie eine Fehlermeldung.+## Installationspakete++Jedes Betriebssystem baut sein eigenes Paket, die Python-Basisumgebung, CalculiX und das Git von dugite sind plattformabhängig. Die CI macht das für alle drei Systeme ([../.github/workflows/dist.yml](../.github/workflows/dist.yml), von Hand oder mit einem Tag `vX.Y.Z`, Pakete als Artefakte am Lauf). Lokal:++```+# 1. Python-Basisumgebung: eigenständiges Python 3.12 (python-build-standalone über uv) mit requirements-base.txt, soma und CalculiX+python ../python/scripts/build_runtime.py --target "$LOCALAPPDATA/soma-dev/python-runtime"+# 2. Paket (Windows: NSIS-Installer, Linux: AppImage und tar.gz, macOS: dmg für Apple Silicon)+SOMA_RUNTIME="$LOCALAPPDATA/soma-dev/python-runtime" SOMA_RELEASE="$LOCALAPPDATA/soma-dev/release" npm run dist+# nur den entpackten Ordner (schneller, zum Prüfen): npm run dist:dir+# 3. Smoke-Suite gegen die gepackte App+SOMA_TEST_EXE="$LOCALAPPDATA/soma-dev/release/win-unpacked/SOMA.exe" node test/smoke.mjs+```++- Ohne `--target` und `SOMA_RUNTIME` liegt die Basisumgebung in `app/python-runtime`, die Pakete in `app/release` (beide in `.gitignore`). In einem synchronisierten Ordner (OneDrive, Netzlaufwerk) besser nicht: rund 1,4 GB in Zehntausenden Dateien.+- **Basisumgebung:** Ein venv lässt sich nicht verschieben, deshalb ein eigenständiges Python. Die Startprogramme (`soma`, `pip` …) bekommen einen relativen Pfad zum Python: unter Windows als `.cmd` (PowerShell, cmd) und ohne Endung (Git Bash), sonst als Shell-Vorspann. `build_runtime.py` prüft am Ende eine Kopie in einem Ordner mit Leerzeichen. `EXTERNALLY-MANAGED` bleibt, pip installiert nur in die Projektumgebung (E67).+- **Im Paket:** `resources/python` (Basisumgebung, `paths.ts` findet sie vor der Entwicklungsumgebung), `resources/app` mit `dist/`, `resources/` und nur `dugite` und `node-pty` aus `node_modules` (alles andere bündelt esbuild), ohne asar. Dazu `LICENSE.txt` und `MODEL-EXCEPTION.md`.+- **Windows:** Installation für den Nutzer nach `%LOCALAPPDATA%\Programs\SOMA` ohne Adminrechte, unsigniert (SmartScreen warnt beim ersten Start).+- **macOS:** nur Apple Silicon (für Intel fehlt `cryptography` als Wheel), ad-hoc signiert, nicht notarisiert: Gatekeeper lässt die App erst nach Rechtsklick > Öffnen oder `xattr -cr /Applications/SOMA.app` starten. Die installierte App übernimmt beim Start den PATH einer Login-Shell, sonst fänden Agenten-Erkennung und Terminals nichts aus Homebrew oder npm.+- **Linux:** gebaut unter Ubuntu 22.04, braucht glibc 2.31 oder neuer (cadquery-ocp). Unter Ubuntu 24.04 und neuer kann AppArmor die Sandbox von Electron im AppImage blockieren.+- Getestet ist das Paket nur unter Windows. Für Linux und macOS gibt es bisher nur die CI, deren Smoke-Test dort noch nicht blockiert.+## Aufbau| Pfad | Inhalt |