From fc67d403cb9a5ef975c2358fcdad31c35e60c7e9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=98=BF=E7=99=BD=E5=8F=94?= <11794527+absfan@user.noreply.gitee.com> Date: Thu, 15 Oct 2026 13:35:47 +0800 Subject: [PATCH] Record verified 1.1.1 portable build and packaged private CAD probe --- README.md | 6 +- docs/releases/v1.1.1-build.json | 97 +++++++++++++++++++ docs/releases/v1.1.1-build.md | 24 +++++ docs/releases/v1.1.1.md | 31 ++++++ .../2026-10-15-private-desktop-execution.md | 2 + docs/user/automatic-designer-startup.md | 2 +- docs/user/v1.1.0-project-tasks.md | 6 +- tools/probe_packaged_private_session.py | 61 ++++++++++++ 8 files changed, 222 insertions(+), 7 deletions(-) create mode 100644 docs/releases/v1.1.1-build.json create mode 100644 docs/releases/v1.1.1-build.md create mode 100644 docs/releases/v1.1.1.md create mode 100644 tools/probe_packaged_private_session.py diff --git a/README.md b/README.md index 9fc53fa..6bcd2e1 100644 --- a/README.md +++ b/README.md @@ -2,9 +2,9 @@ 面向 Windows 和 DxDesigner/Expedition Enterprise 7.9.5 的器件批量替换工具。工具通过 DxDesigner 原生 `Replace Part` 完成替换,并在写入前后保存快照、检查受保护字段、记录操作证据,支持桌面连续队列和可恢复的批处理流程。 -**V1.1.0**:目录读取后一个工程对应一个任务,可采集位号并直接选择部分器件替换,逐行设置新料号、Value 和 NC;Excel 为可选编辑方式,同批任务顺序执行。见 [V1.1.0 使用说明](docs/user/v1.1.0-project-tasks.md) 和 [快速测试入口](docs/testing/v1.1.0-test-entrypoints.md)。 +**当前版本 V1.1.1**:[下载便携包](https://git.simgreek.com/simgreek/dxdesigner-part-replacement/releases/tag/v1.1.1) · [版本说明](docs/releases/v1.1.1.md)。目录读取后一个工程对应一个任务,可采集位号并直接选择部分器件替换,逐行设置新料号、Value 和 NC;Excel 为可选编辑方式,同批任务顺序执行。见 [使用说明](docs/user/v1.1.0-project-tasks.md) 和 [快速测试入口](docs/testing/v1.1.0-test-entrypoints.md)。 -**2026-10-15 源码执行后端更新**:任务中心的自动采集、替换和恢复默认在独立 Windows 桌面启动自有 CAD;完成或暂停后退出 CAD、等待进程结束并确认桌面释放。用户可继续在主桌面查看其他文件,工具不接管主桌面的 CAD。目标工程仍须保存并关闭,避免同时访问同一工程。此次未重新打包,已有发布包不包含本次更新。实测及限制见 [私有桌面执行验证](docs/testing/2026-10-15-private-desktop-execution.md)。 +**V1.1.1 后台执行**:任务中心的自动采集、替换和恢复默认在独立 Windows 桌面启动自有 CAD;完成或暂停后退出 CAD、等待进程结束并确认桌面释放。用户可继续在主桌面查看其他文件,工具不接管主桌面的 CAD。目标工程仍须保存并关闭,避免同时访问同一工程。实测及限制见 [私有桌面执行验证](docs/testing/2026-10-15-private-desktop-execution.md)。 > **当前发布级别:evaluation-only(仅评估)。** 在目标现场完成 7.9.5 验收并取得可追溯证据之前,只能对完整、可丢弃的工程副本和对应中央库进行操作。不要用于唯一工程副本、生产库或未经认证的料号映射。 @@ -23,7 +23,7 @@ - Windows;真实替换基线为 **DxDesigner/Expedition Enterprise 7.9.5**。 - 源码运行和批处理 CLI 使用 **Python 3.12(必须是 3.12)**。 - 目标机器需要可用的 DxDesigner 安装、许可证和中央库;没有中央库时只能运行测试、构建和界面冒烟检查。 -- 自动替换每次处理一个工程。开始前保存并关闭本次目标工程;当前源码使用自有后台 CAD,用户打开的其他工程不会被接管。旧发布包仍按原版本要求关闭已打开工程。 +- 自动替换每次处理一个工程。开始前保存并关闭本次目标工程;V1.1.1 使用自有后台 CAD,用户打开的其他工程不会被接管。更早发布包仍按原版本要求关闭已打开工程。 - 每次现场试验使用完整工程副本,并保留备份、快照、状态、事件日志和报告。 ## 发布包:最快上手 diff --git a/docs/releases/v1.1.1-build.json b/docs/releases/v1.1.1-build.json new file mode 100644 index 0000000..3f49679 --- /dev/null +++ b/docs/releases/v1.1.1-build.json @@ -0,0 +1,97 @@ +{ + "artifacts": { + "version": "1.1.1", + "code_commit": "7610a0fd86b98733b6e92234ba744ca5bcfc88d4", + "build_checks": { + "passed": 219, + "seconds": 34.87 + }, + "exe_sha256": "f029d60fe808c7b5eb47adf9795d4733faa66f33c3f6e9f779fc2541268d1c70", + "vbs_sha256": "212857251e3f42347720b21520836035fa467635ef47f4ca3f330f04cc5a2480", + "private_cad_helper_probe": { + "passed": true, + "project_opened": false, + "clean_released": true + }, + "zip_sha256": "f42f656974cb5170dc4ed80a3e9eaabdedae45ecee229da46a57a178d867e532", + "zip_bytes": 52514265, + "file_count": 235, + "unpacked_bytes": 128586142 + }, + "packaged_helpers": { + "passed": true, + "commands": [ + { + "action": "probe", + "executable": "F:\\Sync Tool Skyworth\\Work Maps\\dxdesigner-part-replacement\\dist\\DxPartReplace\\DxPartReplace.exe" + }, + { + "action": "quit", + "executable": "F:\\Sync Tool Skyworth\\Work Maps\\dxdesigner-part-replacement\\dist\\DxPartReplace\\DxPartReplace.exe" + } + ], + "session": { + "desktop": "dx-258535e794ca41598c912ae87fcdf92b", + "token": "258535e794ca41598c912ae87fcdf92b", + "state": "released", + "cad_pid": 52248, + "guid": "{449B3896xE3A2x469Ax9AEExE68DD21C4B67}", + "startup_seconds": 31.484000000025844, + "clean": true, + "shutdown_seconds": 4.60999999998603 + }, + "source_path_removed_from_child": true, + "project_opened": false + }, + "desktop_observation": { + "samples": 166, + "file_read_samples": 166, + "input_desktop_before": "Default", + "input_desktop_after": "Default", + "foreground_pids": [ + 10104, + 13256 + ], + "owned_cad_became_foreground": false, + "owned_cad_on_input_desktop": false, + "baseline_default_cad_pids": [ + 18732 + ], + "observed_default_cad_pids": [ + 18732 + ], + "cad_exit_confirmed": { + "52248": true + }, + "desktop_absent": { + "dx-258535e794ca41598c912ae87fcdf92b": true + }, + "sessions": { + "dx-258535e794ca41598c912ae87fcdf92b": { + "desktop": "dx-258535e794ca41598c912ae87fcdf92b", + "token": "258535e794ca41598c912ae87fcdf92b", + "state": "released", + "cad_pid": 52248, + "guid": "{449B3896xE3A2x469Ax9AEExE68DD21C4B67}", + "startup_seconds": 31.484000000025844, + "clean": true, + "shutdown_seconds": 4.60999999998603, + "evidence_path": "data\\tasks\\packaged\\quick-run\\private-desktop.json" + } + }, + "observer_errors": [] + }, + "extracted_zip_smoke": { + "extracted_zip_smoke": true, + "version": "1.1.1", + "exit_code": 0, + "missing_helper_arguments_exit_code": 2, + "data_directory_excluded_from_archive": true, + "log": "2026-10-15T05:34:36Z INFO dx_productivity.trial_task_center.f2619d17fd50a1f1 logging configured root=F:\\Sync Tool Skyworth\\Work Maps\\dxdesigner-part-replacement\\build\\release-1.1.1-smoke-data application_log=F:\\Sync Tool Skyworth\\Work Maps\\dxdesigner-part-replacement\\build\\release-1.1.1-smoke-data\\logs\\application.log\n2026-10-15T05:34:36Z INFO dx_productivity.trial_task_center.f2619d17fd50a1f1 application_start version=1.1.1 executable=F:\\Sync Tool Skyworth\\Work Maps\\dxdesigner-part-replacement\\build\\release-1.1.1-extracted\\DxPartReplace\\DxPartReplace.exe os=Windows-11-10.0.26200-SP0 data_root=F:\\Sync Tool Skyworth\\Work Maps\\dxdesigner-part-replacement\\build\\release-1.1.1-smoke-data database=F:\\Sync Tool Skyworth\\Work Maps\\dxdesigner-part-replacement\\build\\release-1.1.1-smoke-data\\task-center.db application_log=F:\\Sync Tool Skyworth\\Work Maps\\dxdesigner-part-replacement\\build\\release-1.1.1-smoke-data\\logs\\application.log\n2026-10-15T05:34:36Z INFO dx_productivity.trial_task_center.f2619d17fd50a1f1 recovered_interrupted_projects=none\n2026-10-15T05:34:37Z INFO dx_productivity.trial_task_center.f2619d17fd50a1f1 operation_start=list_tasks task_id= at=2026-10-15T13:34:37.043664\n2026-10-15T05:34:37Z INFO dx_productivity.trial_task_center.f2619d17fd50a1f1 operation_complete=list_tasks task_id= at=2026-10-15T13:34:37.047016\n2026-10-15T05:34:37Z INFO dx_productivity.trial_task_center.f2619d17fd50a1f1 application_clean_shutdown exit_code=0\n" + }, + "pre_release_fixes": [ + "Absolute package import for an application executed as the frozen entry script; regression reproduced before the fix.", + "Bounded atomic state publication retry for Windows readers denying delete access; native transient and persistent sharing tests added." + ], + "validation_boundary": "Real packaged EXE probe/quit helpers launched by the source supervisor; no project opened in this package smoke. Previous real replacement evidence is linked in the release notes. No new Packager/ERC qualification." +} diff --git a/docs/releases/v1.1.1-build.md b/docs/releases/v1.1.1-build.md new file mode 100644 index 0000000..18fbdcd --- /dev/null +++ b/docs/releases/v1.1.1-build.md @@ -0,0 +1,24 @@ +# 1.1.1 发布构建记录 + +日期:2026-10-15。程序源码提交:`7610a0fd86b98733b6e92234ba744ca5bcfc88d4`;后续发布文档及探针提交不改变成品程序代码。 + +- 标准构建脚本发布检查:219 passed,34.87 秒;没有跳过或放宽构建门槛。 +- PyInstaller 6.22.3 / Python 3.12.10 构建成功;构建自带的独立启动退出检查通过。 +- ZIP 解压到全新目录后,EXE 启动日志为 version=1.1.1,正常退出码 0;helper 缺少必要参数时退出码 2。 +- 成品 EXE 的真实后台 CAD probe/quit 通过,子进程移除源码 PYTHONPATH,没有打开工程;CAD 与桌面确认释放,主桌面没有被切换或抢占。 +- 本次私有 CAD 启动 31.484 秒,退出 4.610 秒;166 次主桌面采样和普通文件读取均完成。 +- ZIP CRC、文件清单、EXE 哈希及包内 VBS 与源码哈希一致性检查通过;包内不含 data、任务数据库、日志或工程备份。 + +产物:`dist/DxPartReplace-1.1.1.zip`,52,514,265 字节(50.08 MiB),235 个文件。 + +| 文件 | SHA-256 | +| --- | --- | +| ZIP | `f42f656974cb5170dc4ed80a3e9eaabdedae45ecee229da46a57a178d867e532` | +| EXE | `f029d60fe808c7b5eb47adf9795d4733faa66f33c3f6e9f779fc2541268d1c70` | +| QuickPartReplace.vbs | `212857251e3f42347720b21520836035fa467635ef47f4ca3f330f04cc5a2480` | + +源码、验证探针和记录推送至 `codex/execution-responsiveness`,版本标签 `v1.1.1`。发行附件为 ZIP 与 `SHA256SUMS-1.1.1.txt`,发布页:[DxPartReplace 1.1.1](https://git.simgreek.com/simgreek/dxdesigner-part-replacement/releases/tag/v1.1.1)。附件上传后另行下载验证 SHA-256。 + +本次发版过程中复现并修复了两项:冻结脚本入口的相对导入失败,以及状态读者短暂占用导致 Windows 原子替换失败。第一轮成品 helper 实际已退出 CAD、释放桌面,但最终状态记录因占用失败;修复后重新运行标准构建与成品探针通过。 + +详细证据见 [JSON](v1.1.1-build.json)。本轮成品验证由源码监督器调用实际 EXE 的 probe/quit 入口,不代表又执行了成品整批替换。此前真实替换、恢复及异常清理证据见 [后端验证记录](../testing/2026-10-15-private-desktop-execution.md),没有新增 Packager/ERC 认证。 diff --git a/docs/releases/v1.1.1.md b/docs/releases/v1.1.1.md new file mode 100644 index 0000000..334a72f --- /dev/null +++ b/docs/releases/v1.1.1.md @@ -0,0 +1,31 @@ +# DxPartReplace 1.1.1 + +发布日期:2026-10-15。 + +本版包含按工程创建任务、位号计划、可选 BOM/Excel 导入、任务顺序执行,以及后台 CAD 执行与完整退出清理。 + +## 更新内容 + +- 自动采集、替换和中断恢复默认使用私有桌面中的自有 CAD,主桌面可继续查看其他文件。 +- 完成、暂停和异常退出均检查自有进程及桌面释放;记录每次后台会话证据。 +- 单步替换同样执行备份、保存、关闭与重开核验;恢复成功后无需另行手动保存。 +- 界面显示后台 CAD 启动及退出阶段,保留位号、旧新物料号、执行阶段耗时和速率记录。 +- 保留同一工程的连续步骤会话复用、异步查询及取消、工程发现缓存等优化。 +- 修复冻结程序后台 helper 的脚本入口导入错误,版本号更新为 1.1.1。 +- 后台状态文件遇到短暂的 Windows 读取占用时进行有限重试,持续权限错误仍会明确报告。 + +## 下载与使用 + +下载 `DxPartReplace-1.1.1.zip` 并完整解压,运行 `DxPartReplace/DxPartReplace.exe`。保留同目录的 `_internal`,不能只复制 EXE。无需另外安装 Python,仍需本机可用的 DxDesigner EE 7.9.5、许可证和中央库。 + +升级前关闭旧工具并备份原 `data`;更新 EXE 和 `_internal`,保留原有 `data`。新包不含本机任务、日志或工程备份,不同版本不要同时使用同一数据目录。 + +目标工程开始前须保存关闭,运行时不要同时打开或修改它。其他工程不会被接管。后台 CAD 启动实测约 22~35 秒,许可证和系统资源仍共享。 + +`SHA256SUMS-1.1.1.txt` 提供 ZIP 的 SHA-256。便携目录同时包含使用说明和版本清单。 + +## 验证范围 + +发布构建运行功能和执行保护检查,再执行 PyInstaller 构建及独立 EXE 启动退出检查。成品另执行实际私有 CAD probe/quit 验证,不依赖源码 PYTHONPATH;确认主桌面不切换、自有 CAD 退出、私有桌面释放。发布记录保存测试结果、ZIP/EXE/脚本哈希及验证证据。 + +原生替换、保存回读、恢复、暂停和超时证据见 [私有桌面执行验证](../testing/2026-10-15-private-desktop-execution.md)。本次成品验证没有重新进行整批替换或 Packager/ERC 验收;现有现场验收边界不变。 diff --git a/docs/testing/2026-10-15-private-desktop-execution.md b/docs/testing/2026-10-15-private-desktop-execution.md index 6ba7e36..d6c8795 100644 --- a/docs/testing/2026-10-15-private-desktop-execution.md +++ b/docs/testing/2026-10-15-private-desktop-execution.md @@ -1,5 +1,7 @@ # 2026-10-15 私有桌面正式执行验证 +> 本文记录源码接入阶段的验证;后续 1.1.1 成品已完成打包,见 [1.1.1 版本说明](../releases/v1.1.1.md)。下文“本轮没有打包”保留该阶段的实际边界。 + 任务中心源码已把私有桌面接入自动采集、单步替换、批量工程会话及中断恢复,完成成功、暂停和异常退出的资源清理。本轮没有打包;此前 EXE 不包含这些更新。 实现提交:`5c0f6a3`、`f26e868`、`fee1aff`、`48ad7b3`。原始工程未修改,原生测试仅操作 `build/private-desktop-native` 下独立副本。环境为 Windows、Python 3.12、DxDesigner EE 7.9.5;中央库使用本机已安装库。压缩证据及原始文件 SHA-256 见 [JSON 数据](data/2026-10-15-private-desktop-execution.json)。不提交工程、中央库或大型供应商文件。 diff --git a/docs/user/automatic-designer-startup.md b/docs/user/automatic-designer-startup.md index 8cb968c..30ef992 100644 --- a/docs/user/automatic-designer-startup.md +++ b/docs/user/automatic-designer-startup.md @@ -1,6 +1,6 @@ # 自动启动 DxDesigner(2026.09.06-R7) -> **2026-10-15 源码已更新**:当前任务中心自动执行改为显式启动私有桌面中的自有 CAD,采集、单步、批量和恢复均接入;不会复用主桌面 CAD。目标工程须关闭,其他文件可正常查看。完成与暂停会退出 CAD 并验证私有桌面释放。详见 [V1.1.0 后台运行说明](v1.1.0-project-tasks.md) 和 [真实验证记录](../testing/2026-10-15-private-desktop-execution.md)。以下保留 R7 的历史启动行为,不能作为当前源码后端的操作说明。本轮没有更新发布包。 +> **V1.1.1 已更新后台执行**:当前任务中心自动执行改为显式启动私有桌面中的自有 CAD,采集、单步、批量和恢复均接入;不会复用主桌面 CAD。目标工程须关闭,其他文件可正常查看。完成与暂停会退出 CAD 并验证私有桌面释放。详见 [后台运行说明](v1.1.0-project-tasks.md)、[真实验证记录](../testing/2026-10-15-private-desktop-execution.md) 和 [1.1.1 版本说明](../releases/v1.1.1.md)。以下保留 R7 的历史启动行为,不能作为当前版本的操作说明。 > 连续队列会在原理图精简备份后自动枚举多图页工程,并逐页打开明确绑定的原理图名和页号。精简备份排除 PCB、CES、历史工程备份和运行日志。下文“只处理单页”的内容是 R7 历史边界,不再适用于当前连续队列;人工单步流程仍只操作当前活动页。 diff --git a/docs/user/v1.1.0-project-tasks.md b/docs/user/v1.1.0-project-tasks.md index 66d595a..5836beb 100644 --- a/docs/user/v1.1.0-project-tasks.md +++ b/docs/user/v1.1.0-project-tasks.md @@ -1,4 +1,4 @@ -# DxPartReplace V1.1.0 使用说明 +# DxPartReplace V1.1 使用说明(当前版本 1.1.1) V1.1.0 沿用原有任务视图和料号规则编辑,增加按工程拆分的任务、按位号选择的替换计划及可选 Excel 操作。 @@ -43,7 +43,7 @@ BOM 导入会把未列出的采集位号保留为“不替换”,并要求每 本机 7.9.5 的真实 TypeLib 没有可直接调用的 ReplacePart 方法,生产替换仍沿用原生对话框及 Library Wins。详见 `docs/research/v1.1.0-native-interface-probe.md`。实际中央库、器件替换和保存回读仍需用工程副本现场验收。 -## 后台运行与释放(2026-10-15 源码更新) +## 后台运行与释放(1.1.1) 任务中心的自动采集、替换和中断核验恢复已默认接入私有 Windows 桌面。工具显式启动并持有自己的 CAD,通过私有桌面、会话 GUID 和活动图页窗口所属 PID 校验连接,不接管主桌面已有 CAD,也不自动退回主桌面执行。 @@ -53,4 +53,4 @@ BOM 导入会把未列出的采集位号保留为“不替换”,并要求每 单步入口也执行备份、保存、重开核验和关闭。恢复成功会显示属性已保存并重开回读,无需用户另开后台工程手动保存。启动阶段尚未进入工程执行且清理成功时可以重试;执行超时、状态不确定或清理失败仍保留保护状态,由核验恢复入口处理。 -该后端已在独立真实副本上完成替换、保存回读、暂停、恢复、启动取消及超时退出验证,详见 [验证记录](../testing/2026-10-15-private-desktop-execution.md)。本轮未打包,原有 EXE 尚不包含此更新。 +该后端已在独立真实副本上完成替换、保存回读、暂停、恢复、启动取消及超时退出验证,详见 [验证记录](../testing/2026-10-15-private-desktop-execution.md)。1.1.1 发布包已包含此更新,详见 [版本说明](../releases/v1.1.1.md)。 diff --git a/tools/probe_packaged_private_session.py b/tools/probe_packaged_private_session.py new file mode 100644 index 0000000..0cccf6e --- /dev/null +++ b/tools/probe_packaged_private_session.py @@ -0,0 +1,61 @@ +"""Exercise the packaged CAD probe/quit helpers without opening any project.""" +import argparse +import json +from pathlib import Path +import sys + +sys.path.insert(0, str(Path(__file__).resolve().parents[1] / 'src')) +from dx_productivity.trial_task_center import isolated_cad +from private_desktop_observer import PrivateDesktopObserver + + +def main(): + parser = argparse.ArgumentParser() + parser.add_argument('--executable', type=Path, required=True) + parser.add_argument('--output', type=Path, required=True) + args = parser.parse_args() + executable, output = args.executable.resolve(strict=True), args.output.resolve() + output.mkdir(parents=True, exist_ok=False) + root = output / 'data/tasks/packaged/quick-run' + original_command = isolated_cad._helper_command + original_environment = isolated_cad._child_environment + commands = [] + + def helper(action, evidence, pid): + command = (str(executable), '--private-cad-action', action, + '--private-cad-evidence', str(evidence), '--private-cad-pid', str(pid)) + commands.append({'action': action, 'executable': str(executable)}) + return command + + def environment(value): + result = dict(value) + # Ensure helpers use the frozen bundle without the source import path. + result.pop('PYTHONPATH', None) + result.pop('PYTHONHOME', None) + return result + + isolated_cad._helper_command = helper + isolated_cad._child_environment = environment + try: + with PrivateDesktopObserver(output): + with isolated_cad.IsolatedCadSession(root) as session: + assert session.binding is not None and session.cad.poll() is None + record = json.loads((root / 'private-desktop.json').read_text(encoding='utf-8')) + observation = json.loads((output / 'desktop-observation.json').read_text(encoding='utf-8')) + assert record['state'] == 'released' and record['clean'] + assert [row['action'] for row in commands] == ['probe', 'quit'] + assert observation['sessions'] and all(observation['cad_exit_confirmed'].values()) + assert all(observation['desktop_absent'].values()) and not observation['observer_errors'] + assert not observation['owned_cad_became_foreground'] and not observation['owned_cad_on_input_desktop'] + assert observation['input_desktop_before'] == observation['input_desktop_after'] + report = {'passed': True, 'commands': commands, 'session': record, + 'source_path_removed_from_child': True, 'project_opened': False} + (output / 'report.json').write_text(json.dumps(report, ensure_ascii=False, indent=2), encoding='utf-8') + print(json.dumps(report, ensure_ascii=False), flush=True) + finally: + isolated_cad._helper_command = original_command + isolated_cad._child_environment = original_environment + + +if __name__ == '__main__': + main()