feat: integrate SimpleCADAPI 2.0.2 CAD workflows

This commit is contained in:
Jerry
2026-08-03 11:17:05 +08:00
parent b5738e9109
commit c3a0f269b7
481 changed files with 110229 additions and 12826 deletions
@@ -1,8 +1,25 @@
# Backend capabilities
## build123d through CAD Skill
## Selection principle
Use as the default STEP-first backend.
There is no permanent default authoring backend. `text-to-cad` owns routing,
DesignIR, validation, repair, artifacts, and Viewer handoff. It does not receive
extra score simply for being the orchestrator.
The router scores:
1. continuity with an explicitly supplied editable source;
2. deterministic standard-factory coverage;
3. semantic graph, replay, units, tolerances, and translation requirements;
4. custom profile and surface vocabulary;
5. assembly and mechanism requirements;
6. validation requirements.
Uploaded STEP reconstruction is a separate mode: SurfaceIR is the effective
rebuild engine, while SimpleCADAPI B-Rep comparison supplements the independent
acceptance stage.
## build123d through CAD Skill
Best fit:
@@ -11,20 +28,36 @@ Best fit:
- Source-level assemblies, named datums, joints, imported components, measurements, alignment checks, and existing STEP inspection.
- STEP output compiled from executable semantic DesignIR 3.0.
Weak signals: a specialized mechanical family already implemented by SimpleCADAPI or a browser-only execution requirement.
Weak signals: a standard mechanical family already implemented by
SimpleCADAPI, or a primary requirement for replayable operation graphs, typed
semantic topology, unit checking, tolerance chains, or CAD translation.
## SimpleCADAPI
Use for its standard mechanical factories and replayable modeling graph.
Best fit:
Best fit in version 2.0.2:
- Spur, helical, and herringbone gears; internal ring gears; racks; cycloidal discs; ball bearings.
- Spur, helical, herringbone, ring, and straight bevel gears; racks; cycloidal
discs; ball bearings; bolts; nuts; and roller-chain sprockets.
- Planetary and cycloidal reducers, joint actuators, and mechanism-heavy assemblies.
- Parameter expressions, operation-graph JSON, replay, semantic tags, and topology queries.
- `@model` / `ModelResult`, parameter expressions, operation-graph JSON, replay,
scene packages, semantic tags, topology lineage, source mapping, and QL.
- Physical units, dimension checking, and manufacturing tolerance chains.
- FreeCAD, Fusion 360, and SolidWorks translation.
- STEP B-Rep inspection, strict target/candidate comparison, multi-view
diagnostics, and slice XOR diagnostics.
- Reusable mechanical product families whose formulas should become deterministic library functions.
Before invocation, inspect the installed package and Skill versions together. Do not mix the current single-`Solid` boolean API with older `*rsolidlist` documentation. If the installed runtime and docs disagree, stop that route and use build123d or repair the installation.
Weak signals: freeform or multi-rail surface construction outside the tested SDK
vocabulary, or an existing build123d source whose feature history must remain
authoritative.
Before invocation, inspect the installed package and Skill versions together.
Require version `2.0.2` or newer for the capabilities listed above. Do not mix
the current single-`Solid` boolean API with older `*rsolidlist` documentation.
If the installed runtime and docs disagree, stop that route and use build123d
or repair the installation.
## Router refinement and repair