Skip to content

armgit / SOMA

Public Imported from GitHub
0

Desktop app for designing parametric 3D models in CadQuery together with the coding agent of your choice

Doku: Changelog und App-README zu Agenten mit fremder Umgebung

Kai-Jungsthoefelde00e5b66da9
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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
### Fixed
diff --git a/app/README.md b/app/README.md
index 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) |