[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-LakshmanTurlapati--Review-Gate":3,"tool-LakshmanTurlapati--Review-Gate":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",153609,2,"2026-04-13T11:34:59",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":77,"owner_email":78,"owner_twitter":79,"owner_website":80,"owner_url":81,"languages":82,"stars":103,"forks":104,"last_commit_at":105,"license":78,"difficulty_score":32,"env_os":106,"env_gpu":107,"env_ram":108,"env_deps":109,"category_tags":117,"github_topics":119,"view_count":32,"oss_zip_url":78,"oss_zip_packed_at":78,"status":17,"created_at":124,"updated_at":125,"faqs":126,"releases":157},7167,"LakshmanTurlapati\u002FReview-Gate","Review-Gate","Review-Gate V2 is a powerful rule for the Cursor IDE that helps you get up to 5x more value from your monthly requests. It creates an interactive loop where the AI waits for your follow-up commands—via text, voice, or image upload—allowing you to perform deep, iterative work all within a single request.","Review-Gate 是一款专为 Cursor IDE 设计的增强规则，旨在帮助用户在单次请求中实现更深度的迭代开发。它解决了 AI 助手常在复杂任务中过早结束对话、导致用户不得不频繁发起新请求从而快速消耗月度配额的问题。通过引入一个交互式循环机制，Review-Gate 让 AI 在完成初步工作后暂停并等待用户的进一步指令，而非直接终止任务。\n\n这款工具特别适合需要处理复杂逻辑、进行多轮代码优化或依赖视觉上下文（如截图、设计稿）的开发者。其核心亮点在于支持多模态输入：用户不仅可以通过文字，还能直接使用语音（内置本地 Whisper 模型实时转写）或上传图片来下达后续指令。所有交互均在一个美观的弹窗界面中完成，无需切换窗口。\n\n借助 Review-Gate，原本可能需要拆分为五次独立请求才能完成的“提问 - 反馈 - 修改”流程，现在可以合并到一次主请求的生命周期内。这不仅大幅提升了单次请求的价值利用率，有效延长月度配额的使用时间，还让 AI 能够更充分地调用其工具链能力，成为陪伴开发者完成长跑式复杂任务的得力伙伴。","[![3OtOp7R.th.png](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FLakshmanTurlapati_Review-Gate_readme_78ed206208fc.png)](https:\u002F\u002Ffreeimage.host\u002Fi\u002F3OtOp7R)\n\n# Review Gate for Cursor IDE\n\n[![Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-2.7.3-blue.svg)](https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-green.svg)](LICENSE)\n[![Platform](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey.svg)]()\n[![MCP](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMCP-Tool-orange.svg)](https:\u002F\u002Fmodelcontextprotocol.io\u002F)\n[![Whisper](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FWhisper%20STT-purple.svg?logo=openai&logoColor=white)](https:\u002F\u002Fgithub.com\u002Fopenai\u002Fwhisper)\n[![Stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FLakshmanTurlapati\u002FReview-Gate.svg)](https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate\u002Fstargazers)\n[![Forks](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002FLakshmanTurlapati\u002FReview-Gate.svg)](https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate\u002Fnetwork)\n\n![Review Gate V2 Interface](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FLakshmanTurlapati_Review-Gate_readme_5b293a3780a7.png)\n\n**Cursor** would often drop the mic way too early! I'd give it a complex task, it'd use maybe 5 of its ~25 available tool calls for that single \"main request,\" then call it a day. Not only was that untapped AI power for that *single thought*, but making small follow-up tweaks meant starting a *new request*. Doing that too often, and my precious **~500 monthly requests** (you know the ones!) would burn up much faster than I liked.\n\n**Presenting: The Review Gate – The \"Turn Your 500 Cursor Requests into 2500!\" Rule!**\n(Okay, maybe not *always* a perfect 5x, but you get the idea!)\n\nI evolved this system for our beloved Cursor IDE to transform my (and your!) AI from a quick sprinter into an endurance marathon runner for complex ideas, all within the lifecycle of a *single main request*. **Now with V2's voice commands, image uploads, and beautiful popup interface!** I've basically told Cursor: \"Hold up, *we're* not done with this request until *I* say we're done.\"\n\n## Architecture\n\n```mermaid\ngraph TD\n    A[User Gives Complex Task] --> B[Cursor Agent Processes Task]\n    B --> C[Review Gate Rule Activates]\n    C --> D[Popup Interface Appears]\n    D --> E[Multi-Modal User Input]\n    E --> E1[Text Commands]\n    E --> E2[Voice Input]\n    E --> E3[Image Upload]\n    E1 --> F[Agent Continues with More Actions]\n    E2 --> F\n    E3 --> F\n    F --> G{Task Complete?}\n    G -->|No| D\n    G -->|Yes| H[Single Request Delivers 5x Value]\n    \n```\n\n\n\n## Features Comparison\n\n| Feature | V1 (Terminal) | V2 (MCP Integration) |\n|---------|--------------|---------------------|\n| **Interface** | Terminal-based script | Beautiful popup interface |\n| **Input Methods** | Text only | Text + Voice + Images |\n| **Integration** | Python script | Native MCP tool |\n| **Platform Support** | macOS\u002FLinux | macOS + Windows + Linux |\n| **Speech-to-Text** | No | Yes - Local Whisper AI |\n| **Image Upload** | No | Yes - Multi-format support |\n| **Real-time Status** | No | Yes - MCP status indicator |\n| **Installation** | Manual rule setup | One-click installer |\n\n## Key Features (What V2 Packs In)\n\n* **Voice-Activated AI Control:** Speak your sub-prompts directly! Click the mic, speak naturally, and watch your words transcribe automatically using local Faster-Whisper AI.\n* **Visual Context Sharing:** Upload images, screenshots, diagrams, or mockups directly in the popup. The AI sees everything you share.\n* **Beautiful Popup Interface:** Professional orange-glow design that fits perfectly in Cursor with real-time MCP status indicators.\n* **AI On MY Leash:** Makes the Cursor Agent wait for *my* (and your!) \"go-ahead\" via an interactive popup before it truly signs off on an *initial* request.\n* **Multiply Your Request Power:** Make *one* main request do the work of many! Instead of 5 new prompts (and 5 dings on your ~500 request counter!), use the Review Gate for 5 (or more!) iterative sub-prompts *within that single request's lifecycle and tool call budget*.\n* **Unlock Full Tool Call Potential:** I designed this to help us guide the AI to use more of its ~25 available tool calls for a *single complex idea* through those sub-prompts.\n* **MCP Integration Magic:** Built on the Model Context Protocol for seamless Cursor integration. The popup automatically appears when needed.\n* **Cross-Platform Speech:** Whisper speech-to-text works flawlessly on macOS and is implemented for Windows and Linux.\n\n## How It Works (V2 Evolution)\n\n1. **You (or I):** Give Cursor a task (this counts as 1 main request towards your ~500).\n2. **Cursor AI:** Does its main job (coding, analysis, maybe a few tool calls from the ~25 for this request).\n3. **Review Gate V2 Kicks In (The Magic Part I Evolved!):**\n   * AI calls the `review_gate_chat` MCP tool automatically\n   * Beautiful popup appears in Cursor with multi-modal input options\n   * AI announces it's waiting for your input in the popup\n4. **You (in the popup):** \n   * **Type** quick follow-ups (e.g., \"Now add docstrings to all new functions.\")\n   * **Speak** your commands using the microphone (automatic transcription)\n   * **Upload images** for visual context (screenshots, mockups, diagrams)\n   * **Or type** `TASK_COMPLETE` when you're satisfied\n5. **Cursor AI (powered by MCP integration):**\n   Reads your popup input (text, speech, images), acts on it (more coding, *more tool calls from the original budget*!), responds in the main chat, then opens the popup again for your *next* input.\n6. **Loop!** This continues, deepening the work on your original request, until you type `TASK_COMPLETE` in the popup.\n\n## Installation\n\n**For the full V2 experience, start with `V2\u002FINSTALLATION.md`.** It documents the canonical shipped V2 files, including `V2\u002Freview-gate-v2-2.7.3.vsix`, `V2\u002FReviewGateV2.mdc`, the manifest-backed packaging helper, and the merge-safe MCP setup.\n\n### V2 Installation (Recommended - MCP Integration)\n\n**Two simple steps to supercharge your Cursor workflow:**\n\n#### Step 1: One-Click Technical Setup\n\n**macOS Installation**\n```bash\n# Clone repository and navigate to V2 subdirectory\ngit clone https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate.git\ncd Review-Gate\u002FV2\n\n# Run the magical one-click installer\n.\u002Finstall.sh\n```\n\n**Windows Installation**\n```powershell\n# Clone repository and navigate to V2 subdirectory\ngit clone https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate.git\ncd Review-Gate\u002FV2\n\n# Run PowerShell installer (may need admin privileges)\n.\u002Finstall.ps1\n```\n\nThe installer automatically handles:\n- **Dependencies**: Package managers (Homebrew\u002FChocolatey), SoX (for speech), Python packages\n- **MCP Server**: Global installation with proper configuration\n- **Extension**: Cursor extension for the popup interface\n- **Configuration**: MCP integration setup that preserves existing MCP configuration by merging only the `review-gate-v2` entry\n\n#### Maintainer Packaging Contract\n\nIf you need to validate or rebuild the shipped artifact, the repo now treats `V2\u002Freview-gate-v2-2.7.3.vsix` as the only canonical release file:\n\n```bash\n# From the repo root\npython3 scripts\u002Fpackage_review_gate_vsix.py --check\n\n# From V2\u002Fcursor-extension\nnpm run package\n```\n\nBoth commands read `V2\u002Frelease-manifest.json`, keep `V2\u002FReviewGateV2.mdc` as the supported rule file, and target the same canonical VSIX path under `V2\u002F`.\n\n#### GitHub Actions Build\n\nThe repo also includes `.github\u002Fworkflows\u002Fbuild-vsix.yml` for CI packaging. On pushes to `main`, pull requests, or manual dispatch, it:\n\n1. Validates `V2\u002Frelease-manifest.json`\n2. Runs `python3 scripts\u002Frun_review_gate_regression_checks.py --suite release-surface`\n3. Builds the canonical VSIX with `npm run package`\n4. Uploads `V2\u002Freview-gate-v2-2.7.3.vsix` as a workflow artifact\n\nThis workflow is intentionally build-only for now. It does not publish a GitHub Release, and it does not change the installation steps above.\n\n#### Alternative: Manual Extension Installation\n\nIf the automatic installer doesn't install the extension properly, you can install it manually:\n\n1. **Download Extension**: Use `V2\u002Freview-gate-v2-2.7.3.vsix`, the canonical shipped artifact\n2. **Open Cursor**: Launch Cursor IDE\n3. **Extensions Panel**: Press `Cmd\u002FCtrl+Shift+X` to open Extensions\n4. **Install from VSIX**: Click the `...` menu → \"Install from VSIX...\"\n5. **Select File**: Choose the downloaded `.vsix` file\n6. **Restart Cursor**: Restart Cursor completely for the extension to activate\n\n#### Step 2: Copy the V2 Rule to Cursor\n\n**CRITICAL STEP**: For the Review Gate V2 to work, you need to copy the V2 rule to your Cursor settings:\n\n1. **Open the Rule File**: Copy the entire contents of `V2\u002FReviewGateV2.mdc`\n2. **Cursor Settings**: Open your Cursor IDE → Settings (Cmd\u002FCtrl + ,)\n3. **Find Rules Section**: Look for \"Rules\" or \"AI Rules\" in the settings\n4. **Paste & Save**: Paste the entire V2 rule content and save\n5. **Restart Cursor**: Restart Cursor completely for the rule to take effect\n\nIf you ever edit `~\u002F.cursor\u002Fmcp.json` manually, preserve existing MCP server entries and merge the `review-gate-v2` configuration instead of replacing the whole file.\n\n### V1 Installation (Original Terminal-Based)\n\nFor those who prefer the original terminal-based approach:\n\n1. **Copy THE Rule:** You'll need the \"Review Gate\" rule text from the V1 documentation.\n2. **Cursor Settings:** Open your Cursor IDE settings.\n3. **Global AI Rules:** Find the section for \"Rules\".\n4. **Paste & Save:** Paste the entire rule. Save.\n5. **Boom!** The original Review Gate is now armed to make every main request count for *way* more.\n\n## Testing Your Installation\n\nAfter both steps are complete:\n\n1. **Manual Popup Test**: Press `Cmd+Shift+R` in Cursor to open the popup manually\n2. **Agent Integration Test**: Ask Cursor: *\"Use the review_gate_chat tool to get my feedback\"*\n3. **Speech Test**: Click the microphone → speak clearly → verify automatic transcription\n4. **Image Test**: Click the camera icon → upload an image → send with text\n5. **Full Workflow Test**: Give Cursor a complex task and watch the Review Gate V2 popup appear automatically\n\n## What You Get (V2 Feature Summary)\n\n### **Voice-to-Text Magic**\n- Click microphone → speak naturally → automatic transcription\n- Local Faster-Whisper AI processing (no cloud, no privacy concerns)\n- Professional visual feedback: mic → red stop button → orange spinner → text injection\n\n### **Image Upload Power**\n- Support for PNG, JPG, JPEG, GIF, BMP, WebP formats\n- Drag & drop or click to upload\n- Images included in MCP responses so the AI can see your visual context\n- Perfect for sharing screenshots, mockups, error dialogs, or architectural diagrams\n\n### **Beautiful Interface**\n- Clean popup with orange glow design that matches Cursor's aesthetic\n- Horizontally aligned controls for professional appearance\n- Real-time MCP status indicator\n- Smooth animations and responsive feedback\n\n### **Seamless MCP Integration**\n- Works automatically with Cursor Agent tool calls\n- 5-minute timeout for thoughtful responses\n- Global installation works across all your Cursor projects\n- File-based communication protocol for reliability\n\n## Play Smart (My Tips & The \"Why\")\n\n* **Why I evolved this hack:** To stop Cursor from ending too soon when I have iterative follow-ups for the *same original thought process*, but now with the power of voice commands and visual context sharing.\n* **Voice Commands Work Best When:** You speak clearly and concisely. The local Whisper AI is quite good but prefers natural, well-paced speech.\n* **Image Context is Gold:** Upload screenshots of errors, mockups of what you want built, or diagrams of architecture. The AI can see and understand visual context.\n* **Platform Notes:** Speech-to-text is rock-solid on macOS. Windows and Linux implementations exist and are improving.\n* **Be Clear in All Inputs:** Whether typing, speaking, or sharing images, clear and direct communication in the popup works best.\n* **`TASK_COMPLETE` is Your Exit:** Don't forget to type this in the popup to let the AI finally rest (and free up that main request slot).\n\n## Troubleshooting\n\n### V2 Troubleshooting\n\n```bash\n# Check if MCP server is running\ntail -f \u002Ftmp\u002Freview_gate_v2.log\n\n# Test speech recording capability\nsox --version\nsox -d -r 16000 -c 1 test.wav trim 0 3 && rm test.wav\n\n# Check extension logs in Cursor\n# Press F12 → Console tab for browser logs\n\n# Verify MCP configuration\ncat ~\u002F.cursor\u002Fmcp.json\n\n# Test the extension manually\n# Press Cmd+Shift+R in Cursor\n```\n\n\n## Heads Up! (My Friendly Warnings)\n\n* **EXPERIMENTAL EVOLUTION!** This is V2 of my power-user move. It works because we're very cleverly instructing the AI with MCP integration.\n* **MCP SERVER RUNS LOCALLY:** The rule uses a local MCP server that integrates with Cursor. The installer sets this up automatically.\n* **SPEECH PROCESSING IS LOCAL:** Your voice is processed locally using Faster-Whisper AI - nothing goes to the cloud.\n* **PLATFORM COMPATIBILITY:** \n  - **macOS**: Primary development path with automated coverage; native installer and live Cursor validation remain tracked follow-up checks\n  - **Windows**: Implemented and supported, with native shell smoke still environment-dependent\n  - **Linux**: Supported path, but less battle-tested than macOS\n* **PYTHON & SOX NEEDED:** The installer handles these, but your system needs to support Python 3 and SoX for speech functionality.\n* **CURSOR UPDATES MIGHT CHANGE THINGS:** Future Cursor versions could affect how this rule behaves. What works today might need tweaks tomorrow!\n* **REMEMBER THE RULE:** The MCP server is just the engine - you MUST copy the V2 rule to your Cursor settings for automatic activation!\n\n## Why V2? You Asked For It!\n\nAfter the original Review Gate gained **100+ forks**, **100+ stars**, **100,000+ impressions**, and countless requests to evolve it further - **you asked for it, I delivered!** The community response was incredible, and the demand for voice commands, visual context, and a more sophisticated interface was overwhelming. V2 is my answer to every single feature request and improvement suggestion.\n\n## About Me & This Evolution\n\nThis \"Review Gate V2\" represents the evolution of my original terminal-based rule into a full-featured, multi-modal interaction system. It was born from my own desire to truly partner with Cursor's AI using not just text, but voice commands and visual context. My goal remains the same: to make every interaction as deep and complete as possible and ensure every available tool call for a big idea gets its chance to shine, making each of those ~500 requests count like gold!\n\nThe V2 system leverages the Model Context Protocol (MCP) to create a seamless bridge between Cursor's AI and a rich, interactive popup interface. Whether you're speaking commands, sharing screenshots, or typing follow-ups, it's all designed to keep you in the flow while maximizing the value of each Cursor request.\n\nTo connect with me or learn more about my work, visit: [www.audienclature.com](https:\u002F\u002Fwww.audienclature.com)\n\n---\n\n*Happy (and supercharged) coding with Cursor! May your AI always await your final command, your voice be clearly transcribed, your images perfectly understood, and your monthly requests feel like they last forever!*\n","[![3OtOp7R.th.png](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FLakshmanTurlapati_Review-Gate_readme_78ed206208fc.png)](https:\u002F\u002Ffreeimage.host\u002Fi\u002F3OtOp7R)\n\n# Review Gate for Cursor IDE\n\n[![版本](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-2.7.3-blue.svg)](https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate)\n[![许可证](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-green.svg)](LICENSE)\n[![平台](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey.svg)]()\n[![MCP](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMCP-Tool-orange.svg)](https:\u002F\u002Fmodelcontextprotocol.io\u002F)\n[![Whisper](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FWhisper%20STT-purple.svg?logo=openai&logoColor=white)](https:\u002F\u002Fgithub.com\u002Fopenai\u002Fwhisper)\n[![星标](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FLakshmanTurlapati\u002FReview-Gate.svg)](https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate\u002Fstargazers)\n[![分支](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002FLakshmanTurlapati\u002FReview-Gate.svg)](https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate\u002Fnetwork)\n\n![Review Gate V2 界面](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FLakshmanTurlapati_Review-Gate_readme_5b293a3780a7.png)\n\n**Cursor** 经常过早地“收工”！我给它一个复杂的任务，它往往只用掉大约 25 次可用工具调用中的 5 次来完成这个“主要请求”，然后就结束了。这不仅浪费了单次思考中未被充分利用的 AI 能力，而且每次进行小的后续调整都需要发起 *新的请求*。如果频繁这样做，我宝贵的 **每月约 500 次请求** 就会比我预期的更快消耗殆尽。\n\n**隆重推出：Review Gate——将你的 500 次 Cursor 请求变成 2500 次的规则！**\n（好吧，也许并不总是完美的 5 倍，但你懂我的意思！）\n\n我为我们心爱的 Cursor IDE 开发了这套系统，旨在将我的（以及你的！）AI 从短跑选手转变为能够持续处理复杂想法的长跑健将，所有这些都只需在一个 *单一的主要请求* 生命周期内完成。**现在，V2 版本还加入了语音命令、图片上传和精美的弹出式界面！** 我基本上是在告诉 Cursor：“等等，除非我说结束，否则这次请求还没完呢。”\n\n## 架构\n\n```mermaid\ngraph TD\n    A[用户给出复杂任务] --> B[Cursor 代理处理任务]\n    B --> C[Review Gate 规则激活]\n    C --> D[弹出界面出现]\n    D --> E[多模态用户输入]\n    E --> E1[文本命令]\n    E --> E2[语音输入]\n    E --> E3[图片上传]\n    E1 --> F[代理继续执行更多操作]\n    E2 --> F\n    E3 --> F\n    F --> G{任务完成吗？}\n    G -->|否| D\n    G -->|是| H[一次请求实现五倍价值]\n    \n```\n\n\n\n## 功能对比\n\n| 功能 | V1（终端版） | V2（MCP 集成版） |\n|---------|--------------|---------------------|\n| **界面** | 基于终端的脚本 | 精美的弹出式界面 |\n| **输入方式** | 仅文本 | 文本 + 语音 + 图片 |\n| **集成** | Python 脚本 | 原生 MCP 工具 |\n| **平台支持** | macOS\u002FLinux | macOS + Windows + Linux |\n| **语音转文字** | 无 | 有 - 本地 Whisper AI |\n| **图片上传** | 无 | 有 - 多格式支持 |\n| **实时状态** | 无 | 有 - MCP 状态指示器 |\n| **安装** | 手动规则设置 | 一键安装程序 |\n\n## 核心功能（V2 包含的内容）\n\n* **语音激活的 AI 控制：** 直接说出你的子提示吧！点击麦克风，自然说话，你的语音将通过本地 Faster-Whisper AI 自动转录。\n* **可视化上下文共享：** 在弹出窗口中直接上传图片、截图、示意图或原型图。AI 可以看到你分享的一切。\n* **精美的弹出式界面：** 专业橙色发光设计，完美融入 Cursor，并配有实时 MCP 状态指示器。\n* **让 AI 掌握在我手中：** 通过交互式弹出窗口，在 Cursor 代理真正确认 *初始* 请求之前，等待 *我*（以及你！）的进一步指示。\n* **提升请求效率：** 让 *一次* 主要请求完成多次工作！与其发出 5 个新提示（并使你的约 500 次请求计数器减少 5 次），不如使用 Review Gate 在 *同一请求的生命周期和工具调用预算内* 进行 5 次（或更多）迭代式的子提示。\n* **释放全部工具调用潜力：** 我设计这个工具是为了帮助我们引导 AI 更充分地利用其约 25 次可用工具调用来完成 *单一复杂想法*，通过这些子提示来实现。\n* **MCP 集成的魔力：** 基于模型上下文协议构建，实现与 Cursor 的无缝集成。弹出窗口会在需要时自动出现。\n* **跨平台语音支持：** Whisper 语音转文字功能在 macOS 上运行良好，并且已为 Windows 和 Linux 实现。\n\n## 工作原理（V2 的进化）\n\n1. **你（或者我）：** 给 Cursor 一个任务（这算作你约 500 次请求中的一次）。\n2. **Cursor AI：** 完成其主要工作（编码、分析，可能还会使用该请求中的几次工具调用）。\n3. **Review Gate V2 启动（我进化的神奇部分！）：**\n   * AI 自动调用 `review_gate_chat` MCP 工具\n   * Cursor 中会出现一个精美的弹出窗口，提供多模态输入选项\n   * AI 宣布正在等待你在弹出窗口中的输入\n4. **你（在弹出窗口中）：**\n   * **输入** 快速跟进内容（例如，“现在给所有新函数添加文档字符串。”）\n   * **用麦克风说出指令**（自动转录）\n   * **上传图片** 提供视觉上下文（截图、原型图、示意图）\n   * **或者输入** `TASK_COMPLETE` 表示满意\n5. **Cursor AI（借助 MCP 集成）：**\n   * 读取你在弹出窗口中的输入（文本、语音、图片），并据此采取行动（继续编码，*在原有预算内使用更多工具调用*！），然后在主聊天窗口中回复，随后再次打开弹出窗口等待你的 *下一次* 输入。\n6. **循环！** 这一过程会持续进行，不断深化对原始请求的工作，直到你在弹出窗口中输入 `TASK_COMPLETE`。\n\n## 安装\n\n**要获得完整的 V2 体验，请从 `V2\u002FINSTALLATION.md` 开始。** 它记录了官方发布的 V2 文件，包括 `V2\u002Freview-gate-v2-2.7.3.vsix`、`V2\u002FReviewGateV2.mdc`、基于清单的打包辅助工具以及安全合并的 MCP 设置。\n\n### V2 安装（推荐 - MCP 集成）\n\n**只需两个简单步骤，即可大幅提升你的 Cursor 工作流程：**\n\n#### 第一步：一键技术设置\n\n**macOS 安装**\n```bash\n# 克隆仓库并进入 V2 子目录\ngit clone https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate.git\ncd Review-Gate\u002FV2\n\n# 运行神奇的一键安装程序\n.\u002Finstall.sh\n```\n\n**Windows 安装**\n```powershell\n# 克隆仓库并进入 V2 子目录\ngit clone https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate.git\ncd Review-Gate\u002FV2\n\n# 运行 PowerShell 安装程序（可能需要管理员权限）\n.\u002Finstall.ps1\n```\n\n安装程序会自动处理：\n- **依赖项**：包管理器（Homebrew\u002FChocolatey）、SoX（用于语音处理）、Python 包\n- **MCP 服务器**：全局安装并正确配置\n- **扩展**：Cursor 弹出式界面扩展\n- **配置**：MCP 集成设置，通过仅合并 `review-gate-v2` 条目来保留现有 MCP 配置\n\n#### 维护者打包协议\n\n如果你需要验证或重新构建已发布的制品，该仓库现在将 `V2\u002Freview-gate-v2-2.7.3.vsix` 视为唯一的官方发布文件：\n\n```bash\n\n# 从仓库根目录\npython3 scripts\u002Fpackage_review_gate_vsix.py --check\n\n# 从 V2\u002Fcursor-extension\nnpm run package\n```\n\n这两条命令都会读取 `V2\u002Frelease-manifest.json`，并以 `V2\u002FReviewGateV2.mdc` 作为支持的规则文件，最终生成的 VSIX 文件会放置在 `V2\u002F` 目录下。\n\n#### GitHub Actions 构建\n\n该仓库还包含 `.github\u002Fworkflows\u002Fbuild-vsix.yml` 用于 CI 打包。当向 `main` 分支推送代码、创建拉取请求或手动触发时，工作流会执行以下步骤：\n\n1. 验证 `V2\u002Frelease-manifest.json`\n2. 运行 `python3 scripts\u002Frun_review_gate_regression_checks.py --suite release-surface`\n3. 使用 `npm run package` 构建标准的 VSIX 文件\n4. 将 `V2\u002Freview-gate-v2-2.7.3.vsix` 上传为工作流产物\n\n目前此工作流仅用于构建，不会发布 GitHub Release，也不会改变上述安装步骤。\n\n#### 替代方案：手动安装扩展\n\n如果自动安装程序未能正确安装扩展，您可以选择手动安装：\n\n1. **下载扩展**：使用 `V2\u002Freview-gate-v2-2.7.3.vsix`，即标准发布的产物\n2. **打开 Cursor**：启动 Cursor IDE\n3. **扩展面板**：按 `Cmd\u002FCtrl+Shift+X` 打开扩展管理界面\n4. **从 VSIX 安装**：点击右上角的 `...` 菜单 → “从 VSIX 安装…”\n5. **选择文件**：浏览并选择已下载的 `.vsix` 文件\n6. **重启 Cursor**：完全重启 Cursor 以使扩展生效\n\n#### 步骤 2：将 V2 规则复制到 Cursor 设置中\n\n**关键步骤**：要使 Review Gate V2 正常工作，您需要将 V2 规则复制到 Cursor 的设置中：\n\n1. **打开规则文件**：复制 `V2\u002FReviewGateV2.mdc` 中的所有内容\n2. **Cursor 设置**：打开 Cursor IDE → 设置（Cmd\u002FCtrl + ,）\n3. **找到规则部分**：在设置中查找“Rules”或“AI Rules”\n4. **粘贴并保存**：将 V2 规则内容完整粘贴进去，并保存\n5. **重启 Cursor**：完全重启 Cursor 以使规则生效\n\n如果您曾手动编辑过 `~\u002F.cursor\u002Fmcp.json` 文件，请保留现有的 MCP 服务器条目，并将 `review-gate-v2` 的配置合并到现有文件中，而不是直接替换整个文件。\n\n### V1 安装（原始终端方式）\n\n对于偏好原始终端方式的用户：\n\n1. **复制规则**：您需要从 V1 文档中获取“Review Gate”规则文本。\n2. **Cursor 设置**：打开 Cursor IDE 的设置界面。\n3. **全局 AI 规则**：找到“Rules”部分。\n4. **粘贴并保存**：将规则全文粘贴进去并保存。\n5. **完成！** 原始的 Review Gate 现已启用，能够让每一次主请求发挥更大的作用。\n\n## 安装验证\n\n完成以上两个步骤后：\n\n1. **手动弹窗测试**：在 Cursor 中按下 `Cmd+Shift+R` 手动打开弹窗\n2. **Agent 集成测试**：向 Cursor 发出指令：“使用 review_gate_chat 工具获取我的反馈”\n3. **语音测试**：点击麦克风图标，清晰地说话，验证自动转录功能是否正常\n4. **图片测试**：点击相机图标，上传一张图片并附带文字发送\n5. **全流程测试**：给 Cursor 一个复杂任务，观察 Review Gate V2 弹窗是否会自动出现。\n\n## 功能概览（V2 特性总结）\n\n### **语音转文本魔法**\n- 点击麦克风按钮，自然开口说话，即可实现自动转录\n- 本地 Faster-Whisper AI 处理（无需云端，无隐私担忧）\n- 专业级视觉反馈：麦克风图标 → 红色停止按钮 → 橙色加载动画 → 文本实时插入\n\n### **图片上传强大功能**\n- 支持 PNG、JPG、JPEG、GIF、BMP、WebP 等格式\n- 可拖放上传或点击选择文件\n- 图片会随 MCP 请求一同发送，让 AI 能够理解您的视觉上下文\n- 非常适合分享截图、原型图、错误提示框或架构示意图等\n\n### **精美界面**\n- 干净整洁的弹窗设计，采用与 Cursor 整体风格一致的橙色渐变配色\n- 水平对齐的操作控件，呈现专业外观\n- 实时显示 MCP 状态\n- 流畅的动画效果和即时反馈\n\n### **无缝 MCP 集成**\n- 自动与 Cursor Agent 工具调用协同工作\n- 5 分钟超时机制，确保响应足够周全\n- 全局安装适用于所有 Cursor 项目\n- 基于文件的通信协议，保障稳定性\n\n## 智能使用技巧（我的建议与背后逻辑）\n\n* **为何开发这一改进版**：为了避免 Cursor 在我仍有后续迭代需求时就结束对话，而如今通过语音指令和视觉上下文共享，可以让每次请求都更有价值。\n* **语音指令的最佳实践**：请尽量清晰、简洁地表达。本地 Whisper AI 表现不错，但更倾向于自然、节奏适中的语速。\n* **图像上下文至关重要**：上传错误截图、待开发的功能原型图或架构示意图等，能够让 AI 更好地理解您的需求。\n* **平台注意事项**：macOS 上的语音转文本功能非常稳定。Windows 和 Linux 版本也在逐步完善。\n* **所有输入需明确**：无论是打字、说话还是上传图片，保持清晰直接的沟通都能获得最佳效果。\n* **使用 `TASK_COMPLETE` 结束对话**：别忘了在弹窗中输入此指令，以便让 AI 最终结束当前任务，释放主请求资源。\n\n## 故障排除\n\n### V2 故障排除\n\n```bash\n# 检查 MCP 服务器是否运行\ntail -f \u002Ftmp\u002Freview_gate_v2.log\n\n# 测试语音录制功能\nsox --version\nsox -d -r 16000 -c 1 test.wav trim 0 3 && rm test.wav\n\n# 查看 Cursor 中的扩展日志\n# 按 F12 打开开发者工具 → Console 标签页查看浏览器日志\n\n# 验证 MCP 配置\ncat ~\u002F.cursor\u002Fmcp.json\n\n# 手动测试扩展\n# 在 Cursor 中按 Cmd+Shift+R\n```\n\n\n## 温馨提示！（友好提醒）\n\n* **实验性升级！** 这是我为高级用户设计的 V2 版本。它之所以有效，是因为我们巧妙地利用了 MCP 集成来指导 AI 行为。\n* **MCP 服务器本地运行**：该规则依赖于本地运行的 MCP 服务器与 Cursor 集成。安装程序会自动完成相关配置。\n* **语音处理本地化**：您的语音将由本地 Faster-Whisper AI 处理，不会上传至云端。\n* **平台兼容性**：\n  - **macOS**：主要开发平台，具备自动化覆盖；原生安装程序和实时 Cursor 验证仍会持续跟踪检查\n  - **Windows**：已实现并支持，但原生 Shell 烟雾环境仍可能存在差异\n  - **Linux**：支持路径，但实战经验不如 macOS 丰富\n* **需安装 Python 和 SoX**：安装程序会自动处理这些依赖项，但您的系统必须支持 Python 3 和 SoX 才能正常使用语音功能。\n* **Cursor 更新可能影响功能**：未来 Cursor 的版本更新可能会改变此规则的行为。今天可用的方法，明天可能需要调整！\n* **务必记住规则**：MCP 服务器只是引擎，您必须将 V2 规则复制到 Cursor 设置中，才能实现自动激活！\n\n## 为什么是V2？你们要求的！\n\n在最初的 Review Gate 获得 **100 多次 Fork**、**100 多颗星**、**10 万多次曝光**，以及无数希望进一步升级的请求之后——**你们提出了需求，我就实现了！** 社区的反馈非常热烈，大家对语音命令、视觉上下文和更复杂界面的需求更是势不可挡。V2 就是我对每一条功能请求和改进建议的回应。\n\n## 关于我与这次进化\n\n这款“Review Gate V2”是我将最初的终端规则演进为一个功能齐全、多模态交互系统的成果。它源于我自身的一个愿望：不仅通过文本，更要借助语音命令和视觉上下文，真正与 Cursor 的 AI 形成默契搭档。我的目标始终如一：让每一次交互都尽可能深入、完整，确保每一个可用于实现宏大构想的工具调用都能充分展现其价值，使那大约 500 条请求每一项都像黄金般珍贵！\n\nV2 系统利用模型上下文协议（MCP），在 Cursor 的 AI 与丰富、交互式的弹出界面之间架起一座无缝桥梁。无论你是发出语音指令、分享截图，还是输入后续内容，这一切都旨在让你保持流畅的工作状态，同时最大化每次 Cursor 请求的价值。\n\n如需联系我或了解更多关于我的工作，请访问：[www.audienclature.com](https:\u002F\u002Fwww.audienclature.com)\n\n---\n\n*祝你使用 Cursor 编程愉快且效率倍增！愿你的 AI 始终静候你的最终指令，你的语音被清晰转录，你的图像被完美理解，而你每月的请求额度仿佛永远用不完！*","# Review-Gate 快速上手指南\n\nReview-Gate 是一款专为 Cursor IDE 设计的增强工具，旨在解决 AI 过早结束复杂任务的问题。通过引入交互式弹窗、语音指令和图像上传功能，它允许你在**单次请求生命周期内**进行多轮迭代，从而大幅提升 Cursor 每月请求配额的使用效率。\n\n## 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n*   **操作系统**: macOS, Windows, 或 Linux\n*   **核心软件**: \n    *   [Cursor IDE](https:\u002F\u002Fcursor.sh\u002F) (已安装)\n    *   Git\n    *   Python 3.x\n*   **前置依赖**:\n    *   **macOS**: 建议安装 Homebrew (用于管理 SoX 等音频依赖)\n    *   **Windows**: 建议安装 Chocolatey 或直接运行提供的 PowerShell 脚本（会自动处理依赖）\n    *   **Linux**: 需确保系统已安装 `sox` 及相关音频库\n*   **网络提示**: 由于涉及 GitHub 仓库克隆及可能的模型下载，国内用户建议配置好网络加速环境或使用镜像源。\n\n## 安装步骤\n\nReview-Gate V2 版本推荐使用 MCP (Model Context Protocol) 集成方式，支持一键安装。\n\n### 1. 克隆仓库并运行安装脚本\n\n打开终端（macOS\u002FLinux）或 PowerShell（Windows），执行以下命令：\n\n**macOS \u002F Linux:**\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate.git\ncd Review-Gate\u002FV2\n.\u002Finstall.sh\n```\n\n**Windows:**\n```powershell\ngit clone https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate.git\ncd Review-Gate\\V2\n.\\install.ps1\n```\n\n> **注意**: Windows 用户可能需要以管理员身份运行 PowerShell。安装脚本将自动处理 Python 包、SoX 音频工具、MCP 服务器配置以及 Cursor 扩展的安装。\n\n### 2. 配置 Cursor 规则 (关键步骤)\n\n安装脚本完成后，必须手动将规则配置添加到 Cursor 中才能生效：\n\n1.  找到项目目录下的 `V2\u002FReviewGateV2.mdc` 文件，复制其**全部内容**。\n2.  打开 Cursor IDE，进入设置 (`Cmd\u002FCtrl + ,`)。\n3.  找到 **\"Rules\"** (或 \"AI Rules\") 部分。\n4.  将复制的内容粘贴进去并保存。\n5.  **重启 Cursor** 以使规则和扩展完全生效。\n\n> **提示**: 如果你手动编辑过 `~\u002F.cursor\u002Fmcp.json`，请确保保留原有的 MCP 配置，仅合并添加 `review-gate-v2` 相关条目，不要直接覆盖整个文件。\n\n### 3. 验证安装\n\n重启 Cursor 后，可以通过以下方式测试：\n*   **手动测试**: 按下 `Cmd+Shift+R` (Mac) 或 `Ctrl+Shift+R` (Win\u002FLinux)，查看是否弹出带有橙色光晕的 Review-Gate 界面。\n*   **语音测试**: 点击弹窗中的麦克风图标说话，检查是否能自动转录为文字。\n\n## 基本使用\n\n安装完成后，Review-Gate 将自动介入你的复杂任务流程。\n\n### 场景示例：多轮迭代开发\n\n1.  **发起主任务**:\n    在 Cursor 聊天框中输入一个复杂的需求，例如：\n    > \"帮我创建一个基于 FastAPI 的用户认证模块，包含注册、登录和 JWT 令牌刷新功能。\"\n\n2.  **自动触发**:\n    当 Cursor 完成初步代码生成后，Review-Gate 会自动拦截并弹出一个交互窗口，提示等待你的进一步指令。\n\n3.  **多模态反馈 (在弹窗中操作)**:\n    *   **文本指令**: 输入 `\"现在给所有新函数添加详细的 docstrings\"` 或 `\"重构数据库连接部分以支持异步\"`。\n    *   **语音指令**: 点击麦克风 🎙️，直接说 *\"把错误处理逻辑改成统一的全局异常处理器\"*，系统将自动转录并发送给 AI。\n    *   **图像上下文**: 点击相机图标 📷，上传一张架构草图或报错截图，AI 将结合图片内容继续工作。\n\n4.  **循环迭代**:\n    AI 会根据你的新指令继续调用工具（消耗的是**当前请求**剩余的 Tool Calls 额度，而非新的月度配额），完成后弹窗会再次出现等待下一步指示。\n\n5.  **结束任务**:\n    当你对结果满意时，在弹窗输入框中输入：\n    ```text\n    TASK_COMPLETE\n    ```\n    此时，整个工作流程正式结束，释放主请求。\n\n### 核心价值\n通过这种方式，你可以用 **1 次** 月度请求配额，完成原本需要 **5-10 次** 独立对话才能完成的迭代开发任务，充分利用了单次请求中约 25 次的工具调用上限。","前端开发者小李正在利用 Cursor IDE 重构一个复杂的电商后台仪表盘，需要同时处理数据可视化组件、API 接口联调及响应式布局优化。\n\n### 没有 Review-Gate 时\n- **请求额度快速耗尽**：每完成一个子任务（如“修复图表渲染”），AI 就自动结束对话；若要微调样式或补充逻辑，必须发起新请求，导致每月 500 次的额度在半天内告急。\n- **上下文频繁断裂**：每次新开请求都需重新粘贴代码片段或复述背景信息，AI 难以记住上一轮的修改细节，导致重复劳动。\n- **多模态交互缺失**：发现 UI 错位时，只能文字描述“左边距太大”，无法直接截图上传，沟通效率极低且容易产生歧义。\n- **工具调用不充分**：Cursor 往往在仅使用了少量工具调用次数后就“过早收工”，未能深度挖掘单次请求的潜力去解决连锁问题。\n\n### 使用 Review-Gate 后\n- **单次请求价值倍增**：小李发起一次主请求后，通过 Review-Gate 的弹窗连续下达 5 次迭代指令（如“调整颜色”、“增加加载动画”、“适配移动端”），将原本需 5 次请求的工作压缩在 1 次内完成，额度利用率提升 5 倍。\n- **无缝持续迭代**：AI 在弹窗中等待指令，完美保留完整的上下文记忆，无需重复背景介绍，直接基于最新代码状态进行深度优化。\n- **语音与图像直达**：遇到布局问题，小李直接点击麦克风口述需求，或拖入设计稿截图，Review-Gate 立即调用本地 Whisper 转录并让 AI 识图修改，实现“所见即所得”的开发流。\n- **掌控对话节奏**：AI 不再擅自结束任务，而是直到小李在弹窗中确认“完成”才停止，确保复杂功能被彻底打磨到位，充分榨干单次请求的工具调用预算。\n\nReview-Gate 将 Cursor 从“短跑选手”转变为“耐力马拉松运动员”，让开发者在单次请求生命周期内实现深度、多模态的迭代开发，极大节省了昂贵的请求额度。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FLakshmanTurlapati_Review-Gate_5b293a37.png","LakshmanTurlapati","Lakshman Turlapati","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FLakshmanTurlapati_35164df4.jpg","Debugging.","InfiniteChoice","Texas",null,"parzival1213","https:\u002F\u002Fwww.parzival.live","https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati",[83,87,91,95,99],{"name":84,"color":85,"percentage":86},"JavaScript","#f1e05a",41.4,{"name":88,"color":89,"percentage":90},"Python","#3572A5",38.8,{"name":92,"color":93,"percentage":94},"PowerShell","#012456",7.8,{"name":96,"color":97,"percentage":98},"Batchfile","#C1F12E",6.1,{"name":100,"color":101,"percentage":102},"Shell","#89e051",5.9,1543,162,"2026-04-13T08:40:50","macOS, Windows, Linux","未说明 (语音识别使用本地 Faster-Whisper AI，未明确强制要求独立 GPU，但本地运行 Whisper 通常建议有 GPU 加速)","未说明",{"notes":110,"python":111,"dependencies":112},"该工具是 Cursor IDE 的插件和 MCP 服务。安装需通过提供的 shell\u002FPowerShell 脚本自动配置依赖（包括 SoX 用于语音、Python 包等）。核心功能包括本地运行的 Faster-Whisper 语音转文字、多模态输入（图片上传）以及自定义的 Cursor 扩展（.vsix 文件）。需手动将规则文件 (ReviewGateV2.mdc) 复制到 Cursor 设置中才能生效。","未说明 (安装脚本会自动处理 Python 包依赖)",[113,114,115,116],"Faster-Whisper","SoX","Node.js\u002Fnpm (用于扩展打包)","MCP Server",[118,15,14,13],"视频",[120,121,122,123],"ai","claude","cursor","ide","2026-03-27T02:49:30.150509","2026-04-14T00:02:54.188243",[127,132,137,142,147,152],{"id":128,"question_zh":129,"answer_zh":130,"source_url":131},32174,"为什么在 MacBook Pro M4 或 Windows 上发送请求后 Agent 会卡住或弹窗无法打开？","此问题已在最新更新中修复。扩展现在使用经过认证的触发证明来验证 MCP 服务器是否在主动运行，从而防止卡死循环。会话路由也已重新设计以绑定到正确的进程。对于 Windows 用户，安装程序已大幅重构，解决了扩展激活和快捷键注册问题。请卸载旧版本并执行全新安装（fresh install）最新代码即可解决。","https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate\u002Fissues\u002F39",{"id":133,"question_zh":134,"answer_zh":135,"source_url":136},32175,"Windows 上插件无法自动调用或快捷键 (Ctrl+Shift+R) 无效怎么办？","该问题已通过更新修复。Windows 安装程序经过了重大重构，包含了规范的发布元数据、一致的文件路径和更好的错误提示。扩展激活和快捷键注册现在应在干净安装后正常工作。如果遇到问题，请尝试完全卸载后重新安装最新版本。","https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate\u002Fissues\u002F48",{"id":138,"question_zh":139,"answer_zh":140,"source_url":141},32176,"为什么在 Windows 上只安装了一个工具，或者模型消息不在扩展中显示？","这两个问题均已在最新更新中解决。安装脚本已重新编写以正确处理发布元数据，修复了工具在 Windows 上未正确注册的问题。同时，弹窗渲染已完全重写，使用了安全的 DOM 构建和适当的内容安全策略，修复了 MCP 工具调用消息无法在 Windows Webview 中显示的问题。解决方案是拉取最新代码并执行全新安装。","https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate\u002Fissues\u002F54",{"id":143,"question_zh":144,"answer_zh":145,"source_url":146},32177,"遇到 Windows 上的聊天中断问题或 MCP 服务器在提交请求后无反应怎么办？","维护者表示该问题对其他用户已修复，如果遇到此情况，请务必先卸载扩展然后重新安装。如果问题依旧，可以尝试回退到 v1 版本。部分用户反馈最新版本的 MCP 服务器可能在 15 秒后停止，这通常需要通过重新安装来解决。","https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate\u002Fissues\u002F24",{"id":148,"question_zh":149,"answer_zh":150,"source_url":151},32178,"使用规则时 Cursor 为何在执行子任务后立即停止而不是循环进入 Stage 3？","这通常是因为 AI 同时接收到了操作命令和退出命令（如 'q'）。正确的行为逻辑应调整为：当同时收到下一个操作命令和退出命令时，仅执行操作命令，然后重启终端运行脚本以进入循环状态；只有当仅收到退出命令时，才视为任务完成。用户需要根据此逻辑调整规则配置。","https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate\u002Fissues\u002F2",{"id":153,"question_zh":154,"answer_zh":155,"source_url":156},32179,"MCP 服务器在发送消息后立即变为非活动状态或不一致怎么办？","这是一个已知的一致性问题，尤其在某些机器上表现明显。虽然维护者提到由于 Cursor 推出了无限请求功能而减少了对此项目的维护，但针对此类“卡死”或“非活动”问题，最有效的通用解决方案是确保使用最新代码进行全新安装，以应用最新的会话路由和认证触发修复。如果问题持续，可能需要检查是否与特定模型（如 Claude 模型）的兼容性有关。","https:\u002F\u002Fgithub.com\u002FLakshmanTurlapati\u002FReview-Gate\u002Fissues\u002F27",[158,163,168,173,178],{"id":159,"version":160,"summary_zh":161,"released_at":162},241822,"v2.7.3","# 版本 2.7.3\n\n## 新增\n- GitHub Actions 工作流，用于验证发布清单、运行发布范围回归测试套件、构建 VSIX，并将打包好的扩展作为工作流产物上传\n- 可移植的打包封装层，使 `npm run package` 在仅暴露 `python3` 而未提供 `python` 别名的环境中也能正常工作\n\n## 改进\n- 现在通过一份由文档、安装程序、测试和 CI 共享的基于清单的契约来验证规范的发布打包流程\n- 公开发布的分发现在以 V2 扩展的单一受支持 VSIX 产物为核心\n\n## 更新\n- 重新构建并发布了 `review-gate-v2-2.7.3.vsix`，作为规范的扩展包\n- 更新了 README 中的维护者指南，以说明 CI 构建流程和规范产物路径，同时不改变最终用户的安装步骤\n\n## 变更\n- 发布自动化现将 `V2\u002Freview-gate-v2-2.7.3.vsix` 视为唯一受支持的打包产物\n- `V2\u002Fcursor-extension` 包脚本现通过 Node 封装层进行委托调用，以确保本地和 CI 环境中的打包行为保持一致","2026-04-02T23:42:17",{"id":164,"version":165,"summary_zh":166,"released_at":167},241823,"v2.1.3","# 版本 2.1.3\n\n## 新增功能\n- 可直接从剪贴板将图片粘贴到 Review Gate 弹出窗口中\n- 支持拖放上传图片，进一步提升工作流效率\n- 在发送消息前可移除单个图片\n\n## 优化\n- 对所有图片操作（粘贴、拖放、移除）进行详细日志记录，便于排查问题\n\n## 更新\n- 发布 review-gate-v2-2.7.0.vsix；移除旧版 2.6.x VSIX 文件\n\n## 变更\n- 扩展文件 extension.js 增加了 297 行代码，以实现新的剪贴板、拖放及图片管理功能","2025-06-22T20:02:10",{"id":169,"version":170,"summary_zh":171,"released_at":172},241824,"v2.1.2","### v2.1.2 - 修复 MCP 配置 JSON 解析问题\n- **安装错误**：修复了合并现有 MCP 配置时出现的“未结束的字符串字面量”错误。\n- **根本原因**：包含引号、换行符或特殊字符的 JSON 在 Shell 中展开时，会导致 Python 解析失败。\n- **技术解决方案**：\n  - 将现有 MCP 服务器配置写入临时文件，而非直接通过 Shell 变量展开。\n  - Python 从文件中读取 JSON，从而避免 Shell 解释带来的问题。\n  - 处理完成后自动清理临时文件。\n- **影响范围**：拥有现有 MCP 配置的用户现在可以重新安装，而不会遇到语法错误。\n- **平台说明**：仅 `install.sh` 脚本（适用于 macOS 和 Linux）受到影响；Windows 安装程序早已采用安全的方法。","2025-06-11T17:09:13",{"id":174,"version":175,"summary_zh":176,"released_at":177},241825,"v2.1.1","- 完整的语音转文本实现，集成 SoX\n- 修复了图标状态管理和对齐相关的 UI 问题\n- 统一标题显示规范\n- 移除 node-mic-record 依赖\n- 增强了错误处理与恢复机制","2025-06-10T19:44:20",{"id":179,"version":180,"summary_zh":78,"released_at":181},241826,"v2.0.0","2025-06-08T12:04:23"]