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 E73, Plan, CLAUDE.md, Changelog und README: App auf Englisch
Kai-Jungsthoefel634a762d2147
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 059e49e..f6b72a3 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -12,6 +12,10 @@ eigenen Abschnitt mit Datum und Git-Tag.- README auf Englisch mit Bildern für die Startseite des Repos, dazu dieser Changelog (E70).- Lizenz: GPL-3.0 oder später, Text in `LICENSE` (E71). Die Modelle der Nutzer sind davon frei (`MODEL-EXCEPTION.md`, E72).+### Geändert++- Die App ist jetzt auf Englisch: Oberfläche, Meldungen, Ausgaben und Fehlermeldungen von `soma`, Skills und die Notizen an den Agenten. Zahlen stehen mit Dezimalpunkt. Ältere Modelle öffnen wie bisher (E73).+## [0.1.0] - 2026-10-08Erste Version mit Nummer. Sie fasst den Stand des Prototyps zusammen.diff --git a/CLAUDE.md b/CLAUDE.mdindex fbb8076..f8ab221 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -49,7 +49,7 @@ node test/run-all.mjs smoke editor # einzelne Suiten parallel, nach npm run bu- **Git in Nutzerprojekten nur vorwärts (E35):** neue Commits, kein Reset, Checkout, Rebase oder Branch. Schreibende Git-Aufrufe der App laufen über `GitRepo` nacheinander.- **Renderer ohne Node-Zugriff:** Alles geht über `preload.ts` und die Typen in `src/shared/types.ts`. Dateizugriffe nur über `resolveInside`. Texte aus dem Projekt nie per `innerHTML`.- **STEP-Namen nur ASCII** (`ascii_name`), Anzeigenamen stehen in `model.map.json`. `output/` zählt nicht als ungespeicherte Änderung, weil STEP-Dateien nicht byte-stabil sind.-- **Sprache:** Oberfläche, Doku, Code-Kommentare und Commit-Nachrichten auf Deutsch. `AGENTS.md` und `model.py` der Vorlage auf Englisch (Agenten folgen englischen Anweisungen zuverlässiger). `README.md` im Hauptordner auf Englisch (Startseite des GitHub-Repos, E70): schlicht und knapp, ohne Emojis, Bilder in `docs/images/`.+- **Sprache:** Die App ist auf Englisch (E73): Oberfläche, Meldungen, Dialoge, Ausgaben und Fehlermeldungen von `soma`, Docstrings der öffentlichen API, Skills samt Kopf, Übergabe-Notizen an den Agenten, `AGENTS.md` und `model.py` der Vorlage. Zahlen mit Dezimalpunkt. Doku, Code-Kommentare, Commit-Nachrichten und Testbeschreibungen auf Deutsch. Was die App aus älteren Projekten wiedererkennt (Commit-Betreffe, Trailer), erkennt sie auch in der alten deutschen Form. `README.md` im Hauptordner auf Englisch (Startseite des GitHub-Repos, E70): schlicht und knapp, ohne Emojis, Bilder in `docs/images/`.- Kommentare erklären das Warum, im Stil des umgebenden Codes.## Testsdiff --git a/DECISIONS.md b/DECISIONS.mdindex ef8cd86..b43e654 100644--- a/DECISIONS.md+++ b/DECISIONS.md@@ -75,3 +75,4 @@| 70 | Changelog und README | **SOMA führt einen Changelog** (`CHANGELOG.md`, Aufbau nach Keep a Changelog, auf Deutsch), jede Version bekommt ein Git-Tag (`v0.1.0` gesetzt). **Die README im Hauptordner ist auf Englisch** und stellt das Projekt vor: Ziel (agentisches Arbeiten in parametrischem CAD ohne überladene Software für Menschen), Bilder, Funktionen, freie Wahl des CLI-Agenten. Schlicht, knapp, ohne Emojis | Wunsch des Nutzers. Ausnahme von der Sprachregel (Doku auf Deutsch) nur für die README, weil sie die Startseite des GitHub-Repos ist. Die Lizenz folgt als eigener Schritt. Die Bilder zeigen das Hotwire-Modell des Nutzers, aufgenommen mit der App || 71 | Lizenz | **SOMA steht unter der GPL-3.0** (`GPL-3.0-or-later`, Text in `LICENSE`). Weiterentwicklungen, die jemand weitergibt, müssen offen bleiben, ein geschlossenes Produkt aus SOMA ist nicht möglich | Entscheidung des Nutzers nach Vergleich von MIT, Apache-2.0, MPL-2.0, GPL-3.0 und AGPL-3.0. Präzisiert 30 (dort war MIT oder Apache-2.0 naheliegend). Damit passt gmsh (GPL-2.0 oder später) ohne Weiteres in die Auslieferung. „oder später“ ist die Empfehlung der FSF und nicht ausdrücklich bestätigt. Offen: Lizenzhinweise der mitgelieferten Komponenten, Rechte an den Modellen der Nutzer (siehe PLAN.md Abschnitt 11) || 72 | Modelle der Nutzer | **Modelle gehören den Nutzern:** Eine zusätzliche Erlaubnis nach Abschnitt 7 der GPL (`MODEL-EXCEPTION.md`) erlaubt, Modelle (`model.py`, `parts/`, Animationen, Lastfälle, `inputs/`) frei zu lizenzieren, auch wenn sie `soma` importieren. Dasselbe gilt für die Dateien, die die App ins Modell kopiert (Vorlage, `AGENTS.md`, Skills), innerhalb eines Modellprojekts. SOMA selbst bleibt voll unter der GPL | Zustimmung des Nutzers zum Vorschlag aus E71. Erzeugte Dateien (STEP, STL, Bilder) betrifft die GPL ohnehin nicht, die Ausnahme sagt das ausdrücklich. Eigene Datei statt Zusatz in `LICENSE`, damit GitHub die GPL weiter erkennt. Text auf Englisch wie die GPL |+| 73 | App auf Englisch | **Die App ist komplett auf Englisch:** Oberfläche, Meldungen und Dialoge, Ausgaben und Fehlermeldungen von `soma`, Docstrings der öffentlichen API, Skills samt Titel, Beschreibung und Einstellungen, die Notizen an den Agenten (`[Markup: …]`, `[Selection: …]` …). Zahlen stehen mit Dezimalpunkt | Wunsch des Nutzers („Lass uns die App komplett auf englisch übersetzen“). Ersetzt die Sprachregel „Oberfläche deutsch“ (PLAN.md Abschnitt 11) und in E48 „Fehlermeldungen deutsch“. Auslegung (nicht ausdrücklich bestätigt): nur Englisch, keine Umschaltung. Deutsch bleiben Doku, Code-Kommentare, Commit-Nachrichten und Changelog. IDs und Dateinamen der Skills bleiben (`3d-druck.md`). Ältere Projekte (deutsche Commit-Betreffe und Trailer der App) werden weiter erkannt. Umsetzung in PLAN.md Abschnitt 10 |diff --git a/PLAN.md b/PLAN.mdindex ba5a285..495eef6 100644--- a/PLAN.md+++ b/PLAN.md@@ -216,7 +216,7 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben- **Viewer:** schwebende Bauteilkarte mit Auge, Suche, Referenzen-Abschnitt und Kontextmenü (Isolieren, Ausblenden, Kamera, Code zeigen, An Agent geben, Exportieren). Auswahlkarte mit Flächenart und Codeausschnitt. Fehlerkarte mit Meldung, Codezeile und Ablauf, das Modell bleibt gedimmt sichtbar. Ansichtswürfel (Oben, Vorne, Rechts), Einpassen, Standardansicht, Darstellungsmenü.- **Export (E34):** Menü mit allen 12 Formaten, für alle Bauteile oder die Auswahl, über `soma export` nach `exports/`.- **Dateien und Code:** Dateibaum mit eingeklappten App-Dateien und Symbolen je Dateityp. Dateien und Ordner, die man ins Fenster zieht, landen in `inputs/`, Vorhandenes wird nie überschrieben (E33). Rechtsklick: Öffnen, Mit Standardprogramm öffnen, Im Explorer zeigen, Pfad an Agent geben, Pfad kopieren, Neue Datei, Neuer Ordner, Umbenennen (F2, direkt in der Zeile), Löschen (Entf, mit Rückfrage in den Papierkorb). Neue Datei und neuer Ordner auch oben im Panel. Markierungen aus `.soma/feedback/` stehen als eigene Gruppe „Markierungen“ im Baum, neueste zuerst. Code-Panel zum Lesen mit Hervorhebung, der Auswahl im Viewer folgend.-- **Verlauf:** Punkte unterscheiden Stände der App (Commit-Trailer `Erstellt-von: SOMA`) und des Agenten, der gespeicherte Stand ist grün, die Vorschau violett mit Rahmen um den Viewer.+- **Verlauf:** Punkte unterscheiden Stände der App (Commit-Trailer `Created-by: SOMA`, bis E73 `Erstellt-von: SOMA`) und des Agenten, der gespeicherte Stand ist grün, die Vorschau violett mit Rahmen um den Viewer.- **Agent-Bereich:** Tabs mit Laufanzeige, „+“ startet erkannte Agenten oder ein leeres Terminal, einklappbar. Die Übergabeleiste fügt Text in die Eingabe ein (als Einfügen, ohne Enter, E11).- **Startseite** bei jedem Start (E69) und über das Logo: Neu, Öffnen, zuletzt geöffnete Modelle mit Vorschaubild, erkannte Agenten, Hinweis auf die Rechte des Agenten (E29).- **Schrift:** IBM Plex Sans und Mono liegen lokal bei (SIL Open Font License).@@ -299,7 +299,7 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben*Skills (E17, E46, E55; 47 Prüfungen in `app/test/skills.mjs`, 14 Einheitentests):*-- **Panel „Skills“** in der Leiste links: die mitgelieferten Skills mit Kurzbeschreibung, Umschalter für die Stufe und aufklappbar den Themen. Mitgeliefert sind 14 Skills in `app/resources/skills/` (siehe „Skill-Inhalte“ unten, zwei kamen mit E58 dazu). Der Inhalt ist für den Agenten auf Englisch, Titel, Beschreibung und Themen für die Oberfläche auf Deutsch (im Kopf der Datei). Die CadQuery-Befehle darin (Kollisionsprüfung, Abstand, Senkungen) sind gegen die Basisumgebung geprüft.+- **Panel „Skills“** in der Leiste links: die mitgelieferten Skills mit Kurzbeschreibung, Umschalter für die Stufe und aufklappbar den Themen. Mitgeliefert sind 14 Skills in `app/resources/skills/` (siehe „Skill-Inhalte“ unten, zwei kamen mit E58 dazu). Inhalt und Kopf (Titel, Beschreibung, Themen, Einstellungen für die Oberfläche) sind auf Englisch, der Kopf war bis E73 deutsch. Die CadQuery-Befehle darin (Kollisionsprüfung, Abstand, Senkungen) sind gegen die Basisumgebung geprüft.- **Stufen (E55, Wunsch des Nutzers):** Jeder Skill steht je Modell auf **Aus**, **Bei Bedarf** oder **Immer** (Umschalter mit drei Feldern in der Karte, „Immer“ hebt die Karte orange hervor, „Aus“ nimmt sie zurück). Bei Bedarf und Immer kopieren den Skill nach `.soma/skills/<id>.md`, tragen ihn in `project.json` ein (`skills` für Immer wie bisher, `skills_on_demand` für Bei Bedarf, auch in der App-Kopie, E27) und listen ihn im Abschnitt am Ende der `AGENTS.md` (zwischen `<!-- soma:skills -->` und `<!-- /soma:skills -->`, bei älteren Projekten ohne diesen Abschnitt wird er angehängt). Der Abschnitt hat zwei Listen: „Always follow“ (vor jeder Änderung lesen und befolgen) und „Read when relevant“ (je Skill der Anlass aus dem neuen Kopffeld `when`, etwa „Read when the parts will be 3D printed on a filament printer (FDM)“, nicht alle vorab lesen). Die Kopie eines Skills „Bei Bedarf“ hat unter der Überschrift einen Hinweis: dem Skill folgen, solange das Thema gilt, das in `NOTES.md` unter `## Requirements` festhalten (sonst weiß eine spätere Sitzung nichts davon), die Werte sind Standardwerte der App (vom Nutzer eingestellte nennt er mit Namen), also nennen oder nachfragen, und in der App lässt er sich auf „Immer“ stellen. **Aus** entfernt Kopie und Eintrag. Jedes Umstellen zählt als ungespeicherte Änderung und wandert mit Snapshot, Git und ZIP. Ein Wechsel zwischen Bei Bedarf und Immer schreibt die Kopie neu, eine unveränderte ohne Sicherung.- **Einstellungen (Wunsch des Nutzers):** Ein Skill erklärt im Kopf Variablen, etwa `var overhang: 45 | ° | Max. Überhangwinkel | 10..85` (Standard, Einheit, Bezeichnung, Bereich) oder eine Auswahl `var material: PLA | | Material | PLA, PETG, ABS, ASA, TPU` (Einträge auch als `wert=Anzeige`). Im Text stehen Platzhalter wie `{{overhang}}`. Im Panel stehen die Einstellungen im aufgeklappten Skill: Zahlenfelder (Komma oder Punkt, Enter übernimmt, Escape verwirft) und Auswahllisten, geänderte Werte orange mit Knopf „zurück auf den Standard“, darunter in der Karte „Eingestellt: …“. Die App prüft jeden Wert (Bereich, Auswahl) und lehnt Falsches mit Grund ab. Gespeichert werden nur abweichende Werte, in `project.json` unter `skill_settings`, auch für ausgeschaltete Skills (sie gelten beim Einschalten). Die Kopie im Projekt enthält die eingesetzten Werte, im Text und im Kopf, der Agent liest also konkrete Zahlen. Eine Änderung schreibt die Kopie eines eingeschalteten Skills neu, eine von Hand geänderte Kopie kommt vorher in die Sicherung. Welche Einstellungen die mitgelieferten Skills haben, steht unten. Ein Skill ohne Einstellungen ist erlaubt.- **Agent:** Ein laufender Agent liest `AGENTS.md` nicht von selbst neu. Die Meldung nach dem Umstellen oder Einstellen sagt das, „An Agent geben“ fügt `[Skill: .soma/skills/<id>.md] ` ein, mit geänderten Einstellungen etwa `[Skill: .soma/skills/3d-druck.md, Einstellungen: Max. Überhangwinkel = 50°] `. `AGENTS.md` erklärt dem Agenten diese Notiz. Den Knopf gibt es bei Bedarf und Immer, bei Bedarf heißt er: jetzt anwenden.@@ -427,6 +427,14 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- **Entfernen auf der Startseite:** Beim Überfahren einer Karte erscheint ein Papierkorb (nicht beim geöffneten Modell). Der Arbeitsordner kommt in den Papierkorb von Windows, die Daten der App dazu (Zustand, Vorschauen, Vorschaubild) werden gelöscht, Sicherungen bleiben. Die Rückfrage sagt, was verloren geht: nichts, wenn der Stand in der ZIP steckt, sonst die Änderungen seit dem Speichern bzw. das ganze Modell, wenn es nie gespeichert wurde. Unveränderte gehen ohne Rückfrage. Hält die eben beendete Shell eines gerade verlassenen Modells den Ordner noch fest, versucht die App es bis zu 10 s lang. Die Karten zeigen „nie gespeichert“.- **Testwerkzeug:** `window.close()` aus der Seite schließt das Fenster am Ereignis `close` vorbei (ohne Rückfrage, ohne Verlassen des Modells). Tests schließen deshalb über `window.soma.test.close()` wie mit dem Kreuz. Die Prüfung der Markierung in der Vorschau wartet bis 30 s auf die Zeichenfläche, unter Last kam der Klick auf „An Agent“ sonst zu früh und blieb wirkungslos. Nach dem Öffnen einer ZIP wartet der Test auf den Speicherstand des neuen Modells (der Build ist inzwischen oft schneller da).+*App auf Englisch (E73, Wunsch des Nutzers; Prüfungen in allen Suiten):*++- **Umfang:** Oberfläche (alle Karten, Menüs, Toasts, Hinweise, `lang="en"`), native Dialoge, Projekt-Check und Logzeilen, Ausgaben, `--help` und Fehlermeldungen von `soma`, Docstrings der öffentlichen API (`add_part`, `import_step`, `import_assembly`, Normteile, `soma.anim`, Studien-API von FEM), die Köpfe der Skills (Titel, Beschreibung, Kategorie, Themen, Einstellungen) und die Beschriftungen in den Bildern von `soma render`. Kategorien der Skills: Way of working, Manufacturing, Design knowledge, Check and present. CodeMirror zeigt seine eigenen englischen Texte, die deutsche Übersetzung im Editor ist entfallen. Code-Kommentare, interne Docstrings und Doku bleiben deutsch.+- **Notizen an den Agenten:** `[Markup: …]`, `[Selection: part "…", model.py line …]`, `[Build error: …]`, `[Measurement: …]`, `[Result: …]`, `[File: …]`, `[Quote: … p. …]`, Zeitpunkte mit `at`. `AGENTS.md` und die Skills beschreiben sie so.+- **Zahlen und Datum:** `en-US` mit Dezimalpunkt, Eingaben nehmen weiter auch ein Komma. Schnitt und Skill-Einstellungen schreiben Zahlen ohne Tausendertrennzeichen, damit ein Wert wie 2000 beim Wiedereinlesen nicht zu 2 wird (mit „2.000“ ging das schon vorher schief). Zeiten als `today 14:02` oder `24 Sept 14:02`.+- **Was in Projekte geschrieben wird:** Commit-Betreffe der App auf Englisch (`New model created`, `Automatic snapshot on save`, `Backup before restore`, `Restored version: …`), Trailer `Created-by: SOMA`, Markierungen als `markup-JJJJMMTT-HHMM.png`, Bilder von `soma render` als `renders/view-iso.png`, `result-<name>.png` und `<id>-sheet.png`, Standardname „New model“, Referenzteile in der STEP unter „Reference“, unbenannte Teile aus `import_assembly` als „Part“.+- **Ältere Projekte:** Der Verlauf erkennt die deutschen Betreffe und den Trailer `Erstellt-von` weiter als Commits der App. Eine `.check.json` von `soma anim check` mit `Kollision` oder `zu nah` wird beim Lesen umgesetzt, deutsche Stufen im Skill-Kopf gelten weiter. Skill-Kopien in bestehenden Projekten haben noch den deutschen Kopf und gelten beim nächsten Umstellen als geändert, sie wandern dann in die Sicherung wie bei jedem Update eines Skills. Gespeicherte Ergebnisse von `soma analyze` behalten ihre deutschen Titel bis „Recalculate“.+*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).@@ -435,7 +443,8 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch**Noch nicht ausdrücklich bestätigt (Vorschläge von mir)**-- `AGENTS.md` und die Kommentare der Vorlage sind **auf Englisch** (Agenten befolgen englische Anweisungen zuverlässiger), die Oberfläche ist deutsch+- `AGENTS.md` und die Kommentare der Vorlage sind **auf Englisch** (Agenten befolgen englische Anweisungen zuverlässiger). Seit E73 ist auch die Oberfläche englisch+- App auf Englisch (E73): nur Englisch, keine Umschaltung der Sprache. IDs und Dateinamen der Skills bleiben deutsch (`3d-druck.md`), sonst müssten bestehende Projekte umziehen. Begriffe: „Mark up“/„Markup“ für Markieren, „Explode“ und „Exploded view“, „Section“, „Send to agent“, „issues“ für die Hinweise zum Projekt, Skill-Stufen Off, On demand, Always. „Show in Explorer“ und „Recycle Bin“ passen nur zu Windows- App-Daten liegen unter Windows in `%LOCALAPPDATA%\soma`, nicht im Roaming-Profil (Arbeitsordner und Caches gehören nicht ins Netz)- Beim Öffnen eines Projekts wird sofort gebaut, damit der Viewer nicht leer ist, außer der letzte Build gilt noch (E66), dann wird er gezeigt. Beim Anlegen läuft vor dem Startcommit ein Build (im vorgewärmten Prozess unter 1 s)- Der Modellname folgt dem Dateinamen der ZIP@@ -472,7 +481,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- Markierung (E16): Das Bild zeigt die Ansicht **ohne Auswahl-Hervorhebung** (die ist Orange wie der Stift und verschluckte die Zeichnung) und ohne schwebende Karten. Auflösung wie der Viewer in Gerätepixeln, keine Verkleinerung. Eine Strichstärke- Markierung, Farben: Statt der drei Farbpunkte aus dem Entwurf steht ein Farbknopf mit Menü in der Leiste (10 Farben und eigene Farbe), sonst würde die Leiste zu breit. Eine Farbe gilt für alles Folgende und färbt eine ausgewählte Form gleich mit- Markierung, Bearbeiten: eigenes Werkzeug „Auswählen“ statt Auswahl mit jedem Werkzeug (sonst verschöbe ein neuer Strich die Form darunter). Rechteck und Ellipse sind hohl und nur an der Linie greifbar, damit Formen darunter erreichbar bleiben. Text skaliert immer im Seitenverhältnis, das Textfeld steht beim Bearbeiten ungedreht-- Markierung: Eingefügt wird `[Markierung: .soma/feedback/markierung-JJJJMMTT-HHMM.png] ` (gleiche Form wie Auswahl und Build-Fehler). Beide Knöpfe („Markieren“ im Viewer, „Markierung“ in der Übergabeleiste) öffnen die Zeichenfläche+- Markierung: Eingefügt wird `[Markup: .soma/feedback/markup-JJJJMMTT-HHMM.png] ` (bis E73 `[Markierung: …markierung-…]`) (gleiche Form wie Auswahl und Build-Fehler). Beide Knöpfe („Markieren“ im Viewer, „Markierung“ in der Übergabeleiste) öffnen die Zeichenfläche- Markierung: Escape verwirft eine Zeichnung erst beim zweiten Druck, „Abbrechen“ sofort. Text wird mit Enter oder beim nächsten Klick übernommen- Markierungen zählen nicht als ungespeicherte Änderung und werden nie aufgeräumt (`.soma/feedback/` wächst, siehe ZIP-Größe unten)- Markierung, Raster: 20 px weit, jede fünfte Linie kräftiger, halbtransparent. Es **steht mit im Bild** (wie Karopapier, der Agent sieht dieselben Kästchen). Linie, Pfeil, Rechteck und Ellipse rasten an den Kreuzungen ein, Alt beim Ziehen hebt das auf, der Stift rastet nie. Die Einstellung bleibt für die nächste Markierung, aber nicht über einen Neustart@@ -497,7 +506,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- Transparenz einzelner Teile bleibt über neue Builds erhalten, geht aber wie das Ausblenden beim Öffnen verloren (nicht gespeichert)- Schnitt: eine Ebene (kein Mehrfachschnitt, kein Schnitt nur durch ausgewählte Teile), Karte unten rechts. Anfangs mitten durchs Modell, weggeschnitten die Seite der Standardansicht. Bei „Fläche“ nur ebene Flächen, anfangs mitten durch deren Bauteil. Die Schnittfläche selbst ist nicht messbar, Messen geht über die Kontur. Der Schnitt wird nicht gespeichert- Schnitt, Darstellung: Füllung in der abgedunkelten Bauteilfarbe mit Schraffur im Bildraum (Abstand und Breite fest in Pixeln), keine Füllung bei transparenten Teilen und Referenzen-- Skills (E17): Ablage in `.soma/skills/` wie in Abschnitt 4 (E17 nennt `skills/`). Inhalt englisch, Oberfläche deutsch. Die mitgelieferten Skills sind Entwürfe, ihre Werte (Wandstärken, Bohrungen, Senkungen, Einschmelzmuttern, Einschraubtiefen, Dehnungen, Werkstoffwerte) sind übliche Richtwerte, keine Normauszüge. Die Maße der Normteile folgen den genannten Normen (Nennmaße)+- Skills (E17): Ablage in `.soma/skills/` wie in Abschnitt 4 (E17 nennt `skills/`). Inhalt und Oberfläche englisch (E73), IDs und Dateinamen deutsch wie bisher. Die mitgelieferten Skills sind Entwürfe, ihre Werte (Wandstärken, Bohrungen, Senkungen, Einschmelzmuttern, Einschraubtiefen, Dehnungen, Werkstoffwerte) sind übliche Richtwerte, keine Normauszüge. Die Maße der Normteile folgen den genannten Normen (Nennmaße)- Skill-Inhalte (E45): Namen und Kennungen der neuen Skills, die Namen der Kategorien (E46), Skills ohne Einstellungen (Sauber modellieren, Normteile). Querverweise nur allgemein („der Skill für das Verfahren“), weil jede Kombination möglich ist- Skills, Laser und Blech: `soma export --format dxf` schneidet das Teil in halber Höhe parallel zu XY. Stehende Platten und Abwicklungen bekommen deshalb einen Schalter `FLAT` in `model.py`, der sie flach auf XY registriert. Ein Export, der die Platte selbst flach legt, wäre bequemer (offen)- Skills, Toleranzen: Die Einstellung „Spiel für Laserteile“ ist entfallen (jetzt „Schnittbreite“ im Laser-Skill). In `project.json` gespeicherte alte Werte werden still übergangen, wie jede unbekannte Einstellung@@ -509,7 +518,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- 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-- Normteile (E48): Schnittstelle auf Englisch (`Screw`, `Nut`, `Washer`, `HeatSetInsert`) wie der Rest von `soma`, Fehlermeldungen deutsch. 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 (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 Teile- Animation, Ablage (E58): beliebig viele Animationen je Datei in `animations/`, Namen im Projekt eindeutig, Kennung aus dem Namen (ASCII). Gebaute Animationen in `.soma/anim/`, Ergebnisse in `.soma/results/`, Bilder und Videos in `renders/`, alle drei nicht in Git (sie entstehen neu), aber in der ZIP. `soma render` ersetzt Dateien gleichen Namens in `renders/`diff --git a/README.md b/README.mdindex d09529c..46eb66d 100644--- a/README.md+++ b/README.md@@ -95,7 +95,6 @@ Early prototype, version 0.1.0. See [CHANGELOG.md](CHANGELOG.md).- Developed and tested on Windows only- No installer yet. Python, CadQuery and Git are meant to ship with the app, for now you set them up yourself-- The user interface is in German for now> **Note:** SOMA itself is vibe coded. Most of the code was written by coding agents (mainly Claude Code) under human direction and review. It has tests, but expect rough edges.