Review Gate for Cursor IDE

Cursor 经常过早地“收工”！我给它一个复杂的任务，它往往只用掉大约 25 次可用工具调用中的 5 次来完成这个“主要请求”，然后就结束了。这不仅浪费了单次思考中未被充分利用的 AI 能力，而且每次进行小的后续调整都需要发起 新的请求。如果频繁这样做，我宝贵的 每月约 500 次请求 就会比我预期的更快消耗殆尽。

隆重推出：Review Gate——将你的 500 次 Cursor 请求变成 2500 次的规则！ （好吧，也许并不总是完美的 5 倍，但你懂我的意思！）

我为我们心爱的 Cursor IDE 开发了这套系统，旨在将我的（以及你的！）AI 从短跑选手转变为能够持续处理复杂想法的长跑健将，所有这些都只需在一个 单一的主要请求 生命周期内完成。现在，V2 版本还加入了语音命令、图片上传和精美的弹出式界面！ 我基本上是在告诉 Cursor：“等等，除非我说结束，否则这次请求还没完呢。”

架构

graph TD
    A[用户给出复杂任务] --> B[Cursor 代理处理任务]
    B --> C[Review Gate 规则激活]
    C --> D[弹出界面出现]
    D --> E[多模态用户输入]
    E --> E1[文本命令]
    E --> E2[语音输入]
    E --> E3[图片上传]
    E1 --> F[代理继续执行更多操作]
    E2 --> F
    E3 --> F
    F --> G{任务完成吗？}
    G -->|否| D
    G -->|是| H[一次请求实现五倍价值]
    

功能对比

功能	V1（终端版）	V2（MCP 集成版）
界面	基于终端的脚本	精美的弹出式界面
输入方式	仅文本	文本 + 语音 + 图片
集成	Python 脚本	原生 MCP 工具
平台支持	macOS/Linux	macOS + Windows + Linux
语音转文字	无	有 - 本地 Whisper AI
图片上传	无	有 - 多格式支持
实时状态	无	有 - MCP 状态指示器
安装	手动规则设置	一键安装程序

核心功能（V2 包含的内容）

• 语音激活的 AI 控制： 直接说出你的子提示吧！点击麦克风，自然说话，你的语音将通过本地 Faster-Whisper AI 自动转录。
• 可视化上下文共享： 在弹出窗口中直接上传图片、截图、示意图或原型图。AI 可以看到你分享的一切。
• 精美的弹出式界面： 专业橙色发光设计，完美融入 Cursor，并配有实时 MCP 状态指示器。
• 让 AI 掌握在我手中： 通过交互式弹出窗口，在 Cursor 代理真正确认 初始 请求之前，等待 我（以及你！）的进一步指示。
• 提升请求效率： 让 一次 主要请求完成多次工作！与其发出 5 个新提示（并使你的约 500 次请求计数器减少 5 次），不如使用 Review Gate 在 同一请求的生命周期和工具调用预算内 进行 5 次（或更多）迭代式的子提示。
• 释放全部工具调用潜力： 我设计这个工具是为了帮助我们引导 AI 更充分地利用其约 25 次可用工具调用来完成 单一复杂想法，通过这些子提示来实现。
• MCP 集成的魔力： 基于模型上下文协议构建，实现与 Cursor 的无缝集成。弹出窗口会在需要时自动出现。
• 跨平台语音支持： Whisper 语音转文字功能在 macOS 上运行良好，并且已为 Windows 和 Linux 实现。

工作原理（V2 的进化）

1. 你（或者我）： 给 Cursor 一个任务（这算作你约 500 次请求中的一次）。
2. Cursor AI： 完成其主要工作（编码、分析，可能还会使用该请求中的几次工具调用）。
3. Review Gate V2 启动（我进化的神奇部分！）：
   • AI 自动调用 review_gate_chat MCP 工具
   • Cursor 中会出现一个精美的弹出窗口，提供多模态输入选项
   • AI 宣布正在等待你在弹出窗口中的输入
4. 你（在弹出窗口中）：
   • 输入 快速跟进内容（例如，“现在给所有新函数添加文档字符串。”）
   • 用麦克风说出指令（自动转录）
   • 上传图片 提供视觉上下文（截图、原型图、示意图）
   • 或者输入 TASK_COMPLETE 表示满意
5. Cursor AI（借助 MCP 集成）：
   • 读取你在弹出窗口中的输入（文本、语音、图片），并据此采取行动（继续编码，在原有预算内使用更多工具调用！），然后在主聊天窗口中回复，随后再次打开弹出窗口等待你的 下一次 输入。
6. 循环！ 这一过程会持续进行，不断深化对原始请求的工作，直到你在弹出窗口中输入 TASK_COMPLETE。

安装

