DevFlow/docs/Batch-Overview.md

DevFlow 批次可视化总览

基于 Batch.md 生成 | 更新: 2026-07-01

---

一、批次时间线（已完成）

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

---

二、功能领域分布

pie title 批次功能领域分布（按完成批次数）
    "文件浏览器/Git" : 8
    "任务管理 UX" : 3
    "工程系统" : 4
    "AI/Agent" : 4
    "架构债/重构" : 4
    "小程序" : 2
    "Bug 修复" : 3
    "依赖图可视化" : 4

---

三、批次依赖关系图

仅展示批次级别依赖，子任务明细见下方表格。

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.vue（1552行，待拆分）

---

五、待推进批次优先级矩阵

批次	价值	风险	象限	建议
Batch 30 代码质量	中	低	高价值低风险	✅ 优先做
Batch 31 MessageList 拆分	高	高	高价值高风险	⚠️ 需谨慎，要测试覆盖
Batch 32 ChatInput 拆分	高	高	高价值高风险	⚠️ 需谨慎，要测试覆盖
Batch 33 多 ReAct 对接	很高	很高	高价值高风险	⚠️ 核心架构改动
Batch 34 产品完善	中	中	中价值中风险	🟡 可延后

---

六、批次提交密度

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]