proudnerdswp/recon-review-engine-code-oversight-by-nerds

RECON；代码监督审查引擎（REVIEW ENGINE FOR CODE OVERSIGHT BY NERDS）

基于LLM的自动代码审查代理，通过OpenAI兼容API（如***、OpenRouter等）分析拉取请求（PR）的diff，并在GitHub和Bitbucket上发布结构化发现作为内联评论，支持多平台自动检测和灵活的审查配置。

核心功能

• AI驱动的代码审查：支持任意OpenAI兼容API（***、OpenRouter等）
• 多平台兼容：自动检测GitHub/Bitbucket Cloud，原生集成平台API
• 五级Verdict系统：Approved（已批准）、Safe to merge（可安全合并）、Needs attention（需关注）、Changes required（需修改）、Do not merge（禁止合并）
• 自动请求修改：发现超出严重程度阈值时，通过平台API发起原生修改请求
• 内联忽略指令：使用// recon:ignore-next-line或块对抑制误报
• 噪音控制：可配置内联评论上限，超出部分汇总到摘要
• 修复提示：Critical/Warning评论附加可折叠修复提示，支持复制到AI工具
• 上下文感知模式审查（可选）：对比仓库多数模式，标记架构差异（限于Warning级别）
• 多审查Profile：Full Review、Security、Style、Architecture
• 路径排除：基于glob模式忽略生成/依赖文件
• 大diff处理：自动token分块，确保LLM分析可行性
• 评论去重：重新运行时避免重复评论
• CI友好：始终返回0状态码，PR阻塞通过平台系统处理

使用场景

• CI/CD流水线：GitHub Actions/Bitbucket Pipelines中PR的自动审查
• 团队质量保障：减少人工审查负担，提升代码一致性
• 定向审查：针对安全、风格、架构等特定维度的专项分析
• 大diff处理：自动化分析大型代码变更，避免遗漏关键问题

配置说明

所有配置通过环境变量完成：

必选变量

平台变量

自动检测平台（GitHub/Bitbucket），令牌优先级：REVIEW_TOKEN > 平台原生令牌（GITHUB_TOKEN/BITBUCKET_TOKEN）

可选变量

Docker部署示例

基本运行命令

bash
docker run --rm \
  -e REVIEW_API_KEY="your_llm_key" \
  -e REVIEW_API_URL="https://api.anthropic.com/v1/messages" \
  -e REVIEW_MODEL="anthropic/claude-sonnet-4" \
  -e GITHUB_TOKEN="your_github_token" \
  proudnerdswp/recon-review-engine-code-oversight-by-nerds

GitHub Actions集成

yaml
name: RECON Code Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - name: Run RECON
        uses: docker://proudnerdswp/recon-review-engine-code-oversight-by-nerds
        env:
          REVIEW_API_KEY: ${{ secrets.REVIEW_API_KEY }}
          REVIEW_API_URL: ${{ secrets.REVIEW_API_URL }}
          REVIEW_MODEL: ${{ secrets.REVIEW_MODEL }}
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}