# code-review-system

**Repository Path**: hamaguagua/code-review-system

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-29
- **Last Updated**: 2026-07-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 自动化代码审查系统 — 调研总览

> 调研日期：2026-06-22
> 项目目标：构建一套支持 Gitee + 多 AI Agent + Skills 的自动化代码审查系统

---

## 调研结论（一句话版）

**Gitee OpenAPI v5 + Claude Code Headless + code-review-graph 的组合完全可行，可以构建一套功能完整的自动化代码审查系统。**

---

## 分项结论速查

### ✅ Gitee OpenAPI（完全满足）

| 需求 | 结论 |
|------|------|
| 获取项目列表 | ✅ `GET /v5/user/repos` 支持分页、筛选 |
| 获取 Commits | ✅ `GET /v5/repos/{owner}/{repo}/commits` 含 diff |
| 获取 MR/PR | ✅ `GET /v5/repos/{owner}/{repo}/pulls` 完整 CRUD |
| 同步源码 | ✅ `git clone` + Token 认证 |
| Group/组织信息 | ✅ `GET /v5/user/orgs` `GET /v5/orgs/{org}/repos` |
| 唯一注意点 | ⚠️ CORS 需后端代理 |

### ✅ AI CLI Agent（均支持 Headless）

| Agent | Headless 模式 | 成熟度 |
|-------|-------------|--------|
| Claude Code | `claude -p "prompt" --output-format json` | ⭐⭐⭐⭐⭐ |
| Codex CLI | `codex exec --full-auto "prompt"` | ⭐⭐⭐⭐ |
| OpenCode | `opencode run "prompt" --format json` | ⭐⭐⭐⭐⭐ |
| Kimi Code | `kimi -p "prompt"`（待验证） | ⭐⭐⭐ |
| Trae Agent | `trae-cli run "prompt"` | ⭐⭐⭐ |
| WorkBuddy | `codebuddy -p "prompt"` | ⭐⭐⭐⭐ |

### ✅ code-review-graph（完全满足）

| 需求 | 结论 |
|------|------|
| 增量 Code Review | ✅ 增量图谱更新 < 2 秒 |
| Baseline 管理 | ✅ 图谱快照对比 |
| 爆炸半径分析 | ✅ 追踪调用者、依赖、测试缺口 |
| 风险评分 | ✅ 自动计算 |
| Token 节省 | ✅ 中位 ~82x 缩减 |
| MCP 集成 | ✅ 30 个 MCP Tools + 5 个 Prompts |

### ✅ IM 消息推送（飞书/企业微信）

| 平台 | Markdown | 表格 | 代码块 | 按钮链接 | 最佳场景 |
|------|---------|------|--------|---------|---------|
| **飞书** | ⭐⭐⭐⭐⭐ 卡片+Markdown | ✅ | ✅ | ✅ | 丰富交互体验 |
| **企业微信** | ⭐⭐⭐⭐ markdown_v2 | ✅ | ✅ | ❌ (文字链) | 表格+代码块展示 |

### ✅ Skill 全局配置管理（cc-switch 模式）

| 能力 | 结论 |
|------|------|
| Provider 统一管理 | ✅ SQLite SSOT → 同步到各 Agent 配置 |
| MCP Server 跨 Agent 同步 | ✅ 注册一次，写入 Claude/Codex/OpenCode 等 |
| Skills 市场 + 一键安装 | ✅ GitHub/PyPI/本地 三种来源 |
| API Key 加密存储 | ✅ AES-256 + 环境变量注入 |

---

## 推荐技术栈

```
前端:  React 18 + Ant Design / shadcn/ui + Vite
后端:  Python 3.11 + FastAPI + SQLite/PostgreSQL
Agent: Claude Code (主力) + OpenCode (备选)
Skill: code-review-graph (代码图谱+影响分析)
通知:  飞书/企业微信 Webhook
配置:  SQLite SSOT (~/.code-review-system/system.db)
任务:  Celery / arq (异步任务)
WS:    FastAPI WebSocket (实时进度)
```

---

## 调研文档索引

| 文档 | 内容 |
|------|------|
| [01-gitee-openapi-调研报告.md](./01-gitee-openapi-调研报告.md) | Gitee API 完整能力评估、接口详情、CORS 方案 |
| [02-ai-cli-agent-调研报告.md](./02-ai-cli-agent-调研报告.md) | 6 款主流 AI CLI Agent 的 Headless 模式、对比和集成方案 |
| [03-code-review-graph-skill-调研报告.md](./03-code-review-graph-skill-调研报告.md) | code-review-graph 的 MCP Tools、审查工作流和集成方案 |
| [04-系统架构设计建议.md](./04-系统架构设计建议.md) | 完整的前后端架构设计、API 设计、数据模型、开发路线图 |
| [05-IM消息推送集成调研报告.md](./05-IM消息推送集成调研报告.md) | 历史 IM Webhook 调研；钉钉能力已下线，请以最新通知设置调研为准 |
| [06-Skill全局配置管理调研报告.md](./06-Skill全局配置管理调研报告.md) | 🆕 cc-switch 模式分析、Provider/MCP/Skills 全局统一管理方案 |
| [10-通知设置重构-企微飞书机器人与文档能力调研.md](./10-通知设置重构-企微飞书机器人与文档能力调研.md) | 🆕 企业微信/飞书机器人与文档 CRUD 能力边界、通知重构安全建议 |
| [docker-compose-deployment.md](./docker-compose-deployment.md) | 🆕 Linux Docker Compose 部署指南、持久化、备份恢复、nginx/WebSocket 代理 |
| [13-基于代码Diff的全流程测试用例生成系统-可行性调研与方案.md](./13-基于代码Diff的全流程测试用例生成系统-可行性调研与方案.md) | 🆕 多仓双分支 Diff → 跨端 API 关联 → 全流程测试用例画布可行性与方案 |
| [14-测试用例画布-基于Diff的全流程用例生成-详细实施计划.md](./14-测试用例画布-基于Diff的全流程用例生成-详细实施计划.md) | 🆕 测试用例画布详细实施计划（模型/API/权限/分期/验收） |
| [15-Claude-Code与系统Provider凭证隔离.md](./15-Claude-Code与系统Provider凭证隔离.md) | 🆕 Claude CLI 401 根因与系统 Provider 凭证隔离（CLAUDE_CONFIG_DIR） |

---

## 关键风险与应对

| 风险 | 等级 | 应对措施 |
|------|------|----------|
| Gitee API 速率限制 (5000/h) | 中 | 后端实现缓存 + 请求队列 |
| AI Agent 调用成本 | 中 | 设置 max_turns + max_budget_usd，记录用量 |
| Kimi Code Headless 文档缺失 | 低 | 优先实现 Claude Code / OpenCode，预留扩展点 |
| code-review-graph 大型仓库构建耗时 | 低 | 首次全量构建后台执行，后续增量更新 < 2s |
| Agent 执行安全性 | 高 | 沙箱隔离 + allowedTools 白名单 + 审计日志 |
| 企业微信消息 4096 字节限制 | 中 | 自动截断 + "查看详情"链接引导至完整报告 |
| IM Webhook 签名校验 | 低 | 统一签名服务；飞书支持 HmacSHA256，企业微信优先使用 IP/密钥保护与脱敏存储 |
| 多 Agent 配置文件格式差异 | 中 | 统一适配层，每种 Agent 独立 JSON/YAML/TOML 写入器 |