From 0a188552d5fa74551e3122e653302ac2fb2a48dc 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: Mon, 16 Nov 2026 09:43:56 +0800 Subject: [PATCH] release: prepare v1.3.1 field test and clarify automatic cleanup --- README.md | 13 +++++++------ docs/releases/v1.3.1.md | 19 +++++++++++++++++++ .../testing/evidence/2026-11-12-r17/README.md | 3 +++ docs/user/safe-stop-and-recovery.md | 6 ++++-- packaging/windows-version-info.txt | 8 ++++---- pyproject.toml | 2 +- src/dx_productivity/dsh/scheduling.py | 1 - .../trial_task_center/batch_supervisor.py | 2 +- .../trial_task_center/batch_worker.py | 1 - .../trial_task_center/recovery.py | 2 +- .../trial_task_center/recovery_commit.py | 1 - .../trial_task_center/ui/main_window.py | 4 ++-- .../trial_task_center/ui/project_plan.py | 2 +- .../trial_task_center/version.py | 2 +- 14 files changed, 44 insertions(+), 22 deletions(-) create mode 100644 docs/releases/v1.3.1.md diff --git a/README.md b/README.md index 2503b68..dba3a7e 100644 --- a/README.md +++ b/README.md @@ -10,13 +10,13 @@ 2026-11-13 的 [PR #27 审查修复与复核](docs/testing/2026-11-13-pr27-review-fixes.md) 单列最新结果:停滞计时、执行回执、BOM 错误、网表范围与确认后状态检查已修复;新候选启动及冻结校验通过,新 20 项实机仍因 Mentor 退出超时未完成,尚未发布。 -**当前版本:V1.3.0(本地包已验证,尚未上传 Release)** · [本版变更](docs/releases/v1.3.0.md) · [构建记录与 SHA256](docs/releases/v1.3.0-build.md) · [完整使用说明](docs/user/v1.1.0-project-tasks.md) +**当前版本:V1.3.1(实机测试预发布)** · [本版变更与已知问题](docs/releases/v1.3.1.md) · [完整使用说明](docs/user/v1.1.0-project-tasks.md) -V1.3.0 使用最新紫蓝双环图标,包含原生三栏 DSH助手、异常自动介入与核验、多文件 BOM 导入、逐项 Value 策略,以及按单器件隔离失败与安全恢复。AI 等待和后台查询不占普通任务执行通道,同一持续异常不会重复介入;状态灯仅显示圆点,悬浮查看原因与阶段。 +V1.3.1 包含 PR #27 的原生 BOM 按需核验、Mentor 批内复用、前后网表比对、完整普通 Harness 及审查修复,沿用紫蓝双环图标和原生三栏 DSH 助手。错误触发自有 Mentor 自动回收,确认相关进程退出后才释放桌面;具体时限与恢复要求见[停止与恢复说明](docs/user/safe-stop-and-recovery.md)。 -本地交付目录为 `outputs/releases/v1.3.0`:自解压 EXE 约 **341 MiB**,ZIP 便携包约 **481 MiB**,附 SHA256 和逐文件清单。两种包均保留完整 Node/Harness、Qt WebEngine 和应用资源。升级前退出旧程序并备份 `data`,完整更新 EXE 与 `_internal`,不要只替换 EXE。 +本地交付目录为 `outputs/releases/v1.3.1`,包含自解压 EXE、ZIP 便携包、SHA256、逐文件清单和本次构建验证报告。两种包均保留完整 Node/Harness、Qt WebEngine 和应用资源。升级前退出旧程序并备份 `data`,解压到新目录,完整保留 EXE 与 `_internal`,不要只替换 EXE。 -**已发布的旧版:V1.2.2(预发布)** · [自解压 EXE](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/releases/download/v1.2.2/DxPartReplace-1.2.2.exe) · [ZIP 便携包](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/releases/download/v1.2.2/DxPartReplace-1.2.2.zip) · [版本说明与附件](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/releases/tag/v1.2.2)。V1.3.0 的远端下载入口将在实际上传后提供。 +**V1.3.1 下载** · [自解压 EXE](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/releases/download/v1.3.1/DxPartReplace-1.3.1.exe) · [ZIP 便携包](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/releases/download/v1.3.1/DxPartReplace-1.3.1.zip) · [版本说明与附件](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/releases/tag/v1.3.1)。本版 Mentor 退出超时仍待实机复核,最新 20 项 CAD 验收未完成。 本版提供[目标封装选择](docs/user/target-cell-selection.md):目标封装可留空,此时工具不主动覆写封装,可后续与中心库同步;需要指定时,在料号规则中读取并选择合法封装。BOM 保持原 11 列。 @@ -177,7 +177,7 @@ node tools/verify_dsh_runtime.mjs 运行期间可以在主桌面查看其他文件,请勿打开或修改本次正在处理的同一工程。需要暂停时,点击 **完成当前项后暂停**,等待当前步骤安全收尾。 -Beta 4 在保存或核验尚未确认时保留应用等待,可先 **导出诊断包**。只有明确接受中断后需要核验时,才选择 **强制结束…**;之后先核验恢复,不能直接重复替换。详见[停止、强制结束与恢复](docs/user/safe-stop-and-recovery.md)。 +普通暂停等待当前项到达安全边界;执行错误或持续停滞会先写入保护记录,再自动回收自有 Mentor。也可手动选择 **强制结束…**;结果不确定时先核验恢复,不能直接重复替换。详见[停止、强制结束与恢复](docs/user/safe-stop-and-recovery.md)。 **完成标志:** 任务显示已完成,底部提示本批执行结束。还要打开结果核对,不能只看进度条。 @@ -242,7 +242,7 @@ DxPartReplace/ ## 验证范围与已知限制 -V1.3.0 本地发行脚本回归 **1358 项通过**;主程序与自解压包的 10 档图标、1.3.0 版本资源、冻结进程启动、自有资源释放和实际助手界面点击均已验证。自解压 EXE 与 ZIP 的 **66,805 个文件**通过 SHA256 与 ZIP CRC 核对,从最终包解出的程序再次启动验证通过。详见 [V1.3.0 构建记录](docs/releases/v1.3.0-build.md)。本轮未发送真实模型请求、修改真实用户 CAD 工程或上传 Release;官方 Harness 前端保留自身的预览版标记,产物未做代码签名。 +历史 V1.3.0 本地包的 1358 项回归、图标、版本资源及 66,805 个文件校验记录见 [V1.3.0 构建记录](docs/releases/v1.3.0-build.md),不作为 V1.3.1 的验收结果。V1.3.1 的实际构建验证记录随 Release 附件提供;本版未宣称完成真实 CAD 20 项验收。官方 Harness 前端保留自身的预览版标记,产物未做代码签名。 V1.1.4 Beta 4 沿用批次后台资源管理:一次 BOM 导入或顺序执行共用一个私有桌面,CAD 按需启动并在同批工程间复用,批次结束统一退出。若提示 **资源释放待处理**,已保存核验的结果保留,请点击 **重新清理资源**;该操作只清理后台资源,不会再次替换。旧的工程保护锁仍按“核验并恢复”处理。设计、异常边界与实机结果见[批次运行时验收记录](docs/testing/2026-10-21-batch-private-runtime.md)。 @@ -273,5 +273,6 @@ py -3.12 -m venv .venv - [历史流程和独立 CLI 说明](docs/user/trial-task-center.md) - [CLI 与原生批处理集成](docs/user/part-replacement.md) - [V1.1.3 版本说明](docs/releases/v1.1.3.md) +- [V1.3.1 实机测试版说明](docs/releases/v1.3.1.md) - [V1.3.0 版本说明](docs/releases/v1.3.0.md) - [V1.3.0 构建记录与校验值](docs/releases/v1.3.0-build.md) diff --git a/docs/releases/v1.3.1.md b/docs/releases/v1.3.1.md new file mode 100644 index 0000000..654da62 --- /dev/null +++ b/docs/releases/v1.3.1.md @@ -0,0 +1,19 @@ +# v1.3.1 实机测试版 + +本版包含 PR #27 的 BOM 按需原生核验、Mentor 批内复用、前后固定副本网表比对,以及官方 Standard Harness 的完整普通会话能力。补齐执行恢复与重试失败的持久收尾、心跳停滞判断、BOM 原始错误保留、网表原子写入和自动诊断会话重启后的快照限制。 + +本次复审后的调整仅清理无用 import、统一版本标识并修正用户文档。错误触发的 Mentor 自动回收保持原设计:先持久化不确定记录,再清理自有进程,确认退出后释放桌面。默认停滞阈值为 150 秒请求停止、300 秒等待安全边界、约 330 秒仍无业务进展进入失败回收;业务进展重新计时,心跳不重新计时。详见 [停止与恢复说明](../user/safe-stop-and-recovery.md)。 + +交付自解压 EXE、便携 ZIP、SHA256、逐文件清单和本次构建验证报告,两种包均包含完整 Node/Harness、Qt WebEngine 和应用资源。普通会话默认 `workspace-write`,支持 Shell、文件编辑、goal、jobs 和子智能体;自动异常诊断只能读取绑定事件快照。 + +## 升级与测试 + +退出旧程序,备份原 `data`,将新版本解压到新目录。完整保留 EXE 与 `_internal`,不要只覆盖单个 EXE,也不要让新旧程序同时使用同一数据目录。首次验证请使用工程副本;需要 DxDesigner EE 7.9.5、许可证和可用中央库。新目录通过“启动程序.cmd”启动,数据保存在该目录的 `data`。 + +建议依次检查启动、BOM 导入、单项替换、暂停/恢复、批内复用和批次结束释放;若出现退出异常,保留任务轮次、日志与诊断包。已保存核验项不要重复替换,结果不确定项先使用“核验并恢复”。 + +## 已知待验证问题 + +上轮冻结 EXE 实机批次出现 Mentor quit helper 超过 20 秒并触发回收,20 项验收未完成。本版未宣称修复该超时,也没有通过放大超时或解除不确定保护来绕过故障。资源释放不代表回滚,`Close(False)` 仍可能落盘。打包、启动和自动化回归通过不能替代本版本的真实 CAD 验收。 + +本版作为预发布提供实机测试,未做代码签名。历史 R17 的 20 项验收和原生/Harness 对照不作为本包的验收结果。 diff --git a/docs/testing/evidence/2026-11-12-r17/README.md b/docs/testing/evidence/2026-11-12-r17/README.md index ada9f48..551e469 100644 --- a/docs/testing/evidence/2026-11-12-r17/README.md +++ b/docs/testing/evidence/2026-11-12-r17/README.md @@ -8,9 +8,12 @@ - `requirements-audit.md` / `.json`:逐项审计,保留一项 P3 列表徽标/筛选问题。 - `launcher-ui.json`:实际 CMD 启动、精确 EXE/data-root、零任务/零 Mentor 及正常退出。 - `harness-native-metrics.json`:同模型同输入预算的对照汇总;不证明 Harness 优于原生。 +- [逐样本配对索引](paired-review-index.json):关联原生/Harness 两臂的输入、模型配置、预算和原始报告;未重新运行模型,原格式失败保留。 摘录中的绝对路径属于验收机器,是原始记录的一部分。完整原始 UI 报告、失败现场、模型会话与进程/桌面观察仍保留于本地 `outputs/`。摘录的原路径及 SHA256 在 `acceptance-summary.json` 中列出。 R17 验收对应的 EXE 哈希固定为 `de35b91aaf4cbbc44177c6ba6efb53d082fbf916661c85809ae1bcc85a3f8759`。后续 PR 合入远端 v1.3.0 的版本元数据不等于重建了该 EXE;合入后的源码回归另行记录,不挪用 R17 实机记录为新构建验收。 PR 合入主分支后的源码回归也已完成:2777 项通过、552 份源/工具/测试指纹前后一致;见 [集成回归证明](pr-integration-proof.json)、`pr-integration-regression.xml` 和 `pr-integration-regression-run.json`。这些记录不是新构建 EXE 的实机验收。 + +上述回归属于 `49ae605` 阶段;后续原 PR HEAD 的三个 `.kyn` fixture 调整了 Git 存储的行尾,未改变该轮测试的工作树字节。后续修复与新回归单列于 [PR #27 复核记录](../../2026-11-13-pr27-review-fixes.md),不将历史结果当作最新构建验收。 diff --git a/docs/user/safe-stop-and-recovery.md b/docs/user/safe-stop-and-recovery.md index cf34355..198b853 100644 --- a/docs/user/safe-stop-and-recovery.md +++ b/docs/user/safe-stop-and-recovery.md @@ -6,9 +6,11 @@ ## 保存或修改长时间没有进度 -有写入可能的阶段,程序不会仅因超过无进度时限就自动终止应用。界面显示保存或核验尚未确认,可以继续等待并导出诊断包。等待不会启动下一项,也不会自动清除保护记录。 +有写入可能的阶段,程序先请求停止并等待安全边界。默认从最后一次业务进度起计时:150 秒无进展时请求停止,300 秒仍无进展时进入安全完成等待,再经过 30 秒仍无进展则触发失败自动回收。阶段或完成数量等实际进度变化会重新计时,只有心跳不会延长等待;这不是整个任务的总时限。等待期间不会启动下一项。 -如果操作已经失败且保存结果不确定,程序保留当前应用和工程现场,不再自动保存或丢弃。应先导出诊断、保留原始工程与备份,再决定是否需要强制结束。此时“继续等待”不表示自动恢复执行。 +执行错误需要释放 Mentor 时,程序先持久化结果不确定的保护记录,再进入自有进程的释放流程;正常退出失败时可能强制结束自有进程。只有确认相关进程退出后才释放私有桌面,不处理用户自行打开的 Mentor。保护记录无法可靠保存时保留资源等待处理,并显示原因。 + +资源释放不等于工程回滚或替换成功,关闭时仍可能落盘。结果不确定的任务必须先“核验并恢复”,已保存核验的项目不会自动重放。Mentor 退出助手另有独立的 20 秒等待时限,不能与上述停滞时限混淆;本版该退出超时仍待实机复核。 纯读取的 BOM/库存采集仍采用有界取消;不存在写入需要完成时,不要求用户无限等待。确认未修改的启动失败也保留既有有界停止机制。 diff --git a/packaging/windows-version-info.txt b/packaging/windows-version-info.txt index d57de04..3ca72d4 100644 --- a/packaging/windows-version-info.txt +++ b/packaging/windows-version-info.txt @@ -1,8 +1,8 @@ # UTF-8 VSVersionInfo( ffi=FixedFileInfo( - filevers=(1, 3, 0, 0), - prodvers=(1, 3, 0, 0), + filevers=(1, 3, 1, 0), + prodvers=(1, 3, 1, 0), mask=0x3f, flags=0x0, OS=0x40004, @@ -15,11 +15,11 @@ VSVersionInfo( StringTable('040904B0', [ StringStruct('CompanyName', 'DxProductivity'), StringStruct('FileDescription', 'DxDesigner Part Replacement'), - StringStruct('FileVersion', '1.3.0.0'), + StringStruct('FileVersion', '1.3.1.0'), StringStruct('InternalName', 'DxPartReplace'), StringStruct('OriginalFilename', 'DxPartReplace.exe'), StringStruct('ProductName', 'DxDesigner Part Replacement'), - StringStruct('ProductVersion', '1.3.0') + StringStruct('ProductVersion', '1.3.1') ]) ]), VarFileInfo([VarStruct('Translation', [1033, 1200])]) diff --git a/pyproject.toml b/pyproject.toml index 1ca4650..989b892 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta" [project] name = "dx-productivity" -version = "1.3.0" +version = "1.3.1" requires-python = ">=3.12,<3.13" dependencies = ["PySide6>=6.7,<7", "pywin32>=306", "pywinauto>=0.6.9,<1", "openpyxl>=3.1,<4"] diff --git a/src/dx_productivity/dsh/scheduling.py b/src/dx_productivity/dsh/scheduling.py index d11b8f7..662fd31 100644 --- a/src/dx_productivity/dsh/scheduling.py +++ b/src/dx_productivity/dsh/scheduling.py @@ -7,7 +7,6 @@ import json from pathlib import Path import re import sqlite3 -from typing import Any from uuid import uuid4 from ..trial_task_center.errors import TaskCenterError diff --git a/src/dx_productivity/trial_task_center/batch_supervisor.py b/src/dx_productivity/trial_task_center/batch_supervisor.py index 01e0de8..8656e63 100644 --- a/src/dx_productivity/trial_task_center/batch_supervisor.py +++ b/src/dx_productivity/trial_task_center/batch_supervisor.py @@ -16,7 +16,7 @@ from uuid import uuid4 from .errors import TaskCenterError from .path_access import canonical_path, internal_path, legacy_path -from .supervisor_protocol import VERSION, MessageGate, valid_journal, encode, decode, decode_error +from .supervisor_protocol import VERSION, MessageGate, valid_journal, encode, decode _WORKER_ROOT = None _LAUNCH_LOCK = threading.Lock() diff --git a/src/dx_productivity/trial_task_center/batch_worker.py b/src/dx_productivity/trial_task_center/batch_worker.py index 4158aba..054dd30 100644 --- a/src/dx_productivity/trial_task_center/batch_worker.py +++ b/src/dx_productivity/trial_task_center/batch_worker.py @@ -9,7 +9,6 @@ from pathlib import Path import sys import threading import time -import traceback from uuid import UUID from .path_access import internal_path, canonical_path diff --git a/src/dx_productivity/trial_task_center/recovery.py b/src/dx_productivity/trial_task_center/recovery.py index d2a648f..1e69984 100644 --- a/src/dx_productivity/trial_task_center/recovery.py +++ b/src/dx_productivity/trial_task_center/recovery.py @@ -15,7 +15,7 @@ from .errors import TaskCenterError from .native_helper import (read_snapshot, require_resumable_transaction, snapshot_target_cell, cell_catalog_binding, cell_catalog_evidence_root) from .quick_run import ( - TERMINAL_STATES, IDLE_PROGRESS_TIMEOUT_SECONDS, QuickRunStepResult, + TERMINAL_STATES, IDLE_PROGRESS_TIMEOUT_SECONDS, _native_helper_launch_arguments, _next_unfinished_command, _path_key, _queue_matches_inputs, _queue_value_mode, _read_command_sheet_targets, _read_command_options, _read_commands, _read_status_details, _safe_run_token, diff --git a/src/dx_productivity/trial_task_center/recovery_commit.py b/src/dx_productivity/trial_task_center/recovery_commit.py index 54cdf65..e73ae0d 100644 --- a/src/dx_productivity/trial_task_center/recovery_commit.py +++ b/src/dx_productivity/trial_task_center/recovery_commit.py @@ -2,7 +2,6 @@ import hashlib import json import os -from pathlib import Path from uuid import uuid4 from .batch_resources import write_record diff --git a/src/dx_productivity/trial_task_center/ui/main_window.py b/src/dx_productivity/trial_task_center/ui/main_window.py index 1dfc0ca..1053c4d 100644 --- a/src/dx_productivity/trial_task_center/ui/main_window.py +++ b/src/dx_productivity/trial_task_center/ui/main_window.py @@ -6,7 +6,7 @@ from shiboken6 import isValid import time from PySide6.QtCore import QElapsedTimer, QSettings, QSignalBlocker, QThreadPool, QTimer, Qt from PySide6.QtGui import QAction, QActionGroup -from PySide6.QtWidgets import (QApplication, QCheckBox, QDialog, QFileDialog, QHBoxLayout, QMainWindow, QMessageBox, +from PySide6.QtWidgets import (QApplication, QCheckBox, QDialog, QFileDialog, QHBoxLayout, QMessageBox, QPushButton, QLabel, QSizePolicy, QSplitter, QStackedWidget, QTabWidget, QToolButton, QVBoxLayout, QWidget) from ..errors import TaskCenterError from ..models import TaskStatus @@ -14,7 +14,7 @@ from ..version import VERSION from .dialogs import _TaskDialog, _MappingDialog from .execution_state import execution_state, pending_batch_tasks from .mapping_table import MappingTable -from .messages import ERROR_TEXT, _format_live_log_line, format_operation_error +from .messages import _format_live_log_line, format_operation_error from .project_plan import DirectoryTaskDialog, ProjectPlanPanel from .project_summary import ProjectSummary from .run_panel import RunPanel diff --git a/src/dx_productivity/trial_task_center/ui/project_plan.py b/src/dx_productivity/trial_task_center/ui/project_plan.py index e0229d5..775b99a 100644 --- a/src/dx_productivity/trial_task_center/ui/project_plan.py +++ b/src/dx_productivity/trial_task_center/ui/project_plan.py @@ -9,7 +9,7 @@ from PySide6.QtCore import Qt, QThreadPool, QObject, Signal, QSignalBlocker from PySide6.QtGui import QAction,QKeySequence from PySide6.QtWidgets import (QCheckBox, QDialog, QDialogButtonBox, QFileDialog, QHBoxLayout, QLabel, QLineEdit, QListWidget, QListWidgetItem, QMessageBox, QPushButton, - QVBoxLayout, QWidget, QToolButton, QMenu, QTableWidget, QTableWidgetItem, + QVBoxLayout, QWidget, QToolButton, QTableWidget, QTableWidgetItem, QAbstractItemView, QHeaderView) from shiboken6 import isValid diff --git a/src/dx_productivity/trial_task_center/version.py b/src/dx_productivity/trial_task_center/version.py index 7b49cf1..4cf03a8 100644 --- a/src/dx_productivity/trial_task_center/version.py +++ b/src/dx_productivity/trial_task_center/version.py @@ -1 +1 @@ -VERSION = "1.3.0" +VERSION = "1.3.1"