# x-review

**Repository Path**: luodeb/x-review

## Basic Information

- **Project Name**: x-review
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-01
- **Last Updated**: 2026-07-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# x-review

[NO VERSION]

基于 AI 的自动化代码评审工具，专门设计用于集成 Gitee（码云）平台。

## 项目简介

x-review 是一个用 Rust 编写的 AI 驱动代码评审工具，通过集成人工智能能力来自动化 Pull Request 代码审查流程。该工具支持 Gitee、Gitea 等代码托管平台，可以全自动分析代码变更、识别潜在问题，并生成专业的评审意见。

### 核心特性

- **多维度代码审查**：支持 Bug 检查、逻辑分析、性能评估、规范审核等多种审查维度
- **AI 智能分析**：集成 OpenAI 和 Trae 大语言模型，提供智能代码审查能力
- **Gitee 深度集成**：无缝对接 Gitee 平台的 PR、Issue、评论等功能
- **灵活的工具系统**：提供文件读取、内容搜索、Man page 获取等丰富的辅助工具
- **可配置的审查流程**：支持自定义审查阶段和提示词模板

## 功能架构

### 审查阶段（Stages）

项目实现了模块化的审查管道，支持以下审查维度：

| 审查阶段 | 说明 |
|---------|------|
| BugStage | 代码缺陷和潜在 BUG 检测 |
| LogicStage | 业务逻辑正确性分析 |
| PerformanceStage | 性能和算法效率评估 |
| DescriptionStage | PR 描述和变更说明审核 |
| GuidelinesStage | 编码规范和最佳实践检查 |
| PosixStage | POSIX API 使用规范检查 |

### 工具系统（Tools）

- **ReadFileTool**：读取仓库文件内容
- **SearchContentTool**：正则表达式搜索代码内容
- **SearchFilesTool**：按模式搜索文件
- **ListDirTool**：目录结构浏览
- **FetchManPageTool**：获取 Linux/POSIX API 文档
- **SearchCratesTool**：搜索crates.iocrate 依赖信息

### Git Provider 工具

- GetPullDetail：获取 PR 详情
- GetPullDescription：获取 PR 描述
- GetDiffFiles：获取变更文件列表
- GetAnnotatedDiff：获取带注释的 Diff
- PostComment：发布评审评论
- PostInlineComment：发布行内评论
- UpdatePull：更新 PR 状态

## 配置说明

### 环境变量配置

项目通过 `configuration.toml` 文件进行配置，主要配置项包括：

```toml
# AI 模型配置
[ai]
model = "gpt-4"
temperature = 0.7
max_tokens = 4096

# Gitee 配置
[gitee]
owner = ""
repo = ""
pr_number = 0
token = ""  # 可选，用于私有仓库

# Trae 配置（如使用）
[trae]
enabled = false
app_id = ""
```

## 安装和使用

### 从源码构建

```bash
# 克隆项目
git clone https://gitee.com/luodeb/x-review.git
cd x-review

# 构建项目
cargo build --release

# 运行评审
./target