Files
cbb-refresh-verify-795/docs/releases/2026-10-26-local-validation-and-audit.md
T

6.1 KiB
Raw Permalink Blame History

0.2.2 本地功能验证与安全审查

日期:2026-10-26。基线:11a2b2e,在 0.2.1 紧急补丁之上继续修复。 环境:Windows 11、Python 3.12.10、Mentor EE7.9.5EE。

真实试跑结果

使用仓库已有的历史成功样本 IP101GR,完整复制到 diagnostics/local-verification-20261026/library。原样本 20,994 个文件、 556,098,864 字节,验证前后 SHA-256 比对没有变化。所有写操作针对隔离副本。

检查 结果及证据
0.2.1 EXE 首次试跑 发现功能缺陷:四项同步均为 2,IsForwardAnnotationAllowed=False,程序仍调用 ForwardAnnotate;Mentor 明确拒绝。保护机制停止批次、保留会话,没有误报 PASS。
首次失败后的关闭 精确核对隔离工程身份后,32 位助手正常 Close(False)/Quit;记录 IsSaved=True、Close=True。未强杀 PCB/iCDB。
修复后的源码试跑 PASS、GREEN;IsVerifiedReuseBlock 返回 READY/raw=1;保存、关闭、进程退出均确认。
再次完整校验 第二次 PASS、GREEN;验证同一副本可重复校验。
最终 0.2.2 EXE 实测 打包后的 EXE 再次完成真实校验,退出码 0、PASS/GREEN;未遗留 PCB 进程。
正常打开 Work PCB 不带 -ReusableCircuit,按普通 PCB 启动,COM 工程身份匹配,正常关闭,未发生数据库打不开错误。
正常打开 Cert PCB 同上,Cert 工程身份匹配并正常关闭。
最终 EXE 校验后再打开 Work PCB 再次普通打开、身份核对和正常关闭通过。

每次成功退出后检查没有残留的对应 PCB 进程,且工程的 sAddress.adr 已消失。新生成的 iCDB 日志记录 Database closed 和 icdb.dat closed。 保存日志仍有 Mentor 的子客户端自动解锁警告;随后数据库关闭、两份 PCB 重新打开均成功,未将这些警告视为已证实的数据库损坏。

原始证据在 diagnostics/local-verification-20261026: frozen-first-run、close-first-run.log、source-second-run、 source-third-run、normal-reopen-work、normal-reopen-cert、 frozen-final-run、normal-reopen-work-final、source-integrity.json。 工程与原始现场文件不包含在发布 ZIP 中。

本轮修复

问题 修复
已验证、全同步的块被重复执行禁止的 Forward Annotation 尊重原生 Allowed 标志;保留后续 Save/Close 和 READY 权威确认。需要同步却不允许执行时仍报错。
pcb.prj 容错 UTF-8 解码可能替换 ANSI 字符 只替换目标字段的字节;严格处理 BOM/UTF-16,备份保持原字节。
写入异常可能截断 pcb.prj 同卷暂存后原子替换;替换失败保持原文件。
目录 Junction 可绕过工程范围校验 校验真实解析路径;交给 Mentor 的路径仍保留原盘符表达。
“成功文本”覆盖非零退出码 Python 和旧 PowerShell 内容检查都要求退出码 0。
内容检查位于互斥锁之外 全流程持有串行互斥锁,包括内容检查及最终状态读取。
保留原生会话后仍可能卸载临时网络盘 CLI 和 UI 在不安全结果/异常时保留本次映射,供恢复使用。
监督程序异常退出后自动化可能继续写入 子进程监视监督程序句柄;停止自动化及保存助手,保留原生数据库拥有者。用真实无害 Windows 进程测试此行为。
旧树状态读取路径强杀 Library Manager 请求正常关闭并确认退出;未关闭则保留并报错。
动态 WMI 查询与相对系统命令查找 固定进程查询白名单;使用系统目录中的 taskkill.exe。移除未使用的自动丢弃文档处理器。
随包/构建依赖的已知漏洞 Pillow 12.3.0 → 13.0.0;setuptools 84.0.0 → 84.1.0。只更新独立构建环境,不修改全局 Python。

自动化验证与扫描范围

  • 373 项 pytest 通过,包含初始事故和本轮扩展回归用例。
  • 两组 PowerShell 测试通过。新增测试用无害的假 importer 验证“输出成功但退出码 7”必须失败,不打开 Mentor 数据。
  • Python 编译检查通过。
  • PyInstaller 构建、冻结版界面启动/关闭及真实校验均通过;检查 EXE 内部代码确认为 0.2.2,内部 Pillow 版本确认为 13.0.0,VBS 和规则文件 与已测试源码逐字节一致。
  • Coverage:语句覆盖 72.19%,分支覆盖 62.69%,综合 70%。实际 Mentor 子进程试跑不计入此覆盖率;没有声称全部代码分支均被覆盖。
  • Bandit 扫描整个 src:0 高、0 中、55 低。低等级提示分类: 8 个 subprocess 导入、12 个受控参数列表调用、25 个容错异常处理、 8 个诊断枚举跳过、2 个 Windows 打开日志目录操作。原始报告全部保留。
  • 一处全接口端口检测明确标注 B104 排除:只尝试 bind 后立即关闭, 不调用 listen/accept,不提供网络服务。
  • pip-audit 检查 18 个运行/构建依赖及其依赖:首次发现 38 条已知公告 (Pillow 37、setuptools 1),升级后复扫 0 条已知漏洞。
  • 发布依赖清单:packaging/requirements-build.txt。扫描报告与覆盖率数据 在证据目录的 bandit-final.json、dependency-audit-fixed.json、coverage.json。

扫描覆盖本仓库 Python 运行代码、相关旧 PowerShell 入口和本次构建依赖; 没有对闭源 Mentor 二进制或整台 Windows 系统作“无漏洞”保证。

使用范围与未验证项

本轮真实样本为单个已经验证过的 IP101GR。非绿色状态推进、错误弹窗、 超时、取消、网络映射故障、并发和异常终止主要由隔离自动测试覆盖。 没有使用生产网络库、生产 DMS 凭据,也没有在 Windows 10 上运行。

本补丁防止不安全的继续操作;没有恢复用户原事故中受损的 PCB。 Verify 本身会通过 Mentor 更新工程数据,不能当作只读检查。 异常时可能保留私有桌面中的原生会话和临时盘符;查看恢复记录后进行 正常关闭或使用 Mentor 恢复流程,不应直接删锁或强杀数据库进程。