feat: harden CAD showcase skill and delivery pipeline
This commit is contained in:
85
references/input_formats.md
Normal file
85
references/input_formats.md
Normal file
@@ -0,0 +1,85 @@
|
||||
# Input Formats and Conversion Branches
|
||||
|
||||
## Contents
|
||||
|
||||
1. Supported inputs
|
||||
2. DWG conversion selection
|
||||
3. XREF and cached-block handling
|
||||
4. 3DSOLID/MESH branch
|
||||
5. PDF boundary
|
||||
6. Dependencies and portability
|
||||
|
||||
## Supported Inputs
|
||||
|
||||
Use this skill directly for architectural DWG/DXF drawing folders and DXF files produced by the bundled WASM bridge. Preserve source folders and write conversions under `work/`.
|
||||
|
||||
For multi-discipline sets, model from 建筑 by default. Pull 结构 later for columns/beams only when the requested showcase needs them. Never feed architecture, structure, MEP, and site drawings into one extraction config.
|
||||
|
||||
## DWG Conversion Selection
|
||||
|
||||
Run `cad_showcase.py inspect` or `cad_dxf_report.py` with an explicit converter policy:
|
||||
|
||||
- `--converter auto`: use libredwg first and retry failed/zero-entity conversions with ODA.
|
||||
- `--converter libredwg`: require libredwg and do not change converter silently.
|
||||
- `--converter oda`: use ODA for every DWG. Choose this for known 3DSOLID/ACIS drawings and TArch files known to break libredwg.
|
||||
|
||||
Tool discovery is environment variable, PATH, then platform defaults:
|
||||
|
||||
- Blender: `BLENDER` -> PATH -> macOS/Windows install defaults.
|
||||
- ODA: `ODA_CONVERTER` -> PATH -> macOS/Windows install defaults.
|
||||
|
||||
ODA requires existing absolute input/output directories. It may show GUI errors while returning no useful stderr; an exit 0 with no output is still a failure. The script stages ASCII file names and verifies produced files.
|
||||
|
||||
If native converters are unavailable, use the tested WASM bridge:
|
||||
|
||||
```bash
|
||||
npm install --prefix work/vendor-js @mlightcad/libredwg-web
|
||||
node scripts/dwg_dump_json.mjs input.dwg work/dump.json \
|
||||
--module-dir work/vendor-js/node_modules
|
||||
python3 scripts/dwgjson_to_dxf.py --json work/dump.json --out work/dxf_raw/input.dxf
|
||||
```
|
||||
|
||||
The bridge carries LINE/POLYLINE/ARC/CIRCLE/ELLIPSE/SPLINE/TEXT/INSERT and block definitions. It drops HATCH/DIMENSION/ATTRIB; record that limitation and do not infer hatch-only columns or attribute-held axis labels from the result.
|
||||
|
||||
## XREF and Cached Blocks
|
||||
|
||||
- `cached_xref_content`: the file contains INSERT stubs plus cached block definitions. Expand blocks in detect/derive; do not ask for a re-export.
|
||||
- `likely_xref_shell`: the referenced geometry is absent. Ask the user to bind/insert XREFs and re-export DXF.
|
||||
- `has_xref_definitions`: verify that no essential external content is missing before modeling.
|
||||
|
||||
Never treat an unresolved XREF shell as a completed floor.
|
||||
|
||||
## 3DSOLID/MESH Branch
|
||||
|
||||
Force ODA before inspecting known solid models because libredwg can keep annotations while silently dropping ACIS data. Then run:
|
||||
|
||||
```bash
|
||||
python3 scripts/extract_3d_solids.py \
|
||||
--dxf work/dxf_sanitized/model.dxf \
|
||||
--out-glb outputs/model/solids.glb \
|
||||
--out-obj outputs/model/solids.obj \
|
||||
--report outputs/model/solids_report.json
|
||||
```
|
||||
|
||||
The extractor supports DXF MESH and flat polygonal ACIS faces. It counts cone/sphere/spline/torus/cylinder/swept/revolution surface records as unsupported. If curved records dominate, request OBJ/STL/STEP exported by AutoCAD, BricsCAD, or another full CAD kernel. Label partial output honestly.
|
||||
|
||||
## PDF Boundary
|
||||
|
||||
This skill does not natively reconstruct CAD geometry from PDF. For PDF-only input:
|
||||
|
||||
- ask for DWG/DXF when precision matters;
|
||||
- or use a separate PDF/vector/OCR workflow with explicit scale calibration before invoking this skill;
|
||||
- never treat raster tracing as CAD-equivalent geometry without dimensional evidence.
|
||||
|
||||
Do not advertise PDF support merely because a floor plan is visible in a PDF.
|
||||
|
||||
## Dependencies and Portability
|
||||
|
||||
Install deterministic dependency sets in the project environment:
|
||||
|
||||
```bash
|
||||
python3 -m pip install -r requirements-core.txt
|
||||
python3 -m pip install -r requirements-delivery.txt
|
||||
```
|
||||
|
||||
Use `cad_showcase.py doctor` before a full run. On Windows set `PYTHONUTF8=1` and enable long paths for deep Chinese file names. Keep optional Blender/IfcOpenShell branches separate from the core Python path.
|
||||
Reference in New Issue
Block a user