审查拆分 1/4:只读占用探测与可取消任务队列 #9

Merged
abaishu0730 merged 1 commits from codex/review-infrastructure into main 2026-11-06 10:25:11 +08:00
Owner

行为变化:引入只读、限时 owner-probe helper 与可取消队列;暂停任务让出通道,现有界面入口保持原有行为,不引入 Mentor 写操作。

失败安全:查询超时/身份异常返回未确认;取消的票据不执行,不终止 Mentor 进程。

回滚:无下游时撤销该提交;接入下游后按依赖逆序回退。

验证:完整 Python 测试 491 passed,编译与 diff 检查通过;原生现场恢复不在本次验收内。

对应 #3 评论 249。以 main a56fd17 为基线,未合并、未发布;说明见 docs/reviews/2026-11-05-infrastructure.md。

行为变化:引入只读、限时 owner-probe helper 与可取消队列;暂停任务让出通道,现有界面入口保持原有行为,不引入 Mentor 写操作。 失败安全:查询超时/身份异常返回未确认;取消的票据不执行,不终止 Mentor 进程。 回滚:无下游时撤销该提交;接入下游后按依赖逆序回退。 验证:完整 Python 测试 **491 passed**,编译与 diff 检查通过;原生现场恢复不在本次验收内。 对应 #3 评论 249。以 main a56fd17 为基线,未合并、未发布;说明见 docs/reviews/2026-11-05-infrastructure.md。
abaishu0730 added 1 commit 2026-11-05 23:21:27 +08:00
Author
Owner

审查 1/4:只读占用探测与原生队列(Approve,3 条 P3)

范围:9e230e1 相对 main a56fd17,6 文件 +419/−136:owner_probe.py、operation_queue.py、application.py 的 --owner-probe 分派、两个行为测试、docs/reviews/2026-11-05-infrastructure.md。

结论

可以合并。 这一片的定位正确:只读、有限时、失败关闭,且没有引入任何原生写操作;测试是行为断言而非 mock 断言。

做得好的地方:

  • helper 放进独立进程并带协议版本与身份校验(snapshot_version、names 回显、pid/name/parent 类型与大写归一、重复 pid 拒绝),超时与畸形响分别映射到 OWNER_QUERY_TIMEOUT / OWNER_QUERY_UNCONFIRMED —— 明确不会把"查不到"当成"没有占用"。
  • WQL 注入面被 [\w.-]+\.exe 双重校验(父进程与 helper 各一次)。
  • NativeQueue 的取消语义有测试:取消的票据不执行动作、暂停票据让出通道给可执行票据、失败后不卡后续。

P3 建议(不阻塞合并)

[P3-1] application.py 整文件行尾翻转(CRLF→LF),diff 不可审查

  • 证据:main 该文件 \r\n = 136 / LF = 136;本 PR 该文件 \r\n = 0 / LF = 140。语义改动只有 4 行(--owner-probe 分派),但 git diff 显示 +276/−136。
  • 仓库 .gitattributes 是 * -text(注释写明"保持字节一致"),整文件翻转与这个约定相悖,也让 blame 失效。
  • 注意:后面 #11 会把 application.py 翻回 CRLF,同时把 ui/main_window.py 翻成 LF —— 建议在链上某一处统一行尾(或加一条 .gitattributes/CI 检查),避免每个 PR 都出现整文件重写。

[P3-2] NativeQueue 轮询等待 + ready() 异常未归一

  • run() 用 condition.wait(.1) 轮询,且新票据 append 时不 notify(类里已经有 wake(),但 run() 的入队路径没用它):新票据最多要等 100ms 才能被看到,wake() 的调用方还得自己记得叫醒。建议入队后 notify_all(),等待改为无超时阻塞。
  • next((token for token, available in self.pending if available()), None) 里 ready() 抛异常会原样冒出(绕过了 QueueCancelled 语义),建议把"不可用"与"异常"都归一为不可用并记录。

[P3-3] owner_probe 的调用约束与 created 空值

  • query_owners/query_process_snapshot 每次调用都会起一个 Python 子进程(本机冷启动量级 150–300ms)。docstring 已写"never in the Qt thread",但本 PR 还没有调用点;建议在协议文档里明确"只能在非 GUI 线程调用",并由 #10/#12 的调用处补测试。
  • 快照允许 created=''(System Idle 等系统进程),而 PID 复用检测依赖 created;建议在消费者侧显式拒绝空 created,或在协议里说明"空 created 不可用于身份判定"。

[P3-4] 测试套件不并行安全

  • 全量跑用会话级命名互斥 Local\CbbRefreshVerify795,backup_recovery 还使用固定目录 ~/.cbb-restore;同一台机器上两个 pytest 同时跑会成片失败(我并发时见过 112 failed,全部是 已有 CBB 校验任务运行,单独跑即过)。这不是本 PR 引入的,但本 PR 新增的队列/租约测试同样受它约束。将来接 CI 时不要在同一 runner 上并行跑多个 job,或给测试加 --dist 隔离/独立临时根。

