From 886e0d598deb3b2188e2e2b57c8f0b069475d86b Mon Sep 17 00:00:00 2001 From: wonder Date: Thu, 18 Jun 2026 23:25:21 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E5=BC=80=E5=8F=91?= =?UTF-8?q?=E8=BF=9B=E5=BA=A6=EF=BC=8C=E6=A0=87=E8=AE=B0=E5=B7=B2=E5=AE=8C?= =?UTF-8?q?=E6=88=90=E5=92=8C=E5=BE=85=E5=BC=80=E5=8F=91=E9=98=B6=E6=AE=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- PLAN.md | 55 ++++++++++++++++++++++++++++++++----------------------- 1 file changed, 32 insertions(+), 23 deletions(-) diff --git a/PLAN.md b/PLAN.md index 235093d..75fcb88 100644 --- a/PLAN.md +++ b/PLAN.md @@ -714,46 +714,55 @@ volumes: ## 10. 开发阶段 -### Phase 1：基础骨架 -- [ ] Go 项目初始化（go mod、目录结构） -- [ ] Gin 路由和基础中间件 -- [ ] SQLite 数据库初始化和迁移 -- [ ] 基础 HTML 模板布局（Tailwind CSS） -- [ ] 设置页面（LLM 配置） +> **当前进度**：Phase 1-2 已完成，Phase 3 部分完成，Phase 4-6 待开发 +> +> - ✅ Phase 1（基础骨架）：Go 项目、Gin 路由、SQLite、设置页面 +> - ✅ Phase 2（Git 核心）：clone、refs、diff、graph 数据、缓存管理 +> - ⚠️ Phase 3（前端交互）：Git Graph 和 Diff 查看器已实现，交互增强待完善 +> - ⏳ Phase 4（LLM 集成）：待开发 +> - ⏳ Phase 5（审查编辑与导出）：待开发 +> - ⚠️ Phase 6（完善与部署）：Docker 配置已完成，其他待完善 -### Phase 2：Git 核心 -- [ ] go-git 集成：clone 仓库 -- [ ] go-git 集成：获取 refs、commits -- [ ] go-git 集成：计算 diff -- [ ] Git Graph 数据提取（构建节点和边） -- [ ] 仓库缓存管理（过期清理） +### Phase 1：基础骨架 ✅ 已完成 +- [x] Go 项目初始化（go mod、目录结构） +- [x] Gin 路由和基础中间件 +- [x] SQLite 数据库初始化和迁移 +- [x] 基础 HTML 模板布局（Tailwind CSS） +- [x] 设置页面（LLM 配置） -### Phase 3：前端交互 -- [ ] D3.js Git Graph 可视化 -- [ ] 交互式分支/commit 选择 -- [ ] Diff 查看器组件（diff2html Split 视图） +### Phase 2：Git 核心 ✅ 已完成 +- [x] go-git 集成：clone 仓库（SSE 进度推送） +- [x] go-git 集成：获取 refs、commits +- [x] go-git 集成：计算 diff +- [x] Git Graph 数据提取（构建节点和边） +- [x] 仓库缓存管理（过期清理） + +### Phase 3：前端交互 ⚠️ 部分完成 +- [x] D3.js Git Graph 可视化（graph.js） +- [x] Diff 查看器组件（diff2html Split 视图）（diff-viewer.js） +- [ ] 交互式分支/commit 选择（base/head 选择） - [ ] 文件树侧边栏（树形结构、点击跳转、滚动高亮联动） - [ ] 上下文行折叠/展开 - [ ] Split/Unified 视图切换 - [ ] AI Review 行内建议展示（嵌入代码行旁） - [ ] SSE 流式展示组件 -### Phase 4：LLM 集成 -- [ ] OpenAI 兼容 API 调用封装 -- [ ] PR 描述生成（prompt + SSE 流式） -- [ ] AI 代码审查（分文件处理 + 汇总） +### Phase 4：LLM 集成 ⏳ 待开发 +- [ ] OpenAI 兼容 API 调用封装（services/llm.go） +- [ ] PR 描述生成（prompt + SSE 流式）（services/generate.go） +- [ ] AI 代码审查（分文件处理 + 汇总）（services/review.go） - [ ] 大 diff 处理（Top-N 策略） -### Phase 5：审查编辑与导出 +### Phase 5：审查编辑与导出 ⏳ 待开发 - [ ] 备注编辑器组件（Markdown 支持，三级作用域） - [ ] 备注 CRUD API（保存/读取） - [ ] PDF 报告 HTML 模板（打印样式） - [ ] chromedp HTML→PDF 生成服务 - [ ] PDF 下载接口 -### Phase 6：完善与部署 +### Phase 6：完善与部署 ⚠️ 部分完成 - [ ] 错误处理和用户提示 -- [ ] Dockerfile + docker-compose（含 Chromium） +- [x] Dockerfile + docker-compose（含 Chromium） - [ ] 文档和使用说明 - [ ] 测试和优化