codereview.gpt：让 AI 为你的代码把脉

想象一下这个场景：你提交了一个 Pull Request，团队里资深开发者的评审意见还没来，但一个「神秘助手」已经在后台默默读完了你的代码改动，给出了风格建议、潜在 bug 预警和最佳实践提示。这就是 codereview.gpt——一款用 ChatGPT 驱动代码评审的 Chrome 浏览器扩展，它让每一位开发者都能随时获得 AI 的代码审查意见。

背景：代码评审的痛点与 AI 的介入

代码评审（Code Review）是软件工程中保证代码质量的核心环节，但在实际工作中，评审往往面临几个困境：评审资源稀缺，成熟项目的资深开发者每天被大量 PR 淹没，难以逐一仔细审查；评审标准不一致，不同评审者关注点不同，容易出现质量波动；小改动也需完整流程，有时一个微小的修复也需要等待数小时才能获得反馈，拖慢迭代节奏。

codereview.gpt 的作者 sturdy-dev 正是看到了这些痛点，于 2022 年底推出了这款工具。它的核心思路非常简单直接：用 ChatGPT 作为永不疲倦的代码评审员，在开发者提交 PR 后快速生成一份 AI 评审意见，帮助发现潜在问题、改进代码风格。由于工具基于 Chrome 扩展实现，安装和使用门槛极低，无需配置服务器或 CI/CD 流水线，任何人都可以在几分钟内开始使用。

核心功能：它是如何工作的

codereview.gpt 的工作流程可以分为四个步骤：

第一步：检测当前页面。 当用户访问一个 GitHub Pull Request 或 GitLab Merge Request 页面时，Chrome 扩展通过 activeTab 权限获取当前标签页的 URL，自动判断是否处于 PR/MR 页面环境。

第二步：抓取代码差异。 扩展通过 scripting 权限注入脚本，利用 node-html-parser 解析页面 DOM，提取 PR 的代码改动（diff）和提交信息（commit messages）。同时通过 GitHub/GitLab 的公开接口获取 PR 描述信息。代码差异以标准的 patch 格式发送给 ChatGPT API。

第三步：AI 评审生成。 扩展调用 ChatGPT API（使用官方 chatgpt npm 包 v5.1.3），将完整的代码差异和上下文信息作为提示词，让模型扮演资深代码评审员的角色，给出安全性、性能、可读性等多个维度的建议。结果通过 showdown（Markdown 转 HTML 库）渲染，在扩展的 popup 窗口中展示。

第四步：用户决策。 AI 评审结果仅展示在扩展弹窗中，不会自动发布到 PR 评论。用户可以复制感兴趣的反馈手动添加到 PR 讨论区，或者作为个人参考。

图1：codereview.gpt 在 Pull Request 页面上的使用效果示意。

技术栈：轻量级 Chrome 扩展的工程选择

从项目结构来看，codereview.gpt 是一个典型的 Chrome Manifest V3 扩展：

前端构建：Webpack 5（开发/生产双模式配置）、PostCSS + Tailwind CSS（样式方案）、Prettier（代码格式化）。这是一个标准的现代前端项目结构。

核心逻辑：纯 JavaScript，主要逻辑在 src/popup.js（约 11,200 字），包含完整的 UI 渲染、API 调用、结果展示逻辑。

外部依赖：非常精简——chatgpt（OpenAI 非官方 SDK，处理 API 通信和流式响应）、parse-diff（解析代码差异文件）、node-html-parser（HTML DOM 解析）、eventsource-parser（处理 ChatGPT 的 SSE 流式响应）、buffer（Node.js Buffer polyfill）。

权限设计：仅申请三个最小权限——activeTab（读当前标签 URL）、storage（缓存 ChatGPT 响应）、scripting（注入脚本抓取页面内容）。扩展仅访问 GitHub/GitLab 相关域名，隐私风险极低。

Manifest V3：已升级到 MV3，采用了 content_security_policy 限制，但保留了 'wasm-unsafe-eval'，这是因为 chatgpt 包内部依赖 WebAssembly 模块。

整体代码量不大（源码约 3,000 行 JS），但功能完整、边界清晰，是一个「小而美」的工具项目。

快速上手：从安装到第一次评审

安装门槛极低，两种方式：

方式一（推荐）：Chrome 网上应用店 直接访问 Chrome Web Store，搜索 codereview.gpt，一键安装。整个过程不超过 1 分钟。

方式二（开发者）：本地加载

git clone https://github.com/sturdy-dev/codereview.gpt
cd codereview.gpt
npm install
npm run build

然后打开 chrome://extensions，开启开发者模式，点击「加载已解压的扩展程序」，选择项目中的 build 目录即可。

使用步骤：

1. 安装完成后，在 Chrome 扩展栏点击 codereview.gpt 图标
2. 在 Settings 中填入你的 OpenAI API Key（需自备，费用按用量计）
3. 访问任意 GitHub Pull Request 或 GitLab Merge Request 页面
4. 点击扩展图标，等待 AI 生成评审结果

局限与风险：AI 评审不是银弹

codereview.gpt 自身坦诚地指出了几个重要限制：

第一，AI 可能产生幻觉。 ChatGPT 有时会生成看似合理但实际错误的评审意见，比如声称某段代码有内存泄漏但实际上并无问题。这种一本正经地胡说八道是所有 LLM 应用的固有局限。项目作者建议对同一 PR 多次运行评审以交叉验证。

第二，纯浏览器扩展，无法自托管。 工具完全运行在用户本地的 Chrome 环境中，无服务器端组件。这意味着无法在 headless CI 环境中集成，也无法实现团队共享的评审标准配置。

第三，依赖 OpenAI API，不支持本地模型。 所有评审请求都发送到 OpenAI 服务器，存在数据隐私和 API 费用双重考量。对于内部项目或敏感代码库，使用时需谨慎评估数据安全。

第四，仅解析当前 PR 的代码差异。 工具无法访问代码库的完整上下文（如历史提交、相关文件、测试覆盖情况），因此评审深度有限，更多是「风格建议」而非「系统性分析」。

行业意义：AI 辅助评审的新起点

codereview.gpt 的出现代表了代码评审领域的一个趋势：将 AI 能力下沉到每个开发者的日常工具链中。它不是要替代专业的代码审查流程，而是作为一个「随时可用的第二意见」——在等待人工评审之前，帮助开发者自我检查。

GitHub 官方 Copilot 和 OpenAI 的 Code Review 功能正在快速迭代，AWS CodeWhisperer、Cursor 等 IDE 工具也在深度集成代码评审能力。codereview.gpt 的价值在于它极低的门槛和精准的场景定位——一个浏览器扩展，无需配置，开箱即用，让 AI 评审的覆盖面从大型企业团队扩展到了每一个独立开发者。

截至目前，该项目已获得 606 颗 GitHub Stars 和 76 个 Forks，虽然最近一次代码更新是 2024 年 8 月（项目可能处于维护模式），但其简洁实用的设计理念仍值得参考。