From e1bbca3fe77fd21bf1a88289dc1b2a432f26d94c Mon Sep 17 00:00:00 2001 From: zhengwr Date: Fri, 3 Jul 2026 09:08:55 +0800 Subject: [PATCH] Organize repo layout for publishing: case docs into references/, add README MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 贝昂CAD诊断与skill优化.md / claudecode_prompt (annotated as archive) / beian corrected-config sample moved under references/ - README.md: what this is, pipeline map, layout, verification discipline Co-Authored-By: Claude Fable 5 --- README.md | 38 +++++++++++++++++++ .../beian_building_config.corrected.json | 0 .../claudecode_prompt_history.md | 2 + .../贝昂CAD诊断与skill优化.md | 0 4 files changed, 40 insertions(+) create mode 100644 README.md rename building-config.corrected.json => references/beian_building_config.corrected.json (100%) rename claudecode_prompt.md => references/claudecode_prompt_history.md (97%) rename 贝昂CAD诊断与skill优化.md => references/贝昂CAD诊断与skill优化.md (100%) diff --git a/README.md b/README.md new file mode 100644 index 0000000..19d5d5b --- /dev/null +++ b/README.md @@ -0,0 +1,38 @@ +# cad-building-showcase + +把中国建筑施工图(DWG/DXF,天正 t3/t8 导出为主)自动转成可交互的 3D 展示模型(GLB + 离线单文件 Web viewer),并支持多栋厂区按总平面装配。Agent-led:脚本负责证据与可重复执行,判读权在 Agent;任何门禁失败即停,不静默出错模型。 + +## 用法 + +入口是 `SKILL.md`(操作手册):决策循环、One-Shot Definition of Done 七条门禁、天正图层方言预设、多栋厂区流程。核心链路: + +``` +cad_dxf_report.py 读图报告(警告:多框图纸/缓存XREF/陌生图层方言…) +detect_sheet_frames.py 图框检测(图签块定框、网格投票/墙剖面互相关对齐、 + 多层图名展开、逐框标高梯+层高建议) +derive_showcase_spec.py 按 config 提取 building_spec.json(分簇 footprint/楼板/顶盖) +audit_showcase_extraction.py 硬门禁审计(楼层对齐+跨层基准、幕墙、框收支表、 + 面积/层数互证…),FAIL 即退出码 3 +spec_to_glb.py GLB 生成;write_offline_viewer.py 离线单文件 viewer +register_site_outlines.py / massing_from_outline.py / assemble_campus.py + 总平面配准(点-边ICP)、无图纸楼体量、厂区装配 +``` + +## 目录 + +- `scripts/` 全部流水线脚本(自含 CLI,`--help` 有说明) +- `tests/test_extraction_pipeline.py` 回归套件(改任何脚本后必跑) +- `references/` 案例记录与校准资料:`pipeline.md`(详细流程)、 + `generalization_test_log.md`(泛化测试与缺口修复清单)、 + `贝昂CAD诊断与skill优化.md`(首个案例全程) +- `assets/` Web 模板与离线 viewer 内联库 + +`work/`、`outputs/`、源 CAD 均不入库(见 `.gitignore`),由脚本从源数据再生。 + +## 验证纪律 + +```bash +python3 tests/test_extraction_pipeline.py # 必须全绿 +``` + +已在四套真实图纸上端到端验证:贝昂科技厂区(基线)、黄桥文体中心、13号地块(双塔+酒店厂区)、27号地块(7栋混合厂区)。质量对比表见 `references/generalization_test_log.md`。 diff --git a/building-config.corrected.json b/references/beian_building_config.corrected.json similarity index 100% rename from building-config.corrected.json rename to references/beian_building_config.corrected.json diff --git a/claudecode_prompt.md b/references/claudecode_prompt_history.md similarity index 97% rename from claudecode_prompt.md rename to references/claudecode_prompt_history.md index 3779b75..6c77f80 100644 --- a/claudecode_prompt.md +++ b/references/claudecode_prompt_history.md @@ -1,3 +1,5 @@ +> 归档:skill 早期迭代时使用的工作提示词,仅作历史记录;文中路径以当时的仓库布局为准。 + # Claude Code 提示词:CAD 展示模型 skill 剩余改进项 (在 /Users/zhengwr/workspace/cad-building-showcase 目录下启动 claude 后粘贴) diff --git a/贝昂CAD诊断与skill优化.md b/references/贝昂CAD诊断与skill优化.md similarity index 100% rename from 贝昂CAD诊断与skill优化.md rename to references/贝昂CAD诊断与skill优化.md