DevFlow/Batch.md

DevFlow 批次推进记录

记录每个批次的提交 hash、改动内容和交付价值。 最后更新: 2026-06-29 | 最新提交: c6df455

---

Batch 1 — 审批超时后端兜底

• 提交: b923d70(后重写为 9dd5a5a)
• 内容:
  • 新增 agentic/approval_timeout.rs，在审批恢复入口检测超时，超时自动取消并写入审计
  • 待审批记录新增创建时刻字段，用于超时判定
  • 应用启动时从设置恢复超时配置（默认 15 分钟，0 为禁用）
  • 新增读写超时配置的接口，设置页可改
  • 与前端共用同一个配置项，保证单一真相源
• 验证: cargo check 通过

---

Batch 2 — 工具卡片拆分核验

• 提交: e95a5cd(后重写为 45fc493)
• 内容:
  • 核验发现工具卡片拆分任务实际已完成，文档标记滞后
  • ToolCard.vue 从 1527 行降至 373 行
  • 审批状态机独立为 useToolApproval.ts（220 行）
  • 头部逻辑、渲染逻辑、通用工具函数各自独立
  • 大型文件拆分三项全部完成（主聊天组件/命令注册/通用 CRUD）
• 验证: 文档核验，无代码改动

---

Batch 3 — 条件表达式 UI 翻译补齐

• 提交: e460e8d(后重写为 d79c816)
• 内容:
  • 工作流条件表达式引擎和执行器集成早已完成
  • 前端边条件编辑入口已存在，但翻译缺失（用中文兜底）
  • 补齐中英文翻译（工作流结构标题/层标签/空态/边条件编辑器）
  • 核验确认条件引擎全部链路均已落地
• 验证: vue-tsc 通过

---

Batch 4 — 知识提炼切读消息表

• 提交: 6aac7ef(后重写为 f57c37e)
• 内容:
  • 知识提炼是最后一个仍读旧消息 JSON 列的路径
  • 改为优先读消息表，表空时回退旧 JSON（老库兼容）
  • 复用既有的记录转消息映射函数，与其他读路径同源
  • 至此消息存储拆分全部完成
• 验证: cargo check 通过

---

Batch 5 — 关闭已完成待办项

• 提交: 59b7188(后重写为 694f24f)
• 内容:
  • 工具卡片分组标题增强（文件路径摘要展示）已落地
  • 重试持锁问题核验无影响（多会话改造后全局锁已移除）
  • 对抗式评估批量命令暂不做（单项已接入，批量无消费方）
  • 残留诊断代码已清理（无硬编码绝对路径）
  • 工程内路径授权政策确认为白名单制
• 验证: 文档核验

---

Batch 6 — 应用状态拆分 + 事件分发统一 + 路径授权治本

• 提交: 996f1d9
• 内容:
  • 状态文件拆分: 1416 行单文件 → 按职责分模块（授权白名单/知识库配置/并发控制）
  • 事件分发器统一: 5 类生命周期事件纳入主事件联合类型，删除第二监听器，一个事件源一个监听器一个分发器
  • 路径授权去硬编码: 不再硬塞编译期路径到白名单，工程根授权靠项目绑定目录 + 设置页配置
• 补丁: cc3ef5b — 修复设置页面崩溃（模块循环依赖导致初始化失败）
• 验证: cargo check + vue-tsc 通过

---

Batch 7 — 小程序配置持久化与心跳闭环

• 提交: cb7e1fc
• 内容:
  • 配置持久化: 运行时配置接入 storage，懒加载恢复，新增重置函数
  • 心跳 pong 闭环: 中继服务识别小程序心跳 ping 直接回 pong（不经桌面端透传），小程序看门狗据此判活
  • 文档同步: 关闭条件引擎/streaming per-conv/workspace_root 三项已完成的待决策
• 验证: cargo check（devflow + df-relay）通过

---

Batch 8 — 消息分页懒加载与事件总线空转优化

• 提交: 3c18dea
• 内容:
  • 消息分页: 消息仓库新增分页查询方法（从尾部取最近 N 条，支持游标），切换对话返回最近 50 条 + 游标，新增加载更多接口
  • 事件总线优化: 发布事件前先检查订阅者数量，无订阅者跳过序列化（消除空转开销）
  • 核验关闭: 对话上下文透明化三项均已落地（目标可见/项目增强预览/完整上下文面板）
• 验证: cargo check 通过

---

Batch 9 — 项目多工程系统（数据层）

