diff --git a/README.md b/README.md index 8f11527..1f52241 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,9 @@ 当前临时分支的备份策略(2026-11-03):应用不再自动备份中心库或 CBB 工程。新增、替换、移除、校验、ICDB 维护和恢复在执行前提示手动备份;请自行保留可用副本。导入暂存、恢复用隔离验证库和轻量操作证据仍会生成,Mentor 原生 Repair 自身的备份行为保持不变。详见[自动备份检查与调整](docs/releases/2026-11-03-manual-backup.md)。此条优先于下方历史版本的备份说明。 -当前开发版本:**[0.2.4b2 生命周期候选](docs/releases/2026-11-06-runtime-lifecycle-candidate.md)(开发候选,待现场验收)**。ICDB 批量检查在后台逐项运行,普通校验、管理和恢复可排队;READY 工程在实际执行前再次排除。检查不自动 Repair、Restore 或选择历史版本,也不代表中心库 READY。 +当前测试版本:**[0.2.4b3](docs/releases/v0.2.4-beta.3.md)(待现场验收)**。ICDB 批量检查在后台逐项运行,普通校验、管理和恢复可排队;READY 工程在实际执行前再次排除。检查不自动 Repair、Restore 或选择历史版本,也不代表中心库 READY。 + +管理写入因无法完成占用确认而未执行,或恢复安装前选择跳过,结果为 `SKIPPED`;取消为 `CANCELLED`,与实际操作失败区分。文件身份核对失败保留“需要恢复”,后续独立 CBB 依据各自会话释放和写前检查决定是否继续,不自动重放失败目标。 停止、超时或应用失联只停止后续原生动作,不结束正在 Save/Close 的调用进程。普通停止等待 5 秒,可能正在写入时最多等待 120 秒后交给后台观察;这不是强制结束时限。保存结果、关闭结果和资源释放分别记录。相关库等待释放,独立库可以排队继续;界面、筛选和日志保持可用。重启只核对未完成会话,不重放管理写操作。legacy 状态读取只观察已打开且匹配库的 LM,不启动 LM 或回答弹窗;无法读取保持 UNKNOWN。 diff --git a/REPOSITORY-NOTES.md b/REPOSITORY-NOTES.md index 466a783..263197f 100644 --- a/REPOSITORY-NOTES.md +++ b/REPOSITORY-NOTES.md @@ -15,6 +15,12 @@ python -m pytest -q python -m compileall -q src tests ``` +For an isolated checkout, set `$env:PYTHONPATH = (Resolve-Path ./src).Path` so +test subprocesses import that checkout rather than another editable installation. +The repository's `.gitattributes` preserves CRLF (`* -text`); use +`git -c core.whitespace=cr-at-eol diff --check` to check whitespace in a clean +clone without reporting the preserved CR bytes as trailing whitespace. + The source import was verified with 336 pytest cases. Tests use fake local files and replace the production Mentor COM/process boundary where required; they do not establish field success against a live network library. diff --git a/SOP.md b/SOP.md index 39a2092..58efe6f 100644 --- a/SOP.md +++ b/SOP.md @@ -1,6 +1,6 @@ # CBB 检查、校验、管理与残留释放操作规程 -适用开发版本:0.2.4b2。未完成现场验收,不自动发布或关闭工单。以下为当前规程,下方旧上传校验检查表保留为历史参考。 +适用测试版本:0.2.4b3。测试版发布不代表现场验收,不自动关闭工单。以下为当前规程,下方旧上传校验检查表保留为历史参考。 ## 当前操作与队列 @@ -20,6 +20,8 @@ ## 历史记录、操作结果与报告 +管理写入无法取得占用确认、或恢复安装前选择跳过时,记录 `SKIPPED`(已跳过 / 未执行);取消记录 `CANCELLED`。这两者不等于实际上传或恢复失败。文件核对失败仍记录“需要恢复”并禁止自动重放该目标;后续独立 CBB 在会话释放及自身写前检查通过后可继续。 + 校验和管理遇到历史释放记录时,先复核实际进程、地址、独占文件及导出副本。确认释放后归档记录再继续,不以历史 JSON 本身判定真实占用;同目标未完成写入仍需核对,不自动重放。释放证明在管理首次原生调用前写入检查点,并在结果中保留。 管理操作生成目标工程、库配置和共享依赖的写前/写后主要文件清单及新增、删除、修改差分;不增加自动全库备份,也不声称检查了其他 CBB 内容。报告不可用与原生操作失败分别记录;本任务已释放时可继续独立项。 diff --git a/docs/releases/v0.2.4-beta.3.md b/docs/releases/v0.2.4-beta.3.md new file mode 100644 index 0000000..f954229 --- /dev/null +++ b/docs/releases/v0.2.4-beta.3.md @@ -0,0 +1,21 @@ +# CBB 刷新校验 v0.2.4-beta.3 + +本测试版整合 PR #14:普通 CBB 导入与可选导出诊断解耦、写前未知会话确认、PCB 打开句柄顺序修复、任务绑定中心库,以及审查评论 414/430 的修复。 + +- 无效来源、可选 Verify 失败不再阻止已释放的独立条目继续。上传完成、校验通过和 READY 分开报告。 +- 无法取得写入确认、或恢复安装前跳过,记录为 SKIPPED;取消为 CANCELLED,保留具体原因。 +- 文件身份采集失败仍为 RECOVERY_REQUIRED;由独立的原生退出和资源证据决定后续资格,禁止自动重放该目标。 +- 无未知原生客户端时只探测一轮;等待用户确认后仍重新检查进程和资源。 +- 保留三个横向菜单和当前图标,不自动备份整个中心库;写操作前仍需人工备份。 + +下载 Windows ZIP 后完整解压,运行 `CbbRefreshVerify-Background/CbbRefreshVerify.exe`,保留同目录 `_internal`。 +发布程序由 Windows 主机从合入后的 main 构建并上传云端;不标记为云端 Windows runner 构建。 +发行附件的 `release-info.json`、`release-smoke.json` 和 `SHA256SUMS.txt` 记录实际提交、验证结果及文件散列。 + +导入确认原生注册、名称/分区、工程关联、允许的顶层块及 Layout,未证明原理图语义等价。 +UPLOADED 不等于 READY;完整 Verify 独立可选。已有其他 LibraryManager 时原生入口仍拒绝,需正常关闭相关会话再继续。 + +自动 ICDB Repair 仍关闭。EDIF 崩溃根因、Windows 10、跨机器 SMB 和现场服务器会话失联修复仍未验收; +测试版发布不代表这些问题已解决,不自动关闭工单。 + +回滚程序时完整解压此前发布包并在关闭新客户端后使用;程序回滚不撤销已完成的中心库写入,工程恢复须依据逐项证据和人工备份。 diff --git a/pyproject.toml b/pyproject.toml index 24a2651..105bbd0 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -3,7 +3,7 @@ requires = ["setuptools>=84.1.0"] build-backend = "setuptools.build_meta" [project] name = "cbb-refresh-verify" -version = "0.2.4b2" +version = "0.2.4b3" requires-python = ">=3.12,<3.13" dependencies = ["PySide6>=6.7,<7", "pywin32>=306", "pywinauto>=0.6.9,<0.7", "Pillow>=13.0.0,<14"] diff --git a/src/cbb_refresh_verify/__init__.py b/src/cbb_refresh_verify/__init__.py index 0c7b898..1e4336f 100644 --- a/src/cbb_refresh_verify/__init__.py +++ b/src/cbb_refresh_verify/__init__.py @@ -1 +1 @@ -__version__ = "0.2.4b2" +__version__ = "0.2.4b3" diff --git a/tests/support/runtime_lifecycle_frozen_smoke.py b/tests/support/runtime_lifecycle_frozen_smoke.py index 25995cc..e43534f 100644 --- a/tests/support/runtime_lifecycle_frozen_smoke.py +++ b/tests/support/runtime_lifecycle_frozen_smoke.py @@ -64,7 +64,7 @@ finally: from PyInstaller.archive.readers import ZlibArchiveReader pyz = bundle_root/'build/CbbRefreshVerify/PYZ-00.pyz' code = ZlibArchiveReader(str(pyz)).extract('cbb_refresh_verify') -assert '0.2.4b2' in code.co_consts +assert '0.2.4b3' in code.co_consts toc = ast.literal_eval((bundle_root/'build/CbbRefreshVerify/Analysis-00.toc').read_text('utf-8')) stack, rows = [toc], [] while stack: @@ -77,6 +77,6 @@ while stack: stack.extend(value) assert rows and all(Path(row[1]).is_relative_to(workspace/'src') for row in rows) results['module_origins'] = {'status': 'passed', 'module_count': len(rows), 'source_root': str(workspace/'src')} -results['version'] = '0.2.4b2' +results['version'] = '0.2.4b3' (root/'result.json').write_text(json.dumps(results, ensure_ascii=False, indent=2), 'utf-8') print(json.dumps({'evidence': str(root/'result.json'), **results}, ensure_ascii=False), flush=True)