docs: 记录 Phase 0 实测结果、AutoCAD 自动化实测环境与属性 key 的取舍

Conversation 0 Commits 2 Files Changed 5

+166 -3

2 Commits

Author	SHA1	Message	Date
company-desktop	6559cdf6f5	docs: 记录 Phase 0 实测结果、AutoCAD 自动化实测环境与属性 key 的取舍 Phase 0 在本机跑通（big1.dwg / AutoCAD 2020 / R230 Debug，开图 108 s）： RegionTexts=5641 UniqueHashes=2597 SimulatedHits=3044 HitRate=54.0% TempFiles=6773 TempBytes=9,341,125 WriteBacks=1140 CoreTools::StringToRegion 2559 次 14.6 s 平均 5.7 ms 最长 321 ms EwPipe::RegionAcisIn 3082 次 8.3 s 平均 2.7 ms EwPipe::RegionAcisout 1140 次 2.3 s 平均 2.0 ms 结论：一次开图做 5641 次 SAT 恢复，共 22.9 s（约占 108 s 的 21%）。此前基于 CPU 采样的估算只有 550~1000 次，低估了 5~10 倍——说明采样只能算占比，算不出调用次数，这类结论必须靠计数器。按 54% 命中率折算，Phase 1 缓存净省约 12 s（约 11%），并少约 4000 次临时文件写盘。同时记录三个待追查项：命中率为何只有 54%、StringToRegion 为何比 RegionAcisIn 贵一倍、开图期间为何回写 1140 次 SAT。文档里补充了"用管子属性做 key"的思路与风险：属性相同则截面相同，业务上成立，但不能单独当 key——DWG 里的 SAT 文本可能来自旧版本/旧路径/手工编辑的异形截面，属性漏一项就会静默复用错误几何。若要做，采用 L1 内容 hash + L2 属性 key 的两级结构， L2 命中后仍比对 textHash，不一致按 miss 处理；落地前先加一路属性 key 命中率计数比较。另外新增 tools/run_acad_perf.ps1 并在 AGENTS.md 记录本机 CAD 实测环境： acad.exe 路径、/p SHS-ENVI2026 启动参数、测试图纸、部署目录，以及"PowerShell 5.1 把无 BOM 的 UTF-8 当 ANSI 读"这个坑（脚本保持 ASCII）。验证：文档与脚本；脚本语法检查通过，本次实测就是用它的等价命令跑出来的。	2026-10-28 19:52:18 +08:00
company-desktop	3f387485fd	fix: 计数器改用 NDEBUG 判断构建类型（本仓库把 _DEBUG 剥掉了）现象：Debug 构建的 R230 里 ENVIPERFDUMP 报"未知命令"，计数器也永远不生效。根因：cmakelists.txt 第 23~24 行会把 /D_DEBUG 从 CMAKE_CXX_FLAGS_DEBUG 里正则剥掉，所以即使 --config Debug 编译，_DEBUG 也没有定义。于是 Phase 0 里用 `#if defined(_DEBUG)` 包住的命令注册和 Enabled() 判定整块被编掉—— 已用二进制验证：修复前 arx 里查不到 ENVIPERFDUMP，修复后能查到（UTF-16 字符串）。修复：改用 NDEBUG。cmakelists.txt 只对 Release 定义 NDEBUG （`$<$<CONFIG:Release>:NDEBUG>`），所以 `#ifndef NDEBUG` 正好等价于"Debug 构建"。 - CoreLibrary/SectionPerfCounter.cpp：计数器启用条件 - CoreCommand/EarthWorm.cpp：ENVIPERFDUMP / ENVIPERFRESET 的函数定义与命令注册验证：R230 Debug 两个 target 重新编译通过，产物已部署；脚本自动开图后 ENVIPERFDUMP 正常输出（数据已记录到计划文档 Phase 0 实测结果）。已知风险：`#ifdef _DEBUG` 在本仓库本来就不生效，rxdebug.cpp 等历史代码同样如此，本次只修自己新增的两处，没有动别处。	2026-10-28 19:52:18 +08:00

