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
Entscheidung E78, Plan, Changelog und READMEs: eigene Skills
Kai-Jungsthoefel082e779d1270
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 628cc12..43e767d 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -8,6 +8,7 @@ eigenen Abschnitt mit Datum und Git-Tag.### Neu+- Eigene Skills: „Settings“ unten in der linken Leiste (bisher ausgegraut) und auf der Startseite öffnet die Einstellungen. Dort lassen sich mitgelieferte Skills ändern und eigene anlegen, duplizieren, aus Markdown-Dateien importieren und löschen. Der Editor mit Vorschau prüft beim Tippen Kopf, Einstellungen und Platzhalter. Eigene Skills gelten für alle Modelle auf diesem Rechner und werden im Panel „Skills“ ein- und ausgeschaltet wie die mitgelieferten. Geänderte mitgelieferte Skills lassen sich jederzeit zurücksetzen, Gelöschtes und Ersetztes kommt in die Sicherung (E78).- Technische Zeichnungen: Der Agent beschreibt eine Zeichnung in `drawings/*.py` (`soma.drawing`) mit Ansichten, Schnitten, Einzelheiten, Maßen, Texten und Stückliste, `soma drawing build` schreibt PDF und DXF nach `output/drawings/`, alle Blätter zusammen nach `output/drawings.pdf`, und ein Bild, mit dem der Agent sein Ergebnis prüft. Lange Teile lassen sich unterbrochen zeichnen, Schnitte auch mit geknicktem Schnittverlauf. Die Maße werden immer am Modell gemessen, eine Prüfung meldet Überschneidungen von Texten mit Kanten, Maßen und Stückliste, zu lange Einträge im Schriftfeld, Maße neben Kanten und getippte Zahlen. Dazu der Skill „Technical drawings“ mit den Regeln nach ISO (E76).- Skill „Parametric models“, bei neuen Modellen immer an: Der Agent legt erst fest, was die Größe bestimmt und was beim Ändern stehen bleibt, gibt wenige unabhängige Werte als Parameter frei, leitet den Rest daraus ab und baut das Modell an den Grenzen jedes Bereichs zur Probe. Einstellbar sind die Höchstzahl der Parameter und der Umfang dieser Prüfung (E77).@@ -19,6 +20,7 @@ eigenen Abschnitt mit Datum und Git-Tag.### Behoben+- Im Editor erschien der Kopf eines Skills (zwischen zwei `---`) fett wie eine Überschrift. Er steht jetzt gedämpft als eigener Block.- Fetter Text im Terminal (etwa Überschriften des Agenten) wirkte wackelig, runde Buchstaben saßen einen Pixel tiefer als gerade. Die App bringt jetzt den echten fetten Schnitt der Terminalschrift mit, statt das Fett nachrechnen zu lassen.- Skills und andere Markdown-Dateien mit einem Kopf zwischen zwei `---` (Front Matter) zeigten diesen Kopf in der Dokumentansicht als riesige Überschrift. Er steht jetzt klein als Quelltext oben.- Nach dem Ändern eines Parameters hielten `soma anim` und `soma render --result` Animationen und Ergebnisse noch für aktuell. Jetzt zählt `parameters.json` wie in der App zum Modell (E74).diff --git a/CLAUDE.md b/CLAUDE.mdindex fb19ee4..b45a905 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -14,7 +14,7 @@ Eine Desktop-App (Electron, TypeScript), in der ein Nutzer mit einem CLI-Agenten| Pfad | Inhalt ||---|---|-| `app/` | Electron-App. `src/main/` Hauptprozess (`projects.ts` Speichern/Öffnen/Verlauf/Export, `git.ts`, `zip.ts`, `build.ts` (mit vorgewärmtem Python-Prozess), `previews.ts`, `measure.ts`, `skills.ts`, `params.ts` (Werte des Parameter-Panels, E74), `workspace.ts`, `terminals.ts`, `packages.ts` (Projektumgebung, E67), `files.ts`, `bridge.ts` Verbindung für `soma render`, `render.ts` Render-Fenster, `animations.ts`), `src/preload/`, `src/renderer/` (`main.ts` Verdrahtung, `viewer.ts`, `viewcube.ts`, `sectiontool.ts`, `explodetool.ts`, `busy.ts`, `skills.ts`, `params.ts`, `markup.ts`, `measuretool.ts`, `parts.ts`, `code.ts`, `markdown.ts`, `filetree.ts`, `versions.ts`, `terminals.ts`, `ui.ts`, `icons.ts`, für Animation und Analyse `animtool.ts`, `animdata.ts`, `overlay.ts`, `resulttool.ts`, `resultview.ts`, `videoview.ts`, `render.ts`/`render.html` im Render-Fenster), `src/shared/types.ts` (IPC-Vertrag), `src/shared/editable.ts`, `resources/template/` (Vorlage für Nutzerprojekte inkl. `AGENTS.md`), `resources/skills/` (mitgelieferte Skills), `resources/icon.*` (App-Icon, erzeugt mit `scripts/make-icon.py`), `test/` |+| `app/` | Electron-App. `src/main/` Hauptprozess (`projects.ts` Speichern/Öffnen/Verlauf/Export, `git.ts`, `zip.ts`, `build.ts` (mit vorgewärmtem Python-Prozess), `previews.ts`, `measure.ts`, `skills.ts`, `skilllibrary.ts` (eigene Skills, E78), `params.ts` (Werte des Parameter-Panels, E74), `workspace.ts`, `terminals.ts`, `packages.ts` (Projektumgebung, E67), `files.ts`, `bridge.ts` Verbindung für `soma render`, `render.ts` Render-Fenster, `animations.ts`), `src/preload/`, `src/renderer/` (`main.ts` Verdrahtung, `viewer.ts`, `viewcube.ts`, `sectiontool.ts`, `explodetool.ts`, `busy.ts`, `skills.ts`, `settings.ts` (Einstellungen, E78), `params.ts`, `markup.ts`, `measuretool.ts`, `parts.ts`, `code.ts`, `markdown.ts`, `filetree.ts`, `versions.ts`, `terminals.ts`, `ui.ts`, `icons.ts`, für Animation und Analyse `animtool.ts`, `animdata.ts`, `overlay.ts`, `resulttool.ts`, `resultview.ts`, `videoview.ts`, `render.ts`/`render.html` im Render-Fenster), `src/shared/types.ts` (IPC-Vertrag), `src/shared/editable.ts`, `resources/template/` (Vorlage für Nutzerprojekte inkl. `AGENTS.md`), `resources/skills/` (mitgelieferte Skills), `resources/icon.*` (App-Icon, erzeugt mit `scripts/make-icon.py`), `test/` || `design/ui-entwurf-2.html` | Freigegebener Oberflächenentwurf 2 „Aufgeräumt“ (E62), im Browser öffnen, Pfeiltasten blättern. Maßstab für Aufbau, Farben und Texte der Oberfläche. Bild 6 ist das Parameter-Panel (umgesetzt mit E74, Werte des Nutzers getrennt vom Code) || `design/ui-entwurf.html` | Erster Oberflächenentwurf (E38), Farben und Bausteine gelten weiter, der Aufbau ist durch Entwurf 2 ersetzt || `design/icon-vorschlaege.html` | Die fünf Icon-Entwürfe, aus denen „Dialog“ gewählt wurde (E44). Nur noch Referenz |diff --git a/DECISIONS.md b/DECISIONS.mdindex 958b12a..58da9f2 100644--- a/DECISIONS.md+++ b/DECISIONS.md@@ -80,3 +80,4 @@| 75 | Größe der ZIP | **`renders/` kommt nicht mehr in die ZIP** (im Verlauf schon seit E64 nicht). **Vor dem Schreiben der ZIP packt die App die Git-Objekte** (`git repack`), ähnliche Fassungen von `output/model.step` werden als Unterschied gespeichert. Commits und Hashes bleiben, nichts wird gelöscht | Wunsch des Nutzers nach Prüfung zweier ZIPs (Motor 153 MB, Hotwire 12.5 MB, Code jeweils unter 100 KB): „Ja wir lassen renders aus der git repack können wir auch machen wenn das keine probleme verursacht“. Verträgt sich mit E35, weil `repack` keine Historie umschreibt. Umsetzung und Auslegungen in PLAN.md, Abschnitte 10 und 11 || 76 | Technische Zeichnungen | **Der Agent zeichnet selbst, soma liefert einen Werkzeugkasten statt automatischer Anordnung oder Bemaßung.** Eine Zeichnung ist eine Python-Datei `drawings/*.py`: Blatt mit Rahmen und Schriftfeld (abschaltbar), Ansichten aus beliebigen Formen (Bauteil, Gruppe, Zusammenbau, eigene CadQuery-Form) mit verdeckten Kanten, Schnitte, Einzelheiten, Maße an Modellpunkten mit gemessenem Wert, dazu freies Zeichnen direkt mit ezdxf. Ausgabe DXF, PDF und **ein** PNG in hoher Auflösung, Ausschnitte schneidet der Agent bei Bedarf selbst zu. `check` meldet nur. **Best Practices kommen in einen optionalen Skill** | Wunsch des Nutzers nach Brainstorming: „nicht zu viel automatisieren. Der Agent muss viel Spielraum haben … notfalls auch Sachen komplett selbst zeichnen“, dazu „auf jeden Fall einen Skill … für Best Practices“ und „ich glaube nicht, dass mehrere Exporte nötig sind“. Der erste Vorschlag (Ansichten und Maße legt soma selbst an) ist damit verworfen. Technik: verdeckte Kanten mit HLR aus OCP, DXF mit ezdxf, PDF und PNG aus derselben DXF über matplotlib, keine neuen Pakete. Umsetzung und Auslegungen in PLAN.md, Abschnitte 10 und 11 || 77 | Skill: Parametrische Modelle | **Mitgeliefert wird ein Skill „Parametric models“ (`parametrik.md`), damit Agenten mit `param()` gute parametrische Modelle bauen:** Konstruktionsabsicht zuerst, wenige unabhängige Parameter, alles Übrige abgeleitet, Bereiche, in denen jeder Wert baut, Formelemente, die Änderungen überstehen, Felder im Panel, Prüfung an den Bereichsgrenzen | Wunsch des Nutzers („ein Skill … damit die Agenten möglichst gute parametrische Modelle produzieren, mit der param() Funktion“). Ergänzt 45 und 74. Auslegung (nicht ausdrücklich bestätigt): Kategorie Arbeitsweise, ab Werk „Immer“ (jedes Modell hat Parameter, Regel 7 in `AGENTS.md`), Einstellungen Höchstzahl der Parameter und Umfang der Bereichsprüfung, Prüfung ohne neuen Befehl über eine Kopie des Projekts. Umsetzung in PLAN.md, Abschnitte 10 und 11 |+| 78 | Eigene Skills, Einstellungen | **Ein Einstellungsfenster (der bisher ausgegraute Knopf „Options“ unten in der Leiste) mit der Bibliothek der Skills: Nutzer können Skills ändern und eigene hinzufügen.** | Wunsch des Nutzers („können wir irgendwie einfügen, dass Nutzer ihre eigenen Skills einfügen können?“, „in der Settings Menü, was es noch nicht gibt. Die Option zu geben, Skills zu ändern und neue hinzuzufügen“). Ersetzt in E17 „Eigene Nutzer-Skills später“. Auslegung (nicht ausdrücklich bestätigt): Eigene Skills gelten für die ganze App und liegen in den App-Daten, ein geänderter mitgelieferter Skill ist eine eigene Fassung mit derselben Kennung (die mitgelieferte bleibt und kommt mit „Reset“ zurück), Modelle behalten ihre Kopien. Umsetzung und Auslegungen in PLAN.md, Abschnitte 10 und 11 |diff --git a/PLAN.md b/PLAN.mdindex c4bd94d..cd45215 100644--- a/PLAN.md+++ b/PLAN.md@@ -118,7 +118,7 @@ Das Paket `soma` liegt in der mitgelieferten **Basisumgebung**, nicht im Projekt- **Terminal (E19):** Freies Terminal mit mehreren Tabs im Projektordner. Startbuttons für erkannte Agenten. Der zuletzt benutzte Agent startet beim Öffnen automatisch, **ohne Resume**. Der Nutzer installiert den Agenten selbst, die App hilft mit Erkennung und Hinweisen (E4).- **`AGENTS.md` (E18):** Ganz app-verwaltet, Notizen stehen getrennt in `NOTES.md`. Beim Öffnen eines Projekts mit älterer Regelversion wird sie erneuert, dem Nutzer angezeigt und als Commit gesichert (E36). Der Verweis auf die Notizen steht ganz oben.-- **Skills (E17, E55):** Markdown-Regeln (z. B. 3D-Druck, Toleranzen, CNC-Fräsen), je Modell in drei Stufen: Aus, Bei Bedarf (der Agent liest sie, wenn das Thema aufkommt) und Immer. Eingeschaltete Skills liegen in `.soma/skills/` und stehen mit vollem Pfad in `AGENTS.md`, „Bei Bedarf“ mit Anlass. Zunächst nur mitgelieferte, eigene Nutzer-Skills später.+- **Skills (E17, E55):** Markdown-Regeln (z. B. 3D-Druck, Toleranzen, CNC-Fräsen), je Modell in drei Stufen: Aus, Bei Bedarf (der Agent liest sie, wenn das Thema aufkommt) und Immer. Eingeschaltete Skills liegen in `.soma/skills/` und stehen mit vollem Pfad in `AGENTS.md`, „Bei Bedarf“ mit Anlass. Mitgelieferte und eigene des Nutzers, angelegt und geändert in den Einstellungen (E78).- **Rückmeldung an den Agenten (E11):** Markierungen (Viewer-Bild oder leere Fläche mit Zeichnung) landen als PNG in `.soma/feedback/`, Auswahlen (Bauteilname, Datei, Zeilen, Fläche) und Build-Fehler gehen als Text. Die App fügt Pfad oder Text in die Eingabezeile des Terminals ein, der Nutzer schickt selbst ab. Später kommt ein MCP-Server der App dazu.- **Bilder und Videos für den Agenten (E58):** `soma render` schickt den Auftrag über eine lokale Verbindung an die App (HTTP nur auf 127.0.0.1, freier Port, Schlüssel je App-Start, beides als `SOMA_APP` und `SOMA_APP_TOKEN` in den Terminals der App). Ein unsichtbares Fenster rendert mit demselben Viewer, der Agent öffnet die PNG-Dateien. Videos kann er nicht ansehen, zu jedem Video entsteht deshalb eine Übersicht mit Standbildern und Zeiten. Dieselbe Verbindung kann später den MCP-Server tragen.@@ -478,9 +478,21 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- **Für den Agenten:** Skill „Technical drawings“ (`zeichnung.md`, Prüfen und Zeigen, bei Bedarf) mit Best Practices nach ISO 128, 129, 5455, 5456, 7200 und den Werkzeugen, Einstellungen Norm, Blattgröße, Allgemeintoleranz und Sprache. `AGENTS.md` nennt `drawings/` und den Befehl. Der Nutzer öffnet die PDF in der vorhandenen PDF-Ansicht und kann Seiten markieren.- **Grenzen:** Ein Agent-Test (Claude Code, ein Blatt). Text steht in der PDF als Pfad, „Zitat an Agent“ geht dort nicht. Keine automatische Stückliste (Daten muss der Agent zusammenstellen), keine Gewindedarstellung nach ISO 6410 (Normteile haben kein Gewinde), keine Rasterfelder am Rahmen, kein Eintrag im Umschalter des Viewers. Gedrehte Schnitte (Schnittverlauf mit schrägem Abschnitt) werden nicht in die Ebene geklappt, ihre schrägen Flächen bleiben ohne Schraffur. Die Projektion großer Baugruppen ist ungetestet. Getestet unter Windows.+*Eigene Skills und Einstellungen (E78, Wunsch des Nutzers; Prüfungen in `app/test/skills.mjs` und `unit.mjs`):*++- **Einstellungen:** Der bisher ausgegraute Knopf unten in der Leiste heißt jetzt „Settings“ und öffnet ein Fenster über der App, auch von der Startseite aus (Knopf in ihrer Kopfzeile). Links die Bereiche, bisher nur „Skills“. Dahinter ist die App gesperrt (`inert`), Escape schließt, bei Ungespeichertem mit Rückfrage (Save, Discard, Cancel).+- **Bibliothek:** mitgelieferte Skills (`resources/skills/`) und eigene in den App-Daten (`<App-Daten>/skills/`, unter Windows `%LOCALAPPDATA%\soma\skills`). Eine eigene Datei mit der Kennung eines mitgelieferten ersetzt diesen („Edited“), die mitgelieferte bleibt unangetastet. Was bisher nur für mitgelieferte galt (Panel, Stufen, Einstellungen mit `{{name}}`, Stufe für neue Modelle über `default:`), gilt für alle Skills der Bibliothek (`librarySkills` in `skills.ts`, Verwaltung in `skilllibrary.ts`).+- **Bereich „Skills“:** Liste nach Kategorien mit den Abzeichen „Edited“ und „Yours“, rechts der Text im Markdown-Editor (CodeMirror wie im Code-Panel), Vorschau als Dokument und bei bearbeiteten die mitgelieferte Fassung zum Vergleich (nur lesbar). Speichern mit Knopf oder Strg+S, „Discard“ verwirft. Die Stufe für neue Modelle steht im Kopf. „New skill“ fragt in einem Popover nach dem Namen und zeigt den Dateinamen vorab (Kennung aus dem Namen, Umlaute umschrieben, bei Gleichheit `-2`), die Vorlage erklärt den Kopf in Kommentarzeilen mit `#`. „Duplicate“ legt eine Kopie unter neuem Namen an (Titel, Name und erste Überschrift angepasst). „Import …“ übernimmt Markdown-Dateien, bei gleicher Kennung mit Rückfrage (ersetzen, als Kopie, überspringen). Der Ordner-Knopf öffnet den Ordner der eigenen Skills.+- **Prüfung beim Tippen (meldet nur, E28):** Leer oder über 256 KB verhindert das Speichern. Sonst Hinweise: kein Kopf, Kopf ohne Ende, unbekannte Schlüssel (etwa `Title:`), Zeilen, die keine Einstellung sind, Standardwert außerhalb des Bereichs, Platzhalter ohne Einstellung, ungenutzte Einstellung, unbekannte Stufe, fehlende `summary`, `category` oder `when`, kein Titel, kein Inhalt. Alle mitgelieferten Skills bestehen ohne Hinweis. Dateien im eigenen Ordner, die die App nicht liest (Großbuchstaben oder Leerzeichen im Namen, zu groß), stehen mit Grund und Vorschlag unter der Liste.+- **Nichts still überschreiben:** Löschen eines eigenen und Zurücksetzen eines bearbeiteten Skills nach Rückfrage, die Datei kommt nach `workspace-backups/skills-library/`. Ebenso eine Fassung, die außerhalb der App geändert wurde, während der Skill im Editor offen war, und eine beim Import ersetzte. Gleicht der gespeicherte Text der mitgelieferten Fassung, fällt die eigene Datei weg (gesichert).+- **Neuere App:** `state.json` merkt sich je bearbeitetem Skill einen Fingerabdruck der mitgelieferten Fassung, auf der er beruht (`skill_bases`). Bringt eine neuere App eine andere mit, zeigen Liste (gelber Punkt) und Editor einen Hinweis. Erneutes Speichern übernimmt den neuen Fingerabdruck.+- **Modelle:** Die Kopien in `.soma/skills/` bleiben, wie sie sind. Hat das offene Modell den Skill eingeschaltet, sagt das die Meldung nach dem Speichern, das Panel zeigt „The copy differs from the current version“, Aus und wieder Ein übernimmt die neue Fassung (die alte Kopie kommt in die Sicherung). Ein gelöschter eigener Skill bleibt in Modellen, die ihn nutzen, das Panel meldet, dass es ihn nicht mehr gibt. Die Karte im Panel nennt die Herkunft und hat „Edit“, der Stift oben im Panel öffnet die Einstellungen.+- **Editor:** Der Kopf zwischen zwei `---` ist im Markdown-Editor ein eigener, gedämpfter Block (vorher las der Parser ihn als Überschrift und zeigte ihn fett), auch im Code-Panel.+- **Grenzen:** Eigene Skills liegen nur auf diesem Rechner, über ein Modell wandert nur die Kopie, nicht zurück in die Bibliothek. Die Kennung lässt sich nicht umbenennen, einen Export gibt es nicht (der Ordner-Knopf zeigt die Datei). Getestet unter Windows.+*Offen in Phase 1:* Auto-Start des Agenten ohne Resume, Agent-Test mit weiteren Agenten und längeren Sitzungen, Bündelung von Python und Installer, macOS und Linux.-**Danach:** Zukaufteile wie NEMA-17-Motoren und V-Slot-Profile (E48, Wunsch des Nutzers), Versions-Schieber, `soma check` und Projekt-Check, MCP-Server. **Später:** Volumen/Gewicht, Versionsvergleich, eigene Nutzer-Skills, maßhaltiger Sketcher (nur bei Bedarf).+**Danach:** Zukaufteile wie NEMA-17-Motoren und V-Slot-Profile (E48, Wunsch des Nutzers), Versions-Schieber, `soma check` und Projekt-Check, MCP-Server. **Später:** Volumen/Gewicht, Versionsvergleich, weitere Bereiche der Einstellungen, maßhaltiger Sketcher (nur bei Bedarf).## 11. Offene Punkte@@ -533,7 +545,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- Dateibaum, Löschen: nur in den Papierkorb, nie endgültig. Klappt der Papierkorb nicht, bleibt die Datei und es kommt eine Meldung. Umbenennen und Löschen werden abgelehnt, solange die Datei (oder eine im Ordner) im Editor ungespeichert ist. Offene Reiter ziehen beim Umbenennen mit- Dateibaum, Öffnen: „Mit Standardprogramm öffnen“ lehnt Ausführbares ab (`.exe`, `.bat`, `.ps1`, `.js`, `.py`, `.lnk` …), weil der Arbeitsordner nicht vertrauenswürdig ist. Klick auf ein Bild öffnet es zum Markieren (E52), das Bildprogramm des Systems über Rechtsklick „Mit Standardprogramm öffnen“. „Pfad an Agent geben“ fügt `[Datei: <Pfad>] ` ein- Dateibaum, Symbole: nur die Form unterscheidet die Typen, nicht die Farbe (Farben haben feste Bedeutungen)-- Dateibaum, Skills (Wunsch des Nutzers, sie dort zu sehen): Gruppe „Skills“ unter den Markierungen, anfangs eingeklappt (ein neues Modell hat 17 Kopien). Die Zeilen zeigen die Dateinamen (`3d-druck.md`), nicht die englischen Titel aus dem Panel. Eigene Skills lassen sich dort nicht anlegen+- Dateibaum, Skills (Wunsch des Nutzers, sie dort zu sehen): Gruppe „Skills“ unter den Markierungen, anfangs eingeklappt (ein neues Modell hat 17 Kopien). Die Zeilen zeigen die Dateinamen (`3d-druck.md`), nicht die englischen Titel aus dem Panel. Eigene Skills lassen sich dort nicht anlegen (dafür die Einstellungen, E78)- Einfügen in den Agenten (Auswahl, Markierung, Build-Fehler, Pfad): immer ins aktive Terminal. Ist es beendet, ins zuletzt benutzte, das noch läuft (es kommt nach vorn). Nur wenn keines mehr läuft, kommt der Hinweis auf „+“- Bilder markieren (E50): Ränder um das eingepasste Bild in der Farbe der leeren Fläche. Stand und Schnitt des Viewers stehen dann nicht im eingefügten Text- Markdown (E51): Ansicht und Editor zum Umschalten statt WYSIWYG-Bearbeitung (der Quelltext bleibt so, wie der Agent ihn schreibt). Gerendert mit `marked` (MIT) direkt in DOM-Knoten, ohne `innerHTML`. HTML in der Datei wird nicht ausgeführt: Blöcke erscheinen als Quelltext, Tags im Text fallen weg (außer `<br>`). Bilder nur aus dem Projekt, Web-Bilder werden nicht geladen. Links öffnen nur `http`, `https` und `mailto` im Browser. Auch nur lesbare Dateien (`AGENTS.md`, Skills) erscheinen als Dokument, ihre Kästchen sind gesperrt. Ein Kopf zwischen zwei `---` ganz am Anfang (Front Matter der Skills) steht gedämpft als Quelltext vorn, nicht als Tabelle@@ -562,7 +574,8 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- Skills, 3D-Druck: Die Überhangsuche im Skill prüft nur ebene Flächen. Gekrümmte Flächen (waagerechte Bohrungen, Rundungen unten) prüft der Agent im Viewer- Skills: Die Kopie im Projekt bleibt beim Update der App, wie sie ist (gilt für das Modell, wandert mit). Aus- und Einschalten übernimmt die neue Fassung, die alte kommt in die Sicherung. Einen eigenen Knopf „Aktualisieren“ gibt es nicht- Skills: Nach dem Umstellen fügt die App nichts von selbst in die Eingabe des Agenten ein, nur auf „An Agent geben“-- Skill-Einstellungen: nur Zahlen mit Bereich und Auswahllisten, kein freier Text. Einstellbar nur mitgelieferte Skills (nur sie haben den Text mit Platzhaltern). Die Werte gelten je Modell, es gibt keine App-weiten Vorgaben (etwa „mein Drucker“). Welche Werte es gibt und ihre Bereiche sind Entwürfe+- Skill-Einstellungen: nur Zahlen mit Bereich und Auswahllisten, kein freier Text. Einstellbar nur Skills der Bibliothek, mitgelieferte und eigene (E78), nicht solche, die nur im Projekt liegen (nur die Bibliothek hat den Text mit Platzhaltern). Die Werte gelten je Modell, es gibt keine App-weiten Vorgaben (etwa „mein Drucker“). Welche Werte es gibt und ihre Bereiche sind Entwürfe+- Eigene Skills (E78): gelten für die ganze App und liegen in den App-Daten, nicht je Modell und nicht zwischen Rechnern abgeglichen. Einen mitgelieferten zu ändern legt eine eigene Fassung mit derselben Kennung an, die ihn überall ersetzt, auch in neuen Modellen. Der Knopf heißt „Settings“ (Wort des Nutzers) statt „Options“ aus dem Entwurf. Fenster über der App statt einer eigenen Seite, links Bereiche (bisher nur Skills). Kennung aus dem Namen beim Anlegen, danach fest. Die Vorlage steht in der Kategorie „My skills“ auf „Bei Bedarf“. Speichern ändert keine Modelle (wie ein Update der App), Aus und wieder Ein übernimmt die neue Fassung, einen Knopf „Aktualisieren“ gibt es weiter nicht. Nur leer und zu groß verhindern das Speichern. Kommentarzeilen mit `#` im Kopf übergeht die App. Ein gelöschter eigener Skill bleibt als Eintrag in `skill_defaults`, wenn dort eine Stufe stand (ohne Wirkung)- Normteile (E48): Schnittstelle auf Englisch (`Screw`, `Nut`, `Washer`, `HeatSetInsert`) wie der Rest von `soma`, Fehlermeldungen seit E73 ebenfalls englisch. Lage über Auflagepunkt und Richtung ins Material. Senkung = Kopf plus Spiel des gewählten Durchgangslochs, Tiefe genau die Kopfhöhe (nicht DIN 974, der Skill „Toleranzen“ nennt für Zylinderköpfe etwas größere Senkungen, mit `recess=` einstellbar). Kernloch aus der Spalte „Soft“ (Regelwerte). Einsätze: Standard ruthex, Bohrung 1 mm tiefer als der Einsatz. Farben Stahlgrau und Messing- Normteile: Alte DIN-Namen (DIN 912, DIN 933 …) sind ein Fehler mit Hinweis auf die ISO-Norm, weil manche Maße abweichen. Nur Regelgewinde. Muttern haben eine Bohrung im Nenndurchmesser (sie berühren den Schaft, überschneiden ihn nicht). Ein Einsatz ist dicker als seine Bohrung, Kollisionsprüfungen mit seinem Teil lässt der Agent aus (steht im Skill „Normteile“)- Rolle `hardware` (E48): Zukaufteile haben keinen eigenen Abschnitt im Bauteilbaum, sie unterscheiden sich durch Farbe und den Zusatz „(Zukaufteil)“ in der Auswahl. `soma export --all` nennt die Zahl der übersprungenen Teilediff --git a/README.md b/README.mdindex 2f80afd..e4c6d61 100644--- a/README.md+++ b/README.md@@ -50,7 +50,7 @@ Any CLI agent that can read files and run commands works: Claude Code, OpenCode,- Send a selection, a measurement or a section to the agent with one click- Draw on the 3D view, or drop in a photo of a hand sketch and draw on that, then hand the image to the agent- `soma render` lets the agent look at its own work as images or contact sheets-- Skills: optional rule sets per model (3D printing, CNC, sheet metal, tolerances, joints, FEM …), switched on always or on demand+- Skills: optional rule sets per model (3D printing, CNC, sheet metal, tolerances, joints, FEM …), switched on always or on demand. Edit them or add your own in the settings**Project**- A model is a single ZIP file with code, result and historydiff --git a/app/README.md b/app/README.mdindex d035310..aea3cf5 100644--- a/app/README.md+++ b/app/README.md@@ -44,11 +44,11 @@ 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` (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` (Stufen der Skills: Kopie nach `.soma/skills/`, bei Bedarf mit Hinweis, zwei Listen in `AGENTS.md`, Sicherung abweichender Kopien), `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), `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` (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), `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), `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, Umschalter oben links im Viewer, Menüs, Auswahl, Export, Übergabe an den Agenten auch per Ziehen ins Terminal, Startseite), `viewer.ts` (three.js, Klick auf Code, Ansichten, Drehpunkt, 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), `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), `parts.ts` (Bauteilbaum in der Seitenleiste mit Gruppen, Auge und Transparenz, Zeilen lassen sich ins Terminal ziehen), `code.ts` (Code-Spalte mit Editor: CodeMirror 6, Speichern auf Wunsch, Abgleich mit Änderungen des Agenten, Konflikte, Umschalter für Markdown), `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, Umschalter oben links im Viewer, Menüs, Auswahl, Export, Übergabe an den Agenten auch per Ziehen ins Terminal, Startseite), `viewer.ts` (three.js, Klick auf Code, Ansichten, Drehpunkt, 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, Bereich „Skills“ mit Liste, Markdown-Editor, Vorschau und Prüfung beim Tippen, E78), `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), `parts.ts` (Bauteilbaum in der Seitenleiste mit Gruppen, Auge und Transparenz, Zeilen lassen sich ins Terminal ziehen), `code.ts` (Code-Spalte mit Editor: CodeMirror 6, Speichern auf Wunsch, Abgleich mit Änderungen des Agenten, Konflikte, Umschalter für Markdown), `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` (Karte „Animation“, gewählt im Umschalter oben links), `overlay.ts` (Untertitel, Beschriftungen, Legende auf einer 2D-Fläche, im Viewer wie im Video), `resultview.ts` und `resulttool.ts` (Ergebnisse farbig, Karte „Analyse“), `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) |+| `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 || `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/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) |@@ -57,4 +57,4 @@ node test/run-all.mjs smoke editor # nur diese, nach npm run build## Noch nicht enthalten (siehe PLAN.md, Abschnitt 10)-Panel „Pakete“, Hilfe und Optionen (die Knöpfe stehen schon ausgegraut da), Varianten und abgeleitete Werte im Parameter-Panel, eigene Skills, Auto-Start des Agenten, `soma check`, Bündelung von Python und Installer, macOS und Linux (nur Windows getestet).+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).