JohnXu22786/adversarial-review

README excerpt

gavel-review 对抗式多视角代码审查插件。多个独立审查视角（透镜）并行地对代码改动发起攻击式审查——每个视角只关心自己那一类问题，彼此不干扰；随后仲裁层把跨视角的发现合并去重、按严重度分级，输出带证据与修复建议的报告。全程只读，不修改任何代码。 插件自带确定性静态哨兵（无需模型的规则扫描）、抑制规则（防止同类问题反复上报）与审查历史（增量对照已知问题），并同时提供两种入口： - dsh（DeepSeek Harness）插件入口 ：注册 gavel review 工具，模型在会话中直接调用； - 独立 CLI 入口 ：本地命令行运行，兼容任何 OpenAI Chat Completions 协议的模型服务。 零第三方运行时依赖（核心引擎与 CLI 仅使用 Node 内置能力）。 设计思路 单一审查者容易被自己的视角带偏：写代码的人看不到自己的盲区，通用审查又常常把风格问题与真正的缺陷混在一起。gavel 的做法是 把「破坏」拆成多个专业方向，并行攻击，再合并战果 ： - 每个透镜带一套 可落地的检查点清单 （如「空值与未初始化」「注入」「复杂度」），发现必须对应到具体检查点，报告可直接追溯到清单条目； - 透镜之间并行扇出，互不等待（可独立配置启用哪些透镜）； - 静态哨兵先于模型用确定性规则兜底，保证即使模型失败也有产出； - 仲裁层按「文件 + 行号邻近 + 标题词元重叠」聚类跨透镜发现，多个视角命中同一问题会获得 佐证加成 ，严重度可能升一级； - 严重度是 确定性计算 （影响 × 2 + 置信度 + 佐证），同一输入永远得到同一结论； - 可选 深度复核 阶段：对候选问题逐条做挑战式再验证，被驳回的问题降级为「观察」而不是删除——决策过程保持透明。 审查流水线 目录结构 独立 CLI 使用 要求 Node.js = 20.19（源码直跑需 = 23.6，见下文）。无需安装任何依赖即可使用构建产物： 常用选项： 选项 说明 --diff 统一 diff 文本文件（ - 读 stdin），与 --base 、 --path 互斥 --base 运行 git diff --unified=8 （如 HEAD 1 ） --path 整文件审查，可重复 --lens 透镜子集： correctness,security,maintainability ；含无效 id 时报错退出 --deep 启用深度复核（挑战式再验证） --emit-rules 为「必须修复」及以上问题生成抑制规则 --rules 规则文件（默认 /rules.json ） --no-history 关闭案卷与历史对照 --history-dir 案卷目录（默认 .gavel/ ） --out / --json-out Markdown / JSON 报告输出路径 --fail-o…

Category