AI Code Reviewer

# AI Code Reviewer

AI 驱动的代码审查工具。自动分析代码质量、发现潜在 bug、生成 PR 描述、建议测试用例。支持多种编程语言。

触发词

核心功能

1. 代码质量分析

2. 智能 PR 描述生成

输入：Git diff 或代码变更
↓
AI 分析:
- 变更摘要
- 影响范围
- 测试建议
- 注意事项
↓
输出：完整的 PR 描述 (Markdown)

3. 测试用例生成

4. 多语言支持

| 语言 | 支持程度 | 框架 |

|------|---------|------|

| JavaScript/TypeScript | ✅ 完整 | ESLint, Jest |

| Python | ✅ 完整 | Pylint, Pytest |

| Java | ✅ 完整 | Checkstyle, JUnit |

| Go | ✅ 完整 | gofmt, go test |

| Rust | ✅ 完整 | clippy, cargo test |

| PHP | ✅ 完整 | PHPCS, PHPUnit |

配置说明

环境变量

# OpenRouter API (已有)
OPENROUTER_API_KEY=sk-or-v1-xxxxx

# GitHub Token (可选，用于自动 PR)
GITHUB_TOKEN=ghp_xxxxx

# 代码审查规则 (可选)
CODE_REVIEW_STRICTNESS=medium  # low/medium/high
ENABLE_SECURITY_CHECK=true
ENABLE_PERFORMANCE_CHECK=true

本地配置

在 `TOOLS.md` 中添加:

### AI Code Reviewer 配置

- 默认审查严格度：medium
- 自动修复建议：是
- 生成测试用例：是
- 支持语言：JS/TS, Python, Java, Go, Rust, PHP

使用示例

基础用法

审查这段代码

指定语言

用 Python 审查这段代码

生成 PR 描述

为这个变更生成 PR 描述

生成测试

为这个函数生成单元测试

完整审查

完整审查：检查代码质量 + 生成 PR 描述 + 生成测试

输出格式

代码审查报告

🔍 AI 代码审查报告

📁 文件：src/utils/validator.js
📊 评分：85/100 (良好)

✅ 优点:
• 函数命名清晰
• 注释完整
• 错误处理得当

⚠️ 需要改进 (3 个):
1. [性能] 第 23 行：循环内重复计算，建议提取到循环外
   建议：const limit = items.length; for (let i = 0; i < limit; i++)

2. [安全] 第 45 行：用户输入未验证，存在注入风险
   建议：添加 sanitizeInput() 验证

3. [风格] 第 67 行：函数过长 (80 行)，建议拆分
   建议：拆分为 validateUser() 和 validatePermissions()

🧪 测试建议:
• 添加边界条件测试 (空数组、null、undefined)
• 添加异常输入测试
• 覆盖率目标：80%

📝 自动修复：需要我帮你修复这些问题吗？[是/否/查看建议]

PR 描述

## 🎯 变更摘要

实现了用户权限验证功能，包括角色检查和权限过滤。

## 📝 详细说明

- 新增 `validatePermissions()` 函数
- 优化了循环性能 (减少重复计算)
- 添加了输入验证防止注入攻击

## 🧪 测试

- [x] 单元测试已添加
- [x] 边界条件测试通过
- [ ] 集成测试待完成

## ⚠️ 注意事项

- 需要更新数据库迁移脚本
- 向后兼容，无需手动迁移

## 📋 检查清单

- [x] 代码审查通过
- [x] 测试覆盖率 > 80%
- [x] 文档已更新

测试用例

// 生成的测试用例
describe('validatePermissions', () => {
  test('应该允许管理员访问所有资源', () => {
    const user = { role: 'admin' };
    expect(validatePermissions(user, 'any')).toBe(true);
  });

  test('应该拒绝未授权用户访问', () => {
    const user = { role: 'guest' };
    expect(validatePermissions(user, 'admin-only')).toBe(false);
  });

  test('应该处理空用户对象', () => {
    expect(() => validatePermissions(null, 'resource'))
      .toThrow('Invalid user object');
  });

  test('应该处理边界条件：空权限列表', () => {
    const user = { role: 'user', permissions: [] };
    expect(validatePermissions(user, 'resource')).toBe(false);
  });
});

错误处理

| 错误 | 原因 | 解决方案 |

|------|------|---------|

| 语言不支持 | 非支持语言 | 提示支持的语言列表 |

| 代码过短 | 无法分析 | 建议提供完整函数/类 |

| API 限流 | 请求过多 | 自动重试 + 排队 |

| 语法错误 | 代码不完整 | 提示具体错误位置 |

定价策略

| 版本 | 价格 | 功能 |

|------|------|------|

| 免费版 | $0 | 每日 5 次审查，基础检查 |

| 专业版 | $24.99/月 | 无限审查，PR 生成，测试生成 |

| 团队版 | $79.99/月 | 团队协作，CI/CD 集成，自定义规则 |

开发优先级

依赖技能

更新日志

v0.1.0 (2026-03-14)