ouldmiloudzaki/ai-code-reviewer
GitHub: ouldmiloudzaki/ai-code-reviewer
基于 Groq LLM 和 FastAPI 的 AI 代码审查工具，能快速检测代码中的 bug、安全问题和改进空间并按严重程度排名。
Stars: 0 | Forks: 0
# AI 代码审查器 🔍
粘贴你的代码，即可获得即时的 **AI 驱动审查** —— 包括 bug、安全
问题、性能缺陷以及改进建议，并按严重程度进行排名，
附带代码质量评分。
本项目使用 **FastAPI** 后端构建，将代码发送至 **Groq** 托管的 LLM 并
返回结构化的审查结果，渲染在一个简洁、零依赖的仪表板中。
## 功能
- **即时审查** —— 粘贴代码，几秒钟内即可获取结果。
- **严重程度排名** —— 严重 / 警告 / 建议，带有颜色区分。
- **质量评分** —— 0–100 的整体评估以及简短摘要。
- **语言自动检测**（也可手动选择）。
- **Demo 模式** —— 即使没有 API key，也可以使用示例输出运行，让你
能够立即体验 UI。
- **零前端依赖** —— 单个独立的 HTML 文件（原生
JS），无需 CDN 或构建步骤。
## 技术栈
| 层级 | 技术 |
|----------|---------------------------------------|
| 后端 | Python, FastAPI |
| AI / LLM | Groq (Llama 3.3 70B), JSON mode |
| 前端 | 原生 JS, HTML/CSS (零依赖) |
## 运行方式
### 快速开始 (Windows)
```
./start.ps1
```
然后打开 **http://127.0.0.1:8000**。
### 添加你的 Groq key（用于真实审查）
1. 在 https://console.groq.com/keys 获取免费的 key
2. 将 `backend/.env.example` 复制为 `backend/.env`
3. 设置 `GROQ_API_KEY=your_key_here`
4. 重启服务器。
如果没有 key，应用将在 **Demo 模式**下运行（示例输出）。
### 手动运行
```
cd backend
python -m venv .venv
.venv\Scripts\activate # Windows
pip install -r requirements.txt
uvicorn app:app --reload
```
## 工作原理
1. 前端将你的代码 POST 到 `/api/review`。
2. 后端提示 Groq LLM 使用模型的 JSON 输出模式返回严格的 JSON 审查结果
（`backend/reviewer.py`）。
3. 响应（评分、摘要和发现的问题）将使用颜色区分的
严重程度标签进行渲染。
由 **Zakaria Ould Miloud** 开发 —— 计算机科学硕士 2 年级（AI 与 IoT）。
标签：AI代码审查, AV绕过, FastAPI, 后端开发, 数据可视化, 调试辅助, 逆向工具, 错误基检测, 静态代码分析