From 0efea3872875aa46525262d8588aa6174c6bf0be Mon Sep 17 00:00:00 2001 From: "jiawei.chen" Date: Wed, 8 Jul 2026 17:01:13 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0API=E6=96=87=E6=A1=A3?= =?UTF-8?q?+=E5=B7=A5=E4=BD=9C=E6=B5=81=E6=96=87=E6=A1=A3(=E5=88=86?= =?UTF-8?q?=E6=94=AF=E6=A3=80=E6=B5=8B+=E5=AF=B9=E6=AF=94=E6=8E=A5?= =?UTF-8?q?=E5=8F=A3)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/AGENT_WORKFLOW.md | 20 +++++++++++++++++++- docs/API.md | 39 +++++++++++++++++++++++++++++++++++++++ 2 files changed, 58 insertions(+), 1 deletion(-) diff --git a/docs/AGENT_WORKFLOW.md b/docs/AGENT_WORKFLOW.md index c80f185..a9ad69c 100644 --- a/docs/AGENT_WORKFLOW.md +++ b/docs/AGENT_WORKFLOW.md @@ -62,7 +62,25 @@ python3 main.py diff -r -a HEAD~3 ## 三、UI 变更检查 + 自动修复 -### 3.1 检测模式 +### 3.1 仓库管理 - 分支自动检测 + +``` +输入 Git 仓库 URL + → 失焦/点击「最新分支」按钮 + → git ls-remote --heads 获取所有远程分支 + → git for-each-ref --sort=-committerdate 找到最新提交分支 + → 自动切换到最新分支 + → 显示分支列表(数量 + commit hash + 最新/默认标签) + → 点击「扫描」→ clone → AST 分析 → DDD 建模 +``` + +**分支功能:** +- 自动检测:失焦后自动扫描远程分支 +- 手动检测:点击「⚡最新分支」按钮,自动找到最近提交的分支并切换 +- 下拉列表:显示所有分支 + commit hash 前 8 位 + 最新/默认标签 +- 分支对比:POST /api/repos/compare 对比任意两个分支的变更文件 + +### 3.2 检测模式 ``` 输入前端仓库 URL → 克隆前端代码 diff --git a/docs/API.md b/docs/API.md index da5f1a8..a5a15b8 100644 --- a/docs/API.md +++ b/docs/API.md @@ -39,6 +39,45 @@ Base URL: `http://localhost:5002` --- +## 仓库分支 + +### GET /api/repos/branches?url= +获取远程仓库所有分支列表,自动识别最新提交分支。 + +**响应:** +```json +{ + "branches": [{"name": "dev", "commit": "8c45c92"}, {"name": "main", "commit": "6f6053f"}], + "total": 15, + "default": "main", + "latest": "dev" +} +``` + +### POST /api/repos/compare +对比两个分支的变更文件列表。 + +**请求体:** +```json +{ + "url": "https://github.com/user/repo.git", + "base": "main", + "compare": "dev" +} +``` + +**响应:** +```json +{ + "base": "main", + "compare": "dev", + "changed_files": ["agent/llm_client.py", "backend/app.py"], + "total_changes": 2 +} +``` + +--- + ## 仓库管理 ### GET /api/repos