6.1 KiB
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 恢复流程,不应直接删锁或强杀数据库进程。