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
Plan, Changelog und app/README: Bereich in der Zeile, Auswertungen mit Parametern
Kai-Jungsthoefel4be4597d658e
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex f3ded35..67ce10c 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -8,8 +8,13 @@ eigenen Abschnitt mit Datum und Git-Tag.### Geändert+- Jede Zeile im Panel „Parameters“ zeigt den Bereich, den der Agent gesetzt hat, ohne Aufklappen („30–200 mm“, „3 options“), rot, wenn der Wert außerhalb liegt (E74).- Kleinere ZIP beim Speichern: Bilder und Videos aus `renders/` kommen nicht mehr mit, und die Versionsgeschichte wird vorher gepackt, sodass ähnliche Fassungen des Modells kaum zusätzlichen Platz brauchen. Am Modellmotor schrumpft der Verlauf von 81 auf 35 MB (E75).+### Behoben++- 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).+## [0.2.0] - 2026-10-08Parameter für den Nutzer, die App auf Englisch, Start auf der Startseite und die Lizenz.diff --git a/PLAN.md b/PLAN.mdindex 2c7fd1c..02fd240 100644--- a/PLAN.md+++ b/PLAN.md@@ -442,11 +442,12 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- **Anlass:** Der Agent schreibt ein Skript mit festen Werten. Der Nutzer will einzelne davon selbst verstellen (Kurbelwinkel des Modellmotors, Bauraum einer CNC-Maschine), aber nicht alle Konstanten sehen.- **Für den Agenten:** `BORE = param(38.0, "Cylinder bore", min=30, max=42, step=0.5, unit="mm", group="Crank train")` in `model.py` oder `parts/params.py`. Vorbild sind Streamlit, Gradio und ipywidgets (Funktionsaufruf mit Bereich), nicht die Kommentare des OpenSCAD-Customizers: Ein Aufruf läuft wirklich, Tippfehler brechen mit Datei und Zeile ab. Der Name kommt aus der Zuweisung (Syntaxbaum an der Stelle des Aufrufs), `name=` nur ohne Zuweisung. Dieselbe Stelle zweimal (eine Animation importiert das Modell) gibt denselben Wert, zwei Stellen mit demselben Namen sind ein Fehler.- **Werte des Nutzers getrennt vom Code:** Der Wert des Agenten bleibt im Code, die des Nutzers stehen in `parameters.json` (`{"note": …, "values": {"BORE": 40}}`, in Git und ZIP). Nur so lässt sich jedes Feld auf den Wert des Agenten zurücksetzen (Wunsch des Nutzers). Der Entwurf sah vor, den Wert in den Code zu schreiben. `soma build` liest die Datei bei jedem Lauf (auch ohne App), `soma export`, Animationen und Auswertungen sehen so dieselben Werte.-- **Panel:** Eintrag „Parameters“ in der Leiste (Symbol Schieber, „Options“ bekommt das Zahnrad). Zeilen mit Name, Name im Code und Feld nach Art: Zahlenfeld mit Einheit, Stepper, Schalter, Auswahl, Textfeld. Gruppen wie im Code (ohne Gruppe zuerst), einklappbar. Aufgeklappt: Schieber (bei min und max, gebaut wird beim Loslassen), Erklärung, Wert im Code mit Bereich, Sprung in den Code, „Send to agent“ (`[Parameter: "Length" (LENGTH) = 100 mm, set in the app, code default 60 mm, model.py line 10]`). Abweichende Werte orange mit Knopf zum Zurücksetzen, unten „N changed“ mit „Reset all“.+- **Panel:** Eintrag „Parameters“ in der Leiste (Symbol Schieber, „Options“ bekommt das Zahnrad). Zeilen mit Name, darunter Name im Code und der Bereich des Agenten („30–200 mm“, „≥ 2 mm“, „3 options“, rot außerhalb, Wunsch des Nutzers), daneben das Feld nach Art: Zahlenfeld mit Einheit, Stepper, Schalter, Auswahl, Textfeld. Gruppen wie im Code (ohne Gruppe zuerst), einklappbar. Aufgeklappt: Schieber (bei min und max, gebaut wird beim Loslassen), Erklärung, Wert im Code mit Bereich, Sprung in den Code, „Send to agent“ (`[Parameter: "Length" (LENGTH) = 100 mm, set in the app, code default 60 mm, model.py line 10]`). Abweichende Werte orange mit Knopf zum Zurücksetzen, unten „N changed“ mit „Reset all“.- **Ändern:** Enter, Verlassen des Felds, Schalter, Auswahl oder Loslassen des Schiebers schreiben die Datei und bauen gleich, auch bei ausgeschaltetem Auto-Build (wie Strg+S im Editor, E39). Pfeiltasten und Stepper sammeln kurz. Ein Wert gleich dem im Code entfernt den Eintrag. Ändert der Agent die Datei, baut der Watcher wie bei Code.- **Melden statt reparieren (E28):** Ein Wert außerhalb des Bereichs wird eingetragen und gebaut, die Zeile ist rot, `soma build` warnt. Unpassende Werte (2.5 für eine ganze Zahl) gelten nicht, die Zeile ist rot. Werte ohne Parameter stehen in einem eigenen Abschnitt mit „Remove“. Eine unlesbare `parameters.json` wird gemeldet und nie überschrieben. Scheitert der Build nach einer Änderung, bietet das Panel „Back to <Wert davor>“ und „Send to agent“, nimmt aber nichts selbst zurück. Scheitert er vor den Parametern (Syntaxfehler), bleibt die Liste des vorigen Builds mit Hinweis bedienbar.- **Vorlage und Agent:** Die Vorlage macht LENGTH, WIDTH, HEIGHT und WALL zu Parametern (an allen Bereichsgrenzen gebaut). `AGENTS.md` (Regel 7) sagt, welche Werte Parameter werden (Hauptmaße, Anzahlen, Optionen, Stellungen, meist 3 bis 15), dass der Bereich über die ganze Spanne funktionieren soll und was mit `parameters.json` zu tun ist. Der Skill „Clean CadQuery modeling“ verweist darauf. Leerer Zustand mit „Ask the agent“.-- **Grenzen:** Jede Änderung baut das ganze Modell, auch eine reine Stellung wie ein Kurbelwinkel (bei großen Modellen Sekunden). Getestet unter Windows.+- **Auswertungen:** `soma analyze` (auch FEM), Animationen und Export führen das Modell über `run_model` aus und rechnen so mit den Werten des Nutzers (Kragarm 4 mm: 31.7 MPa, 8 mm im Panel: 7.7 MPa). Nach einer Änderung gelten Ergebnisse und Animationen als veraltet, in der App (`newestSourceMtime`) wie in `soma` (`animrun.newest_source`, für `soma anim` und `soma render --result`). Neu gerechnet wird nicht von selbst.+- **Grenzen:** Jede Änderung baut das ganze Modell, auch eine reine Stellung wie ein Kurbelwinkel (bei großen Modellen Sekunden). Ein Ergebnis merkt sich nicht, mit welchen Werten es gerechnet wurde. Getestet unter Windows.*Kleinere ZIP (E75, Wunsch des Nutzers nach Prüfung zweier ZIPs; Prüfungen in `app/test/unit.mjs`):*diff --git a/app/README.md b/app/README.mdindex 64d3dc7..9b51a6d 100644--- a/app/README.md+++ b/app/README.md@@ -27,7 +27,7 @@ npm run test:skills # Skills: Panel, Stufen Aus/Bei Bedarf/Immer (Kopie mitnpm 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:animation # Animation, Analyse, soma render und Video: Bauen über den Watcher, Ablauf als Text, Kollisionsprüfung, Fehler mit Ort, Abspielen im Viewer (Lage, Hervorhebung, Kamera), Ausschluss mit Explosion und Messen, Verbindung mit Schlüssel, Bild, Übersicht, MP4 mit WebVTT, Video abspielen und Standbild markieren, Überhang, Wandstärke, Abstand mit Anzeige und Neu berechnen, Beispiel des Skills, ohne App Grenzwert mit Netzgenauigkeit, Teil vor Gruppe, Problemstellen, bessere Druckrichtung, kurze Schritte als eine Zeile, Modell nur einmal ausgeführt (52 Prüfungen)npm run test:packages # Projektumgebung: klein, pip im Terminal installiert dorthin, Basispakete vorhanden und in der Version festgelegt, requirements.txt aus den Importen des Builds, nicht in Git und ZIP, alter Stand mit eigener Liste, anderer Rechner installiert vor dem Build, Paket ohne Quelle als Hinweis (26 Prüfungen, ohne Netz mit lokalen Wheels)-npm run test:params # Parameter (E74): Panel aus der Leiste, Werte in parameters.json statt im Code, Zurücksetzen einzeln und alle, Komma, Bereich (rot, trotzdem gebaut), Schieber, Sprung in den Code, An Agent geben, Typen (Stepper, Schalter, Auswahl, Text), Gruppen, unpassende Werte und Werte ohne Parameter, gescheiterter Build mit „Back to“, Syntaxfehler vor den Parametern, kaputte Datei, Snapshot und ZIP, leerer Zustand (40 Prüfungen)+npm run test:params # Parameter (E74): Panel aus der Leiste, Werte in parameters.json statt im Code, Zurücksetzen einzeln und alle, Komma, Bereich (rot, trotzdem gebaut), Schieber, Sprung in den Code, An Agent geben, Typen (Stepper, Schalter, Auswahl, Text), Gruppen, unpassende Werte und Werte ohne Parameter, gescheiterter Build mit „Back to“, Syntaxfehler vor den Parametern, kaputte Datei, Snapshot und ZIP, leerer Zustand, Bereich des Agenten in der Zeile, Auswertungen mit den Werten des Nutzers und veraltet nach einer Änderung (46 Prüfungen)node test/run-all.mjs fem # FEM: Kragbalken gegen die Formel, verschmolzene Teile mit Druck und Eigengewicht, Fehler (Lagerung, Bauteil, Selektor, kein fix, Code), Karte mit Lastfall und Überhöhung, Wert in Ausgangslage, soma render --result, veraltet nach Änderung der Studie, Neu berechnen, Beispiel des Skills (24 Prüfungen)npm test # alle vierzehn, vier gleichzeitig (test/run-all.mjs)node test/run-all.mjs smoke editor # nur diese, nach npm run build