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: Protokoll und Achsen in Struktur und Anleitung
Kai-Jungsthoefel7c2f8be75017
diff --git a/CLAUDE.md b/CLAUDE.mdindex 8307841..23f473b 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -19,7 +19,7 @@ A desktop app (Electron, TypeScript) in which a user designs 3D models in CadQueDetails in `app/README.md`.**`app/`** Electron app-- `src/main/` main process. Projects: `projects.ts` (save, open, history, export), `git.ts`, `zip.ts`, `workspace.ts`, `files.ts`, `watcher.ts`. Building and display: `build.ts` (prewarmed Python process), `previews.ts` (previews of versions and STEP files from the project), `measure.ts`, `dxf.ts` (E80), `drawings.ts` (document "Drawings", E97), `render.ts` + `bridge.ts` (`soma render`), `animations.ts`. Agent and skills: `terminals.ts`, `agents.ts`, `skills.ts`, `skilllibrary.ts` (own skills, E78). Environment: `packages.ts` (project environment, E67), `params.ts` (parameter panel, E74). App: `settings.ts`, `storage.ts`, `about.ts` (E81), `updates.ts` (new version on GitHub, E98), `help.ts` (E83), `dialogs.ts`.+- `src/main/` main process. Projects: `projects.ts` (save, open, history, export), `git.ts`, `zip.ts`, `workspace.ts`, `files.ts`, `watcher.ts`. Building and display: `build.ts` (prewarmed Python process), `previews.ts` (previews of versions and STEP files from the project), `measure.ts`, `dxf.ts` (E80), `drawings.ts` (document "Drawings", E97), `render.ts` + `bridge.ts` (`soma render`), `animations.ts`. Agent and skills: `terminals.ts`, `agents.ts`, `skills.ts`, `skilllibrary.ts` (own skills, E78). Environment: `packages.ts` (project environment, E67), `params.ts` (parameter panel, E74). App: `log.ts` (log file `logs/soma.log` in the app data, also catches `console.*`), `settings.ts`, `storage.ts`, `about.ts` (E81), `updates.ts` (new version on GitHub, E98), `help.ts` (E83), `dialogs.ts`.- `src/preload/` the only bridge to the renderer.- `src/renderer/` interface, wired up in `main.ts`. Viewer: `viewer.ts`, `viewcube.ts`, `tree.ts` (structure tree, E82), tools `sectiontool.ts`, `explodetool.ts`, `measuretool.ts`, `markup.ts`. Panels: `code.ts`, `pdfview.ts`, `dxfview.ts`, `drawings.ts` + `drawlink.ts` (document "Drawings" and its link to 3D, E97), `markdown.ts`, `filetree.ts`, `versions.ts`, `fileview.ts` (STEP file from the project in the viewer), `terminals.ts`, `params.ts`, `skills.ts`, `help.ts`, `settings.ts` + `settingspages.ts`, `tutorial.ts` (guided tour, E94). Animation and analysis: `animtool.ts`, `animpanel.ts`, `animdata.ts`, `overlay.ts`, `resulttool.ts`, `resultview.ts`, `analysispanel.ts`, `videoview.ts`. Render window: `render.ts`/`render.html`. General: `ui.ts`, `icons.ts`, `busy.ts`, `shortcuts.ts`, `style.css`.- `src/shared/` `types.ts` (IPC contract), `settings.ts` (defaults, validation, mouse bindings, E81), `editable.ts`, `help.ts`, `skillname.ts`, `version.ts`.diff --git a/app/README.md b/app/README.mdindex e2b1a22..6539d35 100644--- a/app/README.md+++ b/app/README.md@@ -76,7 +76,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, STEP-Dateien des Projekts für den Viewer umwandeln, Cache nach Inhalt), `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), `updates.ts` (neueste Version unter GitHub Releases über `net.fetch`, einmal je Sitzung, abschaltbar, E98), `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/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, STEP-Dateien des Projekts für den Viewer umwandeln, Cache nach Inhalt), `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), `log.ts` (Protokoll `logs/soma.log` in den App-Daten: `console.*` des Hauptprozesses und Fehler des Renderers, gescheiterte IPC-Anfragen, Builds, gestartete Agenten mit Version, ungefangene Ausnahmen; Rotation bei 2 MB, 3 alte Dateien), `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), `updates.ts` (neueste Version unter GitHub Releases über `net.fetch`, einmal je Sitzung, abschaltbar, E98), `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), `drawings.ts` (Dokument „Drawings“, E97: alle Blätter aus `.soma/drawings/index.json` als ein PDF in der Code-Spalte, Kopf je Blatt, Treffer auf Ansichten und Maße über die Blatt-mm des Index, Karte zur Auswahl), `drawlink.ts` (Zeichnung und 3D: Kamera in Blickrichtung, Schnittebene ins Schnittwerkzeug, Maß als Punkte, Strecke und Maßzahl), `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), `fileview.ts` (STEP-Datei aus dem Projekt im Viewer: Banner, Neuladen bei Änderung, schließt sich mit der Versionsvorschau aus), `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) |diff --git a/app/resources/skills/soma-app.md b/app/resources/skills/soma-app.mdindex 939cdde..6e39bcf 100644--- a/app/resources/skills/soma-app.md+++ b/app/resources/skills/soma-app.md@@ -90,7 +90,7 @@ The agent works with your user rights. Permissions and safety settings are part3. **Selection card**: the selected part with its face and the line in the code. "Code" jumps there, "Export" saves only this part.4. **Send to agent**: tells the agent which part and face you mean.5. **View cube**: click to look from a side, drag to rotate.-6. **Fit, default view, display**: fit the model into the view, back to the default view, and the display menu (edges, wireframe, transparent, front, top and other views).+6. **Fit, default view, axes, display**: fit the model into the view, back to the default view, origin and axes on and off (red X, green Y, blue Z, like on the view cube), and the display menu (edges, wireframe, transparent, origin and axes, front, top and other views).Mouse (default): left drag rotates, right drag pans, the wheel zooms to the mouse position. A double-click sets thepivot. You can switch to the mouse buttons of SolidWorks, Fusion 360, Onshape and others in Settings, Viewer.@@ -209,7 +209,7 @@ The block and the standard parts are under the Apache License 2.0, so the export2. **Shortcuts**: all keys and mouse actions.3. **Skills**: edit the built-in skills or write your own. They are available in every model.4. **Storage**: how much space SOMA's data takes, and clearing the preview cache.-5. **About**: versions, components and the agents found, and whether the start page checks GitHub for new versions.+5. **About**: versions, components and the agents found, the folders of SOMA including its logs, and whether the start page checks GitHub for new versions.## When something goes wrong@@ -217,3 +217,4 @@ The block and the standard parts are under the Apache License 2.0, so the export- **Warning sign next to the model name**: SOMA found a problem in the model folder (for example a missing file). It only reports, it does not repair anything by itself. Ask the agent or fix it yourself.- **Building takes long**: turn off "Auto on" in the build status and build with Ctrl B when you are ready.- **The agent does not start**: check under "Agents" on the start page whether it is installed.+- **Reporting a problem**: "Copy system info" under Settings > About copies the versions and the end of SOMA's log, paste it into the bug report. The full log is in the folder "Logs" there. It stays on your computer, SOMA sends nothing by itself.