feat: harden CAD showcase skill and delivery pipeline

This commit is contained in:
2026-07-10 09:21:13 +08:00
parent a6856f903d
commit 8b1b1d5e89
53 changed files with 5405 additions and 1327 deletions

View File

@@ -1,5 +1,13 @@
# Web Presentation Upgrades (视觉/交互/性能改进清单)
## Contents
1. Tier 1 defaults
2. Tier 2 geometry quality
3. Tier 3 interaction and scale-out
4. Current implementation status
5. Honesty rules
Prioritized playbook for pushing a working showcase model toward digital-twin
presentation quality. Apply AFTER the geometry passes the One-Shot Definition
of Done — polish never excuses a wrong model. Each item names the code to
@@ -64,16 +72,13 @@ touch. Ordered by value-per-effort.
## Tier 3 — interaction & scale-out
10. Click-to-inspect: raycast -> highlight mesh, show floor/category/source
layer + drawing file (all present in `building_spec.json`; write it into
GLB `extras` during export so the viewer needs no extra fetch).
11. Camera bookmarks + auto-orbit tour; state (visible floors, section
height, camera) serialized into the URL hash for sharing.
12. Progressive loading for campuses: load `overview` GLB first, swap in
`standard`/`detail` per building on idle or on selection
(`build_showcase_variants.py` already produces the variants + manifest).
13. Per-building toggles grouped in the panel (floors nested under building)
once floor keys carry building prefixes (1F1 / 2F1 / 3F1 ...).
10. Click-to-inspect — PARTIAL: raycast/highlight plus floor/category is done.
Source layer + drawing file still require preserved GLB extras; merging
currently collapses that provenance.
11. Camera bookmarks + auto-orbit tour + URL-hash state — DONE.
12. Progressive loading — PARTIAL: overview -> standard global swap is done;
per-building idle/selection loading remains future work.
13. Per-building grouped toggles with floor-key prefix fallback — DONE.
14. Instancing & merge policy: merge static same-material meshes per building
(`BufferGeometryUtils.mergeGeometries`) — target < 150 draw calls for a
5-building campus; keep per-floor granularity only for toggleable nodes.
@@ -128,7 +133,8 @@ catcher (was at basement depth — shadows floated detached), and a data-URI
favicon (console stays clean).
PENDING (Tier 2/3): door/window openings, road/green surfaces (filled
polygons), camera tours / URL state, progressive per-building loading.
polygons), source-layer/drawing provenance through merged GLB extras, and
progressive per-building loading. Camera tours / URL state are complete.
## Honesty rules for presentation upgrades