7.1 KiB
0.3.2 原生数据库更新不阻塞策略与实测(2026-10-10)
用户授权与策略
用户明确要求不要仅因数据库/日志变化阻塞有效 PDF,并要求检查实际影响。默认采用 native_updates_warn:声明的数据库目录中 icdb.dat 仅内容修改、cdbsvr 的 events/log/plog/dbcheck/dbupgrade 子目录与 sAddress.adr 变化、新增 cdbback ZIP,只记录成功提示。不能据此证明变更来源或无害。主数据库新增/删除、配置/图纸/未知文件变化仍阻止发布。严格检查可选且默认关闭。
完整源指纹和 source-diff.json 保留;source-assessment.json 记录允许及阻止的变化。源变化时 commit.json 的 source_verified_before_publish 和 source_content_identical 均为 false,不伪称字节不变。有效 PDF 发布状态为 success,warnings 单列;UI 显示成功(有提示),批量统计计入成功内提示。原生失败、超时、取消或无效 PDF 不会被允许的数据库变化掩盖,也不会覆盖旧输出。不创建工程副本或旧 PDF 备份。
自动测试
新增策略分类、配置/未知变更拦截、声明数据库目录与大小写、主数据库新增/删除、严格模式、无效 PDF、原生退出失败/取消/超时、CLI 退出码与 GUI 严格参数传递、成功提示显示、完整双工程队列统计测试。
完整最终命令:.venv/Scripts/python.exe -m pytest -q --junitxml=artifacts/pytest-v032-final.xml。
197 passed,118.59 秒,退出码 0。 初始回归测试记录保存在 artifacts/pytest-v032-red.log;修复前缺失策略/警告/可选严格模式的测试失败,不用事后单次绿色代替回归验证。
原生实际测试方法
使用本机 EE7.9.5 sch2pdf.exe 与安装自带 icdb2ascii.exe(先核对 -help)。CBB 选现有 Audio_D2128_SURGE_ESD 原工程;PON 使用早已存在的工程A测试工程。本轮不新建工程工作副本、不恢复/降级数据库、不删除原生升级备份。
每个工程:
- -snap=DxD -t -c -h -offline 生成连接及文本属性报告。
- 真实导出两次到不同输出目录,保留原生 PDF 作 QA 对照。QA 保留原生暂存 PDF,不是生产旧输出备份,也不是工程副本。
- 每次导出后再次生成报告。只去除报告日期/选项头,逐字节比较全部 Block 开始的设计正文;包括连接、符号/引脚属性、空值和同名多值,未排序或删除设计字段。
- 比较页面框、矢量坐标、颜色与线宽、文字、书签、注释和链接。字体处理前后分别比较,不把修复乱码时预期发生的字体变化当作源 CAD 变化。
- 全部页按 2 倍分辨率渲染,两次原生输出与两次最终输出分别逐像素比较;不只抽检首页。
- 打包 EXE 另外实际导出 CBB 一页。清除 Python/Qt 搜索覆盖但保留安装所需 Mentor 环境,验证 CLI 返回 0、文件实际发布、源更新有 warnings;再次对比设计报告及页面像素。
注意 icdb2ascii 查询本身也会更新 icdb.dat/日志,所以测试记录明确区分源字节变化和设计报告正文变化,不能把原生报告查询称为只读保证。
真实结果
| 样本 | 原生页数 | 网络 | 符号(含引脚/注释等类型) | 连接项 | 报告属性项 | 导出前后报告正文 | 重复输出逐页渲染 |
|---|---|---|---|---|---|---|---|
| CBB_Audio | 1 × 2 | 22 | 56 | 229 | 577 | 一致 | 2 组,均一致 |
| PON_17pages | 17 × 2 | 465 | 1018 | 5260 | 14054 | 一致 | 34 组,均一致 |
四次原生导出全部成功(有源更新提示),总计 36 页;打包 EXE 额外成功发布 1 页,总计 5 次、37 页。便携版设计报告正文与基线相同,页面像素相同,CLI 返回 0。
两个样本的整体源差异均限定在数据库目录,没有观察到源 .prj/INI/其他配置文件变化。数据库字节实际变了,不宣称整个工程完全没变。设计报告和可见出图未发现连接/报告属性/重复页面改变。
严格检查发现的差异及限制(未隐藏)
原生颜色指令顺序
CBB 重复输出的部分冗余颜色设置指令顺序不同,不能用 PDF 二进制或流指令列表完全相同作为视觉一致性的唯一依据。已验证指令多重集合相同,全部实际渲染像素相同;工具字体处理前后仍严格保持各次原始矢量、颜色、线宽和注释等结构。
原生弹出菜单字段
PON 共 1975 个注释,重复导出只有一个可观测语义差异:第 12 页 CG16 弹出菜单的 Part Label 从空值变为 100NF/16V。源设计报告在导出前后均包含同名的 100NF/16V 与空值项,报告正文没有改变;这与原生导出取用同名/覆盖属性的差异相符,但未确认原生实现内部原因。
这条差异完整保存在 artifacts/v032-annotation-differences.json 和原生报告中。没有把它删除后宣称所有 PDF 内部对象一致:report.strict_all_pdf_objects_equal=false。两次可见页面、其他注释字段、导航目标与位置保持一致;各次字体处理没有改变该次原生菜单数据。需要可靠菜单属性时应另外核对;只需查看/打印图纸可关闭器件弹出菜单。
编码与排版
CBB 用原映射的效果测试保留原生乱码,并不是中文质量通过。追加针对已确认 CP936 旧样本的 PDF-only Arial+中文回退验证:855 段映射、58 段编码修复、607 个中文字符;音频及注意事项正确提取,已查看修复渲染。颜色操作变更数 0,矢量/颜色/线宽/注释/书签保持。未为这个测试再次操作 CAD。
PON Arial+确认 GBK:29061 段字体处理、154 段编码修复、140 段中文回退,提取 1116 个中文字符;注意事项、输入网络、输出网络均存在。PON 第8页原生样张本身已有文字拥挤/重叠与浅色图元;这次保持原布局/配色,没有伪称自动修好了源排版。原生注释有历史 W/S/8 转义解析警告,前后语义比较保留这些数据,不宣称原生格式无警告。FontTools 的非字形 MERG/meta 子集警告也保留在日志。
结论范围
验证对象是当前/已升级样本的 DxD 报告和 PDF,不能推广为所有旧版迁移、全部 PCB/约束或任意并发源编辑都无影响。生产不会每次运行额外 ASCII 报告,也不声称 source_design_semantics_verified=true;路径分类只能分流提示与发布阻止,严格模式仍可选。
打包检查
全新 PyInstaller workpath 构建退出码 0;15 个运行模块全部与当前源码一致。ZIP CRC、解压 EXE 哈希、清除 Python/Qt 搜索环境且 System32-only PATH 的自检和 UI-only 扫描通过。原生运行测试保留 Mentor 必需的环境,不把系统原生依赖当作缺失 Python 来处理。旧版本保留,无 Windows 字体/私有工程/样张随包分发。已检查打包界面,严格检查默认关闭,右上角无引擎 badge。
证据:artifacts/pytest-v032-final.log、artifacts/v032-native-qa/report.json、artifacts/v032-frozen-native-qa.json、artifacts/v032-native-qa/CBB_Audio/Arial-GBK-sample-check.json、artifacts/v032-bundle-source-check.json、artifacts/v032-package-report.json。