Files
cbb-refresh-verify-795/docs/superpowers/specs/2026-09-18-batch-status-bridge-design.md
T
阿白叔 11a2b2e46e Import CBB refresh verify r4 stability baseline
Preserve tested Verify source, authoritative READY checks, bounded bridge retries, diagnostics and failure-only reporting. Include 336-test suite and packaging assets; exclude live Mentor samples, field logs, backups and distributions.
2026-09-29 15:05:20 +08:00

4.0 KiB
Raw Blame History

CBB 批量状态桥设计

目标

支持对 180 到 3000 个 CBB 进行 Mentor authoritative Verify 状态读取,要求单条失败隔离、过程可恢复、结果可审计,并避免现有“一条 CBB 启动一个桥进程”的启动开销。

本阶段只读取 IsVerifiedReuseBlock 返回的 READY/PENDING,不触发 Verify、Unverify,也不修改中心库。

范围与约束

  • 目标平台为 Windows x86 Mentor EE 7.9/7.9.5 环境。
  • RULP/LP 映射为 eReuseBlockType = 0。
  • Mentor 私有 DLL 按非线程安全处理;同一个 LMC 默认只有一个活动桥会话。
  • UNKNOWN、桥异常、超时和非法响应都不能转换成 READY。
  • LMC 或其 ReusableBlocks 内容变化后,旧缓存必须失效。

架构

常驻 JSONL 桥

CbbStatusBridge32.exe --server 启动后加载一次 LMCDLL70.dll,从标准输入逐行读取 JSON 请求,并为每行输出一行 JSON 响应。请求包含 op、lmc_file、block_name 和 block_type;响应包含 status、source、raw_status、耗时和错误信息。

桥内部串行处理请求,不创建线程池,不主动卸载 Mentor DLL。进程退出时由操作系统回收 DLL,避免 Mentor 模块级析构导致堆异常。

Python 批量客户端

新增批量会话客户端,负责:

  1. 启动桥并记录 PID、桥版本和 DLL 路径;
  2. 逐条写入请求并读取对应响应;
  3. 对每条请求设置超时,超时后终止桥并重启;
  4. 每 300 到 500 条主动轮换桥进程;
  5. 将每条结果立即追加到 JSONL 检查点日志;
  6. 重启后跳过已有成功检查点,继续未完成条目。

缓存与失效

扫描开始时计算 LMC 文件的大小、修改时间和 SHA-256,并记录 ReusableBlocksLP 根目录的目录指纹。缓存键为:中心库指纹、CBB 名称、类型。单次扫描内相同键直接复用结果;Verify 成功后删除对应 CBB 缓存并重新读取。任一指纹变化则废弃本批缓存。

并发策略

第一版只实现单桥串行批处理。原因是 Mentor 私有 MFC 状态接口和 LMC 文件锁尚未证明可并发访问。

代码保留 worker 数配置,但默认值为 1;只有完成两个独立桥进程读取同一 LMC 的稳定性、状态一致性和锁冲突测试后,才开放 worker 大于 1。并发测试失败时必须自动回退到 1,而不是把异常结果标成 READY。

错误处理

  • 单条返回 PENDING 是有效结果,继续下一条。
  • 单条超时、非零退出码、非法 JSON、桥崩溃记录为 ERROR/TIMEOUT/UNAVAILABLE,继续下一条。
  • 桥连续崩溃达到阈值时停止本批并弹窗,保留已完成检查点。
  • 任何状态来源不是 IsVerifiedReuseBlock 时,不更新 UI 的 authoritative 状态。

日志格式

每条记录至少包含:timestamp、scan_id、lmc_file、lmc_fingerprint、block_name、block_type、status、source、raw_status、elapsed_ms、bridge_pid、exit_code、error。

日志采用追加写入和 UTF-8 JSONL;程序启动时扫描最后一个完整 JSON 行,忽略截断行并从未完成条目继续。

验收指标

  • 180 条连续扫描无桥泄漏、无错误状态升级,失败条目不阻塞后续条目。
  • 3000 条模拟批处理可中断并恢复,恢复不重复已完成条目。
  • 常驻桥的平均单条耗时和每 500 条轮换耗时有统计输出。
  • 在已知样本中,1GPHY_8212/2GPHY_ZX5201 返回 READY,1GPHY_8211/IP101GR/PEF7071_PHY 返回 PENDING。
  • 核心 Python 测试、桥协议测试和批处理故障注入测试全部通过。
  • 不执行真实 Verify/Unverify,不修改生产中心库。

不在本阶段

  • 批处理验收完成后,主 UI 默认使用状态桥的 Ready/Pending 判定;旧证据链仅通过 CBB_STATUS_BRIDGE_MODE=legacy 显式启用。
  • 不实现 2 到 10 并发窗口。
  • 不通过鼠标、键盘、坐标或图标颜色触发或判断 Verify。
  • 不把 Docker 作为 Mentor DLL 的运行环境。