From 901ef97a258ffd28370746b706090d4d261e9140 Mon Sep 17 00:00:00 2001
From: accelerator <accelerator_top@qq.com>
Date: Sun, 1 Mar 2026 03:38:58 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0README=E6=B7=BB?=
 =?UTF-8?q?=E5=8A=A0Agent=E5=AE=A1=E6=9F=A5=E6=A8=A1=E5=BC=8F=E6=96=87?=
 =?UTF-8?q?=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

补充Agent模式架构说明、配置项文档和管理API接口说明

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
---
 README.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/README.md b/README.md
index e5b670d..87942a1 100644
--- a/README.md
+++ b/README.md
@@ -111,6 +111,18 @@ Gitea功能增强助手，基于Bun和TypeScript开发，提供AI驱动的代码
 - `OPENAI_MODEL`：OpenAI 使用模型
 - `CUSTOM_SUMMARY_PROMPT`: 自定义总结审查提示 (可选)
 - `CUSTOM_LINE_COMMENT_PROMPT`: 自定义行评论提示 (可选)
+- `REVIEW_ENGINE`: 审查引擎模式，`legacy` 或 `agent` (默认: `legacy`)
+- `REVIEW_WORKDIR`: Agent 本地仓库 mirror/worktree 工作目录
+- `REVIEW_MODEL_PLANNER`: Agent 规划模型
+- `REVIEW_MODEL_SPECIALIST`: 专家子代理模型
+- `REVIEW_MODEL_JUDGE`: Judge 聚合模型
+- `REVIEW_MAX_PARALLEL_RUNS`: 单机并发审查任务上限
+- `REVIEW_MAX_FILES_PER_RUN`: 单次审查最多处理文件数
+- `REVIEW_MAX_FILE_CONTENT_CHARS`: 单文件上下文最大字符数
+- `REVIEW_AUTO_PUBLISH_MIN_CONFIDENCE`: 自动发布评论最小置信度
+- `REVIEW_ENABLE_HUMAN_GATE`: 是否启用人工审批队列
+- `REVIEW_ALLOWED_COMMANDS`: 本地审查沙箱命令白名单
+- `REVIEW_COMMAND_TIMEOUT_MS`: 单条本地命令超时
 - `PORT`: 应用监听端口 (默认: 3000)
 - `WEBHOOK_SECRET`: Webhook秘钥，用于验证请求来源
 - `FEISHU_WEBHOOK_URL`: 飞书Webhook地址，用于发送通知
@@ -191,6 +203,21 @@ Gitea功能增强助手，基于Bun和TypeScript开发，提供AI驱动的代码
 
 这对于增量工作尤其有用，可以只对最新的变更进行审查，避免重复评审已审查过的代码。
 
+### Agent 审查模式（新）
+
+当 `REVIEW_ENGINE=agent` 时，系统会启用 Agent 编排流程：
+
+1. Webhook 事件先入队（支持幂等去重）
+2. Worker 在后台拉取任务并执行
+3. 基于本地 clone（mirror + worktree）构建上下文
+4. 多专家代理并行生成 findings
+5. Judge 聚合后按策略自动发布/进入人工审批
+
+管理后台新增审查任务查看接口：
+
+- `GET /admin/api/review/runs`
+- `GET /admin/api/review/runs/:runId`
+
 ## 代码审查规则
 
 ### 总体评价规则