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
App: Nutzeranleitung als Hilfe-Fenster und Skill aus einer Quelle (E83)
Kai-Jungsthoefel386af97bd795
diff --git a/app/README.md b/app/README.mdindex d8cee66..f6cc563 100644--- a/app/README.md+++ b/app/README.md@@ -15,7 +15,7 @@ Electron-App (TypeScript) für 3D-Modelle mit einem Coding-Agenten im Terminal.npm installnpm start # baut und startetnpm 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 (107 Prüfungen)+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: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)@@ -23,7 +23,7 @@ npm run test:measure # Messen: Fläche, Kante, Punkt, Abstand paralleler Ebennpm 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 (53 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 (23 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)@@ -34,6 +34,7 @@ npm run test:params # Parameter (E74): Panel aus der Leiste, Werte in paramenode 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 siebzehn, vier gleichzeitig (test/run-all.mjs)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. `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.@@ -46,17 +47,18 @@ node test/run-all.mjs smoke editor # nur diese, nach npm run build| 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), `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), `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), `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/` | 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), `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) |-| `src/shared/` | `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 |+| `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` (deutsch, Oberfläche), `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/`, `anim.py` und `animrun.py` Animationen mit `soma anim`, `analysis.py` Auswertungen mit `soma analyze`, `fem.py` Festigkeit mit `soma analyze fem` (gmsh, pyamg), `render.py` Auftrag an die App für `soma render`, `drawing.py` und `drawrun.py` technische Zeichnungen mit `soma drawing` (E76: HLR aus OCP, DXF mit ezdxf, PDF und PNG über matplotlib, Prüfung), `dxfview.py` DXF für die Ansicht der App mit `soma dxfview` (E80, Zeichenmodul von ezdxf), `gltf.py` GLB-Schreiber, `progress.py` Fortschritt langer Befehle) || `test/` | `smoke.mjs`, `versions.mjs`, `editor.mjs`, `measure.mjs`, `groups.mjs`, `section.mjs`, `explode.mjs`, `skills.mjs`, `params.mjs`, `fasteners.mjs`, `drawing.mjs`, `dxf.mjs`, `animation.mjs` (Ende-zu-Ende), `unit.mjs` (ohne Electron), `harness.mjs` (App starten und steuern), `cdp.mjs` (kleiner DevTools-Client, puppeteer scheitert an Electron 44) |## Noch nicht enthalten (siehe PLAN.md, Abschnitt 10)-Panel „Pakete“, Hilfe (der Knopf steht schon ausgegraut da), weitere Bereiche der Einstellungen, Varianten und abgeleitete Werte im Parameter-Panel, Auto-Start des Agenten, `soma check`, Bündelung von Python und Installer, macOS und Linux (nur Windows getestet).+Panel „Pakete“, weitere Bereiche der Einstellungen, Varianten und abgeleitete Werte im Parameter-Panel, Auto-Start des Agenten, `soma check`, Bündelung von Python und Installer, macOS und Linux (nur Windows getestet).diff --git a/app/package.json b/app/package.jsonindex b20a9b7..651a7f1 100644--- a/app/package.json+++ b/app/package.json@@ -25,6 +25,7 @@"test:packages": "npm run build && node test/packages.mjs","test:settings": "npm run build && node test/settings.mjs","test:unit": "node test/unit.mjs",+ "help:shots": "npm run build && node test/helpshots.mjs","test": "npm run build && node test/run-all.mjs"},"dependencies": {diff --git a/app/resources/help/agent.png b/app/resources/help/agent.pngnew file mode 100644index 0000000..55c39a4Binary files /dev/null and b/app/resources/help/agent.png differdiff --git a/app/resources/help/code.png b/app/resources/help/code.pngnew file mode 100644index 0000000..bd9d6bcBinary files /dev/null and b/app/resources/help/code.png differdiff --git a/app/resources/help/export.png b/app/resources/help/export.pngnew file mode 100644index 0000000..26f062fBinary files /dev/null and b/app/resources/help/export.png differdiff --git a/app/resources/help/history.png b/app/resources/help/history.pngnew file mode 100644index 0000000..88f95f7Binary files /dev/null and b/app/resources/help/history.png differdiff --git a/app/resources/help/markup.png b/app/resources/help/markup.pngnew file mode 100644index 0000000..b7a1f42Binary files /dev/null and b/app/resources/help/markup.png differdiff --git a/app/resources/help/settings.png b/app/resources/help/settings.pngnew file mode 100644index 0000000..b7d7eebBinary files /dev/null and b/app/resources/help/settings.png differdiff --git a/app/resources/help/sidebar.png b/app/resources/help/sidebar.pngnew file mode 100644index 0000000..217e30bBinary files /dev/null and b/app/resources/help/sidebar.png differdiff --git a/app/resources/help/start.png b/app/resources/help/start.pngnew file mode 100644index 0000000..9900febBinary files /dev/null and b/app/resources/help/start.png differdiff --git a/app/resources/help/tools.png b/app/resources/help/tools.pngnew file mode 100644index 0000000..97a3a9cBinary files /dev/null and b/app/resources/help/tools.png differdiff --git a/app/resources/help/viewer.png b/app/resources/help/viewer.pngnew file mode 100644index 0000000..0f3f21aBinary files /dev/null and b/app/resources/help/viewer.png differdiff --git a/app/resources/help/window.png b/app/resources/help/window.pngnew file mode 100644index 0000000..be872edBinary files /dev/null and b/app/resources/help/window.png differdiff --git a/app/resources/skills/soma-app.md b/app/resources/skills/soma-app.mdnew file mode 100644index 0000000..ee579a0--- /dev/null+++ b/app/resources/skills/soma-app.md@@ -0,0 +1,171 @@+---+title: Using the app+name: Using the SOMA app+summary: The user guide of SOMA with numbered screenshots: window, viewer, tools, panels, history, export and settings. The agent reads it to answer questions about the app.+order: 9+category: Way of working+default: on-demand+when: the user asks how to do something in the SOMA app, cannot find a button or panel, or asks what a part of the window does+topics: The window; Start page; The agent; Viewer; Tools; Mark up; Sidebar; Files and code; Saving and history; Export; Settings; When something goes wrong+---+# Using SOMA++<!-- agent -->+> **For the agent:** this is the user guide that the app also shows under "Help". Use it to answer questions about the+> app. The screenshots are in `.soma/help/` (for example `.soma/help/window.png`). Open one when you need to see where+> something is. The numbers in a picture match the numbered list below it. Name buttons exactly as written here, say+> where they are, and keep answers short. Only describe what this guide says. If it does not cover a question, say so+> instead of guessing. All keyboard shortcuts are listed in the app under Settings, Shortcuts.+<!-- /agent -->++SOMA is a 3D modeling app where an AI agent writes the model for you. You describe what you want in the agent's+terminal, the agent writes CadQuery code, and SOMA builds it and shows it in 3D. You check the result, point at+things, and ask for changes.++## The window++++1. **Model menu**: new model, open, recent models, save as. Next to it: whether the model is saved.+2. **Build status**: "Built" when the model is up to date, "Build failed" if the code has an error. Click for details. With "Auto on" the model is rebuilt whenever the code changes.+3. **Columns**: show or hide the sidebar, the code and the agent (Ctrl 1, Ctrl 2, Ctrl 3).+4. **Export**: write parts as STL, STEP and other formats.+5. **Save**: saves the model as a .soma file and adds a version to the history (Ctrl S).+6. **Sidebar**: parameters, files, analysis, animation, skills, help and settings.+7. **Structure tree**: the parts of the model. Click the arrow to expand it.+8. **Tools**: measure, section, explode and mark up.+9. **View cube**: click a side, edge or corner to look from there.+10. **History**: every saved version. Click a dot to look at it.+11. **Agent**: the terminal where you talk to the agent.++The logo at the top left opens the start page.++## Start page++++1. **New model**: starts from a small example (a box with a lid) and opens a terminal in the model folder (Ctrl N).+2. **Open**: opens a .soma or ZIP file (Ctrl O).+3. **Recent**: models you worked on. The bin on a card removes the model from this computer, a saved .soma file stays.+4. **Agents on this computer**: the agents SOMA found. You install them yourself, SOMA does not bring one.+5. **Settings**: viewer, shortcuts, skills, storage and version.+6. **Back to the model**: returns to the open model.++## The agent++++1. **Tabs**: each tab is an agent or a terminal, running in the model folder.+2. **New tab**: opens the menu below.+3. **Start agent**: starts one of the agents found on this computer.+4. **Empty terminal**: a plain command line, for example for `soma build`.++Type your wishes into the agent and press Enter. Everything with **Send to agent** (a part, a measurement, an error,+a drawing) puts a short note into the agent's input. Add your own words, then press Enter. You can also drag a file+from Files into the terminal to name it.++The agent works with your user rights. Permissions and safety settings are part of the agent, not of SOMA.++## Viewer++++1. **Structure tree**: click a name to select the part. The search finds parts by name.+2. **Hide and transparent**: the eye hides a part, the half circle makes it transparent. Drag across several eyes to hide many at once.+3. **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).++Mouse (default): left drag rotates, right drag pans, the wheel zooms to the mouse position. A double-click sets the+pivot. You can switch to the mouse buttons of SolidWorks, Fusion 360, Onshape and others in Settings, Viewer.++Click selects a part, Ctrl+click adds more. Right-click a part for isolate, hide, transparent, zoom, code and agent.+Keys: H hides, Shift H shows all, I isolates, T makes transparent, Esc clears the selection.++## Tools++++1. **Measure**: click a face or edge for its size, a second one for distance and angle. The values are exact.+2. **Section**: cuts the model open along X, Y, Z or parallel to a face. Move the plane with the slider or type a value.+3. **Explode**: pulls the parts apart. Plays the disassembly step by step and can send the order to the agent.+4. **Mark up**: draw on a picture of the view for the agent (see below).+5. **Tool card**: settings of the active tool. The × closes the tool. None of the tools change the model.++## Mark up++++1. **Drawing tools**: select, pen, line, arrow, rectangle, circle and text.+2. **Color**: color of the next shape, or of the selected one.+3. **Undo and delete**: Ctrl Z undoes, Del deletes the selected shape.+4. **Grid and blank canvas**: a grid to draw straight, or an empty sheet for a sketch instead of the model.+5. **Cancel**: discards the drawing (Esc).+6. **Send to agent**: saves the picture in the model and passes it to the agent. Then write what you want, for example "make this hole bigger".++Mark up is the quickest way to show the agent what you mean: draw an arrow, write a dimension, circle a spot.++## Sidebar++++1. **Parameters**: values of the model you can change yourself, such as sizes, counts or angles. The model rebuilds right away. The agent decides which values appear here. The arrow next to a changed value brings back the agent's value.+2. **Files**: all files of the model. Click one to open it next to it.+3. **Analysis**: results the agent calculated, such as strength (FEM), wall thickness, overhang or clearance. Click one to see it in color on the model, with its report.+4. **Animation**: motion the agent made, for example an assembly sequence. Click one to play it in the viewer, "Make video" writes an MP4.+5. **Skills**: rule sets for the agent, such as 3D printing, CNC or tolerances. Off, On demand (the agent reads them when the topic comes up) or Always.+6. **Help**: this guide (F1).+7. **Settings**: see below.++A dot on Analysis or Animation means the agent made something new you have not looked at yet.++## Files and code++++1. **File tree**: the model's files. Right-click for new, rename, show in Explorer and delete. "Managed by the app" holds files SOMA writes itself.+2. **Drop zone**: drop STEP files, images or sketches here. They go to `inputs/`, where the agent can use them.+3. **Open files**: one tab per open file.+4. **Linked to selection**: when on, clicking a part in the viewer jumps to its code.+5. **Editor**: you can edit the code yourself. Ctrl S saves the file and builds. If the agent changes the same file, SOMA asks before anything is overwritten.++Markdown files (such as `NOTES.md`) open as a document, PDF and DXF files open as a drawing.++## Saving and history++++1. **Timeline**: one dot per version, the newest on the right. The agent adds versions as it works, Save adds one too.+2. **Back to now**: leaves the preview.+3. **Restore**: makes the version you are looking at the current one. It is added as a new version, nothing is lost.++A model is a single `.soma` file with code, results and the whole history. The first Save asks where to put it,+after that Ctrl S saves to the same file. Copy or send the file like any other document.++## Export++++1. **Scope**: all parts, or only the selected one.+2. **Formats**: for 3D printing (STL, 3MF), CAD (STEP, IGES), graphics and 2D (DXF, SVG). All parts become one file per part in a folder you choose.+3. **Everything as ZIP**: the whole model with code, results and history, for someone without SOMA.++Reference parts (for example an imported circuit board) are not included in "All parts".++## Settings++++1. **Viewer**: mouse buttons like in your CAD program, zoom direction, perspective or orthographic, display when a model opens, decimal places of measurements.+2. **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.++## When something goes wrong++- **Build failed**: a red card in the viewer shows the error and the line. "Send to agent" asks the agent to fix it, "Open code" shows the line. The viewer keeps showing the last model that worked.+- **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 this computer" on the start page whether it is installed.diff --git a/app/resources/template/.gitignore b/app/resources/template/.gitignoreindex 2b9b259..c014fa8 100644--- a/app/resources/template/.gitignore+++ b/app/resources/template/.gitignore@@ -21,3 +21,6 @@ renders/# Environment with the model's extra packages (only requirements.txt is versioned).soma/env/++# Pictures of the app's user guide (copied by the app)+.soma/help/diff --git a/app/src/main/git.ts b/app/src/main/git.tsindex abb82df..4b1ab64 100644--- a/app/src/main/git.ts+++ b/app/src/main/git.ts@@ -20,11 +20,11 @@ const COMMON = ['-c', 'core.quotepath=false', '-c', 'core.autocrlf=false'];/*** Zwischenergebnisse der App, die nie in den Verlauf gehören: Geometrie für das Messen, gebaute Animationen, Ergebnisse* von soma analyze (bis zu 70 MB je Auswertung), Bilder und Videos von soma render und die Projektumgebung mit den- * Zusatzpaketen (E67, im Verlauf steht nur requirements.txt). Ältere Projekte haben sie noch+ * Zusatzpaketen (E67, im Verlauf steht nur requirements.txt), dazu die Bilder der Anleitung (E83). Ältere Projekte haben sie noch* nicht in der .gitignore, deshalb klammert die App sie selbst aus, beim Status und beim Hinzufügen (siehe addAll), und* trägt sie beim Öffnen in .git/info/exclude ein, damit auch die Commits des Agenten sie nicht aufnehmen (ensureIgnored).*/-const APP_CACHES = ['.soma/geometry', '.soma/anim', '.soma/results', '.soma/drawings', '.soma/env', 'renders'];+const APP_CACHES = ['.soma/geometry', '.soma/anim', '.soma/results', '.soma/drawings', '.soma/env', '.soma/help', 'renders'];/** `output/` zählt nicht als Änderung: STEP-Dateien sind nicht byte-stabil (Zeitstempel, teils Reihenfolge). */const NOT_OUTPUT = ['--', '.', ':(exclude)output', ...APP_CACHES.map((p) => `:(exclude)${p}`)];/** Was die Vorlage in der .gitignore hat (resources/template/.gitignore), für ältere Projekte in .git/info/exclude. */diff --git a/app/src/main/help.ts b/app/src/main/help.tsnew file mode 100644index 0000000..fa2a020--- /dev/null+++ b/app/src/main/help.ts@@ -0,0 +1,50 @@+import fs from 'node:fs';+import path from 'node:path';+import { HELP_DIR, HELP_IMAGE, HELP_SKILL } from '../shared/help';+import { readSkillFile, SKILLS_DIR } from './skills';++/**+ * Anleitung (E83) im Hauptprozess: Text für das Hilfe-Fenster, Bilder dazu und die Kopie der Bilder ins Projekt. Der Text ist+ * der mitgelieferte Skill (`<skillsDir>/soma-app.md`), nicht eine bearbeitete Fassung aus der Bibliothek: Die Hilfe beschreibt+ * die App, wie sie ist. Die Bilder liegen in `<helpDir>/`.+ */++/** Text der Anleitung, null wenn die Datei fehlt oder zu groß ist. */+export const readHelp = (skillsDir: string): string | null => readSkillFile(path.join(skillsDir, `${HELP_SKILL}.md`));++/** Ein Bild der Anleitung. Nur Namen nach HELP_IMAGE, also nichts außerhalb des Ordners. */+export function readHelpImage(helpDir: string, name: unknown): Buffer | null {+ if (typeof name !== 'string' || !HELP_IMAGE.test(name)) return null;+ try { return fs.readFileSync(path.join(helpDir, name)); } catch { return null; }+}++const sameFile = (a: string, b: string): boolean => {+ try {+ const sa = fs.statSync(a), sb = fs.statSync(b);+ return sa.size === sb.size && fs.readFileSync(a).equals(fs.readFileSync(b));+ } catch { return false; }+};++/**+ * Bilder der Anleitung nach `.soma/help/` im Projekt, sofern der Skill dort liegt (Stufe Bei Bedarf oder Immer): Der Agent+ * öffnet sie über die Pfade im Skill. Der Ordner gehört der App, steht nicht im Verlauf und nicht in der Modelldatei+ * (wie `.soma/drawings/`), deshalb ersetzt die App dort abweichende Bilder ohne Sicherung. Fremde Dateien bleiben liegen.+ * Fehler werden nur protokolliert: Ohne Bilder bleibt der Text brauchbar.+ */+export function syncHelpImages(root: string, helpDir: string): void {+ if (!fs.existsSync(path.join(root, SKILLS_DIR, `${HELP_SKILL}.md`))) return;+ try {+ const names = fs.readdirSync(helpDir).filter((n) => HELP_IMAGE.test(n));+ const dest = path.join(root, HELP_DIR);+ // Ein Verweis (Symlink) an Stelle des Ordners könnte nach außen zeigen: dann nichts schreiben+ if (fs.existsSync(dest) && !fs.lstatSync(dest).isDirectory()) { console.error(`[soma] ${HELP_DIR} is not a folder, the pictures of the guide are not copied.`); return; }+ fs.mkdirSync(dest, { recursive: true });+ for (const n of names) {+ const to = path.join(dest, n);+ if (fs.existsSync(to) && fs.lstatSync(to).isSymbolicLink()) continue;+ if (!sameFile(path.join(helpDir, n), to)) fs.copyFileSync(path.join(helpDir, n), to);+ }+ } catch (e) {+ console.error('[soma] Could not copy the pictures of the guide:', e);+ }+}diff --git a/app/src/main/main.ts b/app/src/main/main.tsindex 93fe7c2..87f9e35 100644--- a/app/src/main/main.ts+++ b/app/src/main/main.ts@@ -10,7 +10,8 @@ import { viewDxf } from './dxf';import { backupText, createEntry, entryPath, importInputs, listFiles, renameEntry, resolveInside, saveFeedbackImage, trashEntry, writeProjectText } from './files';import { ProjectController } from './projects';import { terminalEnv } from './terminals';-import { appIcon, editBackupsDir, libraryBackupsDir, skillDirs, thumbnailsDir, userSkillsDir } from './paths';+import { readHelp, readHelpImage } from './help';+import { appIcon, editBackupsDir, helpDir, libraryBackupsDir, skillDirs, skillsDir, thumbnailsDir, userSkillsDir } from './paths';import { readSettings, writeSettings } from './settings';import { areaDir, clearPreviews, isStorageArea, storageStats } from './storage';import { checkLibraryText, createLibrarySkill, importLibrarySkills, libraryState, ownFile, readLibrarySkill, removeLibrarySkill, saveLibrarySkill } from './skilllibrary';@@ -140,6 +141,9 @@ function registerIpc(ctl: ProjectController): void {ipcMain.handle('params:state', () => ctl.paramState());ipcMain.handle('params:set', (_e, values: unknown) => ctl.setParams(values));ipcMain.handle('params:resetAll', () => ctl.resetAllParams());+ // Anleitung (E83): Text aus dem mitgelieferten Skill, Bilder aus resources/help/+ ipcMain.handle('help:read', () => readHelp(skillsDir()));+ ipcMain.handle('help:image', (_e, name: unknown) => readHelpImage(helpDir(), name));ipcMain.handle('skills:list', () => ctl.skills());ipcMain.handle('skills:set', (_e, id: unknown, mode: unknown) => ctl.setSkill(id, mode));ipcMain.handle('skills:configure', (_e, id: unknown, values: unknown) => ctl.configureSkill(id, values));@@ -250,8 +254,15 @@ function registerIpc(ctl: ProjectController): void {// Fenster schließen wie mit dem Kreuz (mit Rückfrage und Verlassen des Modells). window.close() der Seite umgeht dasipcMain.handle('test:close', (e) => { BrowserWindow.fromWebContents(e.sender)?.close(); });// Screenshot auch aus unsichtbaren Fenstern (CDP liefert dort kein Bild)- ipcMain.handle('test:screenshot', async (e, file: string) => {- const img = await e.sender.capturePage();+ // `rect` (in CSS-Pixeln): nur dieser Ausschnitt, etwa für die Bilder der Hilfe (test/helpshots.mjs)+ // capturePage(rect) liefert bei Fenstern außerhalb des Bildschirms das ganze Bild, deshalb danach zuschneiden+ ipcMain.handle('test:screenshot', async (e, file: string, rect?: Electron.Rectangle) => {+ let img = await e.sender.capturePage();+ const css = BrowserWindow.fromWebContents(e.sender)?.getContentBounds().width;+ if (rect && css) {+ const f = img.getSize().width / css;+ img = img.crop({ x: Math.round(rect.x * f), y: Math.round(rect.y * f), width: Math.round(rect.width * f), height: Math.round(rect.height * f) });+ }fs.writeFileSync(file, img.toPNG());return img.getSize();});diff --git a/app/src/main/paths.ts b/app/src/main/paths.tsindex 5023f64..d899bcf 100644--- a/app/src/main/paths.ts+++ b/app/src/main/paths.ts@@ -35,6 +35,8 @@ export const templateDir = () => path.join(app.getAppPath(), 'resources', 'templ/** Mitgelieferte Skills (E17), je einer als Markdown. */export const skillsDir = () => path.join(app.getAppPath(), 'resources', 'skills');+/** Bilder der Anleitung (E83), der Text ist der mitgelieferte Skill `soma-app.md`. */+export const helpDir = () => path.join(app.getAppPath(), 'resources', 'help');/** Eigene und bearbeitete Skills des Nutzers (E78), gelten für die ganze App. */export const userSkillsDir = () => path.join(userDataDir(), 'skills');/** Beide Ordner der Bibliothek der Skills. */diff --git a/app/src/main/projects.ts b/app/src/main/projects.tsindex fe8ff9e..226f687 100644--- a/app/src/main/projects.ts+++ b/app/src/main/projects.ts@@ -15,7 +15,9 @@ import { GitRepo, type GitStatus } from './git';import { MeasureService } from './measure';import { ensureEnv, envIsCurrent, installMissing, missingPackages } from './packages';import { checkParamValue, isParamValue, readUserParams, writeUserParams } from './params';-import { previewsDir, skillBackupsDir, skillDirs } from './paths';+import { helpDir, previewsDir, skillBackupsDir, skillDirs } from './paths';+import { syncHelpImages } from './help';+import { HELP_SKILL } from '../shared/help';import { storeBuildAsPreview } from './previews';import {agentsEntries, checkValue, cleanValues, copySkill, isSkillId, isSkillMode, librarySkill, listSkills, modeOf, removeSkill, withMode, writeAgentsList, type SkillValues,@@ -117,6 +119,7 @@ export class ProjectController {const terminals = new TerminalManager(this.wc, dir);const git = new GitRepo(dir);void git.ensureIgnored(); // ältere Projekte: Zwischenergebnisse auch aus den Commits des Agenten heraushalten+ syncHelpImages(dir, helpDir()); // Bilder der Anleitung (E83) fehlen nach dem Öffnen einer .soma-Datei oder sind von einer älteren Appconst anims = new AnimBuilder(dir, () => this.send('anim:changed'));const stopWatch = watchProject(dir, (rel) => builds.sourceChanged(rel ? path.join(dir, rel) : null), () => this.send('fs:changed'),(rel) => this.animFileChanged(rel));@@ -722,6 +725,7 @@ export class ProjectController {const backup = mode === 'off'? removeSkill(s.dir, skillDirs(), skill, skillBackupsDir(s.id), values): copySkill(s.dir, skillDirs(), skill, skillBackupsDir(s.id), values, mode, was === 'off' ? undefined : values);+ if (skill === HELP_SKILL && mode !== 'off') syncHelpImages(s.dir, helpDir());const next = withMode(modes, skill, mode);updateProjectSkills(s.id, { modes: next });const warning = writeAgentsList(s.dir, agentsEntries(s.dir, skillDirs(), next));diff --git a/app/src/main/zip.ts b/app/src/main/zip.tsindex edbbd62..09252b7 100644--- a/app/src/main/zip.ts+++ b/app/src/main/zip.ts@@ -19,9 +19,10 @@ const SKIP_FILES = new Set(['.soma/model.glb', '.soma/model.map.json', '.soma/bu* Ganze Ordner, die nie gepackt werden (Pfad relativ zum Projekt): die Geometrie für das Messen entsteht beim Bauen neu,* Animationen baut die App beim Öffnen neu, Ergebnisse von soma analyze (bis zu 70 MB je Auswertung) rechnet man neu.* Die Projektumgebung (E67) legt die App beim Öffnen an und installiert dabei requirements.txt. Bilder und Videos von- * soma render entstehen aus dem Code neu (E75, beim Hotwire 41 % der ZIP).+ * soma render entstehen aus dem Code neu (E75, beim Hotwire 41 % der ZIP). Die Bilder der Anleitung kopiert die App beim+ * Öffnen ins Projekt (E83).*/-const SKIP_PATHS = new Set(['.soma/geometry', '.soma/anim', '.soma/results', '.soma/drawings', '.soma/env', 'renders']);+const SKIP_PATHS = new Set(['.soma/geometry', '.soma/anim', '.soma/results', '.soma/drawings', '.soma/env', '.soma/help', 'renders']);/** Schon gepackt (Git-Objekte sind zlib, Bilder und Videos komprimiert): nur ablegen, nochmal Deflate kostet nur Zeit. */const STORED = /^\.git\/objects\/|\.(png|jpe?g|webp|mp4|webm|zip|soma|gz|7z|pack)$/i;const MAX_UNPACKED = 2 * 1024 ** 3;diff --git a/app/src/preload/preload.ts b/app/src/preload/preload.tsindex f903e68..ece1895 100644--- a/app/src/preload/preload.ts+++ b/app/src/preload/preload.ts@@ -74,6 +74,10 @@ const api: SomaApi = {set: (values) => ipcRenderer.invoke('params:set', values),resetAll: () => ipcRenderer.invoke('params:resetAll'),},+ help: {+ read: () => ipcRenderer.invoke('help:read'),+ image: (name) => ipcRenderer.invoke('help:image', name),+ },skills: {list: () => ipcRenderer.invoke('skills:list'),set: (id, mode) => ipcRenderer.invoke('skills:set', id, mode),@@ -123,7 +127,7 @@ const api: SomaApi = {// Nur im Testmodus: vorbereitete Antworten für native Dialogetest: process.env.SOMA_TEST === '1'? {- answers: (a) => ipcRenderer.invoke('test:answers', a), screenshot: (f) => ipcRenderer.invoke('test:screenshot', f), bridge: () => ipcRenderer.invoke('test:bridge'),+ answers: (a) => ipcRenderer.invoke('test:answers', a), screenshot: (f, rect) => ipcRenderer.invoke('test:screenshot', f, rect), bridge: () => ipcRenderer.invoke('test:bridge'),close: () => ipcRenderer.invoke('test:close'), clipboard: () => ipcRenderer.invoke('test:clipboard'),}: undefined,diff --git a/app/src/renderer/help.ts b/app/src/renderer/help.tsnew file mode 100644index 0000000..d28cdb4--- /dev/null+++ b/app/src/renderer/help.ts@@ -0,0 +1,131 @@+import { HELP_DIR, helpSections, type HelpSection } from '../shared/help';+import type { SomaApi } from '../shared/types';+import { renderMarkdown } from './markdown';+import { el, menus } from './ui';++interface Ui {+ root: HTMLElement;+ nav: HTMLElement;+ body: HTMLElement;+ close: HTMLButtonElement;+ /** Was hinter dem Fenster liegt: gesperrt, solange es offen ist. */+ background: HTMLElement[];+}++interface Deps {+ help: SomaApi['help'];+ /** Web-Link aus der Anleitung. */+ openUrl(href: string): void;+}++/** Pfad, unter dem die Anleitung als Skill im Projekt läge: Von dort lösen sich die Bilder (`../help/…`) auf. */+const AS_FILE = '.soma/skills/soma-app.md';++/**+ * Hilfe (E83): Fenster über der App wie die Einstellungen, links die Abschnitte der Anleitung, rechts der gewählte. Der Text+ * ist der mitgelieferte Skill „Using the app“ ohne die Teile nur für den Agenten (shared/help.ts), gezeigt mit derselben+ * Markdown-Ansicht wie Notizen. Bilder kommen aus den Dateien der App, nicht aus dem Projekt.+ */+export class HelpDialog {+ private sections: HelpSection[] = [];+ private current = 0;+ private error = '';+ private loaded = false;+ private lastFocus: HTMLElement | null = null;+ /** blob:-Adressen der Bilder, einmal geladen für die ganze Sitzung. */+ private images = new Map<string, Promise<string | null>>();++ constructor(private ui: Ui, private deps: Deps) {+ ui.close.addEventListener('click', () => this.close());+ ui.root.addEventListener('mousedown', (e) => { if (e.target === ui.root) this.close(); });+ ui.root.addEventListener('keydown', (e) => {+ if (e.key === 'Escape' && !e.defaultPrevented) { e.preventDefault(); this.close(); }+ else if ((e.key === 'ArrowDown' || e.key === 'ArrowUp') && (e.target as HTMLElement | null)?.closest?.('[data-help]')) {+ e.preventDefault();+ this.show(Math.max(0, Math.min(this.sections.length - 1, this.current + (e.key === 'ArrowDown' ? 1 : -1))), true);+ }+ });+ }++ get isOpen(): boolean { return !this.ui.root.hidden; }++ /** Öffnen, mit `title` gleich bei diesem Abschnitt. Die Anleitung wird beim ersten Öffnen gelesen. */+ async open(title?: string): Promise<void> {+ if (!this.isOpen) {+ this.lastFocus = document.activeElement instanceof HTMLElement ? document.activeElement : null;+ menus.close();+ this.ui.root.hidden = false;+ for (const b of this.ui.background) b.inert = true;+ }+ if (!this.loaded) await this.load();+ const i = title ? this.sections.findIndex((s) => s.title.toLowerCase() === title.toLowerCase()) : -1;+ this.show(i >= 0 ? i : this.current, true);+ }++ close(): void {+ if (!this.isOpen) return;+ this.ui.root.hidden = true;+ for (const b of this.ui.background) b.inert = false;+ this.lastFocus?.focus();+ }++ private async load(): Promise<void> {+ try {+ const raw = await this.deps.help.read();+ this.sections = raw ? helpSections(raw) : [];+ this.error = raw ? '' : 'The guide is missing from this installation (resources/skills/soma-app.md).';+ } catch (e) { this.error = e instanceof Error ? e.message : String(e); }+ this.loaded = !this.error;+ this.ui.nav.replaceChildren(...this.sections.map((s, i) => {+ const b = el('button', { textContent: s.title });+ b.dataset.help = String(i);+ b.addEventListener('click', () => this.show(i, false));+ return b;+ }));+ }++ private show(i: number, focus: boolean): void {+ if (this.error || !this.sections.length) {+ this.ui.body.replaceChildren(el('p', { className: 'st-empty', textContent: this.error || 'The guide is empty.' }));+ return;+ }+ this.current = i;+ const s = this.sections[i];+ this.ui.nav.querySelectorAll<HTMLButtonElement>('button[data-help]').forEach((b) => {+ if (b.dataset.help === String(i)) b.setAttribute('aria-current', 'page'); else b.removeAttribute('aria-current');+ });+ const doc = renderMarkdown(`## ${s.title}\n\n${s.text}`, AS_FILE, true, {+ link: (href) => { if (/^(https?:|mailto:)/i.test(href)) this.deps.openUrl(href); },+ image: (rel) => this.image(rel),+ toggleTask: () => {},+ edit: () => {},+ });+ doc.classList.add('help-doc');+ // Bilder passen in die Breite, ein Klick zeigt sie in voller Größe (kleine Beschriftungen lesbar)+ doc.querySelectorAll<HTMLImageElement>('img.md-img').forEach((img) => img.addEventListener('click', () => img.classList.toggle('full')));+ this.ui.body.replaceChildren(doc);+ this.ui.body.scrollTop = 0;+ if (focus) this.ui.nav.querySelector<HTMLElement>(`button[data-help="${i}"]`)?.focus();+ }++ /** Bild der Anleitung: nur aus `.soma/help/` (so stehen sie im Text), geladen aus den Dateien der App. */+ private image(rel: string): Promise<string | null> {+ const name = rel.startsWith(`${HELP_DIR}/`) ? rel.slice(HELP_DIR.length + 1) : '';+ if (!name) return Promise.resolve(null);+ let p = this.images.get(name);+ if (!p) {+ p = this.deps.help.image(name).then((bytes) => (bytes ? URL.createObjectURL(new Blob([bytes as BlobPart], { type: 'image/png' })) : null)).catch(() => null);+ this.images.set(name, p);+ }+ return p;+ }++ /** Für die Tests: Abschnitte, gezeigter Abschnitt und wie viele Bilder geladen sind. */+ state(): { open: boolean; sections: string[]; current: string; images: number; loadedImages: number; text: string } {+ const imgs = [...this.ui.body.querySelectorAll<HTMLImageElement>('img')];+ return {+ open: this.isOpen, sections: this.sections.map((s) => s.title), current: this.sections[this.current]?.title ?? '',+ images: imgs.length, loadedImages: imgs.filter((x) => x.complete && x.naturalWidth > 0).length, text: this.ui.body.textContent ?? '',+ };+ }+}diff --git a/app/src/renderer/index.html b/app/src/renderer/index.htmlindex 0e3831f..53e4210 100644--- a/app/src/renderer/index.html+++ b/app/src/renderer/index.html@@ -46,7 +46,7 @@<span class="rail-sep"></span><button data-panel="skills" aria-pressed="false" title="Skills: rules for the agent, set per model (3D printing, tolerances …)"><i data-icon="book" data-size="20" data-stroke="1.7"></i><span>Skills</span></button><span class="grow"></span>- <button disabled title="Help is coming in a later version"><i data-icon="help" data-size="20" data-stroke="1.7"></i><span>Help</span></button>+ <button id="btn-help" title="Help: how the app works (F1)"><i data-icon="help" data-size="20" data-stroke="1.7"></i><span>Help</span></button><button id="btn-settings" title="Settings: viewer, skills, storage and version"><i data-icon="cog" data-size="20" data-stroke="1.6"></i><span>Settings</span></button></nav>@@ -487,6 +487,7 @@<div id="start" class="start" hidden><header class="top"><span class="logo"><i data-icon="logo" data-size="22" data-stroke="1.6"></i></span><b class="brand">SOMA</b><span id="start-version" class="c3 small"></span><span class="grow"></span>+ <button id="btn-start-help" class="btn" title="Help: how the app works (F1)"><i data-icon="help" data-size="15" data-stroke="1.7"></i>Help</button><button id="btn-start-settings" class="btn" title="Settings: viewer, skills, storage and version"><i data-icon="cog" data-size="15" data-stroke="1.7"></i>Settings</button><button id="btn-start-close" class="btn">Back to the model</button></header><div class="start-body">@@ -552,6 +553,18 @@</div><div id="menu-skill-name" class="menu wide st-namepop" role="dialog" aria-label="Name of the skill" hidden></div>+ <!-- Hilfe (E83): die Anleitung aus dem Skill soma-app.md, links die Abschnitte. Inhalt baut help.ts -->+ <div id="help" class="st-scrim" hidden>+ <div class="st-dlg" role="dialog" aria-modal="true" aria-labelledby="help-title">+ <header class="st-hd"><i data-icon="help" data-size="18" data-stroke="1.7"></i><b id="help-title">Help</b><span class="c3 small">How SOMA works. The agent knows this guide too: just ask it.</span><span class="grow"></span>+ <button id="btn-help-close" class="ibtn" aria-label="Close help" title="Close (Escape)"><i data-icon="x" data-size="16" data-stroke="2"></i></button></header>+ <div class="st-body">+ <nav id="help-nav" class="st-nav help-nav" aria-label="Help"></nav>+ <section id="help-body" class="st-sec help-body" aria-label="Guide"></section>+ </div>+ </div>+ </div>+<div id="toast" role="status" hidden></div></div><script src="main.js"></script>diff --git a/app/src/renderer/main.ts b/app/src/renderer/main.tsindex 41f3685..2efed30 100644--- a/app/src/renderer/main.ts+++ b/app/src/renderer/main.ts@@ -14,6 +14,7 @@ import { MAX_QUOTE } from './pdfview';import { MeasureTool } from './measuretool';import { SectionTool } from './sectiontool';import { ExplodeTool } from './explodetool';+import { HelpDialog } from './help';import { SettingsDialog } from './settings';import { AboutPage, ShortcutsPage, StoragePage, ViewerPage } from './settingspages';import { SkillsPanel } from './skills';@@ -236,6 +237,18 @@ const settings = new SettingsDialog({modelMode: async (id) => (project ? (await api.skills.list()).find((s) => s.id === id)?.mode ?? 'off' : null),pages: { viewer: viewerPage, keys: shortcutsPage, storage: storagePage, about: aboutPage },});+// Hilfe (E83): Knopf in der Leiste und auf der Startseite, F1 überall außer in den Einstellungen+const help = new HelpDialog({ root: $('help'), nav: $('help-nav'), body: $('help-body'), close: $('btn-help-close') as HTMLButtonElement, background: [$('topbar'), $('body'), $('start')] }, {+ help: api.help,+ openUrl: (href) => void api.openUrl(href).then((r) => { if (!r.ok) toast(r.error ?? `${href} could not be opened.`, 'error'); }),+});+$('btn-help').addEventListener('click', () => void help.open());+$('btn-start-help').addEventListener('click', () => void help.open());+window.addEventListener('keydown', (e) => {+ if (e.key !== 'F1' || e.ctrlKey || e.altKey || e.metaKey || settings.isOpen) return;+ e.preventDefault();+ if (help.isOpen) help.close(); else void help.open();+});$('btn-settings').addEventListener('click', () => void settings.open());$('btn-start-settings').addEventListener('click', () => void settings.open());$('btn-skills-manage').addEventListener('click', () => void settings.open());@@ -808,7 +821,7 @@ function selectionAction(a: 'hide' | 'showAll' | 'isolate' | 'ghost'): void {// Tasten für die Auswahl (wie in CAD): H ausblenden, Shift H alles einblenden, I isolieren, T transparent, Esc Auswahl aufheben.// Nicht beim Schreiben (Code, Terminal, Felder) und nicht, solange Markierung, Video, Einstellungen oder die Startseite offen sindwindow.addEventListener('keydown', (e) => {- if (!project || e.ctrlKey || e.altKey || e.metaKey || e.repeat || settings.isOpen || !$('start').hidden) return;+ if (!project || e.ctrlKey || e.altKey || e.metaKey || e.repeat || settings.isOpen || help.isOpen || !$('start').hidden) return;if ((e.target as HTMLElement | null)?.closest?.('#terminals, #code-view, input, textarea, select, [contenteditable=true]')) return;if (markup.active || !$('videoview').hidden) return;const k = e.key.toLowerCase();@@ -1129,7 +1142,7 @@ const openProject = async (id: string) => { if (await leaveEditor('Open model'))// F3 klappt den Strukturbaum auf und zu wie in CATIA (E82, Vorschlag aus dem Entwurf). Nicht beim Schreiben in Code, Terminal oder Feldernwindow.addEventListener('keydown', (e) => {- if (e.key !== 'F3' || e.ctrlKey || e.altKey || e.shiftKey || !project || settings.isOpen || !$('start').hidden) return;+ if (e.key !== 'F3' || e.ctrlKey || e.altKey || e.shiftKey || !project || settings.isOpen || help.isOpen || !$('start').hidden) return;if ((e.target as HTMLElement | null)?.closest?.('#terminals, #code-view, input, textarea, select, [contenteditable=true]')) return;e.preventDefault();tree.setOpen(!tree.isOpen);@@ -1137,8 +1150,8 @@ window.addEventListener('keydown', (e) => {// Kurzbefehle gelten nicht im Terminal: dort gehören Strg+S/Strg+O den Programmen (Claude Code nutzt Strg+O selbst)window.addEventListener('keydown', (e) => {- // Die Einstellungen liegen über allem und haben eigene Kurzbefehle (Strg+S speichert den Skill)- if (settings.isOpen || (e.target as HTMLElement | null)?.closest?.('#terminals') || !e.ctrlKey || e.altKey) return;+ // Die Einstellungen liegen über allem und haben eigene Kurzbefehle (Strg+S speichert den Skill), die Hilfe ebenso+ if (settings.isOpen || help.isOpen || (e.target as HTMLElement | null)?.closest?.('#terminals') || !e.ctrlKey || e.altKey) return;const k = e.key.toLowerCase();// Ohne offenes Modell (Startseite beim Start, E69) gibt es nur Neu und Öffnenif (!project && k !== 'n' && k !== 'o') return;@@ -1591,6 +1604,9 @@ if (api.testMode) {layout: () => ({ side: panel, code: codeOpen, agent: !$('terminals').classList.contains('collapsed') }),refreshViewLists: () => refreshViewLists(),openSkill: (id: string | null) => skills.openDetail(id),+ help: () => help.state(),+ openHelp: (title?: string) => help.open(title),+ closeHelp: () => help.close(),settings: () => settings.state(),openSettings: (id?: string) => settings.open(id),closeSettings: () => settings.close(),diff --git a/app/src/renderer/shortcuts.ts b/app/src/renderer/shortcuts.tsindex 66f5070..c74c3d0 100644--- a/app/src/renderer/shortcuts.ts+++ b/app/src/renderer/shortcuts.ts@@ -44,6 +44,7 @@ export function shortcutGroups(nav: NavPreset): ShortcutGroup[] {{ keys: ['Ctrl', '1'], what: 'Show or hide the sidebar' },{ keys: ['Ctrl', '2'], what: 'Show or hide the code' },{ keys: ['Ctrl', '3'], what: 'Expand or collapse the agent' },+ { keys: ['F1'], what: 'Help: how the app works' },],},{diff --git a/app/src/renderer/style.css b/app/src/renderer/style.cssindex ac1dc73..af6ea1e 100644--- a/app/src/renderer/style.css+++ b/app/src/renderer/style.css@@ -1030,6 +1030,16 @@ code { font-family:var(--mono); font-size:.95em; }.st-name-file { font-family:var(--mono); font-size:11.5px; }.st-name-actions { display:flex; justify-content:flex-end; gap:6px; padding:4px 10px 6px; }+/* Hilfe (E83): wie die Einstellungen, rechts die Anleitung. Bilder in voller Breite, Klick zeigt sie in Originalgröße */+#help { z-index:36; }+.help-nav button { height:auto; min-height:30px; padding-top:5px; padding-bottom:5px; line-height:1.35; }+.help-body { display:block; overflow:auto; }+.help-doc { max-width:1000px; padding:20px 30px 48px; }+.help-doc h2 { margin-top:0; }+.help-doc .md-img { display:block; margin:6px 0 4px; border:1px solid var(--line); cursor:zoom-in; }+.help-doc .md-img.full { max-width:none; cursor:zoom-out; }+.help-doc ol li::marker { color:#ffd23f; font-weight:600; }+/* Einstellungen, Reiter Viewer, Speicher und Info (E81) */.st-sec.st-page { display:block; overflow:auto; }.st-pg { max-width:800px; padding:22px 32px 40px; }diff --git a/app/src/shared/help.ts b/app/src/shared/help.tsnew file mode 100644index 0000000..67ddaf6--- /dev/null+++ b/app/src/shared/help.ts@@ -0,0 +1,39 @@+// Anleitung (E83): eine Quelle für die Hilfe der App und den Skill „Using the app“. Die Quelle ist der mitgelieferte Skill+// `resources/skills/soma-app.md`, die Bilder liegen in `resources/help/`. Der Agent bekommt den Skill wie jeden anderen+// (Kopie in `.soma/skills/`), die Bilder kopiert die App nach `.soma/help/`. Deshalb verweisen die Bilder im Text relativ+// auf `../help/<name>.png`: Von der Kopie aus stimmt das im Projekt, und die Hilfe der App löst denselben Pfad auf.+// Was nur der Agent braucht, steht zwischen `<!-- agent -->` und `<!-- /agent -->`, die Hilfe der App lässt es weg.++/** Kennung des Skills, aus dem die Hilfe stammt. */+export const HELP_SKILL = 'soma-app';+/** Ordner der Bilder im Projekt (Zwischenergebnis der App, nicht im Verlauf). */+export const HELP_DIR = '.soma/help';+/** Dateiname eines Bildes der Anleitung: nur so wird gelesen und kopiert. */+export const HELP_IMAGE = /^[a-z0-9][a-z0-9-]{0,40}\.png$/;++export interface HelpSection { title: string; text: string }++const FRONT = /^?---[ \t]*\r?\n[\s\S]*?\r?\n---[ \t]*(?:\r?\n|$)/;+const AGENT = /<!--\s*agent\s*-->[\s\S]*?<!--\s*\/agent\s*-->[ \t]*\r?\n?/g;++/**+ * Text der Anleitung für die App, je Überschrift `##` ein Abschnitt: ohne Kopf, ohne die Teile für den Agenten und ohne+ * die Hauptüberschrift (das Fenster heißt schon „Help“). Was vor dem ersten Abschnitt steht, kommt an den Anfang des ersten.+ */+export function helpSections(raw: string): HelpSection[] {+ const text = raw.replace(/\r\n?/g, '\n').replace(FRONT, '').replace(AGENT, '').replace(/^#\s+.*\n/m, '');+ const parts = text.split(/^##\s+/m);+ const intro = parts.shift()!.trim();+ const out = parts.map((p) => {+ const nl = p.indexOf('\n');+ return { title: (nl < 0 ? p : p.slice(0, nl)).trim(), text: nl < 0 ? '' : p.slice(nl + 1).trim() };+ }).filter((s) => s.title);+ if (out.length && intro) out[0].text = `${intro}\n\n${out[0].text}`;+ if (!out.length && intro) out.push({ title: 'Help', text: intro });+ return out;+}++/** Bilder, auf die die Anleitung verweist (`../help/<name>.png`), in der Reihenfolge des Textes. */+export function helpImages(raw: string): string[] {+ return [...raw.matchAll(/!\[[^\]]*\]\(\.\.\/help\/([^)\s]+)\)/g)].map((m) => m[1]);+}diff --git a/app/src/shared/types.ts b/app/src/shared/types.tsindex a1d4996..fca143e 100644--- a/app/src/shared/types.ts+++ b/app/src/shared/types.ts@@ -371,7 +371,7 @@ export interface SomaApi {};/** Nur im Testmodus (SOMA_TEST=1) vorhanden. */test?: {- answers(a: unknown[]): Promise<void>; screenshot(file: string): Promise<{ width: number; height: number }>; bridge(): Promise<Record<string, string>>; close(): Promise<void>;+ answers(a: unknown[]): Promise<void>; screenshot(file: string, rect?: { x: number; y: number; width: number; height: number }): Promise<{ width: number; height: number }>; bridge(): Promise<Record<string, string>>; close(): Promise<void>;/** Was die App in die Zwischenablage legen wollte (im Test bleibt die echte unberührt). */clipboard(): Promise<string>;};@@ -440,6 +440,8 @@ export interface SomaApi {/** Alle Werte des Nutzers entfernen: Es gelten wieder die Werte aus dem Code. */resetAll(): Promise<ParamResult>;};+ /** Anleitung (E83): Text (der mitgelieferte Skill soma-app.md, null wenn er fehlt) und ein Bild daraus nach Dateiname. */+ help: { read(): Promise<string | null>; image(name: string): Promise<Uint8Array | null> };/** Skills des offenen Modells (E17): auflisten, Stufe wählen (E55). */skills: {list(): Promise<SkillInfo[]>;diff --git a/app/test/drawing.mjs b/app/test/drawing.mjsindex 39b3433..6701e43 100644--- a/app/test/drawing.mjs+++ b/app/test/drawing.mjs@@ -224,7 +224,8 @@ print(json.dumps(dict(errors=len(aud.errors), types=types, layers=layers, detailfs.mkdirSync(path.join(proj.dir, 'drawings'), { recursive: true });fs.writeFileSync(path.join(proj.dir, 'drawings', 'bracket.py'), block + '\n');await waitFor('Modell gebaut', () => window.__t.status().state === 'ok' && window.__t.partCount() === 2, 90000).catch(() => {});- await waitFor('Speicherstand', () => !!window.__t.saveState(), 10000).catch(() => {});+ // Erst wenn der Speicherstand model.py und drawings/ zählt: Er kommt aus einer Abfrage im Takt, sonst vergleicht der Test mit einem alten Stand+ await waitFor('Speicherstand', () => (window.__t.saveState()?.dirtyFiles ?? 0) >= 2, 10000).catch(() => {});const dirty0 = (await ev(() => window.__t.saveState())).dirtyFiles;const ab = soma(proj.dir, 'drawing', 'build');check('Im Projekt der App gebaut', ab.status === 0 && fs.existsSync(path.join(proj.dir, 'output', 'drawings', 'Bracket.pdf')), (ab.stderr || ab.stdout).slice(-200));diff --git a/app/test/harness.mjs b/app/test/harness.mjsindex acde5c4..48a4d26 100644--- a/app/test/harness.mjs+++ b/app/test/harness.mjs@@ -77,8 +77,8 @@ export async function startApp({ port = Number(process.env.SOMA_TEST_PORT) || 93domClick: (id) => ev((i) => document.getElementById(i).click(), id),/** Antworten für die nächsten nativen Dialoge (Pfade, Knopf-Indizes). */answers: (list) => ev((a) => window.soma.test.answers(a), list),- /** Screenshot des Fensters (über Electron, funktioniert auch bei unsichtbarem Fenster). */- screenshot: (file) => ev((f) => window.soma.test.screenshot(f), file),+ /** Screenshot des Fensters (über Electron, funktioniert auch bei unsichtbarem Fenster), mit `rect` nur ein Ausschnitt in CSS-Pixeln. */+ screenshot: (file, rect) => ev(([f, r]) => window.soma.test.screenshot(f, r ?? undefined), [file, rect ?? null]),/** Beendet die App hart (wie ein Absturz). */crash() { clearTimeout(dog); page.close(); kill(); },async stop() { clearTimeout(dog); page.close(); kill(); await sleep(600); },diff --git a/app/test/helpshots-spec.mjs b/app/test/helpshots-spec.mjsnew file mode 100644index 0000000..681d914--- /dev/null+++ b/app/test/helpshots-spec.mjs@@ -0,0 +1,141 @@+// Bilder der Anleitung (resources/help/*.png): Ausschnitt und nummerierte Markierungen je Bild. Die Anleitung+// (resources/skills/soma-app.md) erklärt unter jedem Bild die Nummern als Liste „1. **Bezeichnung**: …“. Die Bezeichnungen+// hier und dort müssen gleich sein, test/unit.mjs prüft das. Erzeugt werden die Bilder mit `npm run help:shots`.+//+// `clip`: Selektoren, deren gemeinsamer Rahmen das Bild ist (ohne: ganzes Fenster), `pad` Rand darum in CSS-Pixeln,+// `clipWidth` und `clipHeight` ersetzen Breite oder Höhe dieses Rahmens.+// Je Markierung `sel` (ein Selektor oder mehrere, dann der gemeinsame Rahmen), `at` die Stelle der Nummer am Rahmen+// (tl, t, tr, r, br, b, bl, l, c), `box` zeichnet den Rahmen gestrichelt mit (für Bereiche statt einzelner Knöpfe).++export const SHOTS = [+ {+ file: 'window.png',+ marks: [+ { label: 'Model menu', sel: '#btn-doc', at: 'tr', box: true },+ { label: 'Build status', sel: '#build-pill', at: 'b', box: true },+ { label: 'Columns', sel: '#layout', at: 'b', box: true },+ { label: 'Export', sel: '#btn-export', at: 'b' },+ { label: 'Save', sel: '#btn-save', at: 'b' },+ { label: 'Sidebar', sel: '#rail', at: 'r', box: true },+ { label: 'Structure tree', sel: '#tree', at: 'r' },+ { label: 'Tools', sel: '#dock', at: 'b', box: true },+ { label: 'View cube', sel: '#cube', at: 'l', box: true },+ { label: 'History', sel: '#versions', at: 't', box: true },+ { label: 'Agent', sel: '#terminals', at: 'c', box: true },+ ],+ },+ {+ file: 'start.png',+ marks: [+ { label: 'New model', sel: '#start-new', at: 'tr', box: true },+ { label: 'Open', sel: '#start-open', at: 'tr', box: true },+ { label: 'Recent', sel: '#start-recent', at: 'tr', box: true },+ { label: 'Agents on this computer', sel: '.start-side .panel-card', at: 'tr', box: true },+ { label: 'Settings', sel: '#btn-start-settings', at: 'b' },+ { label: 'Back to the model', sel: '#btn-start-close', at: 'b' },+ ],+ },+ {+ file: 'agent.png',+ clip: ['#terminals', '#menu-agents'],+ clipHeight: 420,+ marks: [+ { label: 'Tabs', sel: '#term-tabs .tab', at: 'b' },+ { label: 'New tab', sel: '#btn-term-add', at: 'r' },+ { label: 'Start agent', sel: '#agent-list', at: 'r', box: true },+ { label: 'Empty terminal', sel: '#btn-term-plain', at: 'r' },+ ],+ },+ {+ file: 'viewer.png',+ clip: ['#viewer'],+ marks: [+ { label: 'Structure tree', sel: '#tree', at: 'r', box: true },+ { label: 'Hide and transparent', sel: '#tree .tr-row .tg', at: 'l' },+ { label: 'Selection card', sel: '#selcard', at: 'tr', box: true },+ { label: 'Send to agent', sel: '#btn-sel-agent', at: 'r' },+ { label: 'View cube', sel: '#cube-view', at: 'l' },+ { label: 'Fit, default view, display', sel: '#cube .vbtns', at: 'l', box: true },+ ],+ },+ {+ file: 'tools.png',+ clip: ['#viewer'],+ marks: [+ { label: 'Measure', sel: '#btn-measure', at: 'b' },+ { label: 'Section', sel: '#btn-section', at: 'b' },+ { label: 'Explode', sel: '#btn-explode', at: 'b' },+ { label: 'Mark up', sel: '#btn-mark', at: 'b' },+ { label: 'Tool card', sel: '#section-card', at: 'tr', box: true },+ ],+ },+ {+ file: 'markup.png',+ clip: ['#viewer'],+ marks: [+ { label: 'Drawing tools', sel: '#mark-tools [data-tool]', at: 'b', box: true },+ { label: 'Color', sel: '#btn-mark-color', at: 'b' },+ { label: 'Undo and delete', sel: ['#btn-mark-undo', '#btn-mark-delete'], at: 'b' },+ { label: 'Grid and blank canvas', sel: ['#btn-mark-grid', '#btn-mark-blank'], at: 'b' },+ { label: 'Cancel', sel: '#btn-mark-cancel', at: 't' },+ { label: 'Send to agent', sel: '#btn-mark-send', at: 't' },+ ],+ },+ {+ file: 'sidebar.png',+ clip: ['#rail'],+ clipWidth: 104,+ marks: [+ { label: 'Parameters', sel: '#rail [data-panel=params]', at: 'r' },+ { label: 'Files', sel: '#rail [data-panel=files]', at: 'r' },+ { label: 'Analysis', sel: '#rail [data-panel=analysis]', at: 'r' },+ { label: 'Animation', sel: '#rail [data-panel=anim]', at: 'r' },+ { label: 'Skills', sel: '#rail [data-panel=skills]', at: 'r' },+ { label: 'Help', sel: '#btn-help', at: 'r' },+ { label: 'Settings', sel: '#btn-settings', at: 'r' },+ ],+ },+ {+ file: 'code.png',+ clip: ['#side', '#editor'],+ marks: [+ { label: 'File tree', sel: '#tab-files', at: 'c', box: true },+ { label: 'Drop zone', sel: '#dropzone', at: 't' },+ { label: 'Open files', sel: '#code-tabs', at: 'r' },+ { label: 'Linked to selection', sel: '#btn-codelink', at: 'l' },+ { label: 'Editor', sel: '#code-view', at: 'c', box: true },+ ],+ },+ {+ file: 'history.png',+ clip: ['#preview-banner', '#versions'],+ pad: 14,+ marks: [+ { label: 'Timeline', sel: '#vtrack', at: 't', box: true },+ { label: 'Back to now', sel: '#btn-live', at: 't' },+ { label: 'Restore', sel: '#btn-restore', at: 't' },+ ],+ },+ {+ file: 'export.png',+ clip: ['#btn-export', '#menu-export'],+ pad: 28,+ marks: [+ { label: 'Scope', sel: '#menu-export .seg', at: 'l' },+ { label: 'Formats', sel: '#menu-export .chips', at: 'l', box: true },+ { label: 'Everything as ZIP', sel: '#exp-zip', at: 'l' },+ ],+ },+ {+ file: 'settings.png',+ clip: ['.st-dlg'],+ clipHeight: 420,+ marks: [+ { label: 'Viewer', sel: '#st-nav [data-sec=viewer]', at: 'r' },+ { label: 'Shortcuts', sel: '#st-nav [data-sec=keys]', at: 'r' },+ { label: 'Skills', sel: '#st-nav [data-sec=skills]', at: 'r' },+ { label: 'Storage', sel: '#st-nav [data-sec=storage]', at: 'r' },+ { label: 'About', sel: '#st-nav [data-sec=about]', at: 'r' },+ ],+ },+];diff --git a/app/test/helpshots.mjs b/app/test/helpshots.mjsnew file mode 100644index 0000000..4ddb72c--- /dev/null+++ b/app/test/helpshots.mjs@@ -0,0 +1,153 @@+// Erzeugt die Bilder der Anleitung (resources/help/*.png) aus der echten App: je Bild ein Zustand, darüber nummerierte+// Markierungen nach test/helpshots-spec.mjs. Aufruf: npm run help:shots (baut vorher). Nach Änderungen an der Oberfläche+// neu erzeugen und die Bilder ansehen, die Texte unter den Bildern stehen in resources/skills/soma-app.md.+// Das Fenster läuft außerhalb des Bildschirms (unsichtbare Fenster zeichnen nicht neu).+import fs from 'node:fs';+import path from 'node:path';+import { SHOTS } from './helpshots-spec.mjs';++process.env.SMOKE_VISIBLE = 'offscreen';+const { APP, cleanup, sleep, startApp } = await import('./harness.mjs');++const OUT = path.join(APP, 'resources', 'help');+const only = process.argv.slice(2);+let app;+let failed = false;++/**+ * Legt die Markierungen über das Fenster (fester Layer ganz oben) und liefert den Ausschnitt des Bildes in CSS-Pixeln.+ * Läuft im Renderer: keine Variablen von außen.+ */+function overlay(shot) {+ document.getElementById('help-marks')?.remove();+ const rectOf = (sel) => {+ const els = (Array.isArray(sel) ? sel : [sel]).flatMap((s) => {+ const all = [...document.querySelectorAll(s)].filter((e) => e.getClientRects().length);+ // Mehrere Treffer eines Selektors mit [data-tool] und Ähnlichem: alle, sonst nur der erste sichtbare+ return /\[data-tool\]|\.chips$/.test(s) ? all : all.slice(0, 1);+ });+ if (!els.length) return null;+ const rs = els.map((e) => e.getBoundingClientRect());+ const x = Math.min(...rs.map((r) => r.left)), y = Math.min(...rs.map((r) => r.top));+ return { x, y, w: Math.max(...rs.map((r) => r.right)) - x, h: Math.max(...rs.map((r) => r.bottom)) - y };+ };+ const missing = [];+ const layer = document.createElement('div');+ layer.id = 'help-marks';+ layer.style.cssText = 'position:fixed;inset:0;pointer-events:none;z-index:2147483647';+ const R = 12;+ shot.marks.forEach((m, i) => {+ const r = rectOf(m.sel);+ if (!r) { missing.push(String(m.sel)); return; }+ if (m.box) {+ const b = document.createElement('div');+ b.style.cssText = `position:absolute;left:${r.x - 3}px;top:${r.y - 3}px;width:${r.w + 6}px;height:${r.h + 6}px;border:2px dashed #ffd23f;border-radius:8px;box-sizing:border-box`;+ layer.append(b);+ }+ const at = m.at ?? 'tr';+ // Nummer neben den Rahmen, damit sie nichts verdeckt. Nur an den Ecken eines Bereichs sitzt sie auf dem Rahmen+ const out = at === 'c' || (m.box && at.length === 2) ? 0 : R + 4;+ let cx = r.x + r.w / 2, cy = r.y + r.h / 2;+ if (at.includes('l')) cx = r.x - out; if (at.includes('r')) cx = r.x + r.w + out;+ if (at.includes('t')) cy = r.y - out; if (at.includes('b')) cy = r.y + r.h + out;+ if (at === 'l' || at === 'r') cy = r.y + r.h / 2;+ if (at === 't' || at === 'b') cx = r.x + r.w / 2;+ cx = Math.max(R + 2, Math.min(innerWidth - R - 2, cx)); cy = Math.max(R + 2, Math.min(innerHeight - R - 2, cy));+ const n = document.createElement('div');+ n.textContent = String(i + 1);+ n.style.cssText = `position:absolute;left:${cx - R}px;top:${cy - R}px;width:${2 * R}px;height:${2 * R}px;border-radius:50%;background:#ffd23f;color:#111;`+ + 'font:700 13px/24px "IBM Plex Sans",sans-serif;text-align:center;box-shadow:0 0 0 2px #111,0 2px 8px rgba(0,0,0,.6)';+ layer.append(n);+ });+ document.body.append(layer);+ let clip = null;+ if (shot.clip) {+ const r = rectOf(shot.clip);+ if (!r) missing.push(`clip ${shot.clip}`);+ else {+ const pad = shot.pad ?? 0;+ const x = Math.max(0, Math.floor(r.x - pad)), y = Math.max(0, Math.floor(r.y - pad));+ const w = Math.min(innerWidth - x, Math.ceil((shot.clipWidth ?? r.w) + 2 * pad)), h = Math.min(innerHeight - y, Math.ceil((shot.clipHeight ?? r.h) + 2 * pad));+ clip = { x, y, width: w, height: h };+ }+ }+ return { missing, clip };+}++try {+ app = await startApp({ name: 'helpshots' });+ const { ev, waitFor, domClick, page } = app;+ const click = (sel) => ev((s) => document.querySelector(s).click(), sel);+ const esc = () => ev(() => document.activeElement?.dispatchEvent(new KeyboardEvent('keydown', { key: 'Escape', bubbles: true })));+ await waitFor('Projekt', () => !!window.__t && !!window.__t.project());+ await waitFor('Build', () => window.__t.status().state === 'ok' && window.__t.partCount() === 2, 120000);+ // Terminal leeren und kurzer Prompt: Der Pfad des Testordners (mit Benutzernamen) gehört nicht ins Bild+ await waitFor('Terminal', () => window.__t.terminals.activeId != null, 20000);+ await sleep(1500);+ await ev(() => window.soma.term.write(window.__t.terminals.activeId, "function prompt { 'PS> ' }; Clear-Host\r"));+ await sleep(1500);++ /** Zustand je Bild herstellen und danach wieder aufräumen. */+ const prep = {+ 'window.png': async () => {},+ 'start.png': async () => { await ev(() => window.__t.showStart(true)); await sleep(600); },+ 'agent.png': async () => { await domClick('btn-term-add'); await sleep(400); },+ 'viewer.png': async () => {+ await ev(() => window.__t.treeOpen(true));+ const pos = await ev(() => {+ const v = window.__t.viewer; const id = window.__t.parts().find((p) => p.name === 'Lid').id;+ const f = v.facesOf(id).filter((x) => x.surface === 'PLANE').sort((a, b) => b.center[2] - a.center[2])[0];+ return v.screenOf(id, f.id);+ });+ await page.click(pos.x, pos.y);+ await waitFor('Auswahl', () => window.__t.info().includes('Lid'), 10000);+ },+ 'tools.png': async () => { await domClick('btn-section'); await waitFor('Schnitt', () => !document.getElementById('section-card').hidden, 10000); },+ 'markup.png': async () => { await domClick('btn-mark'); await waitFor('Markierung', () => !document.getElementById('markup').hidden, 10000); },+ 'code.png': async () => {+ await ev(() => window.__t.showPanel('files'));+ await ev(() => window.__t.openCode('model.py'));+ await waitFor('Code', () => window.__t.codeText().includes('add_part'), 10000);+ },+ 'history.png': async () => {+ await waitFor('Verlauf', () => document.querySelectorAll('#vdots .vdot:not(.live)').length > 0, 15000);+ await click('#vdots .vdot:not(.live)');+ await waitFor('Vorschau', () => !document.getElementById('preview-banner').hidden, 30000);+ },+ 'export.png': async () => { await domClick('btn-export'); await sleep(300); },+ 'settings.png': async () => { await ev(() => window.__t.settingsShow('viewer')); await sleep(600); },+ };+ const reset = {+ 'start.png': () => ev(() => window.__t.showStart(false)),+ 'agent.png': esc,+ 'viewer.png': async () => { await domClick('btn-sel-close'); await ev(() => window.__t.treeOpen(false)); },+ 'tools.png': () => domClick('btn-section-close'),+ 'markup.png': () => domClick('btn-mark-cancel'),+ 'code.png': async () => { await ev(() => window.__t.showPanel(null)); await ev(() => window.__t.showCode(false)); },+ 'history.png': async () => { await domClick('btn-live'); await waitFor('Jetzt', () => document.getElementById('preview-banner').hidden, 30000); },+ 'export.png': esc,+ 'settings.png': () => ev(() => window.__t.closeSettings()),+ };++ fs.mkdirSync(OUT, { recursive: true });+ for (const shot of SHOTS) {+ if (only.length && !only.includes(shot.file)) continue;+ await prep[shot.file]?.();+ await sleep(900);+ const { missing, clip } = await ev(overlay, shot);+ if (missing.length) { console.log(`FEHLER ${shot.file}: nicht gefunden: ${missing.join(', ')}`); failed = true; }+ await sleep(300);+ const size = await app.screenshot(path.join(OUT, shot.file), clip ?? undefined);+ console.log(`${shot.file.padEnd(14)} ${size.width} x ${size.height}, ${shot.marks.length} Nummern`);+ await ev(() => document.getElementById('help-marks')?.remove());+ await reset[shot.file]?.();+ await sleep(400);+ }+} catch (e) {+ console.log('FEHLER', e.message);+ failed = true;+} finally {+ await app?.stop();+ if (app) cleanup(app.ud);+}+process.exit(failed ? 1 : 0);diff --git a/app/test/skills.mjs b/app/test/skills.mjsindex aaead6c..ab064ee 100644--- a/app/test/skills.mjs+++ b/app/test/skills.mjs@@ -60,13 +60,13 @@ try {/** Die beiden Listen des Abschnitts: Immer vor „Read when relevant“, Bei Bedarf danach. */const always = () => (block() ?? '').split('### Read when relevant')[0];const demand = () => (block() ?? '').split('### Read when relevant')[1] ?? '';- const DEMAND_NEW = '3d-druck,harz-pulver,cnc,laser,blech,toleranzen,verbindungen,festigkeit,baugruppen,analyse,animation,fem,zeichnung';+ const DEMAND_NEW = 'soma-app,3d-druck,harz-pulver,cnc,laser,blech,toleranzen,verbindungen,festigkeit,baugruppen,analyse,animation,fem,zeichnung';// 1) Panel: die mitgelieferten Skills nach Kategorien und `order`await ev(() => document.querySelector('#rail [data-panel="skills"]').click());await waitFor('Skills geladen', () => window.__t.skills().skills.length >= 3, 10000);let s = await st();- const ORDER = 'konstruktionsablauf,cadquery,parametrik,3d-druck,harz-pulver,cnc,laser,blech,toleranzen,verbindungen,normteile,festigkeit,baugruppen,analyse,animation,fem,zeichnung';+ const ORDER = 'konstruktionsablauf,cadquery,parametrik,soma-app,3d-druck,harz-pulver,cnc,laser,blech,toleranzen,verbindungen,normteile,festigkeit,baugruppen,analyse,animation,fem,zeichnung';const heads = await ev(() => [...document.querySelectorAll('#skills-list .sk-cat')].map((h) => h.textContent).join(','));check('Panel „Skills": Überschriften Way of working, Manufacturing, Design knowledge, Check and present, darunter die Skills nach `order`',s.skills.map((x) => x.id).join(',') === ORDER && heads === 'Way of working,Manufacturing,Design knowledge,Check and present'@@ -92,8 +92,37 @@ try {&& always().includes('- `.soma/skills/parametrik.md`: Parametric models') && !always().includes('3d-druck')&& demand().includes('- `.soma/skills/3d-druck.md`: 3D printing (FDM). Read when the parts will be 3D printed on a filament printer (FDM).')&& DEMAND_NEW.split(',').every((id) => demand().includes(`.soma/skills/${id}.md`))- && (await g('ls-files', '.soma/skills')).split('\n').length === 17+ && (await g('ls-files', '.soma/skills')).split('\n').length === 18&& (await ev(() => window.__t.saveState())).dirtyFiles === 0, `${String((await ev(() => window.__t.saveState())).dirtyFiles)} | ${String(block()).slice(0, 200)}`);+ // Anleitung (E83): Skill „Using the app“ bei Bedarf, Bilder in .soma/help/ (nicht im Verlauf), Hilfe-Fenster aus derselben Quelle+ const helpPngs = fs.readdirSync(path.join(APP, 'resources', 'help')).filter((n) => n.endsWith('.png'));+ const helpCopy = read('.soma/skills/soma-app.md') ?? '';+ check('Anleitung als Skill: Kopie mit Bildpfaden ../help/, alle Bilder in .soma/help/, nicht in Git, nichts ungespeichert',+ helpCopy.includes('](../help/window.png)') && helpCopy.includes('For the agent') && helpPngs.length >= 8+ && helpPngs.every((n) => fs.existsSync(path.join(dir, '.soma', 'help', n))) && !(await g('ls-files', '.soma/help'))+ && (await ev(() => window.__t.saveState())).dirtyFiles === 0, helpPngs.join(','));+ fs.rmSync(path.join(dir, '.soma', 'help', 'window.png'));+ await setMode('soma-app', 'always');+ check('Stufe neu gesetzt: fehlendes Bild kommt wieder', fs.existsSync(path.join(dir, '.soma', 'help', 'window.png')));+ await setMode('soma-app', 'demand');+ await domClick('btn-help');+ await waitFor('Hilfe offen', () => window.__t.help().open && window.__t.help().loadedImages > 0, 15000);+ let hs = await ev(() => window.__t.help());+ check('Help in der Leiste: Fenster mit den Abschnitten der Anleitung, Bild geladen, ohne Teile für den Agenten',+ hs.sections[0] === 'The window' && hs.sections.includes('Export') && hs.current === 'The window' && hs.images === 1 && hs.loadedImages === 1+ && hs.text.includes('Model menu') && !hs.text.includes('For the agent') && await ev(() => document.getElementById('topbar').inert), JSON.stringify(hs).slice(0, 200));+ await ev(() => document.querySelector('#help-nav button[data-help="4"]').click());+ hs = await ev(() => window.__t.help());+ check('Abschnitt wechseln: Tools mit Bild und Liste', hs.current === 'Tools' && hs.text.includes('Section') && hs.images === 1, hs.current);+ await shot('skills-0-hilfe');+ await ev(() => document.querySelector('#help-nav button[aria-current=page]').dispatchEvent(new KeyboardEvent('keydown', { key: 'Escape', bubbles: true })));+ const closed = await ev(() => !window.__t.help().open && !document.getElementById('topbar').inert);+ await ev(() => window.dispatchEvent(new KeyboardEvent('keydown', { key: 'F1', bubbles: true })));+ await waitFor('F1', () => window.__t.help().open, 5000).catch(() => {});+ hs = await ev(() => window.__t.help());+ check('Escape schließt, F1 öffnet wieder beim zuletzt gezeigten Abschnitt', closed && hs.open && hs.current === 'Tools', JSON.stringify({ closed, open: hs.open, cur: hs.current }));+ await ev(() => window.__t.closeHelp());+check('Zeile mit Stufen-Schalter, Klick auf die Zeile öffnet die Karte mit drei Stufen, die eingestellte gewählt', await ev(() => {document.querySelector('#skills-list .sk-row[data-id="3d-druck"] .sk-open').click();const row = document.querySelector('#skills-list .sk-row[data-id="3d-druck"]'); // die Liste wird neu gezeichnet@@ -346,12 +375,12 @@ try {const fdm2 = fs.readFileSync(path.join(p2.dir, '.soma', 'skills', '3d-druck.md'), 'utf8');const ka2 = fs.readFileSync(path.join(p2.dir, '.soma', 'skills', 'konstruktionsablauf.md'), 'utf8');check('Neues Modell nach der Vorgabe: immer Sauber modellieren, Parametrik, 3D-Druck, Normteile, Laser aus, Konstruktionsablauf bei Bedarf, Standardwerte statt 55° und PETG',- JSON.stringify(pj2.skills) === '["cadquery","parametrik","3d-druck","normteile"]' && pj2.skills_on_demand.join(',') === 'konstruktionsablauf,harz-pulver,cnc,blech,toleranzen,verbindungen,festigkeit,baugruppen,analyse,animation,fem,zeichnung'+ JSON.stringify(pj2.skills) === '["cadquery","parametrik","3d-druck","normteile"]' && pj2.skills_on_demand.join(',') === 'konstruktionsablauf,soma-app,harz-pulver,cnc,blech,toleranzen,verbindungen,festigkeit,baugruppen,analyse,animation,fem,zeichnung'&& !pj2.skill_settings && fdm2.includes('Overhangs up to 45°') && fdm2.includes('| Material | PLA |') && !fdm2.includes('On demand') && ka2.includes('> **On demand:**')&& !fs.existsSync(path.join(p2.dir, '.soma', 'skills', 'laser.md'))&& norm(fs.readFileSync(path.join(p2.dir, 'AGENTS.md'), 'utf8')).includes('- `.soma/skills/3d-druck.md`: 3D printing (FDM)\n'), JSON.stringify(pj2));await waitFor('Speicherstand neu', () => window.__t.saveState() && !window.__t.saveState().unsaved, 10000).catch(() => {});- check('Neues Modell: Skills im Startcommit, nichts ungespeichert', (await exec(['ls-files', '.soma/skills'], p2.dir)).stdout.trim().split('\n').length === 16+ check('Neues Modell: Skills im Startcommit, nichts ungespeichert', (await exec(['ls-files', '.soma/skills'], p2.dir)).stdout.trim().split('\n').length === 17&& (await ev(() => window.__t.saveState())).dirtyFiles === 0, String((await ev(() => window.__t.saveState())).dirtyFiles));// 11) Einstellungen (E78): eigene Skills anlegen, mitgelieferte bearbeiten und zurücksetzen, löschen, importieren@@ -370,9 +399,9 @@ try {// Beim ersten Öffnen steht das Fenster im Reiter Viewer (E81), die Skills sind ein Reiter danebenawait waitFor('Einstellungen offen', () => window.__t.settings().open && window.__t.settings().section === 'viewer', 10000);await ev(() => document.querySelector('#st-nav [data-sec="skills"]').click());- await waitFor('Reiter Skills', () => window.__t.settings().section === 'skills' && window.__t.settings().skills.length >= 17, 10000);+ await waitFor('Reiter Skills', () => window.__t.settings().section === 'skills' && window.__t.settings().skills.length >= 18, 10000);let us = await ust();- check('Einstellungen: alle mitgelieferten Skills nach Kategorien, keiner gewählt, Hintergrund gesperrt', us.skills.length === 17 && us.skills.every((s) => s.source === 'builtin') && us.selected === null+ check('Einstellungen: alle mitgelieferten Skills nach Kategorien, keiner gewählt, Hintergrund gesperrt', us.skills.length === 18 && us.skills.every((s) => s.source === 'builtin') && us.selected === null&& us.list.includes('3D printing (FDM)') && /way of working/i.test(us.list) && await ev(() => {// Echte Klicks: Das Fenster selbst darf nicht gesperrt sein, der Knopf liegt oben (Treffertest)const b = document.getElementById('btn-st-new').getBoundingClientRect();diff --git a/app/test/unit.mjs b/app/test/unit.mjsindex 7312dde..c7e5bac 100644--- a/app/test/unit.mjs+++ b/app/test/unit.mjs@@ -200,10 +200,10 @@ try {const SKD = { bundled: path.join(APP, 'resources', 'skills'), user: path.join(tmp, 'keine-eigenen-skills') };const dm = defaultModes(SKD, {});check('Neue Modelle: ohne Vorgabe des Nutzers Arbeitsweise (mit Parametrik) und Normteile immer, alle übrigen bei Bedarf', dm.always.join(',') === 'konstruktionsablauf,cadquery,parametrik,normteile'- && dm.demand.join(',') === '3d-druck,harz-pulver,cnc,laser,blech,toleranzen,verbindungen,festigkeit,baugruppen,analyse,animation,fem,zeichnung', JSON.stringify(dm));+ && dm.demand.join(',') === 'soma-app,3d-druck,harz-pulver,cnc,laser,blech,toleranzen,verbindungen,festigkeit,baugruppen,analyse,animation,fem,zeichnung', JSON.stringify(dm));const dm2 = defaultModes(SKD, { konstruktionsablauf: 'demand', toleranzen: 'always', '3d-druck': 'always', laser: 'off' });check('Neue Modelle: Vorgabe des Nutzers geht vor, in der Reihenfolge des Panels, „Aus“ fehlt ganz', dm2.always.join(',') === 'cadquery,parametrik,3d-druck,toleranzen,normteile'- && dm2.demand.join(',') === 'konstruktionsablauf,harz-pulver,cnc,blech,verbindungen,festigkeit,baugruppen,analyse,animation,fem,zeichnung', JSON.stringify(dm2));+ && dm2.demand.join(',') === 'konstruktionsablauf,soma-app,harz-pulver,cnc,blech,verbindungen,festigkeit,baugruppen,analyse,animation,fem,zeichnung', JSON.stringify(dm2));// Bei Bedarf (E55): Hinweis unter der ersten Überschrift, Werte als Standard der App, vom Nutzer gesetzte mit Namenconst rd = renderSkill(SRC, {}, 'demand');check('Bei Bedarf: Hinweis direkt unter der Überschrift, mit Leerzeilen, Werte als Standard der App, NOTES.md', rd.includes('# Skill\n\n> **On demand:**')@@ -511,6 +511,37 @@ try {const lg = Object.fromEntries(S.navLegend('soma').map((l) => [l.action, l.how]));check('Legende: erst ohne Taste, dann mit, Umschalt und Strg zusammengefasst, Zoom mit Mausrad vorn', lg.pan === 'right drag, Shift or Ctrl + left drag'&& lg.zoom === 'wheel, middle drag, Shift or Ctrl + middle drag' && S.navLegend('fusion').find((l) => l.action === 'zoom').how === 'wheel', JSON.stringify(lg));++ // Anleitung (E83): eine Quelle für Hilfe und Skill. Bilder vorhanden und benutzt, Nummern wie in test/helpshots-spec.mjs+ const hOut = path.join(tmp, 'help.mjs');+ await build({ entryPoints: [path.join(APP, 'src', 'shared', 'help.ts')], outfile: hOut, bundle: true, platform: 'node', format: 'esm', logLevel: 'silent' });+ const H = await import(pathToFileURL(hOut).href);+ const guide = fs.readFileSync(path.join(APP, 'resources', 'skills', 'soma-app.md'), 'utf8');+ const secs = H.helpSections(guide);+ check('Anleitung für die App: Abschnitte je ##, ohne Kopf, ohne Teile für den Agenten, Einleitung im ersten Abschnitt',+ secs.length >= 8 && secs[0].title === 'The window' && secs.every((s) => !/<!--|For the agent|^---/m.test(s.text)) && /AI agent/.test(secs[0].text)+ && /For the agent/.test(guide), secs.map((s) => s.title).join(', '));+ const cut = H.helpSections('---\r\ntitle: x\r\n---\r\n# T\r\n\r\nIntro\r\n<!-- agent -->\r\nnur Agent\r\n<!-- /agent -->\r\n## A\r\nText a\r\n## B\r\n');+ check('Zerlegen (auch mit CRLF): Einleitung vor A, Agent-Teil weg, leerer Abschnitt B bleibt', cut.length === 2 && cut[0].text === 'Intro\n\nText a'+ && cut[1].title === 'B' && cut[1].text === '', JSON.stringify(cut));+ const imgs = H.helpImages(guide);+ const files = fs.readdirSync(path.join(APP, 'resources', 'help')).filter((n) => n.endsWith('.png')).sort();+ check('Jedes Bild der Anleitung liegt in resources/help/, jedes dort wird benutzt, Namen erlaubt', JSON.stringify([...imgs].sort()) === JSON.stringify(files)+ && imgs.every((n) => H.HELP_IMAGE.test(n)), `${imgs.join(',')} | ${files.join(',')}`);+ const { SHOTS } = await import(pathToFileURL(path.join(APP, 'test', 'helpshots-spec.mjs')).href);+ const lists = Object.fromEntries(imgs.map((n) => {+ const after = guide.slice(guide.indexOf(`(../help/${n})`)).split(/\r?\n/).slice(1);+ const items = [];+ for (const line of after) { const m = /^(\d+)\. \*\*(.+?)\*\*/.exec(line); if (m) items.push(m[2]); else if (items.length && line.trim()) break; }+ return [n, items];+ }));+ const badShots = SHOTS.filter((s) => JSON.stringify(lists[s.file]) !== JSON.stringify(s.marks.map((m) => m.label)));+ check('Nummern der Bilder: Liste unter jedem Bild nennt dieselben Bezeichnungen in derselben Reihenfolge wie die Markierungen',+ !badShots.length && SHOTS.length === imgs.length, badShots.map((s) => `${s.file}: ${JSON.stringify(lists[s.file])}`).join(' | '));+ const SK = await import(pathToFileURL(sk).href);+ const hc = SK.checkSkillText(guide);+ check('Anleitung ist ein gültiger Skill ohne Hinweise, Bei Bedarf für neue Modelle', !hc.errors.length && !hc.warnings.length && SK.parseSkill('soma-app', guide).defaultMode === 'demand',+ [...hc.errors, ...hc.warnings].join(' | '));} catch (e) {console.log('ABBRUCH:', e.message);t.fail();