代码评审

name: 代码评审

on:
  pull_request:
    types: [opened, synchronize, reopened, ready_for_review]

permissions:
  pull-requests: write
  contents: read
  issues: write

jobs:
  code-review:
    runs-on: ubuntu-latest
    # 对草稿 PR 跳过自动代码评审
    if: github.event.pull_request.draft == false
    steps:
      - name: 检出仓库
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
          ref: ${{ github.event.pull_request.head.sha }}

      - name: 安装 Cursor CLI
        run: |
          curl https://cursor.com/install -fsS | bash
          echo "$HOME/.cursor/bin" >> $GITHUB_PATH

      - name: 配置 git 身份
        run: |
          git config user.name "Cursor Agent"
          git config user.email "cursoragent@cursor.com"

      - name: 执行自动代码评审
        env:
          CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
          MODEL: gpt-5
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          BLOCKING_REVIEW: ${{ vars.BLOCKING_REVIEW || 'false' }}
        run: |
          cursor-agent --force --model "$MODEL" --output-format=text --print '你正在 GitHub Actions 运行器中执行自动代码评审。gh CLI 可用并已通过 GH_TOKEN 认证。你可以在拉取请求上发表评论。

          上下文：
          - 仓库：${{ github.repository }}
          - PR 编号：${{ github.event.pull_request.number }}
          - PR Head SHA：${{ github.event.pull_request.head.sha }}
          - PR Base SHA：${{ github.event.pull_request.base.sha }}
          - 阻塞评审：${{ env.BLOCKING_REVIEW }}

          目标：
          1) 复查已有评审评论，对已处理的标记为 resolved。
          2) 审查当前 PR diff，只标记明确且高严重度的问题。
          3) 仅在变更行留下非常简短的行内评论（1-2 句），并在末尾附上简要总结。

          流程：
          - 获取现有评论：gh pr view --json comments
          - 获取 diff：gh pr diff
          - 获取带补丁的变更文件以计算行内位置：gh api repos/${{ github.repository }}/pulls/${{ github.event.pull_request.number }}/files --paginate --jq '.[] | {filename,patch}'
          - 为每个问题计算精确的行内锚点（文件路径 + diff 位置）。评论必须放在 diff 的变更行内，而不是作为顶层评论。
          - 检测由该机器人撰写的此前顶层“无问题”类评论（匹配正文如："✅ no issues"、"No issues found"、"LGTM"）。
          - 如果本次运行发现问题，且存在此前“无问题”评论：
            - 优先移除它们以避免混淆：
              - 尝试通过以下方式删除顶层评论：gh api -X DELETE repos/${{ github.repository }}/issues/comments/<comment_id>
              - 若无法删除，通过 GraphQL（minimizeComment）最小化，或编辑为添加前缀"[已被新发现取代]"。
            - 若既不能删除也不能最小化，则回复该评论："⚠️ 已被取代：在较新的提交中发现了问题"
          - 若此前报告的问题看起来已被附近的变更修复，回复：✅ 此问题似乎已被近期变更解决
          - 仅分析以下内容：
            - null/undefined 解引用
            - 资源泄漏（未关闭的文件或连接）
            - 注入（SQL/XSS）
            - 并发/竞态条件
            - 对关键操作缺少错误处理
            - 明显的逻辑错误导致不正确行为
            - 明确的性能反模式且具有可衡量影响
            - 明确的安全漏洞
          - 避免重复：如果相似反馈已在相同或相邻行存在则跳过。

          评论规则：
          - 最多 10 条行内评论；优先最关键问题
          - 一条评论只包含一个问题；放在精确的变更行上
          - 所有问题评论必须是行内的（锚定到 PR diff 中的文件与行/位置）
          - 语气自然、具体且可执行；不要提及“自动化”或“高置信度”
          - 使用表情：🚨 严重 🔒 安全 ⚡ 性能 ⚠️ 逻辑 ✅ 已解决 ✨ 改进

          提交：
          - 如果没有可报告的问题，且已存在指示“无问题”的顶层评论（例如："✅ no issues"、"No issues found"、"LGTM"），不要再提交新评论。跳过提交以避免冗余。
          - 如果没有可报告的问题，且不存在此前“无问题”评论，提交一条简短摘要评论说明无问题。
          - 如果存在可报告的问题，且此前存在“无问题”评论，确保在提交新的评审前删除/最小化/标记为已被取代该评论。
          - 若存在可报告问题，提交一份评审，仅包含行内评论以及可选的精炼摘要正文。使用 GitHub Reviews API 以确保评论为行内：
            - 构建如下的评论 JSON 数组：[{ "path": "<file>", "position": <diff_position>, "body": "..." }]
            - 通过以下方式提交：gh api repos/${{ github.repository }}/pulls/${{ github.event.pull_request.number }}/reviews -f event=COMMENT -f body="$SUMMARY" -f comments='[$COMMENTS_JSON]'
          - 不要使用：gh pr review --approve 或 --request-changes

          阻塞策略：
          - 如果 BLOCKING_REVIEW 为 true 且发布了任何 🚨 或 🔒 问题：echo "CRITICAL_ISSUES_FOUND=true" >> $GITHUB_ENV
          - 否则：echo "CRITICAL_ISSUES_FOUND=false" >> $GITHUB_ENV
          - 最后务必设置 CRITICAL_ISSUES_FOUND
          '

      - name: 检查阻塞评审结果
        if: env.BLOCKING_REVIEW == 'true'
        run: |
          echo "正在检查严重问题..."
          echo "CRITICAL_ISSUES_FOUND: ${CRITICAL_ISSUES_FOUND:-unset}"

          if [ "${CRITICAL_ISSUES_FOUND:-false}" = "true" ]; then
            echo "❌ 发现严重问题，且启用了阻塞评审。工作流失败。"
            exit 1
          else
            echo "✅ 未发现阻塞性问题。"
          fi