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: Changelog und App-README zu Agenten mit fremder Umgebung
Kai-Jungsthoefelde00e5b66da9
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 2c14c0b..1b44241 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -6,6 +6,15 @@ the version is bumped.## [Unreleased]+### Fixed++- Agents that run their commands outside the app's terminal (seen with Codex on Windows, which uses a background service with the environment of another program) can use `soma render` again: it now finds the running app without the terminal's environment variables.++### Added++- `soma build` notes when the shell lacks the environment of the app's terminals and says how to call `soma` and `pip` instead.+- New skill "Shell environment" (on demand for new models): what the agent does when `soma` or `pip` is not found, or umlauts in files look garbled in Windows PowerShell.+## [0.7.1] - 2026-10-12### Fixeddiff --git a/app/README.md b/app/README.mdindex 60a602f..7f59d2e 100644--- a/app/README.md+++ b/app/README.md@@ -71,7 +71,7 @@ SOMA_TEST_EXE="$LOCALAPPDATA/soma-dev/release/win-unpacked/SOMA.exe" node test/s| Pfad | Inhalt ||---|---|-| `src/main/` | Hauptprozess: `projects.ts` (offenes Projekt, Speichern, Öffnen, Verlauf, Wiederherstellen), `git.ts` (mitgeliefertes Git über dugite), `zip.ts` (Modelldatei .soma oder ZIP schreiben und sicher entpacken), `workspace.ts` (UUID-Arbeitsordner, Projektzustand doppelt, Projekt-Check nur melden), `build.ts` (Build als Einmal-Prozess mit Entprellung, Warteschlange, Zeitlimit, ein vorgewärmter Python-Prozess für alle Aufträge der App, gilt der letzte Build noch), `previews.ts` (Build als Vorschau eines Commits ablegen), `measure.ts` (langlebiger Python-Messdienst, `soma serve`), `skills.ts` (Bibliothek aus mitgelieferten und eigenen Skills, Stufen der Skills: Kopie nach `.soma/skills/`, bei Bedarf mit Hinweis, zwei Listen in `AGENTS.md`, Sicherung abweichender Kopien, Prüfung eines Skill-Texts), `help.ts` (Text und Bilder der Anleitung, Bilder nach `.soma/help/` im Projekt, E83), `skilllibrary.ts` (eigene Skills in den App-Daten für die Einstellungen: anlegen, speichern, zurücksetzen, löschen, importieren, mit Sicherung, E78), `settings.ts` (Einstellungen der App in `settings.json`, Kaputtes gemeldet und vor dem Ersetzen gesichert, E81), `storage.ts` (Größe der App-Daten je Bereich, Vorschau-Cache leeren, E81), `about.ts` (Versionen, Komponenten mit Lizenz, Python-Pakete aus den Metadaten, Text für Fehlermeldungen, E81), `params.ts` (Werte des Nutzers in `parameters.json` lesen, prüfen und schreiben, E74), `dialogs.ts` (native Dialoge, im Test beantwortbar), `watcher.ts`, `terminals.ts` (node-pty, Projektumgebung, `soma` und `git` im PATH, `PIP_PYTHON`), `packages.ts` (Projektumgebung `.soma/env` anlegen lassen, fehlende Pakete aus `requirements.txt` installieren, E67), `files.ts` (Pfadschutz, Dateien nach `inputs/`, Markierungen nach `.soma/feedback/`, Schreiben aus dem Editor mit Konfliktprüfung und Sicherung), `dxf.ts` (DXF für die Ansicht über `soma dxfview`, nur bei geänderter Datei, E80), `agents.ts`, dazu für E58 `bridge.ts` (Verbindung für `soma render`: HTTP auf 127.0.0.1 mit Schlüssel), `render.ts` (unsichtbares Render-Fenster, Aufträge nacheinander), `animations.ts` (Liste der Animationen und Ergebnisse, Bauen im Hintergrund) |+| `src/main/` | Hauptprozess: `projects.ts` (offenes Projekt, Speichern, Öffnen, Verlauf, Wiederherstellen), `git.ts` (mitgeliefertes Git über dugite), `zip.ts` (Modelldatei .soma oder ZIP schreiben und sicher entpacken), `workspace.ts` (UUID-Arbeitsordner, Projektzustand doppelt, Projekt-Check nur melden), `build.ts` (Build als Einmal-Prozess mit Entprellung, Warteschlange, Zeitlimit, ein vorgewärmter Python-Prozess für alle Aufträge der App, gilt der letzte Build noch), `previews.ts` (Build als Vorschau eines Commits ablegen), `measure.ts` (langlebiger Python-Messdienst, `soma serve`), `skills.ts` (Bibliothek aus mitgelieferten und eigenen Skills, Stufen der Skills: Kopie nach `.soma/skills/`, bei Bedarf mit Hinweis, zwei Listen in `AGENTS.md`, Sicherung abweichender Kopien, Prüfung eines Skill-Texts), `help.ts` (Text und Bilder der Anleitung, Bilder nach `.soma/help/` im Projekt, E83), `skilllibrary.ts` (eigene Skills in den App-Daten für die Einstellungen: anlegen, speichern, zurücksetzen, löschen, importieren, mit Sicherung, E78), `settings.ts` (Einstellungen der App in `settings.json`, Kaputtes gemeldet und vor dem Ersetzen gesichert, E81), `storage.ts` (Größe der App-Daten je Bereich, Vorschau-Cache leeren, E81), `about.ts` (Versionen, Komponenten mit Lizenz, Python-Pakete aus den Metadaten, Text für Fehlermeldungen, E81), `params.ts` (Werte des Nutzers in `parameters.json` lesen, prüfen und schreiben, E74), `dialogs.ts` (native Dialoge, im Test beantwortbar), `watcher.ts`, `terminals.ts` (node-pty, Projektumgebung, `soma` und `git` im PATH, `PIP_PYTHON`), `packages.ts` (Projektumgebung `.soma/env` anlegen lassen, fehlende Pakete aus `requirements.txt` installieren, E67), `files.ts` (Pfadschutz, Dateien nach `inputs/`, Markierungen nach `.soma/feedback/`, Schreiben aus dem Editor mit Konfliktprüfung und Sicherung), `dxf.ts` (DXF für die Ansicht über `soma dxfview`, nur bei geänderter Datei, E80), `agents.ts`, dazu für E58 `bridge.ts` (Verbindung für `soma render`: HTTP auf 127.0.0.1 mit Schlüssel, Adresse und Schlüssel auch in `bridge.json` der App-Daten für Agenten mit fremder Umgebung), `render.ts` (unsichtbares Render-Fenster, Aufträge nacheinander), `animations.ts` (Liste der Animationen und Ergebnisse, Bauen im Hintergrund) || `src/preload/` | Schmale, feste Schnittstelle zum Renderer (kein Node-Zugriff dort), `render-preload.ts` für das Render-Fenster || `src/renderer/` | Oberfläche: `main.ts` (Verdrahtung: Kopfzeile mit Spalten-Schaltern, Seitenleiste und Code-Spalte, Reiter Analysis und Animation mit Punkt für Neues, Werkzeuge neben dem Strukturbaum, Menüs, Auswahl, Export, Übergabe an den Agenten auch per Ziehen ins Terminal, Startseite), `viewer.ts` (three.js, Klick auf Code, Ansichten, Drehpunkt, Mausbelegungen und orthografische Kamera (E81), Schnittebene mit gefüllter Schnittfläche und Kontur, verschobene Bauteile der Explosion mit Wegen, Strahltest der Demontage-Analyse mit BVH aus `three-mesh-bvh`, Vorschaubild, Bild für die Markierung), `viewcube.ts` (Ansichtswürfel in 3D), `sectiontool.ts` (Schnitt: Karte, Ebene, Text für den Agenten), `explodetool.ts` (Explosion: Demontage-Analyse mit Baugruppen und schrägen Richtungen, Elternteile, Lage, Abspielen Schritt für Schritt, Karte, Texte für den Agenten), `busy.ts` (Ladeanzeige über dem Viewer mit Fortschritt und Abbrechen, für die Analyse der Explosion), `skills.ts` (Skills in der Seitenleiste: Zeilen mit Stufen-Schalter, Karte daneben mit Einstellungen), `help.ts` (Hilfe über der App: Abschnitte der Anleitung, E83), `tutorial.ts` (geführte Tour, E94: Karte mit Schritt, Titel und Text, oranger Rahmen um das Element, Abdunklung aus vier Flächen, Klicks gehen durch, ohne Element Karte in der Mitte; die zehn Schritte am Modell „Tutorial“), `settings.ts` (Einstellungen über der App mit Reitern, Reiter „Skills“ mit Liste, Markdown-Editor, Vorschau und Prüfung beim Tippen, E78), `settingspages.ts` (Reiter Viewer, Shortcuts, Storage und About, E81), `params.ts` (Parameter in der Seitenleiste: Felder nach Art, Gruppen, Zurücksetzen auf den Wert aus dem Code, E74), `markup.ts` (Zeichenfläche der Markierung, Formen als bearbeitbare Objekte), `measuretool.ts` (Messen: Ablauf, Karte, Text für den Agenten), `tree.ts` (Strukturbaum oben links im Viewer, E82: ohne Hintergrund, Baumstriche, Gruppen, Auge und Transparenz vor dem Namen, Referenzen als Gruppe am Ende, Suche, F3, Mehrfachauswahl, Ziehen über die Augen), `shortcuts.ts` (Liste aller Tasten für den Reiter Shortcuts der Einstellungen), `code.ts` (Code-Spalte mit Editor: CodeMirror 6, Speichern auf Wunsch, Abgleich mit Änderungen des Agenten, Konflikte, Umschalter für Markdown), `dxfview.ts` (DXF-Ansicht im Code-Panel: Pfade auf einer Canvas, Zoom, Layer, Mark up view, E80), `markdown.ts` (Markdown als Dokument: Tokens von `marked` direkt als DOM, ohne `innerHTML`), `filetree.ts` (Dateibaum in der Seitenleiste, offene Datei hervorgehoben), `versions.ts` (Verlaufsleiste), `terminals.ts` (xterm.js, Tabs, Einklappen, Einfügen), `ui.ts` (Menüs, Meldungen, Helfer), `icons.ts` (Symbole), `style.css` (Farben mit fester Bedeutung, siehe Kopf der Datei) || `src/renderer/` (E58) | `animdata.ts` (Animation aus der glTF-Datei auswerten), `animtool.ts` (Abspielleiste unten im Bild), `animpanel.ts` (Reiter Animation: Liste mit Videos, Schritte, E82), `overlay.ts` (Untertitel, Beschriftungen, Legende auf einer 2D-Fläche, im Viewer wie im Video), `resultview.ts` und `resulttool.ts` (Ergebnisse farbig, Legende, Leiste und Beschriftungen im Bild), `analysispanel.ts` (Reiter Analysis: Liste und Bericht, E82), `videoview.ts` (Video-Player mit Standbild markieren), `render.html` und `render.ts` (unsichtbares Render-Fenster: Bild, Übersicht, MP4 mit WebCodecs und mediabunny) |