Desktop app for designing parametric 3D models in CadQuery together with the coding agent of your choice
SOMA: Desktop-App
Electron-App (TypeScript) für 3D-Modelle mit einem Coding-Agenten im Terminal. Version 0.11.0 (Major.minor.bugfix, E68, steht in package.json und ../python/soma/__init__.py). Oberfläche nach den Entwürfen in ../design/, Änderungen in ../CHANGELOG.md. Die Kennungen E12 in Code und Doku verweisen auf das Entscheidungslog der Entwicklung, das nicht im Repo liegt.
Voraussetzungen
- Node.js 22 oder neuer, Python 3.12 mit CadQuery (Basisumgebung),
somadarin installiert. - Entwicklung:
powershell -File ../python/scripts/setup_env.ps1baut die Basisumgebung auspython/requirements-base.txt(mit uv, braucht uv und Python 3.12, E67), installiertsomadarin editierbar und holt CalculiX mitpython/scripts/fetch_ccx.pynachvenv\ccx(E84). Die App findet sie unter%LOCALAPPDATA%\soma-dev\venvoder überSOMA_PYTHON. Jedes Modell bekommt daneben eine kleine Projektumgebung unter.soma/envfü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(fallsnpm installdas Binary nicht geholt hat).
Starten und Testen
npm install
npm start # baut und startet
npm run typecheck
npm run test:unit # Bausteine ohne Electron: Dateien und Ordner nach inputs/, Anlegen, Umbenennen und Papierkorb im Dateibaum, Markierung nach .soma/feedback/, Pfadschutz, Schreiben aus dem Editor mit Konfliktprüfung, App-Icon, Einstellungen, Kategorien, Stufen und Standard der Skills, Abschnitt in AGENTS.md, Animationsdateien bauen nicht das Modell, Zwischenergebnisse nicht in Verlauf und ZIP auch in älteren Projekten, gilt der letzte Build noch, Build als Vorschau eines Commits, Einstellungen der App mit Mausbelegungen, Anleitung (Abschnitte, Bilder, Nummern wie die Markierungen der Bilder, gültiger Skill) (112 Prüfungen)
npm run test:buildlock # ohne Electron: zwei soma build auf dasselbe Modell laufen nacheinander, Sperre endet mit dem Prozess, Zeitlimit beim Warten
npm run test:meshexport # ohne Electron: 3MF, AMF, STL, OBJ von vielen Geometrien geschlossen, mannigfaltig, Volumen wie im CAD
npm run test:smoke # echte App, unsichtbar: Projekt, Viewer, Auswahl, Panels, Terminal, Übergabe an den Agenten, Markierung (Zeichnen, Linie, Raster, Auswählen, Verschieben, Drehen, Skalieren, Farben, Bild aus dem Dateibaum), Dateibaum (Markierungen, Menü, Anlegen, Umbenennen, Papierkorb), Auto-Build, Fehlerfall, Export, Ansichtswürfel und Drehpunkt (88 Prüfungen)
npm run test:versions # Git-Verlauf, Speichern als .soma, Öffnen von .soma und .zip, Export als ZIP, Vorschau (auch markiert), Wiederherstellen, Störfälle, Öffnen ohne Neubau, Vorschau aus dem Build, Start auf der Startseite, unveränderte Modelle verschwinden, Entfernen (75 Prüfungen)
npm run test:editor # Editor: Höhe und Scrollen, Speichern nur auf Wunsch mit genau einem Build (nur bei Python und inputs/), Änderungen des Agenten, Konflikte mit Sicherung, Nur lesen, CRLF, Rückfragen bei Modellwechsel und Reiter schließen, Markdown als Dokument (37 Prüfungen)
npm run test:measure # Messen: Fläche, Kante, Punkt, Abstand paralleler Ebenen, zweier Bohrungen, zweier Punkte, Punkt zur Ebene, Verdecktes, neuer Build, Vorschau (21 Prüfungen)
npm run test:stepview # STEP-Datei aus dem Dateibaum im Viewer: Banner, Cache, Build wartet, Messen, Schnitt, Explosion, Neuladen bei Änderung, zurück zum Modell, Versionsvorschau, kaputte und leere Dateien (25 Prüfungen)
npm run test:cadquery # CadQuery rein und raus: Kompatibilitätsmodus (show_object, ocp_vscode, result), Export als Datei und als Ordner, Lauf ohne soma, Rückweg Zeichen für Zeichen, veränderter Block, nicht exportierbare Imports, in der App „New from CadQuery script“ und „As CadQuery script“, Pfeil-Menü von „New model“ auf der Startseite (30 Prüfungen)
npm run test:groups # Gruppen: eigene und importierte (STEP-Baugruppe), Baum, Aus-/Einblenden und Transparenz je Gruppe, Klick durch transparente Teile, Ausgabe-STEP (17 Prüfungen)
npm run test:section # Schnitt: X/Y/Z und an Fläche, Eingabe der Lage, Seite wechseln, gefüllte und schraffierte Schnittfläche, Klicks durch den Schnitt, Wandstärke an der Kontur messen, neuer Build (26 Prüfungen)
npm run test:explode # Explosion: Demontage-Analyse (Richtung je Teil, Schrauben durch ihr Kernloch, Stift schräg aus seiner Bohrung, Baugruppe mit eingeschlossener Mutter, Elternteile), gleiche Lücke, Reihenfolge bei 100 %, Abspielen Schritt für Schritt, Reihenfolge an den Agenten, Auswahl in Einbaulage, Messen setzt zusammen, Schnitt dazu, neuer Build (39 Prüfungen)
npm run test:skills # Skills: Panel, Stufen Aus/Bei Bedarf/Immer (Kopie mit oder ohne Hinweis, project.json, zwei Listen in AGENTS.md), Einstellungen (Werte in der Kopie, Prüfung, Standard, vorab bei ausgeschaltetem Skill), Ansehen, Kopien im Dateibaum (Gruppe, nur lesen, Kopf als Quelltext), An Agent geben, Sicherung geänderter Kopien, fehlende Dateien und falsche Listen nur gemeldet, Snapshot und ZIP, Kategorien, Stufen für neue Modelle, Anleitung als Skill mit Bildern in .soma/help/, Hilfe-Fenster mit F1 (60 Prüfungen)
npm run test:fasteners # Normteile: Maße aus den Tabellen, Lage (at, direction, on, sunk), Bohrungen und Mutternfallen ohne Überschneidung, Einsätze, Fehlermeldungen, Rolle hardware, rotate/translate/moved, Codeblock des Skills „Normteile“, in der App Baum, Auswahl und export --all (37 Prüfungen)
npm run test:drawing # Technische Zeichnungen (E76): Codeblock des Skills ohne Hinweise, Ansichten, Schnitt, Einzelheit, gemessene Maße, Kreise je Ansicht, DXF mit DIMENSION und Schraffur, bytegleich beim Neubau, Hinweise der Prüfung, Fehler mit Zeile, info und list, verwaiste PDF, kaputtes Modell, in der App PDF im Code-Panel und nichts ungespeichert, Textbreite, Seite der Hinweislinie, Tabelle ohne Spaltenbreiten (37 Prüfungen)
npm run test:drawview # Dokument „Drawings“ (E97): Leiste öffnet es in der Code-Spalte ohne Seitenleiste, Hinweis ohne Zeichnungen, Blatt nach `soma drawing build` aus dem Terminal, Kopf je Blatt, Hervorheben unter dem Zeiger, Klick auf Ansicht (Kamera), Schnitt (Schnittwerkzeug auf seiner Ebene), Maß (Punkte und Maßzahl im Bild), Einzelheit (Kamera rückt heran), Escape, veraltet, Punkt für neue Blätter (19 Prüfungen)
npm run test:dxf # DXF-Ansicht (E80): soma dxfview mit Einheit, Größe, Layern, Kurven, Linientyp als Striche, Nicht-Zeichenbares, gleiche Ausgabe, kaputte Datei; in der App Öffnen per Klick im Dateibaum, Layer aus und ein (auch im Menü, ausgeschaltete aus der Datei), Zoom, Neuladen mit Ausschnitt, Mark up view mit Bereich, kaputte und gelöschte Datei (23 Prüfungen)
npm run test:animation # Animation, Analyse, soma render und Video: Bauen über den Watcher, Ablauf als Text, Kollisionsprüfung, Fehler mit Ort, Abspielen im Viewer (Lage, Hervorhebung, Kamera), Ausschluss mit Explosion und Messen, Verbindung mit Schlüssel, Bild, Übersicht, MP4 mit WebVTT, Video abspielen und Standbild markieren, Überhang, Wandstärke, Abstand mit Anzeige und Neu berechnen, Beispiel des Skills, ohne App Grenzwert mit Netzgenauigkeit, Teil vor Gruppe, Problemstellen, bessere Druckrichtung, kurze Schritte als eine Zeile, Modell nur einmal ausgeführt soma render mit Richtung, Ausblenden, Einpassen und Zoom (65 Prüfungen)
npm run test:settings # Einstellungen (E81): Reiter, Mausbelegungen (SOMA, SolidWorks, Fusion, Onshape) mit Ziehen und Klick, Zoomrichtung, orthografisch (Bildgröße, Auswählen, verdeckte Kanten beim Messen), Nachkommastellen in der offenen Messung, Darstellung beim Öffnen, Speicherplatz und Vorschau-Cache leeren, About mit Versionen, Komponenten und Kopieren, Neustart, kaputte settings.json mit Sicherung (45 Prüfungen)
npm run test:updates # Pille „neue Version“ auf der Startseite gegen einen lokalen Ersatz der GitHub-API: neuere Version mit Link, aktueller Stand ohne Pille, Fehler als leise Pille, höchste Nummer aus der Liste (Vorabversion zählt, Entwurf nicht), aktueller Stand, fremder Link, Fehler 403, unlesbare Nummer, leere Liste, einmal je Sitzung, Ausschalten unter About ohne weitere Anfrage (14 Prüfungen)
npm run test:tutorial # Tutorial (E94): Karte auf der Startseite, „Got it“ über einen Neustart, kaputte settings.json, Modell „Tutorial“, Next, Back, Skip, Escape, Ziel jedes Schritts vorhanden und Karte im Fenster, Haken beim Ausprobieren, fehlendes Ziel, Neustart aus der Hilfe mit Rückfrage, unverändertes Tutorial-Modell verschwindet (31 Prüfungen)
npm run test:folder # Ordner-Modus „Open folder“: Abbrechen ändert nichts, Abschnitt in AGENTS.md und Verweis in CLAUDE.md mit Sicherung, requirements.txt und Git des Nutzers unverändert, reines CadQuery als Einstieg, kein Speichern und Wiederherstellen, erneutes Öffnen ohne Frage, Entfernen nur aus der Liste, leerer, kopierter und fehlender Ordner (27 Prüfungen)
npm run test:packages # Projektumgebung: klein, pip im Terminal installiert dorthin, Basispakete vorhanden und in der Version festgelegt, requirements.txt aus den Importen des Builds, nicht in Git und ZIP, alter Stand mit eigener Liste, anderer Rechner installiert vor dem Build, Paket ohne Quelle als Hinweis, „Copy path for agent app“ mit `python -m soma` ohne PATH und `soma render` über bridge.json (31 Prüfungen, ohne Netz mit lokalen Wheels)
npm run test:params # Parameter (E74): Panel aus der Leiste, Werte in parameters.json statt im Code, Zurücksetzen einzeln und alle, Komma, Bereich (rot, trotzdem gebaut), Schieber, Sprung in den Code, An Agent geben, Typen (Stepper, Schalter, Auswahl, Text), Gruppen, unpassende Werte und Werte ohne Parameter, gescheiterter Build mit „Back to“, Syntaxfehler vor den Parametern, kaputte Datei, Snapshot und ZIP, leerer Zustand, Bereich des Agenten in der Zeile, Auswertungen mit den Werten des Nutzers und veraltet nach einer Änderung (46 Prüfungen)
node test/run-all.mjs fem # FEM: Kragbalken gegen die Formel, verschmolzene Teile mit Druck und Eigengewicht, Fehler (Lagerung, Bauteil, Selektor, kein fix, Code), Karte mit Lastfall und Überhöhung, Wert in Ausgangslage, soma render --result, veraltet nach Änderung der Studie, Neu berechnen, Beispiel des Skills (24 Prüfungen)
npm test # alle außer animation und fem, vier gleichzeitig (test/run-all.mjs)
npm run test:all # alle, auch die langsamen animation und fem (je etwa 6 Minuten)
node test/run-all.mjs smoke editor # nur diese, nach npm run build
npm run help:shots # Bilder der Anleitung neu aufnehmen (resources/help/), nach Änderungen an der Oberfläche
npm test startet die Suiten parallel über test/run-all.mjs, längste zuerst. Jede bekommt einen freien Port vom System (SOMA_TEST_PORT), damit sich parallele Läufe nicht gegenseitig die App fernsteuern, und gibt ihre Ausgabe am Stück aus, sobald sie fertig ist. Am Ende steht eine Übersicht mit Dauer und Prüfungen je Suite. animation und fem laufen nur mit npm run test:all (--all) oder ausdrücklich genannt. SOMA_TEST_JOBS=1 lässt sie nacheinander laufen, SOMA_TEST_WATCHDOG_S setzt den Watchdog je Suite (im Runner 900 s, sonst 360 s), SOMA_TEST_TIMES=1 schreibt vor jede Prüfung die Sekunden seit Start. Eine einzelne Testdatei direkt (node test/smoke.mjs) nimmt Port 9333, wenn SOMA_TEST_PORT nicht gesetzt ist.
SMOKE_VISIBLE=1 zeigt das Fenster. SMOKE_VISIBLE=offscreen zeigt es weit außerhalb des Bildschirms ohne Fokus, dann sind Screenshots (test/versions.png) frisch. Ein unsichtbares Fenster zeichnet nicht neu, seine Screenshots sind veraltet, die DOM-Prüfungen sind davon nicht betroffen. Mit SMOKE_VISIBLE=offscreen und zusätzlich SMOKE_SHOTS=1 legt der Smoke-Test Bilder der wichtigsten Zustände in test/shots/ ab (Arbeitsbereich, Code, Dateien, Fehler, Startseite, Agent eingeklappt, Markieren mit Textfeld, leerer Fläche, Auswahl und Farbmenü, dazu das gespeicherte Bild, wie der Agent es sieht), zum Prüfen von Änderungen an der Oberfläche.
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, von Hand oder mit einem Tag vX.Y.Z, Pakete als Artefakte am Lauf, bei einem Tag zusätzlich als GitHub-Release, solange 0.x als Vorabversion). 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 und ZIP, 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
--targetundSOMA_RUNTIMEliegt die Basisumgebung inapp/python-runtime, die Pakete inapp/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übersetzt die ganze Umgebung vorab (compileall, unchecked-hash) und prüft am Ende eine Kopie in einem Ordner mit Leerzeichen, dort auch, dass beim Import keine neue.pycentsteht. Die App startet Python mitPYTHONDONTWRITEBYTECODE(pythonEnvinpaths.ts): Unter macOS machte jede neue.pycim Paket die Signatur ungültig.EXTERNALLY-MANAGEDbleibt, pip installiert nur in die Projektumgebung (E67). - Im Paket:
resources/python(Basisumgebung,paths.tsfindet sie vor der Entwicklungsumgebung),resources/appmitdist/,resources/und nurdugiteundnode-ptyausnode_modules(alles andere bündelt esbuild), ohne asar. DazuLICENSE.txt,MODEL-EXCEPTION.mdundTHIRD_PARTY_NOTICES.md(von Hand gepflegt). Die Lizenztexte der npm-Pakete sammeltesbuild.config.mjsbeim Build nachdist/licenses/<paket>@<version>/, weil esbuild sie beim Bündeln verliert. - Windows: Installation für den Nutzer nach
%LOCALAPPDATA%\Programs\SOMAohne Adminrechte, unsigniert (SmartScreen warnt beim ersten Start). Dazuwin-unpackedals ZIP zum Entpacken ohne Installation (nicht das Zielportable, das bei jedem Start nach %TEMP% entpackt). Die App-Daten liegen auch dann unter%APPDATA%. Windows überträgt die Download-Markierung (Mark of the Web) beim Entpacken mit dem Explorer auf alle Dateien, ohne „Zulassen“ in den Eigenschaften des ZIPs warnt SmartScreen beim Start vonSOMA.exegenauso. - macOS: nur Apple Silicon (für Intel fehlt
cryptographyals Wheel), ad-hoc signiert, nicht notarisiert: Gatekeeper lässt die App erst nach Rechtsklick > Öffnen oderxattr -cr /Applications/SOMA.appstarten. 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). gmsh braucht libGLU, libXft, libXinerama und libXcursor,
build_runtime.pyliefert sie mit. Ohne nutzbaren Grafiktreiber (VM, Remote-Desktop, xvfb) sperrt Chromium WebGL, bekommt der Viewer deshalb kein WebGL, merkt die App sich das in den App-Daten (software-gl) und startet mit--ignore-gpu-blocklistneu (Software-Rendering,main.ts). Die Tests legen den Merker unter xvfb vorab an (SOMA_TEST_SOFTWARE_GL=1). Unter Ubuntu 24.04 und neuer kann AppArmor die Sandbox von Electron im AppImage blockieren. - Geprüft mit der Smoke-Suite: Windows (lokal und CI), Linux unter WSL mit Ubuntu 24.04 und xvfb, macOS in der CI (dort scheitern nur die Prüfungen mit Koordinaten im Viewer, der Bildschirm des Runners ist zu klein). Auf echten Rechnern kurz ausprobiert (2026-10-11): Linux unter Kubuntu mit Grafikkarte, macOS mit Apple Silicon, beide starten mit 3D-Ansicht.
Aufbau
| 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, geöffnete Ordner in folders.json), folders.ts (Ordner-Modus „Open folder“: was angelegt und geändert wird, Abschnitt in AGENTS.md, Verweis in CLAUDE.md, mit Sicherung, E103), 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) |
src/shared/ |
help.ts Anleitung in Abschnitte zerlegen (E83), types.ts Typen des IPC-Vertrags, editable.ts welche Dateien der Editor nur zeigt (gilt in Renderer und Hauptprozess), skillname.ts Kennung eines eigenen Skills aus seinem Namen |
resources/template/ |
Vorlage für neue Projekte: model.py, AGENTS.md, CLAUDE.md, NOTES.md, .gitignore |
resources/skills/ |
Mitgelieferte Skills (E17), je eine Markdown-Datei: Kopf mit title, summary, topics, category (Überschrift im Panel), 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/, cqcompat.py Kompatibilitätsmodus für CadQuery-Skripte ohne add_part (E100), cqexport.py mit `soma cadquery export |
test/ |
smoke.mjs, versions.mjs, editor.mjs, measure.mjs, stepview.mjs, cadquery.mjs, folder.mjs (Ordner-Modus), groups.mjs, section.mjs, explode.mjs, skills.mjs, params.mjs, tutorial.mjs, updates.mjs, fasteners.mjs, drawing.mjs, drawview.mjs, dxf.mjs, animation.mjs (Ende-zu-Ende), unit.mjs (ohne Electron), buildlock.mjs (Sperre von soma build, nur Python), meshexport.mjs (Netz-Exporte, nur Python), harness.mjs (App starten und steuern), cdp.mjs (kleiner DevTools-Client, puppeteer scheitert an Electron 44) |
Noch nicht enthalten
Panel „Pakete“, weitere Bereiche der Einstellungen, Varianten und abgeleitete Werte im Parameter-Panel, Auto-Start des Agenten, soma check, Signatur der Installationspakete. Linux und macOS auf echten Rechnern nur kurz ausprobiert (Start und 3D-Ansicht).