要获得完整的 V2 体验，请从 V2/INSTALLATION.md 开始。 它记录了官方发布的 V2 文件，包括 V2/review-gate-v2-2.7.3.vsix、V2/ReviewGateV2.mdc、基于清单的打包辅助工具以及安全合并的 MCP 设置。

V2 安装（推荐 - MCP 集成）

只需两个简单步骤，即可大幅提升你的 Cursor 工作流程：

第一步：一键技术设置

macOS 安装

# 克隆仓库并进入 V2 子目录
git clone https://github.com/LakshmanTurlapati/Review-Gate.git
cd Review-Gate/V2

# 运行神奇的一键安装程序
./install.sh

Windows 安装

# 克隆仓库并进入 V2 子目录
git clone https://github.com/LakshmanTurlapati/Review-Gate.git
cd Review-Gate/V2

# 运行 PowerShell 安装程序（可能需要管理员权限）
./install.ps1

安装程序会自动处理：

• 依赖项：包管理器（Homebrew/Chocolatey）、SoX（用于语音处理）、Python 包
• MCP 服务器：全局安装并正确配置
• 扩展：Cursor 弹出式界面扩展
• 配置：MCP 集成设置，通过仅合并 review-gate-v2 条目来保留现有 MCP 配置

维护者打包协议

如果你需要验证或重新构建已发布的制品，该仓库现在将 V2/review-gate-v2-2.7.3.vsix 视为唯一的官方发布文件：

# 从仓库根目录
python3 scripts/package_review_gate_vsix.py --check

# 从 V2/cursor-extension
npm run package

这两条命令都会读取 V2/release-manifest.json，并以 V2/ReviewGateV2.mdc 作为支持的规则文件，最终生成的 VSIX 文件会放置在 V2/ 目录下。

GitHub Actions 构建

该仓库还包含 .github/workflows/build-vsix.yml 用于 CI 打包。当向 main 分支推送代码、创建拉取请求或手动触发时，工作流会执行以下步骤：

1. 验证 V2/release-manifest.json
2. 运行 python3 scripts/run_review_gate_regression_checks.py --suite release-surface
3. 使用 npm run package 构建标准的 VSIX 文件
4. 将 V2/review-gate-v2-2.7.3.vsix 上传为工作流产物

目前此工作流仅用于构建，不会发布 GitHub Release，也不会改变上述安装步骤。

替代方案：手动安装扩展

如果自动安装程序未能正确安装扩展，您可以选择手动安装：

1. 下载扩展：使用 V2/review-gate-v2-2.7.3.vsix，即标准发布的产物
2. 打开 Cursor：启动 Cursor IDE
3. 扩展面板：按 Cmd/Ctrl+Shift+X 打开扩展管理界面
4. 从 VSIX 安装：点击右上角的 ... 菜单 → “从 VSIX 安装…”
5. 选择文件：浏览并选择已下载的 .vsix 文件
6. 重启 Cursor：完全重启 Cursor 以使扩展生效

步骤 2：将 V2 规则复制到 Cursor 设置中

关键步骤：要使 Review Gate V2 正常工作，您需要将 V2 规则复制到 Cursor 的设置中：

1. 打开规则文件：复制 V2/ReviewGateV2.mdc 中的所有内容
2. Cursor 设置：打开 Cursor IDE → 设置（Cmd/Ctrl + ,）
3. 找到规则部分：在设置中查找“Rules”或“AI Rules”
4. 粘贴并保存：将 V2 规则内容完整粘贴进去，并保存
5. 重启 Cursor：完全重启 Cursor 以使规则生效

如果您曾手动编辑过 ~/.cursor/mcp.json 文件，请保留现有的 MCP 服务器条目，并将 review-gate-v2 的配置合并到现有文件中，而不是直接替换整个文件。

V1 安装（原始终端方式）

对于偏好原始终端方式的用户：

1. 复制规则：您需要从 V1 文档中获取“Review Gate”规则文本。
2. Cursor 设置：打开 Cursor IDE 的设置界面。
3. 全局 AI 规则：找到“Rules”部分。
4. 粘贴并保存：将规则全文粘贴进去并保存。
5. 完成！ 原始的 Review Gate 现已启用，能够让每一次主请求发挥更大的作用。

安装验证

完成以上两个步骤后：

1. 手动弹窗测试：在 Cursor 中按下 Cmd+Shift+R 手动打开弹窗
2. Agent 集成测试：向 Cursor 发出指令：“使用 review_gate_chat 工具获取我的反馈”
3. 语音测试：点击麦克风图标，清晰地说话，验证自动转录功能是否正常
4. 图片测试：点击相机图标，上传一张图片并附带文字发送
5. 全流程测试：给 Cursor 一个复杂任务，观察 Review Gate V2 弹窗是否会自动出现。

