Files
DevFlow/docs/Batch-Overview.md

189 lines
6.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# DevFlow 批次可视化总览
> 基于 [Batch.md](../Batch.md) 生成 | 更新: 2026-07-01
---
## 一、批次时间线(已完成)
```mermaid
gantt
title DevFlow 批次推进时间线
dateFormat YYYY-MM-DD
axisFormat %m-%d
section 审批与工具卡
Batch 1 审批超时后端兜底 :done, b1, 2026-06-14, 1d
Batch 2 工具卡片拆分核验 :done, b2, after b1, 1d
Batch 3 条件表达式 UI 翻译 :done, b3, after b2, 1d
section 数据与状态
Batch 4 知识提炼切读消息表 :done, b4, after b3, 1d
Batch 5 关闭已完成待办项 :done, b5, after b4, 1d
Batch 6 应用状态拆分+路径授权 :done, b6, after b5, 1d
section 跨端与消息
Batch 7 小程序配置持久化 :done, b7, after b6, 1d
Batch 8 消息分页懒加载 :done, b8, after b7, 1d
Batch 9 多工程数据层 :done, b9, after b8, 1d
section 文件浏览器
Batch 10 文件浏览器 UI :done, b10, after b9, 1d
Batch 11 Git 只读 AI 工具 :done, b11, after b10, 1d
Batch 12 Git 写操作 AI 工具 :done, b12, after b11, 1d
Batch 13 文件浏览器增强 :done, b13, after b12, 1d
section 收尾与重构
Batch 14 浏览器收尾 :done, b14, after b13, 1d
Batch 15 多工程管理 :done, b15, after b14, 1d
Batch 16 提交历史作者 :done, b16, after b15, 1d
section 崩溃修复与 UX
渲染崩溃修复 TDZ+窗口权限 :done, fix1, after b16, 1d
Batch 17 Git 能力闭环 :done, b17, after fix1, 1d
Batch 18 小程序审批超时 :done, b18, after b17, 1d
section UX 与架构
Batch 19 任务管理 UX 重构 :done, b19, after b18, 1d
Batch 20 coordinator.rs 删除 :done, b20, after b19, 1d
任务快捷操作菜单 :done, menu1, after b20, 1d
section DAG 与依赖图
TDZ 防御 :done, tdz1, after menu1, 1d
Plan 执行器骨架 :done, plan1, after tdz1, 1d
Batch 25 工程依赖图数据层 :done, b25, after plan1, 1d
section 增强
Batch 26 dagre 布局 :done, b26, after b25, 1d
Batch 28 架构债收尾 :done, b28, after b26, 1d
Batch 29 环检测+PNG+总数 :done, b29, after b28, 1d
section 待推进
Batch 30 代码质量收尾 :b30, after b29, 3d
Batch 31 MessageList 拆分 :b31, after b30, 3d
Batch 32 ChatInput 拆分 :b32, after b31, 3d
Batch 33 多 ReAct 对接 :b33, after b32, 5d
Batch 34 产品完善 :b34, after b33, 3d
```
---
## 二、功能领域分布
```mermaid
pie title 批次功能领域分布(按完成批次数)
"文件浏览器/Git" : 8
"任务管理 UX" : 3
"工程系统" : 4
"AI/Agent" : 4
"架构债/重构" : 4
"小程序" : 2
"Bug 修复" : 3
"依赖图可视化" : 4
```
---
## 三、批次依赖关系图
> 仅展示批次级别依赖,子任务明细见下方表格。
```mermaid
flowchart TD
B6["B6 状态拆分"] --> B9["B9 多工程数据层"]
B9 --> B10["B10 文件浏览器"]
B9 --> B25["B25 依赖图数据"]
B10 --> B13["B13 浏览器增强"]
B13 --> B14["B14 收尾"]
B13 --> B15["B15 多工程管理"]
B13 --> B16["B16 提交作者"]
B13 --> B17["B17 Git 闭环"]
B25 --> B26["B26 dagre布局"]
B26 --> B29["B29 环检测+PNG"]
B9 --> B11["B11 Git只读"]
B11 --> B12["B12 Git写操作"]
PLAN["Plan执行器"] --> B33["B33 多ReAct"]
B30["B30 代码质量"] --> B31["B31 MsgList拆分"]
B31 --> B32["B32 ChatInput拆分"]
style B6 fill:#2d5a2d,color:#fff
style B9 fill:#2d5a2d,color:#fff
style B10 fill:#2d5a2d,color:#fff
style B11 fill:#2d5a2d,color:#fff
style B12 fill:#2d5a2d,color:#fff
style B13 fill:#2d5a2d,color:#fff
style B14 fill:#2d5a2d,color:#fff
style B15 fill:#2d5a2d,color:#fff
style B16 fill:#2d5a2d,color:#fff
style B17 fill:#2d5a2d,color:#fff
style B25 fill:#2d5a2d,color:#fff
style B26 fill:#2d5a2d,color:#fff
style B29 fill:#2d5a2d,color:#fff
style PLAN fill:#2d5a2d,color:#fff
style B30 fill:#5a4a2d,color:#fff
style B31 fill:#5a4a2d,color:#fff
style B32 fill:#5a4a2d,color:#fff
style B33 fill:#5a4a2d,color:#fff
```
绿色 = 已完成 | 橙色 = 待推进
---
## 四、批次子任务明细
| 批次 | 状态 | 子任务 |
|------|------|--------|
| Batch 9 | ✅ | project_modules 表 · ModuleRepo CRUD · 创建项目适配 · AI 工具注册 |
| Batch 10 | ✅ | 文件树组件 · 文件预览 · Git 状态标记 · 面包屑导航 |
| Batch 13 | ✅ | 行号/图标 · Diff 视图 · Git 变更面板 · 窗口分离 · 分页提交历史 |
| Batch 17 | ✅ | Diff 行号解析 · 分支只读展示 · 提交详情 · 写入后自动刷新 |
| Batch 19 | ✅ | 搜索框 · 筛选改下拉 · 排序选择器 · 分组可折叠 · 快捷操作菜单 |
| Batch 25 | ✅ | module_dependencies 表 · DependencyRepo CRUD · 依赖边渲染 · 小地图 |
| Batch 26 | ✅ | dagre 布局 · 添加依赖弹窗 · 边类型着色 |
| Batch 29 | ✅ | 环形检测 IPC · PNG 导出 · count_tasks IPC · 真实 total |
| Batch 30 | ⏸️ | 搜索索引核验 · 编译警告清理 · i18n 核验 · String 替 newtype |
| Batch 31 | ⏸️ | 提取 MessageItem.vue · 提取 useMessageScroll.ts |
| Batch 32 | ⏸️ | 提取 SkillMention.vue · 提取 ImageInput.vue |
| Batch 33 | ⏸️ | PlanExecutor 接入 loop · plan_hint 生成 DAG · 执行进度展示 |
---
## 四、关键指标
| 指标 | 数值 |
|------|------|
| 已完成批次 | 29 |
| 待推进批次 | 5 |
| 总提交数Batch 1-29 | ~35 |
| 涉及 Rust 文件 | ~25 |
| 涉及 Vue/TS 文件 | ~40 |
| 新增数据库迁移版本 | V35 |
| 新增 IPC 命令 | ~15 |
| 新增 npm 依赖 | @antv/x6 / dagre / highlight.js |
| 当前最大文件 | MessageList.vue1552行待拆分 |
---
## 五、待推进批次优先级矩阵
| 批次 | 价值 | 风险 | 象限 | 建议 |
|------|------|------|------|------|
| Batch 30 代码质量 | 中 | 低 | 高价值低风险 | ✅ 优先做 |
| Batch 31 MessageList 拆分 | 高 | 高 | 高价值高风险 | ⚠️ 需谨慎,要测试覆盖 |
| Batch 32 ChatInput 拆分 | 高 | 高 | 高价值高风险 | ⚠️ 需谨慎,要测试覆盖 |
| Batch 33 多 ReAct 对接 | 很高 | 很高 | 高价值高风险 | ⚠️ 核心架构改动 |
| Batch 34 产品完善 | 中 | 中 | 中价值中风险 | 🟡 可延后 |
---
## 六、批次提交密度
```mermaid
xychart-beta
title "批次提交密度(按阶段)"
x-axis ["阶段1", "阶段2", "阶段3", "阶段4", "阶段5", "阶段6", "阶段7", "阶段8", "阶段9"]
y-axis "批次数" 0 --> 8
bar [3, 3, 2, 3, 3, 3, 3, 3, 3]
```