docs: plan native lifecycle safety and read-only status boundaries

This commit is contained in:
阿白叔 committed 2026-11-06 14:25:09 +08:00
1 parent 5eb4b2d7ed
commit 3e7ae2b76f
2 files changed
+571

No files matched your search

@@ -0,0 +1,370 @@
# CBB 原生操作生命周期与只读边界 Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. 本计划默认在当前会话逐项执行,不隐含授权创建额外代理。
**Goal:** 消除保存阶段的自动强杀、管理工作进程失联后的无监督写入,以及 legacy 状态读取的隐式弹窗操作,同时保持工具可用和独立任务可继续。
**Architecture:** 复用现有 NativeQueue、LibraryLock、私有桌面和库外证据体系,补充一个保存事实解析模块与一个会话记录模块。先实现保存/停止策略,再补管理监督与跨重启观察,最后收紧读取路径并联调 GUI/CLI;不重写调度框架。
**Tech Stack:** Python 3.12、PySide6、pywin32、Windows、Mentor EE7.9.5、现有 32 位 cscript/VBS 与状态桥;不增加运行时依赖。
**Spec:** [2026-11-06-runtime-lifecycle-safety-design.md](../specs/2026-11-06-runtime-lifecycle-safety-design.md)
**Status:** 计划草案。用户已确认范围;本轮明确要求完成计划,因此设计和实施清单同时供审阅,不能视为设计已经批准或代码实施已经授权。基线为 `5eb4b2d7ed09947f19310ba80ba3b9a2a09b6f7d`;本文件没有修改生产行为。
## Global Constraints
- 技术栈保持 Python 3.12、PySide6、pywin32、Mentor EE7.9.5,不增加运行时依赖。
- 检验、ICDB 批量检查、中心库管理保持独立;ICDB 自动 Repair 继续关闭。
- READY 条目继续排除维护;状态读取失败不伪造 READY,也不直接判定 ICDB 损坏。
- 自动停止、超时、失败清理、监督器失联都不得强杀可能正在原生写入的进程或 COM 保存 helper。
- UI、搜索、筛选、日志查看和只读浏览保持可用;一个未释放写入不得占着全局执行票据等待无限长时间。
- 同库仍在进行的写入不可并发启动;已释放的单项失败不得阻止独立项,其他独立库可排队获得执行机会。
- 历史 JSON 只触发身份及实际资源复核,不直接构成真实占用;报告错误不得伪造占用或永久禁用入口。
- 不自动选择历史版本、重新导入、恢复备份、删除原生锁/地址文件或修改 LMC 伪造状态。
- 不新增全库自动备份或全库内容哈希;此前确认的人工备份策略不变。
- 确认结束客户端与正常停止分开;本轮不增加“放弃正在进行的保存”按钮,不自动放宽服务器保护。
- 原生动作、证据读取、路径解析、进程查询和重启核对都放在非 GUI 线程;GUI 只更新视图和提交用户意图。
- 保留 VerifyRequest / VerifyResult 的现有参数及 safe_to_continue 兼容性,只追加有默认值的事实字段。
- 保持原有文件行尾,不进行与功能无关的整文件规范化。
- 开发验证只使用临时数据、模拟原生边界或隔离副本;不在生产库制造保存中断。
## 实施起点与三个交付单元
执行前重新读取 PR #10/#11/#12、main 和本地工作树,不将旧评论当成新实现的批准。另开 `codex/runtime-lifecycle-safety` 临时分支,使用独立工作树;保留用户原始脏工作区与已运行程序,不 force-push。
- **A:保存与停止闭环。** Task 1–4 作为一个功能单元验收;前面的模型和 primitive 可以独立提交,接线未完成时不交付候选程序。
- **B:管理失联与重启核对。** Task 5–6,在 A 的协议上扩展管理;不增加自动清除锁文件。
- **C:只读边界与交付验证。** Task 7–9;最终创建仅含本轮差分的草稿 PR,按 A/B/C 给出审查顺序。
### Task 1:建立保存事实解析与停止判据
**Files:**
- Create: `src/cbb_refresh_verify/operation_lifecycle.py`
- Create: `tests/test_operation_lifecycle.py`
**Interfaces:**
- Consumes: 本轮 helper 的标记序列与独立进程/资源观察结果;不读取文件或调用 COM。
- Produces: `classify_save_state(markers: Sequence[str], *, helper_exited: bool | None, native_released: bool | None, forced: bool = False) -> dict[str, str | bool]`。
- Produces: `stop_disposition(*, call_started: bool | None, call_returned: bool | None, identity_confirmed: bool) -> str`,返回 CANCEL_BEFORE_CALL / WAIT_FOR_RETURN / CLEANUP_RETURNED / OBSERVE_UNCONFIRMED。
- 返回字段固定为 save_state、close_state、helper_state、resource_state、interrupted、detail,取值见设计第 4 节;其他任务不得另造不兼容枚举。
- [ ] **Step 1: 写失败测试,证明 Save/Close/释放不能互相替代。**
```python
from cbb_refresh_verify.operation_lifecycle import classify_save_state, stop_disposition
def test_saved_but_not_closed_is_not_unsaved_or_fully_released():
facts = classify_save_state(["SAVE_START", "SAVE_OK", "CLOSE_START"],
helper_exited=False, native_released=False)
assert facts["save_state"] == "COMMITTED"
assert facts["close_state"] == "UNKNOWN"
assert facts["resource_state"] == "RETAINED"
def test_process_exit_without_save_result_is_unknown():
facts = classify_save_state(["SAVE_START"], helper_exited=True, native_released=True)
assert facts["save_state"] == "UNKNOWN"
assert facts["resource_state"] == "RELEASED"
def test_an_unreturned_call_requires_waiting():
assert stop_disposition(call_started=True, call_returned=False,
identity_confirmed=True) == "WAIT_FOR_RETURN"
```
- [ ] **Step 2: 运行并确认 RED。** `python -m pytest -q tests/test_operation_lifecycle.py`;预期缺少新模块/函数。再加取消前、SAVE_REJECTED、CLOSE_FAILED、日志截断/矛盾、forced=True 的行为断言,不把进程退出断言成保存完成。
- [ ] **Step 3: 实现纯判据。** 核心映射从明确证据出发:
```python
save_state = ("COMMITTED" if "SAVE_OK" in markers else
"REJECTED" if "SAVE_REJECTED" in markers else
"NOT_STARTED" if "CANCELLED_BEFORE_SAVE" in markers else "UNKNOWN")
resource_state = ("RELEASED" if native_released is True and helper_exited is True else
"RETAINED" if native_released is False or helper_exited is False else "UNKNOWN")
```
不把 UNKNOWN 当 False;矛盾标记降为 UNKNOWN 并记录原因。`forced=True` 不能把 UNKNOWN 的保存状态升级为成功。
- [ ] **Step 4: 运行该文件及 `tests/test_runtime_timing.py`,确认已有标记消费保持兼容。**
- [ ] **Step 5: 提交。** `git commit -m "feat: distinguish save close and resource release facts"`。
### Task 2:保存 helper 的启动门和完整返回事实
**Files:**
- Modify: `src/cbb_refresh_verify/save_verified_block.vbs`
- Modify: `src/cbb_refresh_verify/desktop_worker.py:17`(launch_save_helper)
- Modify: `src/cbb_refresh_verify/mentor_adapter.py:818`(保存启动和等待)
- Modify: `tests/test_save_helper_runtime.py`
- Modify: `tests/test_failure_lifecycle.py`
- Create: `tests/test_save_helper_identity.py`(基线没有此文件,用于 helper 启动门和精确身份测试)
**Interfaces:**
- Consumes: Task 1 的 `classify_save_state`。
- Produces: VBS 标记 CANCELLED_BEFORE_SAVE / SAVE_START / SAVE_OK / SAVE_REJECTED / POST_SAVE_FAILED / CLOSE_START / CLOSE_OK / CLOSE_FAILED,以及既有 LICENSE_OK / IS_SAVED / QUIT_OK。
- `launch_save_helper(command, **kwargs)` 保持原调用兼容;生产调用附加第 4 个 VBS 参数 `start_gate`,helper 未放行时不进入 COM;已有三参数 harness 保留兼容覆盖。
- helper 启动门在 30 秒内未放行或取消时,以明确的启动前取消结果退出。门放行前记录精确 helper 身份,不靠事后按父 PID 猜测。
- [ ] **Step 1: 扩展真实 cscript harness,先复现保存中取消和保存后关闭失败。** 继续使用 `tests/test_save_helper_runtime.py` 中实际 VBS 源码,仅替换 COM 创建。FakeDoc.Save 内创建取消文件后返回 True;FakeDoc.Close 返回 False 或延迟返回。断言:
```python
assert "SAVE_OK" in completed.stdout
assert "SAVE_REJECTED" not in completed.stdout
assert "CLOSE_FAILED" in completed.stdout
assert completed.returncode != 0
```
另写门未打开的 harness,在 FakeDoc.Save 中写 `save-called.txt`;取消/门超时后该文件必须不存在。
- [ ] **Step 2: 运行 `python -m pytest -q tests/test_save_helper_runtime.py tests/test_failure_lifecycle.py -k "save or helper"`,确认新行为失败。** 不运行真实 Mentor 保存。
- [ ] **Step 3: 按调用边界写标记,取消只阻止尚未开始的写入。** 局部错误检查示例:
```vb
CheckCancellationBeforeSave
WScript.Echo "SAVE_START"
On Error Resume Next
operationOK = doc.Save()
saveError = Err.Number
saveDescription = Err.Description
Err.Clear
On Error GoTo 0
If saveError <> 0 Then
WScript.Echo "SAVE_RESULT_UNKNOWN|" & CStr(saveError) & "|" & saveDescription
WScript.Quit 11
End If
If Not operationOK Then
WScript.Echo "SAVE_REJECTED"
WScript.Quit 4
End If
WScript.Echo "SAVE_OK"
```
把 `saveError/saveDescription` 加入 Option Explicit 的 Dim。IsSaved/后置同步/Close 使用同样局部检查并写各自原因,不抹掉 SAVE_OK;取消后只在精确文档、已保存且没有未知模态提示时做既有正常关闭,不再次 Save、不自动放弃脏文档。
- [ ] **Step 4: 保存等待不再因取消文件出现就直接抛错丢弃监督。** 本任务先提供可观察的调用返回事实;Task 4 再统一所有生产停止入口,不能保留“保存脚本启动后随便 terminate”的中间交付。
- [ ] **Step 5: 重跑真实 cscript harness、身份核对和 runtime_timing 回归,通过后提交。** `git commit -m "fix: preserve native save results across cancellation"`。
### Task 3:受控会话记录和后台观察交接
**Files:**
- Create: `src/cbb_refresh_verify/session_record.py`
- Create: `tests/test_session_record.py`
- Modify: `src/cbb_refresh_verify/desktop_worker.py`
- Modify: `src/cbb_refresh_verify/library_lock.py`
- Modify: `src/cbb_refresh_verify/network_path.py`
- Test: `tests/test_network_release_safety.py`
**Interfaces:**
- Produces: `write_session_record(path: Path, record: Mapping[str, object]) -> None`,原子 pending→replace,flush/fsync。
- Produces: `read_session_record(path: Path, *, evidence_root: Path) -> dict`,协议 `cbb-runtime-session`、version=1,最大 64 KiB,拒绝重解析点/越界路径。
- Produces: `reconcile_session_record(path: Path, *, evidence_root: Path) -> dict`,仅后台核对,返回 ACTIVE / RELEASED / IDENTITY_CHANGED / UNCONFIRMED、原因、匹配库及独立 release_proof;不终止进程、不执行写操作。
- Produces: `observe_retained_session(path: Path, *, evidence_root: Path, stop=None, progress=None) -> dict`,1 秒为观察间隔,单次进程查询有界;退出观察不表示原生进程退出。
- immutable `session.json`、单写者 `worker-state.json`、watchdog 的 `supervisor-lost.json`、观察者的 `observation-<observer_id>.json` 分开,不互相覆盖。
- 等待循环只使用精确句柄的零等待观察,不持有 `_guard`/全局原生互斥,不循环扫描全库。退出后才尝试独立释放证明;通道忙只延后该观察,不把其他库也设为不可用。
- [ ] **Step 1: 写协议/重启身份测试。** 使用临时 JSON 和本测试创建的 sleep 子进程;在记录上替换 created 或 executable,确保返回 IDENTITY_CHANGED 而不是结束新进程。损坏 JSON、超过 64 KiB 和越界目录返回 UNCONFIRMED。
```python
def test_record_outside_controlled_root_is_observation_only(tmp_path):
from cbb_refresh_verify.session_record import reconcile_session_record
owned = tmp_path / "owned"
owned.mkdir()
external = tmp_path / "external-session.json"
external.write_text("{}", encoding="utf-8")
outcome = reconcile_session_record(external, evidence_root=owned)
assert outcome["status"] == "UNCONFIRMED"
assert outcome["release_proof"] is None
```
PID 复用测试在本测试创建的进程身份记录上替换 created/image,再走同一个 reconcile 入口;只模拟外部进程观察边界,不用实现返回值代替被测流程。
- [ ] **Step 2: 运行 `python -m pytest -q tests/test_session_record.py`,确认 RED。**
- [ ] **Step 3: 实现精确身份、记录路径约束与独立释放证明。** 核对 supervisor/worker/helper/native 的创建时间、映像和当前用户/Windows 会话。PID 不在快照中不能直接生成 RELEASED;复用现有 `release_retained_library` 证明,不删 `.lock`/sAddress.adr。
- [ ] **Step 4: 增加后台交接测试。** A 库 helper 保持活跃,转观察后释放 NativeQueue action;同库写请求仍等待,B 库请求可运行。映射直到匹配库独立释放证明成立才归还;调用 `process.close()` 不得丢失观察所需的精确句柄。
- [ ] **Step 5: 验证报告写失败不终止活跃调用、不把记录存在本身当占用。** 内存观察保留,下一次可重新核对。通过后提交 `git commit -m "feat: persist and reconcile owned native sessions"`。
### Task 4:统一用户停止、超时、finally、kill 和 watchdog
**Files:**
- Modify: `src/cbb_refresh_verify/verify_runner.py:231`、`:951`、`:1067`、`:1090`、`:1128`
- Modify: `src/cbb_refresh_verify/desktop_worker.py:25`、`:174`、`:182`、`:191`、`:224`
- Modify: `src/cbb_refresh_verify/mentor_adapter.py:830`、`:888`、`:1005`
- Modify: `src/cbb_refresh_verify/verify_runner.py`(VerifyResult 默认字段与兼容 auto_repair 停止传播)
- Modify: `src/cbb_refresh_verify/defaults.py`(NATIVE_WRITE_STOP_WAIT_SECONDS)
- Modify: `src/cbb_refresh_verify/native_repair.py:127`(增加 stop=None 并向现有 run_native_repair 传播;默认 auto_repair 不变)
- Test: `tests/test_failure_lifecycle.py`
- Test: `tests/test_abnormal_shutdown.py`
- Test: `tests/test_verify_worker_stability.py`
- Test: `tests/test_incident_safety.py`
**Interfaces:**
- Consumes: Task 1–3 的事实解析、停止判据与后台观察。
- `_stop_worker(process, *, timeout=5)` 保持 bool 返回兼容,但不再对未知/活跃写调用自动 kill;返回 False 表示尚未确认 worker 退出,调用方转受控观察。
- `VerifyResult.write_outcome: dict | None = None`、`session_record_path: Path | None = None` 追加在现有默认字段之后。
- `attempt_recovery(request, diagnosis, evidence_root, *, progress=None, stop=None)` 只补取消传播,不使其默认启用。
- 保存等待转后台的默认界限为 120 秒,放在 `defaults.py` 的 `NATIVE_WRITE_STOP_WAIT_SECONDS`;普通合作式停止等待保持 5 秒。
- [ ] **Step 1: 替换冲突的旧期望并增加跨组件失败测试。** `test_stop_cancels_then_stops_automation_client_after_deadline` 不能再锁定保存中会 kill 的行为。用本测试创建的 helper 进程触发 `_stop_worker`,使 `kill` 和 `stop_automation_clients` 在活跃 Save 时被调用即失败:
```python
class SavingWorker:
def request_stop(self): self.requested = True
def wait(self, timeout): raise TimeoutError("native Save pending")
def poll(self): return None
def kill(self): raise AssertionError("pending Save was killed")
def stop_automation_clients(self): raise AssertionError("save helper was killed")
def test_cancel_preserves_pending_save():
worker = SavingWorker()
assert _stop_worker(worker, timeout=0) is False
assert worker.requested
```
这个 fake 只用于停止分派边界;另用实际 sleep/helper 与真实 VBS harness 验证生命周期,不只断言 mock 被调用。
- [ ] **Step 2: 覆盖五个触发入口。** 用户停止、活动超时、对话框错误、finally 收尾、父进程退出分别触发;verify 生产配置 `stop_clients=True` 必须在测试中出现,不只测默认参数 False。
- [ ] **Step 3: 接入同一阶段判据。** 原生调用可能进行中时只写取消意图;短等待后不关闭观察句柄,120 秒后交 Task 3 观察。只有已证明未进入写入的辅助进程允许终止。`DesktopWorker.kill` 及 watchdog 不能绕开此判据;保存 helper 的注册/启动门与 supervisor 失联竞争必须被覆盖。
- [ ] **Step 4: 清理前采样并保留中断事实。** 更新 session-release/outcome/result/recovery-required 的生成逻辑。后续发现进程退出可以更新 resource_state,但不能把未知保存重写成成功;正常关闭失败保留 COMMITTED。`safe_to_continue=True` 不删除 write_outcome 中的失败。
- [ ] **Step 5: 跑 `tests/test_operation_lifecycle.py tests/test_session_record.py tests/test_failure_lifecycle.py tests/test_abnormal_shutdown.py tests/test_verify_worker_stability.py tests/test_incident_safety.py`,通过后执行交付单元 A 的完整回归并提交。** `git commit -m "fix: honor native write boundaries on every stop path"`。
### Task 5:管理 worker 的监督器失联与事务边界取消
**Files:**
- Modify: `src/cbb_refresh_verify/native_management.py:132`、`:209`、`:694`、`:1131`
- Modify: `src/cbb_refresh_verify/management.py`(run_management / run_management_batch)
- Modify: `src/cbb_refresh_verify/management_transaction.py`(沿用原 nonce/lease 身份,不放宽验证)
- Create: `tests/test_management_supervision.py`
- Test: `tests/test_management_native_transaction.py`
- Test: `tests/test_management_retry_blockers.py`
**Interfaces:**
- Consumes: Task 3 的会话记录,Task 4 的阶段停止规则。
- 管理 job 新增 `cancel_signal`、`session_record_path`、`start_gate` 与 supervisor 创建身份;原 desktop/supervisor_pid/timeout_seconds 保持兼容。
- 新增私有 `_require_management_continuation(job, root)`:每次新原生调用前校验当前取消/监督器身份;被取消时抛已有管理错误并明确 native_started,而不是启动下一动作。
- 现有 `_require_add_supervisor(job, root)` 调用共享判据并保留 add deadline 检查,不移除已有安全检查。
- [ ] **Step 1: 写无监督器和双阶段 update 测试。** 在 catalog 前使 supervisor 退出,确保不创建 LM;remove 调用内部模拟父进程退出但保留 native owner,返回后确保 add 不调用。断言部分完成与资源释放分别记录:
```python
assert result.status == "RECOVERY_REQUIRED" # remove 已发生,add 未发出
assert adapter.calls == ["remove"]
assert result.safe_to_continue is True # 本例原生 owner 已独立证明释放
assert not any(call[0] == "add" for call in adapter.calls if isinstance(call, tuple))
```
- [ ] **Step 2: 对 catalog/add/remove 三条 worker 路由分别触发取消和父进程退出。** 正在 native wait/COM 调用时 helper/worker 存活,返回后不进入下一写动作;同目标不得自动重试。
- [ ] **Step 3: 启动前持久登记并使用 gate,worker 在身份检查后 armed watchdog。** watchdog 只写自己的失联文件和取消信号,不异步退出正在做原生调用的工作进程。调用返回后执行正常自有会话收尾;未知弹窗记录并交已有提示入口。
- [ ] **Step 4: 将仅依赖 `_pending_workers/_retained_workers` 的判据补为内存+可核对记录。** 内存列表继续用于同一进程的快速收尾,但不是唯一恢复入口;读不到 result.json 不能永久推断 owner 活着。
- [ ] **Step 5: 跑管理三个测试文件与 `tests/test_native_management.py tests/test_native_export_guard.py`,通过后提交。** `git commit -m "fix: supervise management workers across cancellation and parent loss"`。
### Task 6:重启核对和相关库范围的可操作入口
**Files:**
- Modify: `src/cbb_refresh_verify/session_record.py`
- Modify: `src/cbb_refresh_verify/residual_sessions.py`
- Modify: `src/cbb_refresh_verify/ui/residual_release_dialog.py`
- Modify: `src/cbb_refresh_verify/ui/main_window.py`
- Test: `tests/test_session_record.py`
- Test: `tests/test_review_release_followup.py`
- Test: `tests/test_ui_lease_lifecycle.py`
- Test: `tests/test_background_queue_regressions.py`
**Interfaces:**
- Consumes: A/B 单元生成的 session.json/worker-state/observation 记录,保留已存在的 release_proof / released Signal 兼容。
- GUI 后台核对只显示状态,不自动点击原生提示、不重放新增/更新/移除、不仅按 Cbb 桌面前缀结束进程。
- NativeQueue 使用已有 ready 回调查询已缓存的相关库可执行性;ready 自身不做 WMI、文件读取或 SMB 路径解析。
- [ ] **Step 1: 写“重启时 active、exited、PID reused、记录损坏”四个场景。** 检查行为结果而不是只检查某函数调用次数:active 可看原生阶段,exited 需独立证明,reused 没有 native 消息,损坏记录不禁用全部 UI。
- [ ] **Step 2: 写 A 库等待、B 库可执行的队列测试。** 暂停保存的 A 保留关联租约,不占队列 active;B 可完成,A 同库新写操作不会进入。用户取消批次不会在恢复后自动重放。
- [ ] **Step 3: 接入启动时的后台发现与已有“查看原生提示/处理保存/请求原生取消/重新检查”。** 未知窗口只展示真实原因;记录 helper 正在 Save/Close 时不向普通强制结束路径放行。不为“能释放”而新增任意杀进程按钮。
- [ ] **Step 4: 证明成立后只解除匹配会话的历史记录和映射。** 关闭自有 desktop 句柄,不能宣称已删除仍有原生引用的桌面。报告保存失败单独展示,不把有效释放反转成真实占用。
- [ ] **Step 5: 跑上述四个文件与 `tests/test_residual_sessions.py tests/test_residual_release_dialog.py`,再跑 A+B 完整回归后提交。** `git commit -m "fix: reconcile retained sessions without blocking independent libraries"`。
### Task 7:关闭 legacy 读取的隐式启动和肯定按钮回退
**Files:**
- Modify: `src/cbb_refresh_verify/library_reader.py:249`、`:340`
- Modify: `src/cbb_refresh_verify/mentor_adapter.py:1453`、`:1532`、`:1629`
- Modify: `src/cbb_refresh_verify/ui/main_window.py:114`
- Create: `tests/test_readonly_status_policy.py`
- Test: `tests/test_library_reader.py`
- Test: `tests/test_batch_status_faults.py`
- Modify: `tests/test_desktop_worker.py`(旧 reader 必启动私有桌面的测试改为可达新边界)
**Interfaces:**
- 默认 authoritative_status_map 入口不变;桥返回失败仍使用 UNKNOWN / UNAVAILABLE,不能升级为 PENDING/READY。
- `read_library_flag(library, name, *, timeout_seconds=90, log_path=None)` 与 `read_library_tree_image_map(library, names, *, timeout_seconds=45, log_path=None)` 保留调用签名和返回形状,但只观察已存在、匹配库身份的 LM;不自动启动新的 LM。
- 无匹配 LM 返回原有 FLAG_UNKNOWN 或 `{name: None}`,并附可读原因,不要求每次搜索/过滤都人工开 LM。
- `handle_known_dialogs` 留给需要的已验证写路径;状态读取不调用它,不修改其他流程的弹窗规则。
- [ ] **Step 1: 写未知提示和无 LM 的回归。** 把 CreateDesktop/CreateProcess/PostMessage 与 affirmative handler 设为触发即失败,调用两个兼容 reader 和 `scan_open_library_status`:
```python
def test_status_read_does_not_launch_or_answer_when_lm_is_absent(monkeypatch):
import win32process
from cbb_refresh_verify import mentor_adapter
monkeypatch.setattr(win32process, "CreateProcess",
lambda *a, **kw: (_ for _ in ()).throw(AssertionError("implicit LM launch")))
# 该测试文件的 FakeDesktop.windows() 返回 [],不连接实际 LM。
assert mentor_adapter.read_library_tree_image_map("C:/Fixture/lib.lmc", ["A"]) == {"A": None}
```
再对“修复/覆盖/保存/未知许可提示”的窗口快照参数化,要求没有任何消息发送。
- [ ] **Step 2: 运行 `python -m pytest -q tests/test_readonly_status_policy.py`,确认 RED。**
- [ ] **Step 3: 去掉读取路径的自动创建和通用肯定应答。** 抽取最小既有 LM 树观察函数,使用 exact library identity,只读树项,不关闭用户打开的窗口;窗口不可读就返回未知。若发现其他调用方仍依赖隐式启动,迁到明确的原生工具打开入口或保留未知,不隐藏恢复原行为。
- [ ] **Step 4: 跑 reader/bridge/UI 状态回归,并用混合 READY/PENDING/UNAVAILABLE 清单检查数量和筛选。** 默认桥成功时不改变结果;legacy 无 LM 不弹每项确认、不启动 Mentor、不伪造损坏。
- [ ] **Step 5: 提交。** `git commit -m "fix: keep legacy status reads observational"`。
### Task 8:GUI/CLI 停止传播和结果展示联调
**Files:**
- Modify: `src/cbb_refresh_verify/verify_runner.py:1251`(run_batch 默认 verifier 转发 stop)
- Modify: `src/cbb_refresh_verify/ui/main_window.py:1504`
- Modify: `src/cbb_refresh_verify/ui/icdb_check_task.py`
- Modify: `src/cbb_refresh_verify/ui/management_dialog.py`
- Modify: `src/cbb_refresh_verify/application.py`(CLI 信号进入本批次 stop)
- Test: `tests/test_operation_queue.py`
- Test: `tests/test_ui_batch_safety.py`
- Test: `tests/test_background_queue_regressions.py`
- Test: `tests/test_application.py`
**Interfaces:**
- `run_batch(..., stop=event)` 的默认调用必须实际传 `run_verify(..., stop=event)`;外部注入 verifier 的原一参数签名保持不变。
- UI 接受 write_outcome 和 session_record_path,但不直接读取/resolve 这些路径;通过现有 ServiceWorker 接收事实。
- 文案分别为“已请求停止,等待当前保存返回”“保存已返回,关闭待确认”“已转后台观察,可查看状态”“当前状态无法确认”,只在对应事实成立时显示。
- [ ] **Step 1: 写 CLI 默认 verifier 的 stop 传播测试与 GUI 延迟保存测试。** GUI 点击停止后 200ms 定时器仍可触发、搜索仍可编辑;新原生动作没有发出,进度不假称已保存或已释放。
- [ ] **Step 2: 写 action 抛异常、队列取消和按库 ready 的回归。** 保留已存在的 Event 轮询取消语义;不用无通知无限 wait;一项异常释放队列票据,后续可执行独立项不被遗留票据挡住。
- [ ] **Step 3: 接入停止来源与事实投影。** `auto_repair=False` 保持默认;兼容修复/复验的 stop 转发使用 Task 4 新签名。Save/Close 尚未确认时不启用本目标自动重试,也不禁用所有只读操作。
- [ ] **Step 4: 跑队列、后台、界面和 CLI 测试,检查退出/重启后未完成状态仍可见。** GUI 线程中将 Path.resolve、WMI、文件读取替换为失败哨兵,确认事实展示不触发它们。
- [ ] **Step 5: 提交。** `git commit -m "fix: propagate stop intent and display independent lifecycle facts"`。
### Task 9:完整回归、冻结包和隔离验收
**Files:**
- Modify: `README.md`
- Modify: `SOP.md`
- Modify: `docs/ICDB-MANUAL-REPAIR-AND-UPDATE.md`
- Create: `docs/releases/2026-11-06-runtime-lifecycle-validation.json`
- Create: `docs/releases/2026-11-06-runtime-lifecycle-candidate.md`
- Modify: `pyproject.toml`、`src/cbb_refresh_verify/__init__.py`(只在实际生成新候选包时递增为 0.2.4b2)
- Test: `tests/test_packaging.py`、`tests/test_packaging_status_bridge.py`
**Interfaces:**
- 验证记录必须关联最终 source tree SHA、测试 XML 哈希、实际版本、候选包 SHA-256、平台/Mentor 版本;缺少真实包或环境的项使用 not_run/unverified,不能写 passed。
- 旧 `0.2.4b1` / `5eb4b2d` 的 1,631 完整回归和 63 项专项为历史基线,不是本轮验收结果。
- [ ] **Step 1: 在独立测试互斥/临时恢复目录下串行跑最终完整套件。** `python -m pytest -q` 必须来自新工作树 src,子进程 PYTHONPATH 同步。不要同时在同一 runner 跑另一个使用真实产品互斥或固定恢复根的全量任务。
- [ ] **Step 2: 跑 `python -m compileall -q src tests` 和 `git diff --check`。** 保持源文件原行尾;记录预期 pywinauto COM 提示,新的警告另查。
- [ ] **Step 3: 生成候选包前更新为 0.2.4b2,按现有 spec 打包并运行 frozen 入口冒烟。** 验证 verify-worker、management-worker、owner-probe、dialog-agent 的模块/脚本可加载;运行“冻结程序 + fake 保存/管理 native 边界”的父进程退出与停止测试。构建环境缺外部依赖时记录具体缺项,不宣称已产生候选包。
- [ ] **Step 4: 通过应用实际按钮运行隔离副本。** 单独记录 Save 前停止、Save 中停止、Close 延迟、管理父进程退出、legacy 未打开 LM、未知原生提示、独立库继续。缺实机场景保留未验收;不为验收在生产库保存中杀进程。
- [ ] **Step 5: 更新文档与审查描述。** 写清默认停止规则、后台观察范围、只读未知状态、真实 COM 无法取消的限制、程序回退与数据恢复的区别。测试用例数量不得替代场景证据。
- [ ] **Step 6: 提交候选记录,推送本轮差分草稿 PR。** `git commit -m "docs: record runtime lifecycle validation and candidate limits"`;按 A/B/C 提供审查顺序,不自动发布或关闭 ICDB 工单。若 main 已变化,重新整合并验证实际候选树。
## 验收映射与自查
| 审查问题 | 计划任务 | 必须看到的证据 |
| --- | --- | --- |
| P1-1 Save/Close 中自动强杀及误记安全 | 1、2、3、4、8 | 实际 helper 存活、无 terminate、保存/关闭/释放独立结果、跨入口停止一致 |
| P1-2 管理失联后无监督操作 | 3、5、6 | 启动门、精确持久身份、失联取消、调用返回后无后续写入、重启可核对 |
| P1-3 legacy 读取隐式启动/肯定应答 | 7、8 | 读取路径无 CreateProcess/点击/用户窗口关闭,未知状态可见 |
| 直接相关停止传播和保存状态记录 | 1、2、4、8 | CLI/GUI 同一 stop,兼容修复链不吞 stop;COMMITTED 与关闭失败并存 |
| 防止修复又导致整批/全工具卡死 | 3、6、8 | 有界等待后转观察;B 库执行,A 库活跃写入不并发;UI 始终可响应 |
| 源码、冻结包和现场验收口径 | 9 | 三层分别记录,缺哪层明确保留,不能互相代替 |
本轮排除项见设计第 13 节。源文件行号以基线供定位,实施时先用 rg 重新定位所有调用方,不直接按旧行号打补丁。
后续默认在当前会话用 executing-plans 按阶段执行;如用户明确选择并行代理,再使用对应技能。当前草案完成后先整体审阅设计,未取得实施指令前只保留文档。
@@ -0,0 +1,201 @@
# CBB 原生操作生命周期与只读边界设计草案
状态:设计草案,待用户整体审阅;本轮只规划,不实现运行时代码。
范围已由用户确认:三条 P1,加上直接相关的停止与状态记录问题。
代码基线:`5eb4b2d7ed09947f19310ba80ba3b9a2a09b6f7d`。审查来源:[PR #12 评论 297](https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/12#issuecomment-297)。评论分析的是旧 `dc536da`;以下结论重新对照当前基线,不把旧评论当作最新提交的复审。
## 1. 要解决的实际问题
1. 用户停止、超时、失败清理和监督器失联可经不同路径结束保存 helper。杀掉调用 `doc.Save()` 的 cscript 后,退出查询又可能将它描述为已安全释放。
2. 管理工作进程缺少统一的监督器失联处理和可跨重启核对的会话记录。新增路径已有 `_require_add_supervisor`,但 catalog、remove、COM 等待和收尾覆盖不一致。
3. legacy 状态读取会启动私有桌面的 LM,并调用偏向肯定按钮的通用弹窗处理器。默认权威桥路径没有这项图标读取回退,不能把风险泛化成所有读取都会执行它。
本轮修复停止与监督行为,不能据此宣布现场 ICDB 失联已修好,或推断已经验证了保存中断的数据后果。
## 2. 方案比较与选择
| 方案 | 代价与限制 | 选择 |
| --- | --- | --- |
| 按异常逐处增加判断 | 改动初期较少,但用户停止、finally、kill、watchdog 容易再分叉;不能解决重启后的身份核对 | 不采用 |
| 小型事实模型、按原生阶段停止、复用现有队列和租约 | 集中约束危险动作,同时保留现有串行操作、后台检查和确认入口;可分三个交付单元审查 | 推荐 |
| 重写调度与自动化框架 | 改动大,可能重新引入阻塞,且难以定位回归 | 不采用 |
本轮只增加保存事实解析和受限会话记录两个小模块,不引入通用流程引擎、任务总线或新依赖。
## 3. 全局约束
- 技术栈保持 Python 3.12、PySide6、pywin32、Mentor EE7.9.5,不增加运行时依赖。
- 检验、ICDB 批量检查、中心库管理保持独立;ICDB 自动 Repair 继续关闭。
- READY 条目继续排除维护;状态读取失败不伪造 READY,也不直接判定 ICDB 损坏。
- 自动停止、超时、失败清理、监督器失联都不得强杀可能正在原生写入的进程或 COM 保存 helper。
- UI、搜索、筛选、日志查看和只读浏览保持可用;一个未释放写入不得占着全局执行票据等待无限长时间。
- 同库仍在进行的写入不可并发启动;已释放的单项失败不得阻止独立项,其他独立库可排队获得执行机会。
- 历史 JSON 只触发身份及实际资源复核,不直接构成真实占用;报告错误不得伪造占用或永久禁用入口。
- 不自动选择历史版本、重新导入、恢复备份、删除原生锁/地址文件或修改 LMC 伪造状态。
- 不新增全库自动备份或全库内容哈希;此前确认的人工备份策略不变。
- 确认结束客户端与正常停止分开;本轮不增加“放弃正在进行的保存”按钮,不自动放宽服务器保护。
- 原生动作、证据读取、路径解析、进程查询和重启核对都放在非 GUI 线程;GUI 只更新视图和提交用户意图。
- 保留 VerifyRequest / VerifyResult 的现有参数及 safe_to_continue 兼容性,只追加有默认值的事实字段。
- 保持原有文件行尾,不进行与功能无关的整文件规范化。
- 开发验证只使用临时数据、模拟原生边界或隔离副本;不在生产库制造保存中断。
## 4. 保存、关闭和释放分开记录
新增 `operation_lifecycle.py`,提供纯函数,不导入 Qt、COM 或管理模块。
`classify_save_state(markers, *, helper_exited, native_released, forced=False)` 返回:
| 字段 | 值 | 能证明什么 |
| --- | --- | --- |
| save_state | NOT_STARTED / COMMITTED / REJECTED / UNKNOWN | COMMITTED 只来自本次 helper 的 SAVE_OK;缺标记不能推断“没有写入” |
| close_state | CLOSED / FAILED / UNKNOWN | 只由本次 CLOSE_OK / CLOSE_FAILED 明确记录;退出码不替代关闭证据 |
| helper_state | EXITED / RUNNING / UNKNOWN | 来自精确进程句柄或身份核对;PID 消失不证明保存完整 |
| resource_state | RELEASED / RETAINED / UNKNOWN | 来自独立资源证明;与保存成功分开 |
| interrupted | bool | 记录异常结束,不用进程消失掩盖中断 |
| detail | str | 说明证据缺失、矛盾或中断的具体原因;正常结果为空字符串 |
SAVE_OK 表示原生 Save 返回成功,不表示工程内容、中心库权威状态或历史版本已验收。关闭失败时仍保留已取得的保存事实。证据读取失败保留 UNKNOWN,不自动将 save_state 改为 REJECTED。
运行中的事实只能由当前操作 nonce、helper 身份和新日志更新;不拼接上轮 save.log。发生矛盾时采用 UNKNOWN 并保留原始标记。
新增兼容字段 `VerifyResult.write_outcome: dict | None = None`、`VerifyResult.session_record_path: Path | None = None`;现有 release_proof 含义不变。
safe_to_continue 继续表达本任务是否已释放后续原生执行所需资源,不能表达保存已通过。若保存结果未知但资源已独立证明释放,结果保留失败/待核对,允许其他独立项;同一目标不自动重放。若当前仍有原生写入,只保留相关库的写入限制,不全局锁住应用。
## 5. 原生调用阶段与停止语义
原生调用使用以下最小阶段:PRECALL、NATIVE_CALL、POSTCALL、CLOSING、RELEASE_CHECK、FINISHED、UNCONFIRMED。保存 helper 启动但本轮阶段缺失时视为可能进入 NATIVE_CALL,不能据此终止。
| 当前事实 | 用户停止/超时后的行为 | 后续项 |
| --- | --- | --- |
| 原生调用尚未发出且身份已确认 | 取消启动,不再进入新的原生动作;正常释放已创建的辅助资源 | 用户取消的批次不再启动后续项 |
| Save/Close/管理 COM 写调用可能仍在进行 | 写停止意图,继续观察调用返回;不杀 helper、worker、PCB 或服务器 | 同库写入等待;UI 和独立库继续可用 |
| Save 已返回,文档未关闭 | 记录 COMMITTED 或 REJECTED;仅对身份一致、已确认可正常关闭的文档执行现有正常收尾 | 无新 Save,不自动放弃未保存修改 |
| 原生调用已返回,资源已释放,但单项失败 | 保存失败及证据,保持同目标待核对,不自动重放 | 非用户取消批次可继续独立项 |
| 无法确认调用是否返回或身份变化 | 留存原始证据,转后台观察/人工处理;不猜测已退出或强制结束 | 只限制无法确认的相关库写入 |
5 秒用于普通合作式停止的短等待。进入原生写入后的前台任务最多再等待 120 秒;该时长只是转后台观察的界限,不是终止进程的时限。后台观察使用独立工作线程/任务,不占 GUI 线程,不占 NativeQueue 的全局 action 票据。
必须在后台观察交接完成、关联库租约及会话记录保存后,才能释放原执行票据。若交接存储失败,保留内存监督并提示记录错误;不得因此调用 kill,也不得声称释放完成。
同库后台写入的独占由现有 LibraryLock / retained lease 约束,其他库仍通过既有串行通道运行。不能解除另一个活跃写入者的文件锁;合作锁也不能宣称约束了别的工程师直接打开 Mentor。
观察循环优先使用已打开进程句柄的零等待查询,不每秒重跑整库扫描或完整 WMI。等待时不得持有 `_guard` 或全局原生互斥;只有候选会话退出后才尝试独立释放证明。证明通道正忙则延后观察,不将其当作新的库故障,不挤占其他库的执行机会。
用户取消批次后不自动恢复该批次。后台释放确认可以解除匹配会话状态,但后续写入仍来自已经排队的独立请求或用户新的操作,不能重放历史写入。
## 6. 保存 helper 与所有退出路径一致
- `_stop_worker`、`DesktopWorker.kill`、`stop_automation_clients`、`close`、verify watchdog 和失败 finally 使用同一阶段判据。不能只修用户停止按钮。
- 终止许可必须是已证明没有原生写调用的精确辅助进程;缺阶段、缺身份、helper 日志不可读都不是终止许可。
- 已启动保存时,worker 不再仅因取消文件出现就放弃监督。先等当前 COM 返回,再决定正常关闭或保留原生提示。
- VBS 在首次 Save 前检查取消。Save 返回后写 SAVE_OK / SAVE_REJECTED,再进行只读后置核对及有条件正常收尾;不让取消检查丢掉已经返回的保存事实。
- VBS 对 Save/IsSaved/后置同步/Close 分别记录阶段和明确失败原因。接触这些调用的错误处理必须是局部检查,不用一个覆盖整份脚本的 On Error Resume Next 掩盖失败。
- Close(True) 若仍可能写入,同样属于受保护原生调用;不得因 Save 已成功就强杀正在 Close 的 helper。
- 父进程意外退出与用户停止采用相同的“停止新动作、观察现有调用”原则。现有 `stop_clients=True` 不能绕过保存保护。
- 本轮不提供自动强制放弃保存。已有人工释放入口若遇到本工具明确登记的活跃 Save/Close,要显示实际阶段,不能把它当普通僵死客户端。
## 7. 可跨重启核对的会话记录
新增 `session_record.py`,只处理本工具受控的库外任务记录。它不执行 UI 操作,不从记录读取命令再运行,不依据文件存在就判占用。
每个会话记录:protocol/version、operation_id、operation、library、block、原生阶段、supervisor/worker/helper/native 的 PID/创建时间/完整映像、当前用户 SID/Windows 会话、desktop、取消文件、证据位置、原生调用是否可能仍在进行、保存/关闭/释放事实、记录时间和观察结果。
有可能新建原生进程时,先记录启动意图;CreateProcess 后记录精确身份。监督器打开工作进程的句柄后,工作进程才能获准进入原生动作;避免 GUI 在首条记录之前消失的空窗。
每个操作目录的 `session.json` 由启动方记录不可变身份;`worker-state.json` 只由 worker 写,`supervisor-lost.json` 只由 watchdog 写,后台观察写自己的 `observation-<observer_id>.json`。不能让多个进程覆盖同一状态文件。保存 helper 增加启动门:Python 写入 helper 精确身份后才放行进入 COM;取消、启动方消失或 30 秒内没有放行时,在 COM 调用前退出。旧测试直接运行 VBS 的无门参数模式只作兼容测试,生产启动必须使用门。
不按桌面名前缀批量删除桌面,不按旧 PID 杀进程。重启时:
1. 后台读取受控目录内受认可协议的记录,限制大小并拒绝目录链接和越界证据路径。
2. 精确核对当前进程创建时间、映像和用户/Windows 会话;PID 复用记为 IDENTITY_CHANGED,不对替代进程做动作。
3. 身份一致且仍活跃的会话显示原生阶段、输出和已有保存/取消选项;不自动继续写操作。
4. 进程确已退出后仍调用现有资源释放证明;确认后归档会话记录并刷新相关视图。
5. 未知记录只显示无法确认的原因和重新检查入口,不因为一份损坏 JSON 永久禁止所有操作。
CloseDesktop 只关闭本工具持有的句柄;原生进程或窗口仍引用桌面时,不宣称桌面已删除。不得把“清理桌面”作为结束正在写库进程的借口。
## 8. 管理 worker 的监督与取消
复用 `_require_add_supervisor` 的阶段检查思路,为 catalog/add/remove 都设置 supervisor identity、统一取消文件和阶段记录,而不是在管理入口外加一个无限等待。
- PRECALL:监督器失联或取消后,不再启动 LM、导入器、移除命令或下一阶段。
- NATIVE_CALL:watchdog 只记录失联和停止意图;COM 或外部 CleanWGLib 调用仍在进行时不强制退出其调用进程。
- POSTCALL:不得因为上一调用返回成功就继续 update 的下一次 add 或其他后续写入。关闭已确认空闲的自有原生会话,未知弹窗保留并暴露。
- update 的 remove 成功而 add 未提交时返回“部分完成/需恢复”,保留该目标检查点,不把它报成纯取消,也不重新导入。
- 正常完成和超时记录都能在重启后独立核对;不再仅依赖 `_retained_workers` 内存列表和 worker 自己写出的单个 safe_to_continue。
watchdog 不能解决不可取消 COM 调用的所有平台限制。验收要求是不再有无记录、无观察、可继续执行新写入的孤儿自动化;不承诺任意卡死的原生进程都能自动安全退出。
## 9. 状态读取的默认边界
推荐默认:普通读取不为 legacy 图标探测自动启动 LM,也不自动应答原生弹窗。
优先使用当前权威状态桥;桥不可用或无可观察的既有 LM 时,条目返回现有 UNKNOWN / UNAVAILABLE 及具体原因。无法查询不能等同于已知 PENDING,更不能等同于 ICDB 损坏。
`scan_open_library_status` 可以只观察用户已经打开、库身份匹配的 LM 树,不点任何按钮,不替用户关闭该 LM。发现模态提示时返回无法确认并保留可查看的提示信息。
`read_library_flag` / `read_library_tree_image_map` 的兼容 API 也必须服从上述边界,不能让隐藏直接调用继续启动生产库 LM 并走通用肯定按钮策略。需要自动创建 LM 的旧诊断能力不属于本轮交付;明确的用户“打开原生工具”入口保持原用途。
不能为了禁止状态读取自动点击,粗暴更改所有验证流程的已验证弹窗白名单。按调用目的分开,读取路径绝不调用肯定优先/fallback 操作器。
## 10. 批次与停止信号
GUI、CLI run_batch、ICDB 后台检查将 stop 传入同一请求链。兼容 auto_repair 分支补齐 stop 传播,但默认仍为关闭,不能把兼容性测试当作重新启用修复的授权。
队列取消、当前调用待返回、当前项失败和资源未释放分别记录。不能通过给全局 stop Event 置位,把一个库的观察状态扩散为所有独立库都停止。
本轮不把 Condition 改成无超时等待,除非所有取消/ready 变化都已有可靠通知;避免修复停止时引入永久等待。
## 11. 测试与验收
### 必须通过的跨组件场景
| 场景 | 必须观察到的结果 |
| --- | --- |
| Save 前取消 | Save 未调用;无新原生写入 |
| Save 调用中取消、超时、未知弹窗或父进程退出 | helper 存活、没有强杀调用;停止意图与当前阶段已记录 |
| Save 返回成功、Close 卡住 | 保存为 COMMITTED,关闭未确认;不得报无写入或全部完成 |
| helper 突然退出且没有返回标记 | 保存 UNKNOWN,原生释放另行核对;不能因进程消失报安全保存 |
| 前台等待超过 120 秒 | 转后台观察;UI 和独立库任务可运行,同库写入不能并发 |
| 管理 GUI 在 catalog/add/remove/update 两阶段之间退出 | 无新动作越过停止边界;已发生动作、待核对范围和精确会话身份可恢复显示 |
| 重启后 PID 复用、记录损坏或报告保存失败 | 不杀替代进程,不重放操作,不制造全局永久锁 |
| 权威桥不可用、LM 没打开 | 状态无法确认;没有 CreateProcess、恢复/覆盖/肯定点击 |
| 既有 LM 出现未知/修复/覆盖/保存提示 | 只观察并返回 UNKNOWN,不点击、不关闭用户会话 |
使用真实 cscript + 替换外部 COM 创建的 VBS harness 验证保存顺序;使用临时 sleep/helper 进程验证父进程退出、超时和进程身份;不在生产 Mentor 中途保存时做破坏试验。
全量 Python 测试必须串行运行,测试互斥使用独立命名空间,恢复临时根与源库分离;编译检查、diff 检查和 frozen helper 入口冒烟完成后才描述候选程序。冻结包先在 fake 原生边界跑同一保存/停止场景。
真实 Mentor 仅在一致隔离副本做延迟保存、当前原生取消、正常收尾、重新打开与权威状态核对;Win10、网络共享库、跨机器并发分别记录,缺环境时保留未验收项。
## 12. 分阶段交付和停止条件
交付单元 A:保存事实、helper/worker 停止规则和有界等待交接。
交付单元 B:管理 worker 的失联、取消、持久记录和重启核对。
交付单元 C:legacy 只读边界、GUI/CLI 停止接入、冻结包与隔离环境验收。
每个单元有独立回归和提交;三单元完成前不以局部通过宣称生命周期修复完成。原有 #10–#12 的旧评论不视为本轮新实现的批准。
实现从当前集成基线另开临时分支 `codex/runtime-lifecycle-safety`,不得覆盖原运行工作区,不 force-push 历史分支。执行时重新读取远端 PR/main 状态,按实际基线选择差分,避免重复合入已合并改动。先交付一个仅包含本轮运行时差分的草稿 PR,并在描述中按 A/B/C 给出审查顺序。
出现以下任一情况停止扩展并回到设计核对:没有办法在保留 COM 调用的同时交接观察、需要自动终止真实服务器、需要删除原生锁或地址才能让测试通过、需要引入新全局门禁才能规避身份不明。
## 13. 本轮明确排除
一般化跨机器写入互斥、全库/非目标工程内容证明、PRJ 重写与 before 字节补齐、UIA 无界线程整改、桥部署预检、CLI 全库范围确认、CI/打包外部路径/README 整理均单独排期。
其中与本轮直接相关的未知进程身份核对、停止传播及 Save/Close 事实拆分已纳入;不把排除项写成已修复。
## 14. 草案自查
- 三条 P1 均有明确生产调用点、拟修改边界和跨组件验收场景。
- 没有把取消等同于强制结束,也没有把退出等同于保存成功。
- 没有通过新增历史记录硬门禁解决问题;活动写入仍保持真实资源约束。
- 没有依赖“调用 watchdog(stop_clients=False) 就万事解决”的错误假设。
- 只读回退范围与权威桥路径区分;未知状态不伪造 READY/PENDING。
- 设计为草案;执行前需用户审阅行为与验收条件,尚未视为代码实施授权。