6.3 KiB
2026-10-30 Windows 环境兼容性验收
目标和范围
按用户确认,以 Windows 10/11 x64、DxDesigner EE 7.9.5 为兼容目标。此次验证把源码测试、模拟异常、真实冻结 EXE 和真实 CAD 工程替换分别记录,不能互相替代。
本机是 Windows 11 Pro 10.0.26200 x64,当前会话不是管理员,并处于宿主已有的 Windows Job 中。源码解释器为 CPython 3.12.14,使用项目虚拟环境。没有可用的 Windows 10 实机证据,因此不能把本机测试解释为 Windows 10 已通过。
源码与启动边界
| 场景 | 验证方式 | 结果 |
|---|---|---|
| 普通 Python 虚拟环境 | 真实子进程 PID、虚拟环境前缀、win32api 依赖导入 | 通过 |
-E、-I 隔离启动参数 |
真实子进程,分别测试重定向和不重定向标准流 | 通过 |
| 中文、空格工作目录 | 真实子进程回报 CWD 与预期一致 | 通过 |
| 子进程环境隔离 | 验证传入环境字典不因虚拟环境适配而改变 | 通过 |
| 冻结/其他程序命令 | 在原生启动边界的受控测试中验证不替换为当前 Python | 通过;此项不是冻结 EXE 实测 |
| 非管理员与嵌套 Job | 本机实际会话及其子进程;Job 归属、后代退出和桌面释放 | 通过 |
| Job 分配失败/归属未确认 | 故障注入,确认不恢复未受管控的子进程并收尾 | 通过;不等同于所有企业策略均可运行 |
| 中文、长路径及 MAX_PATH 受限路径访问 | 路径专项、工程索引/证据、深目录运行测试 | 通过;真实 CAD 路径限制仍需副本验证 |
命令:
..\..\.venv\Scripts\python.exe -m pytest -q tests/v1_1/test_isolated_desktop.py tests/v1_1/test_path_access.py tests/v1_1/test_project_long_paths.py tests/v1_1/test_deep_runtime_paths.py tests/v1_1/test_deep_scan_archive_paths.py tests/v1_1/test_com_project_path.py tests/packaging/test_dx_part_replace_build.py --tb=short --junitxml=build/compatibility-source-results.xml
结果:61 passed,34.12 秒。其中新增 8 项启动环境测试。它们验证现有修复的边界,此轮尚未因这些测试修改生产行为。
冻结包验收
使用 packaging/Build-DxPartReplace.ps1 从当前源码构建,不用旧 EXE 代替。脚本先运行当前 V1.1 与发布安全子集,再构建、检查 win32timezone、验证真实冻结监督器、比较打包 VBS 与源码的哈希并执行应用启动/关闭检查。
构建前置回归:957 passed,1 个已有 pywinauto STA 提示,426.70 秒。
标准构建脚本成功结束。实际冻结监督器、win32timezone 归档、进程创建时间读取、桌面释放和 VBS 源码/包内哈希检查全部通过。
实际 EXE 环境矩阵 7/7 通过:
| 场景 | 实测结果 |
|---|---|
| 清理 Python 环境、从不同工作目录启动 | 通过 |
| PATH 仅保留 System32,不包含 Python | 通过 |
| 设置其他/无效 PYTHONHOME、PYTHONPATH、Qt 插件路径及数据目录环境变量 | 通过;显式数据目录生效,错误目录未创建 |
| 中文、空格数据目录 | 通过 |
| 原生 Windows Qt 平台插件 | 通过;不是 offscreen 替代 |
| 339 字符的数据目录 | 通过;仅证明应用数据/证据路径,不表示 CAD 工程路径上限相同 |
| 把完整 EXE 与 _internal 搬到中文/空格便携目录 | 通过 |
每次均检查真实冻结监督器退出码为 0、Job 归属验证成功、Job 活跃进程数为 0、桌面句柄关闭且确认桌面消失,以及应用干净退出日志。测试数据均在新建目录,--smoke-test 只运行后台进程/桌面检查,不打开或替换 CAD 工程。
便携测试包附带 Run-CompatibilityCheck.ps1。它不需要目标机安装 Python,已在本机 Windows PowerShell 5.1.26100.9711 实际运行通过;输出 JSON 记录退出、日志和资源检查结果。脚本作为本次测试包附件,不会被错误地计为已完成 Windows 10 实机验证。
原始矩阵和源码/EXE SHA256 见 JSON 证据。本次生产代码没有因兼容专项再修改;增加了启动环境回归,并构建当前修复的独立测试包。
测试包:dist/DxPartReplace-compatibility-20261030.zip,包含完整便携目录与自检脚本,是本地兼容性测试候选,未发布到远程。
Windows 10/其他机器的复测方法
复制或解压完整 DxPartReplace 目录,包括 EXE 与 _internal,不要只复制 EXE。可先运行包内 Run-CompatibilityCheck.ps1 自动检查并生成报告;也可在可写目录运行以下命令,每次使用新的数据目录:
$compatDataRoot = Join-Path $env:LOCALAPPDATA ('DxPartReplace-compat-' + [Guid]::NewGuid().ToString('N'))
$compatExe = (Resolve-Path -LiteralPath '.\DxPartReplace.exe').Path
$compatProcess = Start-Process -FilePath $compatExe -ArgumentList @('--smoke-test', '--data-root', ('"' + $compatDataRoot + '"')) -WindowStyle Hidden -Wait -PassThru
$compatProcess.ExitCode
Get-Content -LiteralPath (Join-Path $compatDataRoot 'logs\application.log') -Tail 30
Get-ChildItem -LiteralPath (Join-Path $compatDataRoot 'batch-resources') -Filter 'session.json' -Recurse | ForEach-Object { Get-Content -LiteralPath $_.FullName -Raw | ConvertFrom-Json } | Select-Object state,cleanup
通过条件包括退出码 0、日志同时包含 packaged_runtime_smoke_passed 和 application_clean_shutdown exit_code=0,以及资源记录 state=released、桌面句柄关闭并确认桌面消失。仅看到窗口出现或退出码为 0 不足以证明后台收尾成功。
随后需在工程副本上单独验证:工程采集、BOM 导入、替换保存重开回读、暂停/恢复和资源清理。此步骤才覆盖本机中央库、许可证、CAD COM 注册、工程和文件服务器条件。
尚未证明的环境
- Windows 10 实机、其他 Windows 11 构建及不同补丁状态。
- 其他电脑的 DxDesigner 7.9.5 安装、中心库、许可证与 COM 注册。
- 网络共享工程/数据目录、多用户并发访问 SQLite、只读安装目录和企业杀毒/应用控制策略。
- 其他 CAD 版本和 32 位 Windows;本次目标为 Windows x64、DxDesigner 7.9.5。
不以放宽身份校验、忽略 Job 分配失败或自动重放替换来换取表面兼容。环境不允许安全执行时,必须停止并保留明确诊断。