# 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 框小体量。 10. **图层前缀习惯(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 地库图集出,避免双份几何。 (待续) 3. **消毒步骤误删 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。 4. **MIF 图名解码落地**(黄桥 TDD 存量):`\M+5XXXX` 转义在 cad_dxf_report 的 count_plan_titles 与 detect_sheet_frames 的 entity_text 统一解码 (\M+1..5 → cp932/big5/cp949/johab/gbk),多帧警告与图框识别恢复。 回归测试 10 项全绿。 5. **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 也可跑)。 7. **图签窗图例进模型,footprint 拉出"每层一个尖角"**(黄桥,用户目检发现): 每张图纸图签区画的窗样符号在真实 CURTWALL 层上(每框 6 段共 4.6m,距主体 18–40m,逐层同位),图层排除逮不住;footprint 凹包被拉过去生成细三角飘 板。修复:derive 新增 `drop_isolated_clusters`(默认开)——分类后对全部 段做端点邻近聚簇(union-find + 网格桶,linkage 3m),保留最大簇,丢弃 "距主体 >12m 且总长 <15m"的孤立微簇并大声警告;bounds 随过滤重算。真实 的脱开构件(连廊/门头,总长大或贴近主体)不受影响;F4 西侧高大厅通高幕 墙保留验证通过。回归 6 项(默认丢弃+警告+bounds 收缩+开关保留)。 8. **无支撑屋面线挤成悬空飘带**(黄桥,用户在 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 项(域内保留/域外丢弃/警告/开关)。 9. **轴网藏在匿名块里,图框对齐全 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、网格投票必对;教训:合成轴网要用不均匀开间,等距网格的子集 相关天然多解。