Organize repo layout for publishing: case docs into references/, add README
- 贝昂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 <noreply@anthropic.com>
This commit is contained in:
229
references/beian_building_config.corrected.json
Normal file
229
references/beian_building_config.corrected.json
Normal file
@@ -0,0 +1,229 @@
|
||||
{
|
||||
"project_name": "主辅楼建筑群 CAD 展示模型",
|
||||
"description": "由 11 张 CAD 平面图(主楼地下一层~八层、辅楼首层)生成的轻量化三维展示/数字孪生底座模型",
|
||||
"scale": 0.001,
|
||||
"origin_strategy": "center",
|
||||
"floor_height": 4.2,
|
||||
"curve_chord_source_length": 750,
|
||||
"expand_blocks": false,
|
||||
"expand_blocks_max_depth": 2,
|
||||
"block_insert_layer_fallback": true,
|
||||
"generate_footprints": true,
|
||||
"use_footprint_slabs": true,
|
||||
"use_footprint_roofs": true,
|
||||
"footprint_categories": [
|
||||
"walls",
|
||||
"floor_lines",
|
||||
"columns"
|
||||
],
|
||||
"footprint_concave_ratio": 0.85,
|
||||
"footprint_simplify_tolerance": 0.15,
|
||||
"footprint_min_area": 20.0,
|
||||
"footprint_max_polygons": 4,
|
||||
"slab_thickness": 0.38,
|
||||
"default_disabled_categories": [],
|
||||
"shorten_unsupported_columns": false,
|
||||
"min_length_meters_by_category": {
|
||||
"walls": 0.25,
|
||||
"columns": 0.18,
|
||||
"beams": 0.35,
|
||||
"floor_lines": 0.4,
|
||||
"detail_lines": 0.3,
|
||||
"grid": 1.0
|
||||
},
|
||||
"floor_order": [
|
||||
"B1",
|
||||
"B1M",
|
||||
"1F",
|
||||
"2F",
|
||||
"3F",
|
||||
"4F",
|
||||
"5F",
|
||||
"6F",
|
||||
"7F",
|
||||
"8F",
|
||||
"AUX_1F"
|
||||
],
|
||||
"drawings": [
|
||||
{
|
||||
"file": "A202 - 地下一层平面图.dxf",
|
||||
"floors": [
|
||||
{
|
||||
"key": "B1",
|
||||
"name": "地下一层",
|
||||
"z": -9.0,
|
||||
"height": 4.5
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"file": "A205 - 地下一层夹层平面图.dxf",
|
||||
"floors": [
|
||||
{
|
||||
"key": "B1M",
|
||||
"name": "地下一层夹层",
|
||||
"z": -4.5,
|
||||
"height": 4.5
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"file": "A208 - 主楼首层、二层平面图.dxf",
|
||||
"split_x": -4336,
|
||||
"floors": [
|
||||
{
|
||||
"key": "1F",
|
||||
"name": "主楼首层",
|
||||
"side": "left",
|
||||
"z": 0.0,
|
||||
"height": 4.5
|
||||
},
|
||||
{
|
||||
"key": "2F",
|
||||
"name": "主楼二层",
|
||||
"side": "right",
|
||||
"z": 4.5,
|
||||
"height": 4.2,
|
||||
"offset": [
|
||||
-158029.2,
|
||||
0
|
||||
]
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"file": "A209 - 主楼三层、四层平面图.dxf",
|
||||
"split_x": -15487,
|
||||
"floors": [
|
||||
{
|
||||
"key": "3F",
|
||||
"name": "主楼三层",
|
||||
"side": "left",
|
||||
"z": 8.7,
|
||||
"height": 4.2
|
||||
},
|
||||
{
|
||||
"key": "4F",
|
||||
"name": "主楼四层",
|
||||
"side": "right",
|
||||
"z": 12.9,
|
||||
"height": 4.2,
|
||||
"offset": [
|
||||
-144877.5,
|
||||
0
|
||||
]
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"file": "A210 - 主楼五层、六层平面图.dxf",
|
||||
"split_x": -71695,
|
||||
"floors": [
|
||||
{
|
||||
"key": "5F",
|
||||
"name": "主楼五层",
|
||||
"side": "left",
|
||||
"z": 17.1,
|
||||
"height": 4.2
|
||||
},
|
||||
{
|
||||
"key": "6F",
|
||||
"name": "主楼六层",
|
||||
"side": "right",
|
||||
"z": 21.3,
|
||||
"height": 4.2,
|
||||
"offset": [
|
||||
-92610.0,
|
||||
0
|
||||
]
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"file": "A211 - 主楼七层、八层平面图.dxf",
|
||||
"split_x": -75943,
|
||||
"floors": [
|
||||
{
|
||||
"key": "7F",
|
||||
"name": "主楼七层",
|
||||
"side": "left",
|
||||
"z": 25.5,
|
||||
"height": 4.2
|
||||
},
|
||||
{
|
||||
"key": "8F",
|
||||
"name": "主楼八层",
|
||||
"side": "right",
|
||||
"z": 29.7,
|
||||
"height": 4.2,
|
||||
"offset": [
|
||||
-81464.1,
|
||||
0
|
||||
]
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"file": "A213 - 辅楼首层平面图.dxf",
|
||||
"floors": [
|
||||
{
|
||||
"key": "AUX_1F",
|
||||
"name": "辅楼首层",
|
||||
"z": 0.0,
|
||||
"height": 4.5
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"layers": {
|
||||
"walls": [
|
||||
"I-WALL",
|
||||
"A-WALL",
|
||||
"L-SITE-WALL"
|
||||
],
|
||||
"columns": [
|
||||
"S-COLS"
|
||||
],
|
||||
"beams": [
|
||||
"S-STRS",
|
||||
"S-STRS-MBND"
|
||||
],
|
||||
"floor_lines": [
|
||||
"A-FLOR",
|
||||
"A-FLOR-OVHD"
|
||||
],
|
||||
"detail_lines": [
|
||||
"A-GENM",
|
||||
"A-DETL*"
|
||||
],
|
||||
"grid": [
|
||||
"S-GRID"
|
||||
]
|
||||
},
|
||||
"roof_specs": [
|
||||
{
|
||||
"floor_key": "8F",
|
||||
"z": 33.9,
|
||||
"bounds_from": [
|
||||
"8F"
|
||||
],
|
||||
"footprint_from": [
|
||||
"8F"
|
||||
],
|
||||
"thickness": 0.4,
|
||||
"margin": 0.3
|
||||
},
|
||||
{
|
||||
"floor_key": "AUX_1F",
|
||||
"z": 4.5,
|
||||
"bounds_from": [
|
||||
"AUX_1F"
|
||||
],
|
||||
"footprint_from": [
|
||||
"AUX_1F"
|
||||
],
|
||||
"thickness": 0.4,
|
||||
"margin": 0.3
|
||||
}
|
||||
]
|
||||
}
|
||||
30
references/claudecode_prompt_history.md
Normal file
30
references/claudecode_prompt_history.md
Normal file
@@ -0,0 +1,30 @@
|
||||
> 归档:skill 早期迭代时使用的工作提示词,仅作历史记录;文中路径以当时的仓库布局为准。
|
||||
|
||||
# Claude Code 提示词:CAD 展示模型 skill 剩余改进项
|
||||
|
||||
(在 /Users/zhengwr/workspace/cad-building-showcase 目录下启动 claude 后粘贴)
|
||||
|
||||
---
|
||||
|
||||
你在 CAD 建筑展示模型 skill 的仓库里工作。开始前先完整阅读 SKILL.md(操作手册,含 One-Shot Definition of Done 七条门禁)、references/web_presentation_notes.md(效果升级清单与 PENDING 项)、贝昂CAD诊断与skill优化.md(项目全程记录)。铁律:任何脚本改动后必须跑 `python3 tests/test_extraction_pipeline.py`(当前 24 项全绿);门禁失败就停下修复,绝不绕过;产出必须亲眼验证(渲染图/浏览器截图),不做假数据。
|
||||
|
||||
现成数据:outputs/beian_1hao/ 下有 campus_spec.json(厂区 22 层合成 spec)、building_spec.json / spec_2.json / spec_3.json(1#/2#/3# 单体)、beian_campus.glb(14.9MB 未压缩)、site_manifest.json(摆位配方)、site_floors.json(场布)。CAD 源图在 /Users/zhengwr/workspace/test3d-6/fs贝昂科技_新建项目cad20250728/(如需重新提取,按 SKILL.md 步骤 1 的 WASM 兜底或 macOS ODA 转换)。
|
||||
|
||||
按顺序执行,每项完成后简报结果再继续:
|
||||
|
||||
任务 1 — Draco 压缩(30 分钟)
|
||||
在仓库根目录 `npm install @gltf-transform/core @gltf-transform/extensions @gltf-transform/functions draco3dgltf`,然后 `node tools/compress.mjs outputs/beian_1hao/beian_campus.glb outputs/beian_1hao/beian_campus.draco.glb`。验收:压缩后 ≤3MB,用 pygltflib 或 gltf-transform inspect 确认节点数不变(122)、KHR_draco_mesh_compression 存在。沙盒里 WASM 会崩,macOS 正常——如果这里也崩,报告环境信息,不要硬试。
|
||||
|
||||
任务 2 — 正式 Web 模板部署验证(1 小时)
|
||||
按 SKILL.md 步骤 6:用 scripts/build_showcase_variants.py --build 生成 overview/standard/detail 三档(输入 outputs/beian_1hao/campus_spec.json),scripts/write_web_showcase.py --variants-manifest 组装到 outputs/beian_1hao/web/,`npm install --prefix outputs/beian_1hao/web three@0.181.2 lucide@0.468.0`,起本地服务打开。验收:亲自在浏览器确认——RoomEnvironment 环境光与阴影生效(模板 app.js 刚升级过:主光已移到地上、阴影视锥按模型自适应、幕墙为物理玻璃)、楼层爆炸/剖切/点击溯源可用、桌面与手机宽度布局正常、控制台无报错;截图存 outputs/beian_1hao/web_verify/。
|
||||
|
||||
任务 3 — Tier 2 几何升级:连续墙体(半天,先写测试)
|
||||
给 scripts/spec_to_glb.py 和 scripts/build_blender_showcase.py 加配置开关 `merge_wall_solids`(默认 false):每层墙段用 shapely buffer(width/2, cap_style=2) + unary_union 合并为连续多边形再挤出,消除转角缝。先在 tests/test_extraction_pipeline.py 加用例(L 形墙 union 后应为单一多边形、顶点数合理、默认关闭时输出与现状逐字节一致),再实现。完成后用 campus_spec.json 开关对比渲染两张图,肉眼验证转角处无缝且无异常鼓包,写入 references/web_presentation_notes.md 的 Status。
|
||||
|
||||
任务 4 — 幕墙竖梃分格(半天,同样先测试后实现)
|
||||
spec_to_glb 加 `glazing_mullions`(默认 false):合并后的每条玻璃带按 glazing_panel_w(默认 1.5m)生成竖梃、按层高生成横梃(细盒型材,walls 材质),玻璃面保留。验收同任务 3:新增测试 + 前后对比渲染 + notes 更新。
|
||||
|
||||
任务 5 — 4#/5# 与 3# 精确定位(依赖外部数据,先问我)
|
||||
现有图纸没有 4# 机械停车坑、5# 污水处理池的定位轮廓,3# 是 ±1m 近似摆位。先向我确认是否已拿到设计院"含全部构筑物的可点坐标总平面";拿到后按 SKILL.md 厂区章节流程(detect_sheet_frames → 提取 → 在 site_manifest.json 增加条目 → scripts/assemble_campus.py 重新装配,它会自动做邻栋间距门禁)。没拿到就跳过并在报告里注明,不要造假体量。
|
||||
|
||||
全部完成后:更新 贝昂CAD诊断与skill优化.md 追加一节记录本轮结果与教训,确认 24+ 项测试全绿,git status 列出改动清单(不要自行 commit,等我确认)。
|
||||
89
references/贝昂CAD诊断与skill优化.md
Normal file
89
references/贝昂CAD诊断与skill优化.md
Normal file
@@ -0,0 +1,89 @@
|
||||
# 贝昂科技厂区 CAD:为什么生成错了 + skill 优化记录
|
||||
|
||||
日期:2026-07-02 | 源数据:`test3d-6/fs贝昂科技_新建项目cad20250728`
|
||||
|
||||
## 一、错误原因诊断
|
||||
|
||||
截图里"6 个楼层 B1F–B6F 沿对角线散开"的直接原因,是这套图纸的组织方式与 skill 的假设完全不匹配:
|
||||
|
||||
1. **这是厂区(5 栋建筑),不是一栋楼的 6 层。** `建筑/` 下每个 DWG 是一栋楼(1#厂房、2#厂房、3#辅房、4#机械停车坑、5#应急污水处理池)外加两张总图。上一次运行把"每个文件当一层"堆起来,楼层数、命名(B1F 会被 skill 按地下室排序)、位置全都不对。
|
||||
2. **每个 DWG 的 modelspace 里是整套图纸墙。** 以 1#厂房为例:8 张平面图(地下一层/一层/一层夹层/二~四层/屋顶机房层/屋顶)+ 4 张立面 + 2 张剖面 + 楼梯电梯详图,全部按 A1 图框(1:150,纵向间距 98,100mm)排开。不裁剪 clip 就提取 = 所有图纸叠在一层;裁了但不做 offset 归零 = 每层保留图框位置 → 就是截图里的"斜楼梯"。
|
||||
3. **天正 t3 图层惯例不被默认规则识别。** 轴网在 `DOTE`(不是 AXIS);门窗都是 `WINDOW` 层上的块(窗块 `$TCHSYS$WIN2D`、门块 `$DorLib2D$*`),块内几何在 0 层靠 INSERT 继承图层——skill 的"按子实体图层探测"对这种块**一根线都留不下**,必须显式展开 + 按块名分类。
|
||||
4. **单位混用陷阱。** 楼栋图是毫米;总图是**米制真实测量坐标**(x≈349xxx、y≈663xxx)。config 只有一个全局 scale,两类图不能混在一个 spec 里。
|
||||
5. **性能缺陷(这次已修)。** `derive_showcase_spec.py` 原来对每个楼层重复展开全部 INSERT(O(楼层×块)),audit 又对每个 INSERT 重复 explode。A208 案例"一文件一层"没暴露;贝昂这种"一文件八层 + 1,684 个块"直接超时。
|
||||
|
||||
## 二、这套 CAD 的正确做法
|
||||
|
||||
按栋建模 + 总图摆位,已在 1#厂房上完整验证:
|
||||
|
||||
1. DWG→DXF:macOS 上用 ODA/libredwg;无原生转换器时用新增的 WASM 兜底(`dwg_dump_json.mjs` + `dwgjson_to_dxf.py`,22,970 图元 + 4,081 块定义零丢失)。
|
||||
2. `detect_sheet_frames.py`(新增)自动完成最难的部分:识别 8 个平面图图框(过滤图纸目录行/图签同名字)、按墙体 bbox 收紧 clip、**用轴线位置互相关投票算每层 offset**(B1 图框有 250mm 非均匀偏移也被修正)。
|
||||
3. 层高从剖面图 DIM_ELEV 标高取:B1=-4.8,F1=0(层高 8.1 含 4.8 夹层),F2=8.1,F3=13.1,F4=18.1,机房=23.1,屋面=27.9。
|
||||
4. 天正图层映射 + 门窗块规则写入 config(见 `outputs/beian_1hao/extract_config.json`,可直接当 t3 模板复用)。
|
||||
5. 提取 → 审计 → 叠图 → GLB → 三视图验证:地上各层 bounds 完全一致(104.8m × 58.8m),B1 正确落在内部 33×48m;幕墙连续 100%;GLB 6.7MB / 48 节点。三视图见 `outputs/beian_1hao/beian_previews.png`。
|
||||
|
||||
剩下 4 栋照同样流程各自出模型;楼栋摆位建议用 `更新图纸/贝昂 建筑-总图 首层带轴号(可点坐标)` 量各栋锚点与转角,写一个 site manifest,在 viewer 里按 transform 组装(不要把米制总图混进毫米 spec)。结构柱如需完整,从 `结构/` 图纸补(建筑图里柱多为填充,t3 导出后只剩 6 根线框柱/层)。
|
||||
|
||||
## 三、本次对 skill 的修改
|
||||
|
||||
新增脚本:`detect_sheet_frames.py`(多图框切分+网格对齐配置生成)、`dwg_dump_json.mjs` + `dwgjson_to_dxf.py`(WASM DWG 兜底转换)。
|
||||
|
||||
修复/优化:`derive_showcase_spec.py` 改单遍展开+按层分桶(本例 >45s 超时 → 6.3s,输出逐段一致)、块叶子图层缓存跳过无关块、`cap_groups` 可配置(原来硬编码 A208 的 AUX_/B1 分组)、新增"顶层无盖"警告(顶层既无 caps 又无 roof_specs 时强提示,防止生成没屋顶的模型);`audit_showcase_extraction.py` 块内几何清点改块定义遍历+按名缓存(40s+ → 6.3s);`spec_to_glb.py` 修复两处:多边形三角化失败(缺 mapbox_earcut)原来**静默丢弃全部楼板/顶盖/屋面**,现在显式报警;新增 `slab_bounds_fallback` 开关,避免女儿墙层从 bounds 生成盖满全楼的假板;`cad_dxf_report.py` 修复 input 目录与 work/dxf_raw 相同时 copy 崩溃。
|
||||
|
||||
屋顶问题复盘(第二轮反馈"没有屋顶"):三个原因叠加——① 地上顶盖按设计要走 config `roof_specs`(机房顶 27.9m 一块、主屋面由 F4 顶帽 + 机房层楼板组成 23.1m 一层),首版配置漏了;② roof 类默认线宽 0,女儿墙挤出为零厚度;③ 沙盒缺 mapbox_earcut 导致所有板类网格静默失败。三处都已修,GLB 现含 `PH__roof`(机房顶)、`RF__roof`(檐口/女儿墙带)、F4 顶帽环 + 各层楼板。
|
||||
|
||||
SKILL.md 新增:多图框工作流(第 3 步)、"厂区多栋"章节、天正 t3 预设章节、WASM 兜底说明、audit 裁剪口径注意事项(多图框时全文件覆盖率 ~40% 属正常,要看叠图而非头条数字)、B 前缀楼层键警告。
|
||||
|
||||
回归测试 `tests/test_extraction_pipeline.py` 12 项全部通过。
|
||||
|
||||
## 四、后续建议(未实施)
|
||||
|
||||
audit 增加"裁剪范围内"口径的第二组覆盖率数字;detect_sheet_frames 顺带解析剖面标高自动填 z/height;桥接脚本补 HATCH(柱填充)与 ATTRIB(轴号);出一个 site-manifest 组装脚本把多栋 GLB 合成厂区场景。
|
||||
|
||||
## 五、"一次做对"机制(2026-07-02 第二轮加固)
|
||||
|
||||
思路:把 Agent 的判断变成**会大声失败的确定性门禁**,宁可停在中间也不产出错模型。
|
||||
|
||||
新增/加固的机制(全部有回归测试覆盖,共 20 项 checks):读图报告新增 `multi_frame_sheet` 警告(一个 modelspace 里发现 ≥2 个"XX平面图"标题就强制走 detect_sheet_frames,防"一文件当一层");audit 新增 `floors_aligned` 硬门禁(同组楼层墙体包络中心偏差超限即 exit 3,直接拦截"斜楼梯"输出,测试验证了有 offset 通过 / 无 offset 失败);derive 的 `topless_group` 警告(顶层无盖必须配 roof_specs);GLB 导出的三角化失败显式报警(楼板静默消失问题)。SKILL.md 增加 "One-Shot Definition of Done" 检查单:7 条逐项要有证据(报告行/门禁状态/亲眼看过的渲染图)才能交付。
|
||||
|
||||
## 六(补)、场布重建(第三轮反馈"场布就几根线")
|
||||
|
||||
原因:首版场布只取了定位图测量副本,那份图本来就只画红线/围墙/道路骨架;真正的场地内容(车行道细节、车位、行道树、绿化、出入口、连廊等)在 `建筑-总图(施工图)` 里(米制、含三份方案副本,取顶部与定位副本重合那份)。已把场布提取固化为 skill 脚本 `site_context_from_dump.py`:地面=红线 footprint 板、道路/车位(含圆弧展开与车位块展开,1303+358 段)、围墙=1.8m 栅栏(149 段)、行道树=52 根绿柱(自定义 trees 类别)、场内小构筑物体量(连廊/消控室/钢楼梯,按最近标注命名,出入口自动跳过)。2# 厂房在总图顶副本无独立轮廓(与 1# 贴建、自有整套图纸),按规范应同法建模后摆入,不造假体量。
|
||||
|
||||
## 七、2#/3# 建模与摆位(第四轮"继续")
|
||||
|
||||
2#厂房、3#辅房用与 1# 完全相同的配方跑通(桥接→图框检测→提取):2# 七层全部网格对齐,包络 64.1×40.1m;3# 暴露并修复了检测器一个盲区——**横排图框**(标题同行、x 向 21m 间距),检测器现在同时支持纵排/横排。摆位数据的攻坚:定位图给排水/电气总图的楼底图都是未绑定 XREF(死路),最终解法是**副本配准**——定位图里未旋转的施工场布副本画有全部楼栋,用 1# 的 90.2×42.2 特征矩形做两副本间刚体配准(验证误差 2mm:红线角点变换后与坐标标注完全吻合),再把该副本里 2# 的屋面轮廓(66×39.2)映射回测量坐标同心摆位。3# 用东侧地块四个红线角点均值近似摆位(±1m,manifest 注记待校正)。4#/5# 为地下坑/低矮水池,定位图无轮廓,标记待建不造假。三栋楼与场布的俯视校验见 campus_check.png。
|
||||
|
||||
## 八、1#/2# 间距核实与修正(第六轮)
|
||||
|
||||
用户质疑两楼紧贴。核实结论:**贴建是对的,但差一条缝**——首版按屋面轮廓同心摆位导致 2# 嵌入 1# 达 0.26m。证据链:可点坐标角点中 +10.8m/+38.0m 两条线均精确过沿线 90.2m(1# 东立面延长线)→ 2# 东立面与 1# 齐平;副本A 缝隙带 +0.19m 处的平面线 = 变形缝;反证:若按 10m 防火间距,2# 会顶穿北侧红线(几何不可能)。修正后:墙对墙间距 0.190m、东立面错位 0.001m(seam_check.png)。教训固化进 SKILL.md:摆位锚点必须用墙线/坐标标注而非屋面轮廓(含雨棚外挑会偏);邻栋间距必须数值核验(负值=bug,0.15-0.3m=贴建变形缝需旁证,红线冲突可否证假设)。
|
||||
|
||||
## 六、厂区合成(定位图 → 摆位)
|
||||
|
||||
`定位图 - 副本(2).dwg` 里有一份落在测量坐标上的总平面(mm 单位,x≈349.6km)。1# 厂房在其中的"面积核算"框是 **90.2 × 42.2m、旋转 7.57°**——与模型墙体包络 90.2 × 42.2m 完全 1:1 对应,据此得到精确变换(角点 D=(349582714, 664188492)mm ↔ 模型 (7.3, 8.3)m);180° 朝向歧义用机房墙密度投票判定(no-flip 119 vs 72)。场地本地原点取用地红线角点(避免 349km 坐标撑爆 float32)。合成方式是 **spec 级合并**:把 1# 全部楼层几何旋转平移到场地坐标,再加一层 SITE(红线/围墙/道路/其他楼轮廓),一次导出厂区 GLB。俯视校验图 `campus_check.png` 显示楼栋严丝合缝落在定位框内。剩余 2#/3#/4#/5# 楼各自建模后按 `site_manifest.json` 里同样的配方摆入即可。
|
||||
|
||||
## 九、剩余改进项推进(第七轮)
|
||||
|
||||
沙盒内已完成 4 项:① `assemble_campus.py` 转正——manifest 驱动的多栋装配 + 自动邻栋间距门禁(穿模 exit 3、0.1-0.3m 提示贴缝),用贝昂三栋回归验证与手工装配偏差 ≤0.35mm(manifest 舍入噪声),并且初跑就自我纠错一次(全楼层包络误报穿模 → 改为首层包络判定);② detect_sheet_frames 新增剖面标高收集,1# 实测输出完整层标高序列(-4.8/±0/4.8/8.1/…/27.9/28.8 全中);③ audit 新增裁剪口径覆盖率(多图框时以此为准);④ 桥接脚本补 ATTRIB→TEXT(天正轴号/坐标标注属性不再丢失)。回归测试扩至 24 项全绿(含横排图框用例)。
|
||||
|
||||
Mac 侧待办(沙盒能力边界):Draco 压缩(`node tools/compress.mjs`,WASM 沙盒必崩);正式模板部署验证(npm install three@0.181.2 + 本地服务,验证升级后的 IBL/阴影/物理玻璃实际渲染);4#/5# 建模(先向设计方要含这两个构筑物轮廓的总平面或坐标);3# 摆位精确化(同样需权威定位数据);Tier 2 几何升级(墙体 union/幕墙分格/门窗开洞,动导出管线,需配套回归用例);IFC 语义(build_ifc_poc.py,需 IfcOpenShell)。
|
||||
|
||||
## 十、Mac 侧四项推进:Draco / 正式模板 / 墙体 union / 幕墙分格(第八轮,2026-07-02)
|
||||
|
||||
沙盒能力边界外的待办在 macOS 上全部落地,过程中又修掉一批"两后端行为分歧"型 bug:
|
||||
|
||||
1. **Draco 压缩**:`tools/compress.mjs` 在 macOS 正常(沙盒 WASM 崩溃确认是环境问题)。beian_campus.glb 15.0MB → **0.57MB**(Draco + weld/dedup/prune),121 节点逐一核对无丢挂,`KHR_draco_mesh_compression` 在场且可解码。dedup 把 2 个全同 mesh 合并共享(122→120),无损。
|
||||
2. **正式模板部署验证**(含用户两次现场反馈的修复):
|
||||
- "屋顶的板超出了":`build_blender_showcase.py` 生成屋面默认走 bounds+margin 矩形(要 `use_footprint_roofs` 才用多边形),PH 机房顶变成盖满全楼 bbox 的大板。已改为 footprint 无条件优先(与 spec_to_glb 同契约),修复后 6 个屋面节点尺寸与已验证 GLB 逐一吻合。同类:Blender 端不认 `slab_bounds_fallback:false`,ROADS/FENCE/TREES 等无 footprint 层生成盖满全厂区的 bounds 假板,同步修复。**教训:spec_to_glb 修过的坑要同步检查 Blender 端——两后端必须一个契约,否则换后端重建即翻车。**
|
||||
- "为什么没有嵌入式 viewer 的效果":① 变体类别过滤把场地内容滤掉(路在 detail_lines/grid、树在自定义 trees),`build_showcase_variants.py` 现对 `source_file=="site"` 的楼层整层保留;② 官方模板缺实例化树,已移植(write_web_showcase 从 spec 抽 52 树坐标进 metadata `site_trees`,app.js InstancedMesh 树干+树冠,2 draw call)。
|
||||
- 阴影接收板从 bounds.min.y(B1 底 -5.1m)钳制到 ±0 地坪(地下室存在时阴影悬空脱开建筑);favicon 404 用 data-URI 消掉,控制台零消息。
|
||||
- 浏览器亲测:IBL/软阴影/物理玻璃、爆炸 6m、剖切 14m、点击溯源(F3 墙体)、顶视摆位、390px 手机布局全部通过,截图存 `outputs/beian_1hao/web_verify/`。
|
||||
3. **Tier 2 连续墙体 `merge_wall_solids`**(默认关):spec_to_glb 用 shapely buffer+unary_union+extrude;Blender 端 Python 3.13 无 shapely(ABI 不敢注入),改用原生 `mathutils.geometry.delaunay_2d_cdt` 求并集、边界边挤侧墙。**几何教训:cap_style=2 平头矩形在共享端点的 L 角天生留 w/2×w/2 缺口,union 闭合不了(首轮对比渲染完全一致才暴露);解法是只对共享端点的墙端预延长 w/2(`extend_shared_wall_ends`),洞口自由端不动,T 接头本就有重叠。** 验收:L 角 union 后单多边形恰 6 顶点;默认关闭下厂区 GLB 与改前黄金文件逐字节一致(14,994,560B);开启后三角 +37%(选配近景用)。对比图 `wall_merge_{off,on}_corner.png`。
|
||||
4. **Tier 2 幕墙分格 `glazing_mullions`**(默认关,`glazing_panel_w` 1.5m):竖梃/横梃合成为伪墙段(细盒型材,横梃带 `_z0/_z1`)并入 `<floor>__walls` 节点,viewer 零改动得到墙材质,玻璃保留,且刻意绕过墙体 union。对比图 `mullions_{off,on}_facade.png`(87m F2 幕墙带效果显著)。
|
||||
5. **4#/5# 摆位**:向用户确认"含全部构筑物的可点坐标总平面"尚未拿到——按规范跳过,不造假体量;3# 仍为 ±1m 近似,manifest 注记不变。
|
||||
|
||||
回归测试扩至 **52 项 checks 全绿**(新增墙体 union 8 项、幕墙分格 8 项等)。产出均亲眼验证(浏览器截图 + Blender 渲染对比),无假数据。
|
||||
|
||||
## 交付物
|
||||
|
||||
`outputs/beian_1hao/`:beian_1.glb + beian_1_viewer.html(单楼)、beian_campus.glb + beian_campus_viewer.html(厂区:总平面 + 1# 按定位图摆位)、campus_check.png(摆位俯视校验)、site_manifest.json(各楼摆位配方)、beian_iso.png、beian_previews.png、building_spec.json、campus_spec.json、extract_config.json(t3 模板)、frames_report.md、extraction_audit.md、overlays/(8 层叠图 SVG)。
|
||||
Reference in New Issue
Block a user