code-review-copilot

KO | EN

gitlite — search

#react #typescript #go #android #machine-learning #rust #deep-learning #macos #awesome #kubernetes #vue #security #ios #open-source

code-review-copilot

(★ 19)

No description available.

code-review-copilot Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 代码审查 Agent（Code Review Agent）

一个**会话式**的 GitLab 代码审查 Agent：每个 webhook 触发的审查都是一个**可追问的会话**，由真正的 agent loop 驱动（真 tool calls + 多 subagent），用 [Vercel AI SDK](https://sdk.vercel.ai) v7 原生能力从零构建。

> 不是「单次调用大模型」——agent 会自己 `list_changed_files → fetch_diff → read_file`，按需委派安全/架构/性能 subagent，最后把结论回写 MR；你还能在会话里继续追问。

## 技术栈

- **后端**：[Hono](https://hono.dev)（web 标准 Request/Response，AI SDK 的 `toUIMessageStreamResponse()` 直接 return）
- **前端**：Vite + React + `@ai-sdk/react` 的 `useChat`
- **Agent**：`ai` v7（`streamText` + `stopWhen` + `ToolLoopAgent` subagent 委派）
- **数据**：Prisma + PostgreSQL
- **鉴权**：HMAC 签名 Cookie + 可选 IP 白名单，全局守卫所有 `/api/*`

## 工程结构

```
server/            # Hono 后端
  index.ts         # app 装配 + 全局鉴权 + 生产托管前端
  routes/          # auth / sessions / repositories / settings / chat / webhook / dashboard
  agent/           # model · tools · subagents · review-agent · run-review
  lib/             # gitlab · auth · prompts · prisma · chat-store · branch-match
web/               # Vite + React SPA（Chat / Settings / Repositories / Login）
shared/            # 前后端共享类型
prisma/schema.prisma
```

## 本地开发

```bash
# 1. 起一个 Postgres（或用 docker compose up -d postgres）
# 2. 配置 .env（见 .env.example）
cp .env.example .env

npm install
npm run db:migrate          # 建表
npm run dev                 # 同时起 Hono(:8787) 与 Vite(:5173)
```

打开 `http://localhost:5173`，用 `.env` 里的 `APP_AUTH_USERNAME/SECRET` 登录。

## 配置流程

1. **设置 → 添加 GitLab 账号**：实例地址 + 访问令牌（api 权限）+ Webhook 密钥。
2. **设置 → Tools / Skills 管理**：调整平台默认工具与审查方法；内置 `brooks-lint` 风格 skill 可直接启用。
3. **仓库配置 → 添加仓库**：选账号 → 拉取并选项目 → 配模型（provider/modelId/apiKey）→ 监听分支 / 默认审查提示词 / 自动审查 / 仓库级 Tools 和 Skills 覆盖。
4. 在 GitLab 项目里加 Webhook（**Merge Request events**），URL 指向 `<部署地址>/api/webhook/gitlab`，Secret Token 与账号的 Webhook 密钥一致。
5. **数据看板**：查看 14 天趋势、状态分布、仓库热度、人员维度、失败样本和最近活动；人员分析覆盖活跃占比、失败贡献、仓库覆盖和消息密度。

之后每次 MR 打开/更新都会自动生成一个审查会话，agent 审查并回写 MR，你可在左侧会话里继续追问。

## 核心数据模型

- `GitLabAccount` —— 接入凭证
- `Repository` —— 仓库 + 按仓库的模型/提示词配置
- `AgentTool` / `AgentSkill` —— 平台级工具与 skill 注册表
- `RepositoryToolSetting` / `RepositorySkillSetting` —— 仓库级能力覆盖
- `Session` —— 一次会话（`kind=review|chat`，审查会话带 MR 元信息）
- `Message` —— 线性 `UIMessage` 持久化

## 测试与门禁

```bash
npm run typecheck   # tsc 服务端 + 前端
npm test            # vitest（工具执行 / provider 解析 / 分支匹配）
npm run build       # prisma generate + vite build
```

## Docker 部署

单镜像单容器（Hono 同进程托管前端静态产物 + `/api`）：

```bash
cp .env.example .env   # 至少填好 APP_AUTH_*
docker compose up -d --build
# 访问 http://localhost:8787
```

容器启动时自动执行 `prisma migrate deploy`。

code-review-copilot

code-review-copilot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

code-review-copilot

code-review-copilot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README