Files
cad-building-showcase/references/generalization_test_log.md
zhengwr 778f6b0b5d Log: plot-27 gatehouse + substation end-to-end; site plan has DIM_COOR anchors
Both small buildings pass the pipeline (gatehouse all gates PASS; substation
glazing legitimately SKIP, and drop_unsupported_roof_lines auto-removed 43m
of elevation-frame bleed — first organic catch on a new project). The site
plan carries 104 DIM_COOR coordinate callouts, so plot-27 placement needs no
external data. Remaining: the three big building sets, site manifest,
campus assembly.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 22:19:43 +08:00

13 KiB
Raw Blame History

Skill 泛化测试记录(test3d-7 三项目,2026-07-02 起)

目的:验证 cad-building-showcase skill 在不同 CAD 图纸上能否达到与贝昂案例 同等的 3D 模型质量。判定标尺 = One-Shot Definition of Done 七条门禁 + 量化指标 + 固定目检清单,任何门禁失败 → 修 skill(不绕过)→ 重跑。

测试对象

项目 形态 导出 考验点
黄桥文体中心 单体大公建 天正 _t3 多图框单文件(平面图 A-01-101~107 共 7 框)、钢结构、大跨
13号地块 双塔 + 地库 + 总图 天正 _t3 厂区装配、住宅塔楼标准层、地库
27号地块 1#综合楼A/B + 2# + 配电房 + 门卫 + 地库 _t3 与 _t8 混用 混合导出惯例、小体量构筑物、总平面定位

质量对比表(随进度填充)

门禁/指标 贝昂(基线) 黄桥 13号 27号
读图 Warnings 清零 PASS PASS(13/13 ok,ODA 兜底×3)
图框网格对齐 votes≥3 PASS PASS(7框全对齐 x=14 y≥11)
audit exit 0(三硬门禁) PASS PASS
无 topless_group / 三角化失败 PASS PASS(补 roof_specs 后)
邻栋间距门禁 PASS(0.19m 贴缝) n/a 单体
裁剪口径覆盖率 ~40%(多图框正常) 56.9%
幕墙连续率 100% 100%(6/6 层)
GLB(Draco) 0.57MB/121节点 0.37MB/42节点
目检(渲染+viewer) PASS PASS(console 零消息)

黄桥备注:柱仅 5 段(天正柱为 HATCH 填充,架构图不可提取——SKILL.md 已知 限制,需结构图补柱网);F4 幕墙延伸出墙体范围属实(高大厅通高幕墙出现在 多层平面),按图提取;主屋面暂合并为 20.1m 单板(25.0m 高体量顶待按 剖面证据细分 roof_specs);层高取自立面剖面 PUB_TEXT 标高 (B1=-5.5/F1=0/F2=5.6/F3=11.0/F4=15.5/RF=20.1)。

泛化缺口与修复清单

  1. dwg2dxf GBK 输出崩报告(发现于黄桥首跑):libredwg 在中文图纸上 stdout/stderr 是 GBK 字节,subprocess text=True 按 UTF-8 解码直接崩。 修复:改 bytes 捕获 + errors="replace" 解码。
  2. 消毒步骤毁 CJK 文本(发现于黄桥二跑):sanitize_dxf_comments 用 UTF-8 errors="ignore" round-trip 重写 ANSI_936/GBK 的 DXF, "一层平面图"→"一平图",下游 detect_sheet_frames 的平面图标题匹配整体失效; 结构破损还让 ezdxf 落入 recover 的 surrogateescape 路径,报告写盘 surrogates not allowed 崩溃。修复:消毒改字节级处理(保持原编码), 另加 scrub_surrogates 纵深防御(recover 泄漏的代理字符按 GBK 还原, 还原不了就替换,单个坏图不再拖死整批)。回归测试 +4 项(GBK 合成 DXF 全链路)。

