PR #43 / #37 / #36 / #23 本地审查与集成报告

日期：2026-08-08
基线：origin/main at 6315d02
审查分支：codex/review-pr-43-37-36-23
范围：只审查四个 PR 相对当前主线的增量价值；不执行外部目标动作
结论：四个 PR 均有可复用价值，但只有 #43、#37 适合保留主体；#36、#23 必须选择性集成

执行摘要

PR	相对主线价值	集成决定	关键边界
#43	很高	保留结构化路由、163 条当前回归基准、双平台 CI、供应链 pin gate、动态索引	删除 OpenCode 配置、安装器和专属代理；核心不绑定任何客户端
#37	高	合并 case-review、证据图审查、哈希校验与单测，并增加 R40	同时接受 `done` 与当前约定的 `completed`
#36	中高	选择性合并 Burp 重连/换行消息处理、原子 token、Anything Analyzer 鉴权、进程树与 sudo home 修复	拒绝“所有能力一律 ready”等语义回退
#23	中（整包偏低）	仅合并 Bash case-init、case-guard、结构化 Bash 路由和 CI parity	排除 92 文件中的客户端清单、GIF、演示生成物和硬编码路由副本

平台边界

结构化路由的唯一事实源是 skills/config/routing.json。PowerShell 与 Bash 入口都读取该文件；宿主客户端只允许作为可选适配器存在，不能决定仓库身份、路由规则、测试基准或安装路径。

flowchart LR
    C["任意宿主 / CLI / Agent"] --> A["可选适配层"]
    A --> R["routing.json 单一事实源"]
    P["PowerShell router"] --> R
    B["Bash router"] --> R
    R --> S["41 条路由 / 42 个已跟踪技能模块"]
    R --> T["163 条回归基准"]
    T --> W["Windows CI"]
    T --> L["Linux CI"]

审查发现与修正

#43 的设计价值来自结构化数据与自动门禁，而不是 OpenCode 接入。所有 OpenCode 专属文件与 CI job 已移除。
#37 原实现只识别 done，会把主线使用的 completed 误判为未完成；已补兼容与第 7 条单测。
#36 的桥接重连和 token 写入是净增益；其能力状态改写会制造假阳性，未合并。
#23 的 Bash router 原样复制硬编码表，会立刻与 #43 的 R40/priority 漂移；已重写为读取 routing.json，并在 CI 校验 R1/R3/R40 parity。
新 supply-chain gate 暴露 Kali manifest 的 7 个浮动安装源。已固定 Frida 14.10.4、IDA MCP commit、Agent Browser 0.31.1、ProxyCat commit、Nuclei v3.8.0、pwntools 4.15.0，并让安装命令实际使用这些 pin。
推送后强制复审发现 Bash case-init 未继承 CaseName 路径约束；已拒绝路径、控制字符、通配符与尾随点/空格，并加入负向 CI。
Bash 的授权 URL 曾错误落入 offline 且可能 ready；已与 PowerShell 对齐为 authorized_target_only，明确 offline 只接受本地样本。
Bash case-guard 现只从 auth、network_profile、signoff 对应章节取值，notes/证据中的伪字段不能通过门禁。
Kali ProxyCat 固定源码安装现会生成可探测的 ~/.local/bin/proxycat wrapper；CI checkout 也从可变 tag 固定到 v4.2.2 commit。
原动态 INDEX 在开发机误收录了 12 个 .gitignore 排除的本地模块，干净 clone 会失败；生成器现只枚举 Git 已跟踪 skill，clean clone 与带私有扩展的工作区都稳定为 42 个核心模块。

相对旧主线的量化提升

使用同一组 163 条基准分别调用旧主线硬编码 router 与新结构化 router，每条均在独立 PowerShell 进程运行：

版本	通过	准确率	无输出
旧主线 `6315d02`	137 / 163	84.05%	0
当前结构化实现	163 / 163	100%	0

绝对增加 26 条正确路由、提升 15.95 个百分点。改善覆盖 Frida/Android、证书与 root 检测、抓包重放、勒索软件、Burp/Metasploit、Go 二进制、BLE、USB、native .so、内存 dump 等旧实现会回退 R0 的场景。

验证结果

验证项	结果
结构化路由全量回归	163 / 163 通过
路由一致性与供应链 pin gate	通过
PowerShell smoke	通过
P0 friction / scope-guard 回归	通过
旧版/新版 163 条 A/B	137/163 → 163/163
case-review Python 单测	7 / 7 通过
Burp bridge Node 回归	1 / 1 通过
Bash router/case-init/case-guard parity	通过
PowerShell、Bash 语法与 JSON 解析	通过
Java 编译检查	Gradle 8.7 分发下载被本机证书吊销网络阻塞；改用 Maven Central 的声明依赖与 JDK 21，`McpHttpServer.java` 编译通过

剩余风险

Bash 结构化路由依赖 Python 3；这是显式运行依赖，但避免了第二份路由表。
固定依赖版本需要周期性、显式升级，不再隐式追随 latest。
客户端适配仍可继续扩展，但必须保持核心数据与测试完全宿主无关。
本机未完成 Gradle task 层测试；原因是 128 MB wrapper 分发下载受证书吊销网络与低速链路阻塞，已用同版本依赖完成改动 Java 源文件的独立编译检查。

最终建议

合并当前审查分支的选择性结果，不合并四个 PR 的原始整包形态。后续 PR 应按“核心路由 / 宿主适配 / 演示资产 / 文档”拆分，便于独立审查与回滚。

5.3 KiB Raw Permalink Blame History Unescape Escape