• 提交: b72df78
• 内容:
  • 数据层: project_modules 表（V34 迁移）+ ProjectModuleRepo 完整 CRUD
  • 后端接口: 工程增删改查 + Git 状态查询（实时跑 git 命令返回分支/改动/提交，10s 超时）
  • 创建项目适配: 新建项目时自动创建一个工程（目录=绑定路径，技术栈=探测结果）
  • AI 工具: list_project_modules（AI 了解项目工程结构）
  • 设计文档: 新增工程系统设计方案
• 验证: cargo check 通过

---

Batch 10 — 项目文件浏览器（前端 UI）

• 提交: 50aad37
• 内容:
  • 后端接口: 文件树查询（列目录 + Git 状态合并 + 噪音过滤 + 路径穿越防御）+ 文件读取（文本/图片/二进制，1MB 上限）
  • 文件树组件: 递归树形展示，懒加载子目录，Git 状态标记（橙=修改/绿=新增/灰=未跟踪）
  • 文件预览组件: 代码文本/图片/二进制三分支，加载状态
  • 主容器: 工程选择（单工程隐藏）+ 面包屑导航 + 刷新
  • 集成: 项目详情页新增"文件"Tab
  • 国际化: 中英文同步
• 验证: cargo check + vue-tsc 通过

---

Batch 11 — Git 只读 AI 工具

• 提交: 7b5b62d
• 内容:
  • git_status（Low 自动执行）: 工作区状态结构化（分支 + 改动文件列表 + 状态标记）
  • git_diff（Low）: 改动详情（统计 + patch 截断到 8000 字符防 token 爆）
  • git_log（Low）: 提交历史结构化（哈希/作者/消息/日期）
  • 所有 git 命令在工程目录执行，10s 超时，无 Git 仓库返回空状态
• 验证: cargo check 通过

---

Batch 12 — Git 写操作 AI 工具

• 提交: 0cfea6d
• 内容:
  • git_commit（Medium 审批）: 提交工作区改动，提交前检查敏感文件（.env/.key/.pem）
  • git_branch（Medium 审批）: 分支列表/创建/切换
  • git_merge（High 审批）: 合并分支，自动检测冲突返回冲突文件列表
  • 安全边界: 禁止 push / force / reset --hard
• 验证: cargo check 通过

---

架构设计文档状态同步

• 提交: 8d18918
• 内容: 9 份设计文档状态批量更新（从"待实施"改为"已落地"），1 份归档（规格契约自检被其他机制覆盖）

---

提交注释规范重写

• 内容: Batch 1-5 的提交注释经 filter-branch 重写，消除内部代号（Batch/P1/P2/L1/F-09 等），统一为"两字动词 + 冒号"格式（新增/修复/更新）

---

Batch 13 — 文件浏览器增强(行号/图标/Diff/Git 变更面板/窗口分离)

• 提交: c6df455
• 内容:
  • 行号显示: 文件预览左侧行号列
  • 后缀图标: 20+ 文件类型彩色 SVG 图标(rs/ts/js/vue/css/html/json/md/sh/sql 等)
  • Diff 视图: 有 Git 变更的文件可切换内容/Diff 红绿视图
  • Git 变更面板: 文件树侧栏切换至变更视图,变更文件列表(按目录缩进分组)+提交历史(分页 50 条)
  • 提交详情: 点击提交行展开变更文件列表,点文件查看该文件 diff
  • 提交时间显示: 相对时间(刚刚/N分钟前)+超过 30 天显示具体日期
  • 窗口分离: FileExplorer 可弹出独立 Tauri 窗口
  • 中文编码修复: git 命令注入 LANG/LC_ALL UTF-8 环境变量,修复中文乱码
  • 多工程管理 UI: 工具栏添加工程按钮+弹窗表单
  • 文件变更自动刷新: write_file/patch_file 触发 df-data-changed 事件,AI 写入后自动刷新
  • 面包屑不丢预览: 面包屑导航时保留当前预览文件
  • 刷新保留选中文件: 只清树缓存不清预览
  • 自适应布局: 弹性 flex 布局,窄窗口自适应
  • 审批超时 130s->30s: 按钮级 loading 超时缩短
  • 阶段进度条隐藏: 装饰性元素,待接入真实状态机后启用
• 验证: cargo check + vue-tsc + vite build 通过

---

未纳入批次的其他会话改动

• src/composables/ai/aiShared.ts + src/stores/ai.ts — 循环依赖修复（Batch 6 补丁 cc3ef5b 纳入提交）