功能概览（V2 特性总结）

语音转文本魔法

• 点击麦克风按钮，自然开口说话，即可实现自动转录
• 本地 Faster-Whisper AI 处理（无需云端，无隐私担忧）
• 专业级视觉反馈：麦克风图标 → 红色停止按钮 → 橙色加载动画 → 文本实时插入

图片上传强大功能

• 支持 PNG、JPG、JPEG、GIF、BMP、WebP 等格式
• 可拖放上传或点击选择文件
• 图片会随 MCP 请求一同发送，让 AI 能够理解您的视觉上下文
• 非常适合分享截图、原型图、错误提示框或架构示意图等

精美界面

• 干净整洁的弹窗设计，采用与 Cursor 整体风格一致的橙色渐变配色
• 水平对齐的操作控件，呈现专业外观
• 实时显示 MCP 状态
• 流畅的动画效果和即时反馈

无缝 MCP 集成

• 自动与 Cursor Agent 工具调用协同工作
• 5 分钟超时机制，确保响应足够周全
• 全局安装适用于所有 Cursor 项目
• 基于文件的通信协议，保障稳定性

智能使用技巧（我的建议与背后逻辑）

• 为何开发这一改进版：为了避免 Cursor 在我仍有后续迭代需求时就结束对话，而如今通过语音指令和视觉上下文共享，可以让每次请求都更有价值。
• 语音指令的最佳实践：请尽量清晰、简洁地表达。本地 Whisper AI 表现不错，但更倾向于自然、节奏适中的语速。
• 图像上下文至关重要：上传错误截图、待开发的功能原型图或架构示意图等，能够让 AI 更好地理解您的需求。
• 平台注意事项：macOS 上的语音转文本功能非常稳定。Windows 和 Linux 版本也在逐步完善。
• 所有输入需明确：无论是打字、说话还是上传图片，保持清晰直接的沟通都能获得最佳效果。
• 使用 TASK_COMPLETE 结束对话：别忘了在弹窗中输入此指令，以便让 AI 最终结束当前任务，释放主请求资源。

故障排除

V2 故障排除

# 检查 MCP 服务器是否运行
tail -f /tmp/review_gate_v2.log

# 测试语音录制功能
sox --version
sox -d -r 16000 -c 1 test.wav trim 0 3 && rm test.wav

# 查看 Cursor 中的扩展日志
# 按 F12 打开开发者工具 → Console 标签页查看浏览器日志

# 验证 MCP 配置
cat ~/.cursor/mcp.json

# 手动测试扩展
# 在 Cursor 中按 Cmd+Shift+R

温馨提示！（友好提醒）

• 实验性升级！ 这是我为高级用户设计的 V2 版本。它之所以有效，是因为我们巧妙地利用了 MCP 集成来指导 AI 行为。
• MCP 服务器本地运行：该规则依赖于本地运行的 MCP 服务器与 Cursor 集成。安装程序会自动完成相关配置。
• 语音处理本地化：您的语音将由本地 Faster-Whisper AI 处理，不会上传至云端。
• 平台兼容性：
  • macOS：主要开发平台，具备自动化覆盖；原生安装程序和实时 Cursor 验证仍会持续跟踪检查
  • Windows：已实现并支持，但原生 Shell 烟雾环境仍可能存在差异
  • Linux：支持路径，但实战经验不如 macOS 丰富
• 需安装 Python 和 SoX：安装程序会自动处理这些依赖项，但您的系统必须支持 Python 3 和 SoX 才能正常使用语音功能。
• Cursor 更新可能影响功能：未来 Cursor 的版本更新可能会改变此规则的行为。今天可用的方法，明天可能需要调整！
• 务必记住规则：MCP 服务器只是引擎，您必须将 V2 规则复制到 Cursor 设置中，才能实现自动激活！

为什么是V2？你们要求的！

在最初的 Review Gate 获得 100 多次 Fork、100 多颗星、10 万多次曝光，以及无数希望进一步升级的请求之后——你们提出了需求，我就实现了！ 社区的反馈非常热烈，大家对语音命令、视觉上下文和更复杂界面的需求更是势不可挡。V2 就是我对每一条功能请求和改进建议的回应。

关于我与这次进化

这款“Review Gate V2”是我将最初的终端规则演进为一个功能齐全、多模态交互系统的成果。它源于我自身的一个愿望：不仅通过文本，更要借助语音命令和视觉上下文，真正与 Cursor 的 AI 形成默契搭档。我的目标始终如一：让每一次交互都尽可能深入、完整，确保每一个可用于实现宏大构想的工具调用都能充分展现其价值，使那大约 500 条请求每一项都像黄金般珍贵！