13号/27号 进度(读图阶段完成,2026-07-02 晚)

  • ODA 自动兜底在两地块大规模验证:13号 18/18 全 OK(兜底 8/8)、27号 13/13 全 OK(兜底 9/9)。此前 libredwg 路径下 9 个文件 failed、8 个主图 0 实体,全部恢复(一号楼平面 36,715 实体/70 标题;27号 1#综合楼 89,629 实体/42 标题)。
  • 13号 已知障碍(下一轮处理):
    1. 立面剖面文件(A-0x-200-299)只有 5-6 实体 = 未绑定 XREF 壳——层高无法 从立面标高取,需从 0600 系列(2,834/2,153 实体)找剖面,或按住宅标准 层高推断并如实标注;总图 A-00 系列也偏空(24/159 实体,疑似 XREF 壳), 摆位数据可能要向用户要绑定后的导出。
    2. 新结构形态:多座 + 分区平面(frames_b1 检出 45 候选框): "A/B座"前缀是独立文字实体(标题只剩"座标准层平面图");地下层每层拆 2-3 张分区图(clip 高度重叠)。正确建模需要 (a) 座前缀归并, (b) 一层多 clip 拼接(当前 config 一个楼层只支持一个 clip+offset) ——skill 特性缺口,待设计实现。
    3. 住宅"标准层平面图"一框对应 5~26 层:config 需要楼层复制机制 (floor_order 展开或 template floor),当前要手写 N 份同 clip 条目。
  • 27号 待启动:全部图纸可读;总平面定位图 2,166 实体(有真实摆位内容); 建筑为"整套建施一文件"形态(平面+立面混排,28-49 标题),配电房/门卫 是 2 框小体量。
  1. 图层前缀习惯(A_DOTE/A_AXIS)令轴网匹配静默归零(13号):检测器 默认 axis-layers 是精确 token(AXIS/DOTE),该院所有图层带 A_ 前缀 → votes 全 0 落 clip 角点兜底。修复:默认 pattern 加通配 (*AXIS*,*DOTE*),回归用例 rowframe 加 layer_prefix="A_" 变体。 后续排查(同轮完成):A_AXIS 全部是 0.7-1.5m 轴号刻线(角度 0/90° 精确) 且位于墙 bbox 之外——两处投票杀手都已修:轴线收集窗口外扩 (pitch×0.16)、接受短刻线为网格候选(tick_min/tick_max = pitch×0.004 /0.05,同位刻线聚簇即一票;合成 tick 用例从 WEAK 变满票)。 但 13号 塔楼框实测仍 0 票且这是正确结论:249 根刻线全部属于其他 框(地下分区图),一层/二层/标准层框内没有任何轴线几何。此时只能走 DoD 逃生通道:clip 角点兜底 + 叠图逐层核验。注意 clip 角点锚的是墙 bbox 最小角,随内容而变(标准层 268914 vs RF 259914 差 9m = 阳台/ 露台外扩差异,贝昂 B1 式陷阱)——候选改进:轴线缺失时改用墙体位置 互相关(wall-correlation)做对齐,待下一轮设计。

13号 一号楼已完成的判读(供下一轮直接使用):办公 A/B 双塔 + 3 层裙房; 层高表(平面文件标高直方图 + "地上10层"说明):F1=0/6.0、F2=6.0/6.0、 F3=12.0/4.2、F4~F10=16.2 起步 4.2m 步进(标准层一框两翼,用重复 key 多 clip 合并——该能力已存在:floor_specs 为列表、buckets 按 key 聚合, 重复 key 自动并段,缺口 2 的"多 clip 拼接"实为文档缺失)、PH/RF=45.6、 机房顶 49.8、女儿墙 51.8、B1=-5.95、B2=-9.65;夹层框(F1M/F2M/B1M)与 分区地下框首版跳过;地下体量建议统一由 A-03 地库图集出,避免双份几何。

  1. 跨 clip 长线整条渗入楼层(13号):derive 的 clip 判定是"中点或端点 在框内即整条保留"——表格边框/注记长线把整张图纸宽度带进楼层(56m 框吐出 143m 几何,footprint 凸包长出游离大板,顶视图一片狼藉)。修复:新增 clip_segment_to_rect(Liang-Barsky)把线段裁剪到 clip 矩形,全内 线段原样通过。回归:40m 框内 140m 穿越线裁到框宽。贝昂框距大未暴露此坑, 图框密排的图集必踩。

13号 一号楼 round 3 结论(含一次重要撤回):

  • 有效产出:标准层/机房/屋顶的框内提取与 clip 裁剪干净,audit 三门禁 PASS,GLB 双塔形态正确。
  • 撤回:"双塔间距 85.8m"不可信——后续证据链("地下各层及一层平面图" 大框实为纯文字说明区、F1 仅 70m 墙容不下两个 49m 塔、A/B 座标题各踞一个 并排图框)表明标准层区域是 A/B 座并排排版,38m 框间隙是排版间距, 不是建筑几何;__2 的 104m 宽 clip 是墙 bbox 精修吞并邻框的检测伪影。
  • 教训(多座建筑通则):翼间真实位置只能由"同一图框内含双翼"的图纸 锚定(本例候选:A-03 地库的塔楼竖井、绑定 XREF 后的总图);并排图框的 间距永远不可当作建筑间距。floors_aligned 门禁对该形态存在盲区(多座 merge 后包络中心检查无法发现翼间距错误),候选加固:多座配置要求显式 anchor_frame 或跨框共有几何校验。
  • 下一轮:先提取 A-03 地库(6,877 实体、16 框)拿到双塔竖井真实间距, 再回填一号楼翼位与裙房分区,最后叠图核验 + viewer 目检。
  • round 3 收尾探针结论:地库包的"地上一层平时平面图"锚框候选是空壳 (15 条 A_P_LINE);第二区域 B1_2(地下一层平面图)有实内容 (A_WALL 377 / A_STAIR 442 / A_COLUMN 73)但也是 40m 分区条带—— 地库同样要分区拼接(机械能力已具备:重复 key 多 clip + Liang-Barsky 裁剪)。若地库拼接后仍无双塔竖井锚,则需向用户索取绑定 XREF 的总图/ 立面导出(A-00 总图与 200-299 立面均为壳)。

27号 round 4 进度(2026-07-02 深夜)

  • 门卫(6#)、配电房(5#) 全链跑通:图框检测(门卫 RF 网格对齐 x=6/y=4 票)、 标高实证(门卫 3.8/4.2,配电房 4.2/4.8)、derive/audit/GLB。门卫三门禁全 PASS(14 节点/1.2MB);配电房 floors_aligned PASS、glazing 合法 SKIP (变电所无幕墙),unsupported_roof 规则自动清掉立面框渗入的 43.2m 悬空 屋面线——新规则首次在新项目自然生效。_t8 与 _t3 图层方言在此两例上一致 (WALL/CURTWALL/COLUMN/AXIS/DOTE + 材质命名层如"古铜不锈钢/涂料分割线")。
  • 总平面定位图有真锚:DIM_COOR 层 104 个坐标标注(贝昂配方首选的 "可点坐标")+ 车位/消防道路/道路禁开口段等场布层——27号 摆位数据齐备, 不依赖外部补件。
  • 待办:1#综合楼A(42框)、1#B区(49框)、2#(23框)三个大体量的 detect→config→derive 循环;总平面 DIM_COOR 锚点提取与 site_manifest; assemble_campus 装配 + viewer 目检。

(待续)

  1. 消毒步骤误删 XRECORD 的 999 数值行(发现于苏州博物馆/test3d-8 首跑): sanitize_dxf_comments 逐行匹配 999,但 DXF 是严格 码/值 行对;ODA 转出的 XRECORD 里整数值恰为 999 时被当成注释码连删两行,后续组码整体错位, strict 读取抛 ValueError: Invalid handle {ACAD_REACTORS.(非 DXFError, read_doc 不兜底)→ 整文件误判 failed。libredwg 输出同样中招——首跑 111 个 "失败"文件中相当一部分是消毒自伤。修复:按码/值对遍历(只在码位上匹配 999); read_doc 兜底 (DXFError, ValueError) 走 recover。
  2. MIF 图名解码落地(黄桥 TDD 存量):\M+5XXXX 转义在 cad_dxf_report 的 count_plan_titles 与 detect_sheet_frames 的 entity_text 统一解码 (\M+1..5 → cp932/big5/cp949/johab/gbk),多帧警告与图框识别恢复。 回归测试 10 项全绿。
  3. ODA 自动兜底进代码(黄桥主平面图 0 实体触发):libredwg 转大型天正 DWG 产坏件(重复句柄、缺 ENDBLK/EOF)或转出空 modelspace——黄桥 A-01-101~107 经 dwg2dxf 读 0 实体、经 ODA 读 21,171 实体。 cad_dxf_report 现在对"转换失败 / inspect failed / modelspace 0 实体"的 DWG 自动走 ODA File Converter 重转(ASCII 暂存名规避编码坑、1800s 超时、 oda_fallback_ok/failed 留痕;env ODA_CONVERTER 可覆盖路径)。 回归测试用假目录转换器锁住兜底管线(3 项,沙盒无 ODA 也可跑)。
  4. 图签窗图例进模型,footprint 拉出"每层一个尖角"(黄桥,用户目检发现): 每张图纸图签区画的窗样符号在真实 CURTWALL 层上(每框 6 段共 4.6m,距主体 18–40m,逐层同位),图层排除逮不住;footprint 凹包被拉过去生成细三角飘 板。修复:derive 新增 drop_isolated_clusters(默认开)——分类后对全部 段做端点邻近聚簇(union-find + 网格桶,linkage 3m),保留最大簇,丢弃 "距主体 >12m 且总长 <15m"的孤立微簇并大声警告;bounds 随过滤重算。真实 的脱开构件(连廊/门头,总长大或贴近主体)不受影响;F4 西侧高大厅通高幕 墙保留验证通过。回归 6 项(默认丢弃+警告+bounds 收缩+开关保留)。
  5. 无支撑屋面线挤成悬空飘带(黄桥,用户在 Blender 里发现 F3__roof 悬浮): 平面图会画低矮雨篷/坡屋面轮廓(A-ROOF),其支撑柱是天正 HATCH 填充提不出 来——黄桥 F3 西南角坡屋面下方 F1/F2 均无一段墙,挤出后 15 段线带悬在 11m 空中;B1 平面上的地面雨篷投影线更是埋在 -5.85m。修复:derive 新增 drop_unsupported_roof_lines(默认开)——roof 段中点在"全部楼层 footprint+caps 并集 buffer 2m"之外即丢弃并大声警告(黄桥 F3 丢 10 段/ 24.1m、B1 丢 1 段/82m;贴主体 2m 内的附墙雨篷边保留);要保留可显式加 roof_specs 板或关开关。回归 5 项(域内保留/域外丢弃/警告/开关)。
  6. 轴网藏在匿名块里,图框对齐全 WEAK(黄桥):detect_sheet_frames 只扫 modelspace 线,而这套图把每框轴网包在 A$C... 匿名块(DOTE 线 296/203/197 条在块内、msp 仅 8 条),投票 x=0 y=0 → 全部落到 clip 角点兜底。修复: 检测器递归展开 INSERT(深度≤3、按块名 memo 只展开含轴/墙层曲线的块), 黄桥 7 框全部恢复 grid-aligned(votes x=14 y≥11),B1 的独立偏移被正确 纠出。回归用例构造"轴网在块内 + 两框墙体 bbox 不同"场景,clip 角点兜底 必错 20m、网格投票必对;教训:合成轴网要用不均匀开间,等距网格的子集 相关天然多解。