Author

SHA1

Message

Date

company-desktop

6559cdf6f5

docs: 记录 Phase 0 实测结果、AutoCAD 自动化实测环境与属性 key 的取舍

Phase 0 在本机跑通（big1.dwg / AutoCAD 2020 / R230 Debug，开图 108 s）：

  RegionTexts=5641  UniqueHashes=2597  SimulatedHits=3044  HitRate=54.0%
  TempFiles=6773  TempBytes=9,341,125  WriteBacks=1140
  CoreTools::StringToRegion  2559 次  14.6 s  平均 5.7 ms  最长 321 ms
  EwPipe::RegionAcisIn       3082 次   8.3 s  平均 2.7 ms
  EwPipe::RegionAcisout      1140 次   2.3 s  平均 2.0 ms

结论：一次开图做 5641 次 SAT 恢复，共 22.9 s（约占 108 s 的 21%）。
此前基于 CPU 采样的估算只有 550~1000 次，低估了 5~10 倍——说明采样只能算占比，
算不出调用次数，这类结论必须靠计数器。
按 54% 命中率折算，Phase 1 缓存净省约 12 s（约 11%），并少约 4000 次临时文件写盘。

同时记录三个待追查项：命中率为何只有 54%、StringToRegion 为何比 RegionAcisIn 贵一倍、
开图期间为何回写 1140 次 SAT。

文档里补充了"用管子属性做 key"的思路与风险：属性相同则截面相同，业务上成立，
但不能单独当 key——DWG 里的 SAT 文本可能来自旧版本/旧路径/手工编辑的异形截面，
属性漏一项就会静默复用错误几何。若要做，采用 L1 内容 hash + L2 属性 key 的两级结构，
L2 命中后仍比对 textHash，不一致按 miss 处理；落地前先加一路属性 key 命中率计数比较。

另外新增 tools/run_acad_perf.ps1 并在 AGENTS.md 记录本机 CAD 实测环境：
acad.exe 路径、/p SHS-ENVI2026 启动参数、测试图纸、部署目录，
以及"PowerShell 5.1 把无 BOM 的 UTF-8 当 ANSI 读"这个坑（脚本保持 ASCII）。

验证：文档与脚本；脚本语法检查通过，本次实测就是用它的等价命令跑出来的。

2026-10-28 19:52:18 +08:00

company-desktop

3f387485fd

fix: 计数器改用 NDEBUG 判断构建类型（本仓库把 _DEBUG 剥掉了）

现象：Debug 构建的 R230 里 ENVIPERFDUMP 报"未知命令"，计数器也永远不生效。

根因：cmakelists.txt 第 23~24 行会把 /D_DEBUG 从 CMAKE_CXX_FLAGS_DEBUG 里正则剥掉，
所以即使 --config Debug 编译，_DEBUG 也没有定义。于是 Phase 0 里用
`#if defined(_DEBUG)` 包住的命令注册和 Enabled() 判定整块被编掉——
已用二进制验证：修复前 arx 里查不到 ENVIPERFDUMP，修复后能查到（UTF-16 字符串）。

修复：改用 NDEBUG。cmakelists.txt 只对 Release 定义 NDEBUG
（`$<$<CONFIG:Release>:NDEBUG>`），所以 `#ifndef NDEBUG` 正好等价于"Debug 构建"。

- CoreLibrary/SectionPerfCounter.cpp：计数器启用条件
- CoreCommand/EarthWorm.cpp：ENVIPERFDUMP / ENVIPERFRESET 的函数定义与命令注册

验证：R230 Debug 两个 target 重新编译通过，产物已部署；
脚本自动开图后 ENVIPERFDUMP 正常输出（数据已记录到计划文档 Phase 0 实测结果）。
已知风险：`#ifdef _DEBUG` 在本仓库本来就不生效，rxdebug.cpp 等历史代码同样如此，
本次只修自己新增的两处，没有动别处。

2026-10-28 19:52:18 +08:00

docs: 记录 Phase 0 实测结果、AutoCAD 自动化实测环境与属性 key 的取舍 #98