用途
Selvage（官网 https://github.com/selvage-lab/selvage）是一款 AI 驱动的代码审查自动化工具，以现代 CLI 形式提供。它帮助 AI 分析 Git 差异，以发现代码质量问题、潜在 bug 和安全漏洞，无需人工等待审查即可获得即时反馈。
主要能力
- 多模型支持：通过 OpenRouter 一个 API 密钥即可使用多种 LLM，包括 OpenAI GPT-5、Anthropic Claude Sonnet-4、Google Gemini 以及来自 MiniMax、Zhipu AI、Qwen、Moonshot AI、DeepSeek 等提供的模型；也提供免费层模型。
- 智能上下文分析（AST）：基于 Tree-sitter 进行 AST 分析，自动提取包含更改行的最小代码块及其依赖语句（如 import），仅发送必要上下文，减少 token 消耗并保持审查质量。
- Git 工作流集成：支持分析已暂存、未暂存以及指定提交/分支之间的变更。
- 自动多轮处理：当上下文超出模型限制时自动拆分提示，当总 token 超过约 200k 时自动触发 Large Context Mode，稳定支持大规模代码审查。
- MCP 模式：可在 Cursor、Claude Code 等工具中注册为 MCP 模式，通过自然语言请求审查。
- Claude Code 插件：通过市场一条命令安装，包含专用 /review 技能和 selvage-reviewer 代理，无需 API 密钥即可利用 Claude Code 自身 LLM 完成审查。
- 代理委托审查（get_review_context）：返回结构化审查上下文（diff + Smart Context + 系统提示），供宿主代理（如 Claude Code、Cursor、Antigravity）用自己的 LLM 执行审查，无需 Selvage API 密钥。
- 结果存储：审查结果同时输出到终端并自动保存为 Markdown 和 JSON 文件，方便阅读或程序化集成。
- 开源许可：采用 Apache-2.0 许可证，允许商业使用、修改和分发。
使用方式
安装
- 推荐方式：使用 uv
- 备选方式：使用 pipx
- 传统方式：使用 pip（macOS/Linux 用户若遇到 pip 安装错误，建议使用 uv 或 pipx）
安装后需从 OpenRouter 获取 API 密钥并进行设置。
MCP 模式（推荐） 在 Cursor、Claude Code 等工具的 MCP 配置文件中注册（如 Cursor 常见路径 ~/.cursor/mcp.json），然后在 IDE 中通过自然语言请求审查。
Claude Code 插件 从插件市场安装后可直接使用 /review 技能，无需外部 API 密钥，插件通过 get_review_context 利用 Claude Code 自身 LLM 完成审查。
CLI 用法 提供多种命令行参数：
--repo-path <path>：Git 仓库路径（默认当前目录）--staged：仅审查已暂存变更--target-commit <commit_id>：审查从指定提交到 HEAD 的变更--target-branch <branch_name>：审查当前分支与指定分支之间的变更--model <model_name>：指定使用的 AI 模型（如 claude-sonnet-4-thinking）--open-ui：审查完成后自动启动 UI--no-print：不向终端输出结果（默认输出）--skip-cache：跳过缓存执行新审查
Web UI 审查结果输出到终端并保存文件，同时可通过 Web UI 进行审查管理和重新查看。UI 功能包括显示所有审查结果列表、Markdown 格式展示、JSON 结构化结果视图。
适用场景
- 开发者在提交代码前快速获得 AI 代码质量反馈
- 在 CI/CD 流程中集成自动化审查
- 对大型代码库进行稳定的大规模审查
- 通过 MCP 模式在 IDE 内以自然语言请求审查
- 多模型对比审查与逐步代码改进工作流
限制
- 需从 OpenRouter 获取 API 密钥（Claude Code 插件模式除外，该模式利用宿主自身 LLM）。
- 使用 CLI 需本地已安装 Git 并配置仓库。
- 具体收费、价格及免费额度细节暂未提供明确说明。
- 支持的语言列表、模型上下文长度等具体数值请参考官方文档；Smart Context 支持的语言正在持续扩展。