说明

  • **独占全量测试(无并发干扰)**本机结果:491 passed, 1 warning in 59.53s(QT_QPA_PLATFORM=offscreen),与 PR 自述的 491 一致。
  • 附带观察:三个审查进程并发跑全量时会撞 Local\CbbRefreshVerify795 会话级互斥,出现成片 已有 CBB 校验任务运行 的假失败——见 P3-4。
  • 未验证:真实 WMI 环境下的耗时与权限差异(我的机器上只验证了协议/失败路径的单元行为)。
# 审查 1/4:只读占用探测与原生队列(Approve,3 条 P3) 范围:`9e230e1` 相对 `main a56fd17`,6 文件 +419/−136:`owner_probe.py`、`operation_queue.py`、`application.py` 的 `--owner-probe` 分派、两个行为测试、`docs/reviews/2026-11-05-infrastructure.md`。 ## 结论 **可以合并。** 这一片的定位正确:只读、有限时、失败关闭,且没有引入任何原生写操作;测试是行为断言而非 mock 断言。 做得好的地方: - helper 放进**独立进程**并带协议版本与身份校验(`snapshot_version`、`names` 回显、pid/name/parent 类型与大写归一、重复 pid 拒绝),超时与畸形响分别映射到 `OWNER_QUERY_TIMEOUT` / `OWNER_QUERY_UNCONFIRMED` —— 明确不会把"查不到"当成"没有占用"。 - WQL 注入面被 `[\w.-]+\.exe` 双重校验(父进程与 helper 各一次)。 - `NativeQueue` 的取消语义有测试:取消的票据不执行动作、暂停票据让出通道给可执行票据、失败后不卡后续。 ## P3 建议(不阻塞合并) ### [P3-1] `application.py` 整文件行尾翻转(CRLF→LF),diff 不可审查 - 证据:main 该文件 `\r\n` = 136 / LF = 136;本 PR 该文件 `\r\n` = 0 / LF = 140。语义改动只有 4 行(`--owner-probe` 分派),但 `git diff` 显示 `+276/−136`。 - 仓库 `.gitattributes` 是 `* -text`(注释写明"保持字节一致"),整文件翻转与这个约定相悖,也让 blame 失效。 - 注意:后面 #11 会把 `application.py` **翻回 CRLF**,同时把 `ui/main_window.py` 翻成 LF —— 建议在链上某一处统一行尾(或加一条 `.gitattributes`/CI 检查),避免每个 PR 都出现整文件重写。 ### [P3-2] `NativeQueue` 轮询等待 + `ready()` 异常未归一 - `run()` 用 `condition.wait(.1)` 轮询,且**新票据 append 时不 notify**(类里已经有 `wake()`,但 `run()` 的入队路径没用它):新票据最多要等 100ms 才能被看到,`wake()` 的调用方还得自己记得叫醒。建议入队后 `notify_all()`,等待改为无超时阻塞。 - `next((token for token, available in self.pending if available()), None)` 里 `ready()` 抛异常会原样冒出(绕过了 `QueueCancelled` 语义),建议把"不可用"与"异常"都归一为不可用并记录。 ### [P3-3] `owner_probe` 的调用约束与 `created` 空值 - `query_owners`/`query_process_snapshot` 每次调用都会起一个 Python 子进程(本机冷启动量级 150–300ms)。docstring 已写"never in the Qt thread",但本 PR 还没有调用点;建议在协议文档里明确"只能在非 GUI 线程调用",并由 #10/#12 的调用处补测试。 - 快照允许 `created=''`(System Idle 等系统进程),而 PID 复用检测依赖 `created`;建议在消费者侧显式拒绝空 `created`,或在协议里说明"空 created 不可用于身份判定"。 ### [P3-4] 测试套件不并行安全 - 全量跑用会话级命名互斥 `Local\CbbRefreshVerify795`,`backup_recovery` 还使用固定目录 `~/.cbb-restore`;同一台机器上两个 pytest 同时跑会成片失败(我并发时见过 112 failed,全部是 `已有 CBB 校验任务运行`,单独跑即过)。这不是本 PR 引入的,但本 PR 新增的队列/租约测试同样受它约束。将来接 CI 时不要在同一 runner 上并行跑多个 job,或给测试加 `--dist` 隔离/独立临时根。 ## 说明 - **独占全量测试(无并发干扰)**本机结果:`491 passed, 1 warning in 59.53s`(`QT_QPA_PLATFORM=offscreen`),与 PR 自述的 491 一致。 - 附带观察:三个审查进程并发跑全量时会撞 `Local\CbbRefreshVerify795` 会话级互斥,出现成片 `已有 CBB 校验任务运行` 的假失败——见 P3-4。 - 未验证:真实 WMI 环境下的耗时与权限差异(我的机器上只验证了协议/失败路径的单元行为)。
abaishu0730 marked the pull request as ready for review 2026-11-06 10:25:10 +08:00
abaishu0730 merged commit 959399b974 into main 2026-11-06 10:25:11 +08:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Skyworth_Digital_Hardware/cbb-refresh-verify-795#9