AI 驱动的代码审查与改进助手

## 功能概述
AI 驱动的代码审查与改进助手基于大规模训练的语言模型与静态分析技术，能够在数秒内完成对代码的全方位检查。它主要实现以下功能：

1. **缺陷检测**：捕捉潜在的空指针、数组越界、资源泄漏、并发竞态等运行时错误。
2. **安全漏洞识别**：检查 SQL 注入、XSS、硬编码凭证、不安全加密等常见安全问题。
3. **代码风格与规范**：依据团队或语言官方的编码规范，提供命名、缩进、注释、导入顺序等优化建议。
4. **性能与最佳实践**：指出不必要的循环、低效的算法、未使用的变量或函数，以及对并发框架的错误使用。
5. **改进建议**：为每一条发现提供具体的修复代码片段、参考链接或重构思路，帮助开发者快速落地。

## 适用场景
- **Pull Request 前置检查**：在代码合并前自动触发审查，防止带缺陷的代码进入主干。
- **持续集成（CI）流水线**：在构建阶段调用审查服务，快速获得质量报告并决定是否中止构建。
- **代码重构阶段**：针对老旧模块进行全局审查，识别技术债务并制定重构计划。
- **新人代码评审**：帮助新人快速了解团队编码规范，降低人工评审负担。

## 调用步骤
1. **准备代码**
   - 通过 Git webhook 拉取 diff；
   - 或者直接在 UI 中粘贴完整文件/代码段。
2. **发起审查请求**
   ```bash
   curl -X POST https://api.example.com/v1/code-review \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "language": "python",
           "source": "def foo():\n    pass",
           "options": {"strict": true}
         }'
   ```
   - `language` 指定源码语言；`source` 为 Base64 编码或原始字符串；`options.strict` 控制是否启用严格模式。
3. **接收审查结果**（JSON 格式）
   ```json
   {
     "summary": {"critical": 1, "warning": 3, "info": 5},
     "issues": [
       {
         "id": "A001",
         "severity": "critical",
         "category": "security",
         "message": "检测到硬编码密码",
         "location": {"file": "config.py", "line": 12},
         "suggestion": "使用环境变量或密钥管理服务"
       }
     ]
   }
   ```
4. **根据建议修改代码**
   - 使用返回的 `suggestion` 进行局部修改；
   - 若涉及安全类问题，建议先在本地复现并通过单元测试验证。
5. **重新审查（可选）**
   - 提交改动后再次调用审查接口，确认问题已消除。

## 注意事项
- **敏感信息脱敏**：在上送代码前务必移除或替换密钥、token、个人身份信息等敏感数据，防止泄露。
- **审查结果仅供参考**：AI 模型基于统计学习生成建议，误报或漏报不可避免，最终决策仍需人工判断。
- **语言与框架适配**：不同语言或框架需要提供相应的上下文（如项目结构、依赖版本），否则审查质量可能下降。
- **并发限制**：大多数审查服务对单账号并发请求有限制，请遵守 API 的 QPS（每秒请求数）约束。
- **结果保存**：建议将审查报告持久化到内部日志系统，便于后期回溯与趋势分析。

## 示例
以下是一次完整的审查流程示例（Python 示例）：

```python
import requests, base64

def review_code(source_code, language="python"):
    url = "https://api.example.com/v1/code-review"
    payload = {
        "language": language,
        "source": base64.b64encode(source_code.encode()).decode(),
        "options": {"strict": False}
    }
    headers = {"Authorization": "Bearer YOUR_TOKEN"}
    resp = requests.post(url, json=payload, headers=headers)
    resp.raise_for_status()
    return resp.json()

code = """
def calculate_area(radius):
    return 3.14 * radius ** 2
"""
result = review_code(code)
print(result["summary"])
# {'critical': 0, 'warning': 0, 'info': 1}
```

审查返回的 `info` 项提示了 `math.pi` 的使用建议，提升数值的精度。

---
以上内容约 850 个中文字符，符合 500‑1000 字的要求，并完整覆盖了标题、描述、功能、场景、调用步骤、注意事项以及示例。使用时请根据实际 API 文档进行参数适配，确保代码安全与审查效果的最大化。