Files
cad-building-showcase/docs/history/generalization_test_log.md

394 lines
30 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Skill 泛化测试记录(test3d-7 三项目,2026-07-02 起)
> 历史工程日志;当前规则以 `SKILL.md` 与 `references/` 为准。
目的:验证 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) | PASS(18/18 ok,ODA 兜底×8;XREF=缓存块解锁) | PASS(13/13 ok,ODA 兜底×9) |
| 图框网格对齐 votes≥3 | PASS | PASS(7框全对齐 x=14 y≥11) | PASS*(塔楼框 votes=0 是正确结论:图签定位+墙剖面相关人工配方,叠图核验) | PASS(1#A 14框对齐;1#B x=21;2# 修参考框后 x=17 全列;墙相关兜底在 B1 首次自动生效) |
| audit exit 0(三硬门禁) | PASS | PASS | PASS(+block_locked WARN 信息性) | PASS×5栋(1#A 四门禁全 PASS;1#B/2#/配电 glazing 合法 SKIP) |
| 无 topless_group / 三角化失败 | PASS | PASS(补 roof_specs 后) | PASS(roof_specs) | PASS(roof_specs 全覆盖) |
| 邻栋间距门禁 | PASS(0.19m 贴缝) | n/a 单体 | PASS(-1.46m=共享地库坡道咬合,放行留痕) | PASS(全正值,min 1.72m) |
| 裁剪口径覆盖率 | ~40%(多图框正常) | 56.9% | b1 51.5% / b2 48.0% | 1#A 76.4% / 1#B 57.3% / 2# 46.0% / 配电 87.2% / 门卫 73.5% |
| 幕墙连续率 | 100% | 100%(6/6 层) | 100%(厂区 30 层全通过) | 1#A 100%(18层);2# 6/6;住宅塔无幕墙合法 SKIP |
| GLB(Draco) | 0.57MB/121节点 | 0.37MB/42节点 | 5.4MB HTML 离线 viewer/127节点 | 2.75MB Draco/520节点(7栋100层) |
| 目检(渲染+viewer) | PASS | PASS(console 零消息) | PASS(离线 viewer console 零错误) | PASS(离线 viewer console 零错误,鸟瞰布局与总图一致) |
三项目 Web 交付(2026-07-03 浏览器实测均零 console 错误、交互正常):
`outputs/huangqiao/viewer_huangqiao.html`(2.9MB)、`outputs/dikuai13/viewer_dikuai13.html`(5.4MB)、
`outputs/dikuai27/viewer_dikuai27.html`(11.5MB,7栋100层)。
黄桥备注:柱仅 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 地库图集出,避免双份几何。
11. **跨 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 目检。
## 13号 解锁:XREF 内容其实在包内(round 5,用户追问促成)
**修正此前"需要设计院补绑定总图"的结论**——用户反问"你不会自己操作吗"
促使深挖,发现被引用内容以 **AutoCAD 缓存块**形式存于宿主 DWG:
`X-00-0011`(总图)块内 5,306 图元、`X-01-0200`(立面)4,443 图元;
modelspace 只有 INSERT 桩,读图报告按 msp 计数误报 near_empty。
libredwg 丢 xref 标志、ODA 保留 `xref_path=".\\X-01-0200.dwg"` 但 flags=0
——两条转换路径都把缓存内容导成普通块定义,**expand_blocks 即等效绑定**。
证据要点:总图块内层名带 `X-00-0011$0$` 绑定前缀(0-规划道路/0-景观树木/
0-地面停车/0-消防环线/栏杆/DIM_COOR×40);单位为米制测绘坐标
(x≈55km, y≈57km,同贝昂总图形态);楼栋尺度轮廓在 `...$dx` 层。
**待落地的 skill 改进(下一轮 TDD)**:
1. cad_dxf_report 的 near_empty/xref_shell 判定要检查"INSERT 引用的块内
实体数"——桩+大块 = 缓存 XREF,提示 expand_blocks 而非"找用户要文件";
xref_definitions 收集也要识别 flags=0 但 xref_path 非空/块名 X-* 的情况。
2. detect_sheet_frames 的标题扫描要进入此类大块(当前只扫 msp 文本)。
3. 一号楼翼间距锚:总图 dx 层楼栋轮廓 + 40 个 DIM_COOR 坐标标注;
立面块 X-01-0200 可实证层高表。
## 13号 round 6:一号楼全楼重锚完成(2026-07-02 深夜续)
**撤回之撤回:85.8m 双塔间距是对的。** 总平面缓存块 X-00-0011(藏在
A-00-011-099_t3.dwg,msp 只有 3 个桩 + 两个 1:500 A0 框)展开后实测:
- 三塔同转角 157.668°、同长 49.80m:A座 ctr(56728.78,57289.85)、
B座 ctr(56649.42,57322.45)、二号楼 ctr(56585.65,57348.81)(OBB 49.8×22.5/22.2)
- **B→A 中心距 85.80m、横向偏差 0.00m**;B→二号楼 69.00m 同列
- 图纸内 `__2`/`__3` 标准层框 offset 差恰 85,800mm——图内相对位置=真实位置
(全 DXF 共享一个绘图原点)。当时撤回的理由("F1 70m 装不下双塔")错了:
F1 其实画在 **加长A0(178.35×84.1m @1:100)** 上、全楼一张图,检测器按
sheet pitch(≈55m) 的粗窗把它截半了。
- 交叉验证:85.8+49.8=135.6m + 外墙 = 138.6m = B1 提取跨度 ✓
- 其余锚:办公A/B座 10F H=46.55(女儿墙46.40);裙房 2F H=12.30(12.15);
二号楼 16F H=57.95(57.80);±0.00=4.30 绝对标高;测绘惯例图面x=测绘Y。
已固化 outputs/dikuai13/site_anchors.json(含地下室轮廓 70 点)。
**重锚方法(无轴网楼栋的通用配方,已人工验证,待 TDD 进 skill)**:
1. **共享 x 原点判定**:F3 图幕墙 x=[276262..326062] 与 A座标准层逐毫米相等
→ 同列图纸共享 x,offset_x 全部统一为标准层的 268914.9。
2. **墙体 y 剖面互相关**:塔柱列(两塔 x 带)内墙段按 y 直方图(20mm 桶,
长度加权),与标准层互相关取峰 → 每张图的 y 平移。双塔独立求解全部 Δ=0mm
互证;且 F1/F2/F3 行间平移恒等图框行距 85,100mm,再证。
3. 修正量:F1 偏 x+75.6m/y+12.9m;F2 偏 y+18.4m;**F3 错槽 85.8m(A座三层
被锚到 B座)**;PH 偏 y+4.3m;RF 偏 x≈11m/y+11.3m——而旧 audit
floors_aligned 全 PASS(门禁对"自洽但整体错位"失明,需要跨层公共基准)。
4. F2/F3 图面北缘的楼梯/前室大样混入 → clip y 带宽剔除(与黄桥图签图例同族;
isolated-cluster 阈值逮不住 20m 外 6m 大盒)。右侧簇 45 框全是核心筒详图,
当楼层框检出全 WEAK——详图簇要能识别丢弃。
5. 结果:spec 重导 12 层,F4-F10 双塔 135.6×22.5 ✓,F1 158.7m(含两端
地库坡道,与总图"地库入口/出口"位置吻合)✓,门禁 3 PASS +
block_locked WARN(并行会话新门禁,信息性);b1.glb 64 节点重建,
顶视/轴测目检通过(双塔立于裙房、比例正确)。
**新增 skill TODO(本轮实证出的缺口)**:
- detect_sheet_frames 应优先用图签块 INSERT(A0/A1/A2*_V1 + scale)定图框矩形,
pitch 窗口只做兜底——加长A0 被 pitch 截半就是教训。
- "共享原点 + 墙剖面相关"要成为 votes=0 时的自动对齐路径(先验证共享 x,
再 1D y 相关,双塔/双列一致性做置信度)。
- floors_aligned 门禁要加跨层公共基准核验(如标准层墙罩盒 vs 各层同列内容)。
## 13号 round 7:二号楼 + 厂区装配完成(地上部分收口)
**二号楼(A-02-0100)** 图册干净:左列 5 张 A1(1:100)纵排、行距 60,400,
一层/二层/标准层/机房/屋顶各一张;右侧全是核心筒详图(与 b1 同病,检出即弃)。
- 共享 x 逐毫米成立;墙剖面相关的 y 平移 = ±k×60,400 严格整数倍(内容随框恒位)。
- 剖面标高序列实证层高表:F1=0/6.0、F2=6.0/3.4、F3=9.4/3.4(无独立图,
沿用二层平面)、F4–F16=12.8+3.4k、主屋面 57.0、女儿墙 57.8/58.0、
机房顶 61.2、塔冠幕墙 63.4——**与总图标注 63.4 独立吻合**。
- 塔身提取 49.8×22.2 与总图 OBB 完全一致;门禁 3 PASS + block_locked WARN;
b2.glb 63 节点;F2 与标准层轮廓叠图重合。
- 坑:floor_order 从 b1 抄来只有 F1..F10 → F11-F16 被静默滤掉("floors":12
才暴露)。skill TODO:derive 应在 config floors 里出现但 floor_order 缺失时
大声告警而不是静默丢层。
**厂区装配(assemble_campus)**:锚=总图缓存块实测塔心 OBB 中心,
rotation −22.332°;一二号楼包络重叠 −1.46m 经叠图核验为**缝隙共享地库坡道**
(两张一层图各画一半、互补咬合非重复)→ --allow-overlap 放行并留痕。
campus_spec 30 层/2 楼,dikuai13_campus.glb 127 节点,轴测目检与总图排布一致。
产物:site_anchors.json / site_manifest.json / campus_spec.json /
dikuai13_campus.glb / campus_iso.png / stack_check2.png / b2_verify.png。
**范围说明**:地下车库(A-03,B1/B2/夹层多分区)为地下体量,showcase 默认
不展示,本轮不建模;一层两端地库坡道挡墙已随 F1 提取呈现。待需要时按
右簇分区图+人防图纸另行拼接。
## 27号 round 5-8:三大体量 + 总平面配准 + 厂区装配(2026-07-03,全程收口)
**1#综合楼A(17F办公,0908_t3)**:剖面标高梯干净(0/4.5/.../76.5,机房顶79.5,
女儿墙80.1——图框检测聚合列里的 2.25 步进是楼梯半层平台,逐框probe即排除)。
四层是裙房顶大平层(办公区/楼梯/露台标注俱在,2-2剖面止于18.0 证裙房=F1-F4)
——初判"clip 吞邻框"是误判,唯一真污染是 F6 clip 上缘越入 F5 图纸下缘(收紧
y 带解决)。屋顶平面框只有 S-BEAM/单线/落水管,弃用,主屋面 roof_specs 从
F17 出板。18 层四门禁全 PASS,幕墙连续 100%。
**1#B区(10F,租赁_t3)**:标准层平面由**户型块拼装**(hxt11/hxt22 各含 75 段
WALL 线,轴网在 $TD_AUDIT_GENERATED_(6792) 块)——按名单展开丢墙,必须
expand_blocks=true 全展开。首版 clip 被假 x-pitch 砍半(右侧详图簇同排标题
制造 pitch_x≈15.8k),楼被切掉整翼——检测器修复后全宽恢复(44.9×17.3 ↔ 总图
轮廓 40×14.5 ✓)。精修 clip 会吞上一张图纸的层间杂条:按各层墙 y 簇裁带解决。
层高实证 F1/F2=4.5、F3-F9=2.95、F10=2.85、机房顶35.5。
**2#(22F住宅,_t7_t3)**:此前"全 WEAK"的根因是**参考框选错**——检测器把
"非机动坡道一层平面图"当参考(辅助构筑物,轴网与塔楼无关)。修复参考框排序后
主列 votes x=17 y=7 全对齐;墙剖面互相关兜底在 B1 上首次自动生效
(coverage 0.86/0.83)。墙在绑定前缀层(12314$0$WALL)须 *WALL* 通配且
glazing 在 walls 之前匹配。3.0m×22 层梯(0..66,机房顶69)。
**总平面配准(A-00-001定位图)**:图面坐标=测绘米制(x=测绘Y东、y=测绘X北,
与13号同惯例,52 个 X=/Y= 坐标标注对直接验证)。楼栋轮廓藏在 **EVTR 层**
(六栋闭合多段线按最近楼栋标签认领);1#A **没有画轮廓**,只有 DIM_COOR 角点
——剔除车库轮廓线/消防登高场地上的标注点后,用"模型多层 footprint 并集 对
角点集"点-边 ICP 配准(θ=-2.15°,与 1B 的 -2.1° 场地统一倾角互证)。轴对齐
轮廓要锁角度窗(阳台齿会造出 ~10° 的伪极小值——B2 教训)。配电房配准残差
0.063m(轮廓 9.2×19.2 与模型毫米级吻合)。**总图还揭示 3#/4# 两栋 21-22F
住宅无交付图纸**:按 EVTR 轮廓×层数×3.0m 出诚实体量块(spec 标注"总图轮廓
体量")。门卫模型(42.8m)与总图雨篷(17.4m)尺寸不符,按重心放置留痕待查。
**装配**:assemble_campus 新增每栋 rotation_deg(4#楼独自斜置 ~27°);
7栋100层,邻栋间距全正(min 1.72m),dikuai27_campus.glb 520节点/50.6MB
(Draco 2.75MB)。离线 viewer 浏览器实测零 console 错误,鸟瞰与总图一致。
## 泛化缺口与修复清单(27号 round 5-8 新增,全部 TDD 带回归)
12. **辅助构筑物标题抢参考框**(2#全WEAK根因):ref_rank 只认 key=="F1",
"非机动坡道一层平面图"先到先得。修复:标题纯度判定(楼层词+平面图 之外
有前缀=辅助),辅助框永不做参考并在报告标记;纯 F1 族优先。回归 auxref 场景。
13. **votes=0 的墙剖面互相关自动对齐**(13号 round 6 人工配方进代码):
墙位置直方图(长度加权,x/y 独立),coarse 500mm 投票 + fine 50mm 精化,
coverage≥0.35 且峰比≥1.5 才接受(防止坡道对塔楼的伪相关),报告
`wall-correlated` 而非静默 WEAK。回归 nogrid 场景(clip 角点必错 20m)。
14. **散排标题伪造 x-pitch 砍半 clip**(1#B 整翼被切):pitch_y 存在且
pitch_x < 0.7×pitch_y 时判伪弃用(真实 2D 图纸网格的 pitch_x≈图宽,
不会远小于图高)。回归 mixedrow 场景。
15. **缓存 XREF 识别**(13号 round 5 教训进代码):cad_dxf_report 新增
`insert_block_content`(msp INSERT 引用块的实体量),近空 msp + 块内
≥200 实体 → `cached_xref_content` 警告(提示 expand_blocks≈bind),
不再误导"找用户要绑定导出";detect_sheet_frames 标题扫描进展开块
(13号形态:图名也在缓存块内)。回归 cachedxref/blocktitle 场景。
16. **floor_order 缺口静默丢层**(13号 b2 F11-F16 消失教训):derive 对
"drawings 有但 floor_order 没有"与"floor_order 有但无图产出"两个方向
都大声告警。回归 fo_config 场景。
17. **assemble_campus 每栋 rotation_deg**(27号 4#楼独自斜置):manifest
每栋可覆盖全局旋转。回归 90° 旋转场景。
18. **凹包桥接双塔生成横跨楼板**(13号 一号楼,用户 viewer 目检发现):
一层 key 装 A/B 两塔时 concave_hull 对全部点只出一个包,
use_footprint_slabs 在 36m 空隙上逐层铺板(侧视=塔间"三角连接")。
修复:出包前按端点邻近分簇(footprint_cluster_linkage 6m,网格桶并查集,
段两端强制同簇),每簇独立凹包——真连廊因连廊墙自然连通不受影响。
修后 F4-F10 = 2×49.8m 独立塔包(与总图 OBB 一致);黄桥 F4/RF 北侧
1.4m 长条构件也随之脱离主包(更诚实);27号 各楼无回归。回归 twintower
场景(两簇 40m 距,断言 2 包且无 25m+ 跨包)。教训:**门禁与顶视图对
桥接楼板都不敏感,侧视/正视目检必须看"楼间空气"**——已列入 DoD 目检项。
19. **图签块 INSERT 定图框**(留档项③落地,13号 加长A0 教训):detect 预扫
msp 中 A0/A1/A0+0.5_V1/图框/图签 类块名的 INSERT,世界 bbox 通过尺寸/
长宽比合理性检验后作为该框 clip 窗(墙精修结果 clamp 在框内,不吞邻图);
13号 b1 实测 45 框全部由图签矩形定窗。回归 titleblock 场景(加长A0 一框
双塔,pitch 窗必截半)。
20. **floors_aligned 跨层墙基准核验**(留档项⑤落地,13号 F3 错槽教训):
audit 对同组楼层做墙剖面互相关(对墙量最大的参考层),强峰在非零位移
(|shift|>1m,coverage≥0.45,ratio≥1.5)→ FAIL "自洽但整体错位"。
**零位移护栏**:目标层在原位已贴合(zero_cov≥0.7×best)则不报——
密集裙房参考层会让小轮廓层"哪儿都能贴上"(27号 1#A PH 在 1.5m 处
出过伪峰)。回归 crossdatum 场景(错槽 FAIL/对槽 PASS)+ 三项目审计
无误报。
21. **门卫"尺寸不符"溯源结论(非缺陷)**:模型 42.8m 是大门建筑组
(两侧门房 x 0-8/21-29 + 端部围墙 39-42 + 中间门洞幕墙带),总图只画
岗亭符号(2.4m 八边形)+门头雨篷(17.4m)——表达粒度不同,重心放置合理,
结案。
22. **场地机制产品化 + config 自动化**(本轮以会话脚本验证的能力固化进
scripts/):`register_site_outlines.py`(点-边 ICP 配准 CLI,manifest
片段直出,残差>2m 大声告警)、`massing_from_outline.py`(轮廓×层数
体量 spec CLI);detect 三项:多层合并图名自动展开(四、六、八/
十一至十四 → 每层一条 config 条目,13号 b2 静默丢层的根源性预防)、
复合中文数字解析(十一/二十一 不再变 F0 键)、逐框标高梯 + 均匀步进
层高建议(27号 2# 实测:19 层枚举图名自动展开、step 3.0×11 建议命中;
建议只是证据不自动填 z——楼梯剖面的半层节拍是反例)。回归 +11 项。
23. **查漏门禁四件套**("新项目会不会漏"的正面回应——全部是账目/互证型
不变量,对没见过的方言天然有效):
- `frame_ledger`(audit --frames):检出框必须入 config 或列入
`discarded_frames` 带理由——静默弃用的框正是整翼消失的所在;
- `area_declared`(config `declared_areas_m2`):模型 footprint 面积对
经济技术指标表/标注互证(±15% 默认)——1#B 半栋消失只有总图能暴露;
- `storey_count`(config `expected_storeys_above_ground`):地上层数对
总图 22F 标签/标高梯级数互证;
- `unknown_layer_dialect`(读图报告):平面文件无任何 *WALL*/*墙* 类图层
时点名"陌生方言,先自觉建映射"。
三门禁未布防时 SKIP(既有项目零影响),新项目应全部布防。回归 +8 项。
24. **Web 模板功能移植 + 按需渲染**(test3d-5 会话演进版回收进模板,2026-07-04):
变体页内热切换、分享链接(全状态进 URL hash)、自动巡游、toast、建筑分组
楼层控制(无 buildings 字段时按楼层键前缀回退分组)、按(楼层,类别)合并
网格削 draw call、渐进加载(单 GLB 部署自动跳过二段加载);书签补全
(列表+恢复+删除+入 hash)。**按需渲染**根治"网页开着风扇狂转":静态场景
只在变更时渲染(invalidate() + damping/autoRotate 期间连续),阴影
autoUpdate=false 按变更重烤,模板与离线 viewer 同一契约;27号 实测
模板 web 静止 3 秒 0 帧、离线 viewer 加载全程仅 25 帧。`window.__renders`
为诊断计数,DoD 目检可要求"静止时不增长"。
**仍留档**:⑦ 未命名详图簇(核心筒大样)仍靠 clip 带宽人工剔除,标题纯度
只覆盖有名字的辅助框(需要"详图簇 vs 楼层框"的几何判别设计);2# 的
"十九、二十一层平面图"修改单簇(无障碍改造相关)未并入模型(需用户确认
以哪版为准)。
(待续)
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、网格投票必对;教训:合成轴网要用不均匀开间,等距网格的子集
相关天然多解。