V2 系统利用模型上下文协议（MCP），在 Cursor 的 AI 与丰富、交互式的弹出界面之间架起一座无缝桥梁。无论你是发出语音指令、分享截图，还是输入后续内容，这一切都旨在让你保持流畅的工作状态，同时最大化每次 Cursor 请求的价值。

如需联系我或了解更多关于我的工作，请访问：www.audienclature.com

---

祝你使用 Cursor 编程愉快且效率倍增！愿你的 AI 始终静候你的最终指令，你的语音被清晰转录，你的图像被完美理解，而你每月的请求额度仿佛永远用不完！

Review-Gate 快速上手指南

Review-Gate 是一款专为 Cursor IDE 设计的增强工具，旨在解决 AI 过早结束复杂任务的问题。通过引入交互式弹窗、语音指令和图像上传功能，它允许你在单次请求生命周期内进行多轮迭代，从而大幅提升 Cursor 每月请求配额的使用效率。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统: macOS, Windows, 或 Linux
• 核心软件:
  • Cursor IDE (已安装)
  • Git
  • Python 3.x
• 前置依赖:
  • macOS: 建议安装 Homebrew (用于管理 SoX 等音频依赖)
  • Windows: 建议安装 Chocolatey 或直接运行提供的 PowerShell 脚本（会自动处理依赖）
  • Linux: 需确保系统已安装 sox 及相关音频库
• 网络提示: 由于涉及 GitHub 仓库克隆及可能的模型下载，国内用户建议配置好网络加速环境或使用镜像源。

安装步骤

Review-Gate V2 版本推荐使用 MCP (Model Context Protocol) 集成方式，支持一键安装。

1. 克隆仓库并运行安装脚本

打开终端（macOS/Linux）或 PowerShell（Windows），执行以下命令：

macOS / Linux:

git clone https://github.com/LakshmanTurlapati/Review-Gate.git
cd Review-Gate/V2
./install.sh

Windows:

git clone https://github.com/LakshmanTurlapati/Review-Gate.git
cd Review-Gate\V2
.\install.ps1

注意: Windows 用户可能需要以管理员身份运行 PowerShell。安装脚本将自动处理 Python 包、SoX 音频工具、MCP 服务器配置以及 Cursor 扩展的安装。

2. 配置 Cursor 规则 (关键步骤)

安装脚本完成后，必须手动将规则配置添加到 Cursor 中才能生效：

1. 找到项目目录下的 V2/ReviewGateV2.mdc 文件，复制其全部内容。
2. 打开 Cursor IDE，进入设置 (Cmd/Ctrl + ,)。
3. 找到 "Rules" (或 "AI Rules") 部分。
4. 将复制的内容粘贴进去并保存。
5. 重启 Cursor 以使规则和扩展完全生效。

提示: 如果你手动编辑过 ~/.cursor/mcp.json，请确保保留原有的 MCP 配置，仅合并添加 review-gate-v2 相关条目，不要直接覆盖整个文件。

3. 验证安装

重启 Cursor 后，可以通过以下方式测试：

• 手动测试: 按下 Cmd+Shift+R (Mac) 或 Ctrl+Shift+R (Win/Linux)，查看是否弹出带有橙色光晕的 Review-Gate 界面。
• 语音测试: 点击弹窗中的麦克风图标说话，检查是否能自动转录为文字。

基本使用

安装完成后，Review-Gate 将自动介入你的复杂任务流程。

场景示例：多轮迭代开发

1. 发起主任务: 在 Cursor 聊天框中输入一个复杂的需求，例如：

   "帮我创建一个基于 FastAPI 的用户认证模块，包含注册、登录和 JWT 令牌刷新功能。"

2. 自动触发: 当 Cursor 完成初步代码生成后，Review-Gate 会自动拦截并弹出一个交互窗口，提示等待你的进一步指令。

3. 多模态反馈 (在弹窗中操作):

   • 文本指令: 输入 "现在给所有新函数添加详细的 docstrings" 或 "重构数据库连接部分以支持异步"。
   • 语音指令: 点击麦克风 🎙️，直接说 "把错误处理逻辑改成统一的全局异常处理器"，系统将自动转录并发送给 AI。
   • 图像上下文: 点击相机图标 📷，上传一张架构草图或报错截图，AI 将结合图片内容继续工作。

4. 循环迭代: AI 会根据你的新指令继续调用工具（消耗的是当前请求剩余的 Tool Calls 额度，而非新的月度配额），完成后弹窗会再次出现等待下一步指示。

5. 结束任务: 当你对结果满意时，在弹窗输入框中输入：

   TASK_COMPLETE
   

   此时，整个工作流程正式结束，释放主请求。

核心价值

通过这种方式，你可以用 1 次 月度请求配额，完成原本需要 5-10 次 独立对话才能完成的迭代开发任务，充分利用了单次请求中约 25 次的工具调用上限。