ETRX AI CodeReview

AI 驱动的 Git 提交代码审查工具，支持可配置的提示词和多种 AI 模型。

功能特性

• 一键 AI 代码审查
• 支持多种 AI 模型（Ollama 和 OpenRouter）
• 可配置的提示词模板
• 详细的 Markdown 报告
• 多仓库支持
• 新增：支持从外部 Markdown 文件加载提示词模板

环境要求

• VS Code 1.90+
• Git
• 以下任一选项：
  • Ollama 及本地模型（默认：qwen3:8b）
  • OpenRouter API 密钥

安装方法

1. 从 VS Code 扩展市场安装扩展
2. 在扩展设置中配置 AI 模型
3. 使用 git add 暂存代码变更
4. 点击源代码控制面板中的 "ETRX AI CodeReview" 按钮

配置说明

扩展可以通过 VS Code 设置进行配置：

1. 打开 VS Code 设置（Ctrl+, 或 Cmd+,）
2. 搜索 "ETRX AI Code Review"

AI 模型配置

• Model Provider：选择 Ollama（本地）或 OpenRouter（云端）
• Ollama URL：本地 Ollama 服务器地址（默认：http://192.168.66.181:11434）
• Ollama Model：Ollama 使用的模型名称（默认：qwen3:8b）
• OpenRouter API Key：OpenRouter API 密钥（使用 OpenRouter 时必填）
• OpenRouter Model：OpenRouter 使用的模型名称（默认：moonshotai/kimi-k2:free）

提示词模板配置

• Prompt Templates：直接在设置中定义自定义提示词模板
• Template Directory：新增 包含外部提示词模板文件的目录路径（Markdown 或 TXT）
• Default Template：默认使用的模板名称
• Response Language：AI 回复语言（自动、中文或英文）

输出配置

• Output Path：审查结果保存目录（默认：./.ai-codereview）

使用外部提示词模板

为了更方便地管理长提示词，现在可以从外部 Markdown 或 TXT 文件加载模板：

1. 创建一个目录来存储模板文件（例如：~/.etrx-ai-codereview/etrx-ai-templates）
2. 在该目录中创建 .md 或 .txt 扩展名的模板文件
3. 每个文件应包含带 {diff} 占位符的提示词模板
4. 在 "Template Directory" 设置中配置模板目录路径
5. 扩展会自动加载该目录中的所有模板
6. 模板名称为不带扩展名的文件名

示例：

• 文件：~/.etrx-ai-codereview/etrx-ai-templates/security-review.md
• 模板名称：security-review

插件在首次激活时会自动在用户目录下创建默认的提示词模板文件，用户可以直接修改这些文件来定制自己的审查模板。

使用方法

1. 修改代码
2. 使用 git add 暂存变更
3. 点击源代码控制面板中的 "ETRX AI CodeReview" 按钮
4. 如果配置了多个模板，选择一个提示词模板
5. 等待 AI 分析代码
6. 在编辑器中查看生成的报告

命令

• ETRX AI CodeReview：对暂存的变更进行代码审查
• Open Settings：打开扩展设置

多仓库支持

扩展会自动检测多仓库工作区，并审查所有包含暂存变更的仓库。

已知问题

• "No staged changes found"：确保使用 git add 暂存了变更
• Ollama 连接失败：检查 Ollama 是否运行及模型是否已安装
• OpenRouter API 错误：检查 API 密钥和账户余额
• Git 命令失败：确保项目是 git 仓库且 git 配置正确

版本更新记录

查看 CHANGELOG.md 了解版本更新详情。