🐝 BeeReview
AI 蜂群代码审查系统 —— 找出代码本身的逻辑/业务/安全 bug
跨厂商多模型协同 (Claude + DeepSeek + Qwen + GPT-5)
🎯 核心定位
BeeReview 是代码审查工具, 不是变更对比工具。
你的代码本身有 bug 吗? 有安全漏洞吗? 业务逻辑对吗? 性能能扛住吗?
BeeReview 用 5 个角色化 AI Worker 帮你找这些问题。
⚠️ BeeReview 不关心 "和老代码相比改了什么"。
它关心的是 "这段代码本身写对了吗"。
✨ 核心理念
不同厂商的 LLM 训练数据独立、错误模式互补。BeeReview 通过：
- 代码审查为本 —— 评估代码本身的正确性, 不只是评估"diff 里的变化"
- 角色化分工 —— 5 个 Worker 各专攻一个维度 (不让一个模型干所有事)
- 跨厂商异构 —— Claude + DeepSeek + Qwen + GPT-5 (不只用 Claude 家族)
- Severity 分层聚合 —— Critical 用 OR 逻辑, Nit 用多数投票 (不一刀切)
- Opus 仲裁而非投票 —— 综合判断 > 票数统计
→ 显著降低单模型漏报率, 且单次成本低于纯 Opus 方案。
🧬 v2 核心能力 (v2.0+)
v2 把 BeeReview 从"能跑的多模型审查"升级为 可追溯、可校验、会学习 的审查系统：
| 能力 | 说明 |
|---|
| 🔍 全程留痕 | 每个 worker 的下发 prompt 全文 + CLI 原始 stdout 永久落盘, 配 manifest + SHA256 防篡改 (tamper-evident); 以磁盘文件为准, 不以转述为准 |
| 🛡 Harness 三层校验 | JSON Schema 强校验 (归一化/needs_human/空壳分级) + evidence 接地校验 (文件存在性 + 行号边界 + 引用比对), 把模型幻觉挡在报告外, 绝不静默丢真问题 |
| 🧩 ContextBundle 预填充 | L0 项目指纹 (技术栈/框架/数据库/约定) + L1 角色定制 (领域重点文件) + L2 自适应变更上下文, 让每个 worker 开审前先懂项目 |
| 💚 Worker 健康分 | 由 harness 代码合成 (非 worker 自报) 的 evidence/schema/investigation/suspicious/status 五因子健康分, arbiter 用作置信度调节因子 |
| 🧠 领域经验库 | arbiter 蒸馏"确认为真"的发现 → 复现加权 / 误报反向衰减 / 时间衰减自动淘汰 → 高权重经验注入下次 review 的「重点关注清单」(仅提示, 不抑制新发现) |
| 📋 统一审阅报告 (v2.1) | 单份 HTML 同时呈现决策层 (verdict + 警示带 + 健康仪表盘 + finding 卡含真实代码片段) 与审计层 (prompt/raw/context/经验变化/manifest, 默认折叠), 无需翻阅多个文件 |
| 🔌 Worker 注册表化 | 新增 worker 只需改一段 config JSON + 加 prompt 文件, 不动主流程 |
所有 v2 数据集中存于 ~/.bee-review/，不污染被审项目仓库。详见 CHANGELOG 的 [2.0.0] / [2.1.0] 章节。
🚀 典型用法
# 审查现有代码 (核心场景)
/bee-review --file src/main/java/PaymentService.java
/bee-review --file PaymentService.java --method processOrder
/bee-review --dir src/main/java/payment/
# 审查变更 (PR/diff 场景)
/bee-review # 当前未提交变更
/bee-review --diff /tmp/x.patch
/bee-review --revision main..HEAD
/bee-review --pr 123
无论哪种输入, Worker 都审查代码本身, 找 bug, 而非纠结变更细节。
🚀 快速开始
安装（Claude Code Plugin）
# 方式 1: 从 marketplace 安装（推荐）
/plugin marketplace add focus-tech/bee-review
/plugin install bee-review@bee-review
# 方式 2: 从本地路径安装（开发调试）
/plugin marketplace add ~/AIProjects/bee-review
/plugin install bee-review@bee-review
依赖
| 必需 | 可选（影响 Worker 可用性） |
|---|
| Python 3.8+ | OpenCode (logic, performance worker) |
| jq | Codex (adversary worker) |
| git | — |
# macOS
brew install python3 jq
# 安装可选 CLI Agent
npm install -g opencode @anthropic-ai/codex
opencode auth login
codex login
使用
# 在任意 git 仓库中
/bee-review # 审查当前未提交变更
/bee-review --diff /tmp/changes.patch # 指定 diff 文件
/bee-review --revision main..feature/x # git 范围
/bee-review --skip-l5 # 跳过 L5 复审
/bee-review --workers security,logic # 仅启用部分 worker
/bee-review --privacy internal # 内网模式
🏗 架构
