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.
4.0 KiB
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 批量客户端
新增批量会话客户端,负责:
- 启动桥并记录 PID、桥版本和 DLL 路径;
- 逐条写入请求并读取对应响应;
- 对每条请求设置超时,超时后终止桥并重启;
- 每 300 到 500 条主动轮换桥进程;
- 将每条结果立即追加到 JSONL 检查点日志;
- 重启后跳过已有成功检查点,继续未完成条目。
缓存与失效
扫描开始时计算 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 的运行环境。