Files
cad-building-showcase/docs/history/贝昂CAD诊断与skill优化.md

15 KiB
Raw Permalink Blame History

贝昂科技厂区 CAD:为什么生成错了 + skill 优化记录

历史复盘;当前操作规范以 SKILL.md 与 references/ 为准。

日期: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)。