# DevFlow 文档索引 > 创建: 2026-06-10 | 当前阶段: Phase 2 本地优先开发流程验证 > 更新: 2026-08-02 | 05-代码审查 补录 2026-08-02 走查批次:DevFlow AI 全库走查(00-05,12 crate/78 问题)、claude 多代理走查(汇总+nodes/ai-storage/ideas-前端/基建 5 文档)、本次修复摘要(5 根因 + 13 agent P0/P1/P2 + 架构专项 3,提交 fc249ad/f719546) > 历次: 2026-10-10 按 ls 对齐现存文件(crate 数 8→13;01/04/05/06 子树补录漏登文档);06-19 02-架构设计 核对优化(新增分类索引/补录缺失文档/命名规范);06-17 文档缺陷扫描通过(零死链) --- ## 目录结构 ``` docs/ ├── README.md # 快速开始与文档导航 ├── INDEX.md # 本文件 — 文档导航 ├── todo.md # 工作看板（任务/bug 跟踪，~1200 行含历史） ├── 待审查.md # 代码审查队列（CR 登记+回填，67 条已审） ├── 待决策.md # 需人工决策项（产品取舍/方向选型/排期） ├── 01-技术文档/ │ ├── SQLite-CRUD模式-2026-06-12.md │ ├── Tauri-IPC模式-2026-06-12.md │ ├── AntV-X6调研报告与引入计划-2026-06-30.md # 图可视化层选型(v3.1.7)+ 依赖图落地计划 │ ├── 多代理流水线实战经验-2026-10-03.md # 多代理流水线实战经验 │ ├── 团队级基建-部署与运维-2026-10-05.md # 团队级基建部署与运维 │ └── 签名与发布SOP-2026-10-10.md # 更新签名密钥体系/发布流程/验签/踩坑/应急吊销 ├── 02-架构设计/ │ ├── INDEX.md # 本目录分类索引（按性质四类 + 命名规范摘要） │ ├── 滚动规范/ # 长期维护的真相源 / 规范 / 决策记录 │ ├── 已编号方案/ # 带 F/B/CR 编号的方案文档 │ ├── 专项设计/ # 无编号的主题设计 / 审查派生方案 │ ├── 构想审查/ # 构想 / UX 改进 / 模块审查 / 论证 │ ├── 单对话并行多轮-设计-2026-06-20.md │ ├── 单对话并行多轮-Phase0落地路线图-2026-06-20.md │ ├── 上下文根治设计-20261006.md │ └── 无人值守可靠性专项设计-20261006.md ├── 03-模块文档/ │ ├── df-storage-存储层-2026-06-12.md │ ├── df-workflow-工作流引擎-2026-06-12.md │ ├── df-nodes-节点集合-2026-06-12.md │ ├── df-ai-AI集成模块-2026-06-12.md │ ├── df-knowledge-知识库-2026-06-14.md │ ├── 想法探索-对抗式评估-2026-06-12.md │ ├── DAG引擎详解-2026-06-14.md │ └── AI对话引擎-2026-06-14.md ├── 04-功能迭代/ │ ├── DEVFLOW-1.CRUD层实施-2026-06-12.md │ ├── DEVFLOW-2.IPC桥接实施-2026-06-12.md │ ├── DEVFLOW-3.Store对接实施-2026-06-12.md │ ├── DEVFLOW-4.端到端验证-2026-06-12.md │ ├── 父子任务支持设计-2026-08-04.md # 父子任务支持设计 │ └── u-switch接入分析-2026-09-28.md # u-switch 接入分析 ├── 05-代码审查/ │ ├── 00-全库代码走查汇总-2026-08-02.md # 全库走查汇总（12 crate, 78 问题, 11 P0 / 30 P1 / 37 P2） │ ├── 01-df-nodes-走查-2026-08-02.md # 17 节点走查（20 问题） │ ├── 02-df-workflow-走查-2026-08-02.md # 工作流引擎走查（9 问题） │ ├── 03-df-ai-走查-2026-08-02.md # AI 核心走查（13 问题） │ ├── 04-df-storage-ideas-mcp-走查-2026-08-02.md # 存储/灵感/MCP 走查（17 问题） │ ├── 05-df-relay-tunnel-project-types-execute-走查-2026-08-02.md # 中继/隧道/项目管理/类型/执行走查（19 问题） │ ├── claude-汇总-2026-08-02.md # claude 走查汇总（4 workflow/35 维度 + 修复提交 fc249ad/f719546 + 推翻假设） │ ├── claude-df-nodes-走查-2026-08-02.md # df-nodes 走查（P0×2 df-mcp 数据覆盖 + df-execute probe_pwsh 死缓存） │ ├── claude-df-ai-storage-走查-2026-08-02.md # df-ai/storage 走查（evaluate 拆只读+写 + probe_pwsh 超时/单源 + 注入隔离） │ ├── claude-ideas-前端-走查-2026-08-02.md # ideas + 前端走查（MessageList/MessageItem 双套渲染收敛 f719546） │ ├── claude-基建-剩余模块-走查-2026-08-02.md # 基建/剩余模块走查（P2/P3：status union/胖 composable/审批 hack 等） │ ├── 本次修复摘要-2026-08-02.md # 修复摘要（5 根因 + 13 agent P0/P1/P2 + 架构专项 3） │ ├── 全栈代码审查报告-2026-06-14.md # Rust+Tauri+Vue 全栈审查（5 代理并行） │ ├── 架构与缺陷复核报告-2026-06-14.md # 复核已修项 + 回归审计 + 架构层补充（4 路并行） │ ├── 近期改动代码审查-2026-06-15.md # 工作区 FR-S1/S7/S8 │ ├── 架构审查-2026-06-15.md # 纯架构层（边界/依赖/抽象/扩展性），8 crate + 前端（2 路并行） │ ├── 自研块级memo流式渲染审查-2026-06-15.md # ARC-260615-08 实施走查（splitBlocks/parseBlock/rAF） │ ├── 工作区多角度走查-2026-06-15.md # 工作区22文件547行4路并行（selectType/队列收尾/骨架屏/i18n/DRY） │ ├── 定时走查-2026-06-15-P0复核.md # 定时走查第1轮 │ ├── 定时走查-2026-06-15-第2轮.md # 定时走查第2轮 │ ├── 定时走查-2026-06-15-第3轮.md # 定时走查第3轮 │ ├── 定时走查-2026-06-15-第4轮.md # 定时走查第4轮 │ ├── 定时走查-2026-06-15-第5轮.md # 定时走查第5轮 │ ├── 定时走查-2026-06-15-第6轮.md # 定时走查第6轮 │ ├── 定时走查-2026-06-15-第7轮.md # 定时走查第7轮 │ ├── 定时走查-2026-06-15-第8轮.md # 定时走查第8轮（前端收尾） │ ├── 全局代码review-2026-06-15.md # 7维度并行（DRY/架构/bug/安全/AI可靠/工作流），P1×6+P2×13全闭环 │ ├── 文档全量核对报告-2026-06-15.md # docs全量+根目录4路核对（ARCHITECTURE漂移/模块文档过期/审查状态断层） │ ├── 任务模块问题分析-2026-06-16.md # 任务模块18项核对（真bug 7+增强5+假3+去重3） │ ├── 任务执行与推进能力分析-2026-06-16.md # 推进能力实现度0%，4阶段路径+决策点 │ ├── AI聊天组件极端数据场景分析-2026-06-17.md # aichat 交互层 20 项缺陷（HIGH×2/MED×8/LOW×8） │ ├── aichat-技术债审查-2026-06-21.md # aichat 技术债审查（10 模块 0 P0 / 7 P1 / 25 P2 / 40 P3） │ ├── aichat-会话实测分析-2026-06-22.md # aichat 会话实测分析 │ ├── 全量走查报告-2026-06-28.md # 全量走查报告 │ ├── aichat-会话实测分析-2026-07-07.md # aichat 会话实测分析 │ ├── aichat-对话功能走查-2026-07-17.md # aichat 对话功能走查 │ ├── UIUX扩展审查-2026-08-02.md # UI/UX 扩展审查 │ ├── aichat历史会话实证诊断-2026-08-04.md # aichat 历史会话实证诊断 │ ├── AI工具失败画像复盘-2026-08-08.md # AI 工具失败画像复盘 │ ├── aichat效率走查-2026-08-09.md # aichat 效率走查 │ ├── df-mcp+工具crate走查-2026-08-09.md # df-mcp + 工具 crate 走查 │ ├── settings+审计+布局后端走查-2026-08-09.md # settings/审计/布局后端走查 │ ├── 任务+仪表盘+灵感知识走查-2026-08-09.md # 任务/仪表盘/灵感知识走查 │ ├── 项目详情页走查-2026-08-09.md # 项目详情页走查 │ ├── aichat交互走查-2026-09-28.md # aichat 交互走查 │ ├── aichat可用性与交互成本研究-2026-09-29.md # aichat 可用性与交互成本研究 │ ├── aichat知识库与记忆走查-2026-09-29.md # aichat 知识库与记忆走查 │ ├── 整体UIUX三维走查-2026-09-29.md # 整体 UI/UX 三维走查 │ ├── aichat三路走查报告-2026-10-02.md # aichat 三路走查报告 │ ├── UX走查-Web规范合规-2026-10-05.md # UX 走查 Web 规范合规 │ └── 全系统模块走查索引.md # 全系统模块走查索引 ├── 06-前端开发/ │ ├── View改造指南-2026-06-12.md │ └── 前端架构技术债-2026-06-19.md # 前端架构技术债盘点 ├── 07-项目管理/ │ ├── PROGRESS.md # 项目进展与交接记录 │ ├── Batch.md # 批次执行记录 │ ├── Phase1任务清单-2026-06-12.md │ ├── Phase2计划-2026-06-12.md │ └── 用户主张思想总纲-2026-10.md # 跨会话用户主张蒸馏（注入用） ├── 08-用户指南/ │ ├── 使用手册-2026-06-12.md # 用户手册（对齐 06-15 代码基线） │ ├── AI文件操作工具手册.md # AI 工具 API 全量参考（10 工具，2026-06-16 更新） │ ├── patch_file使用指南.md # patch_file 专项使用指南 └── 09-问题排查/ └── aichat-apikey-401排查-2026-06-15.md ``` --- ## 快速导航 | 分类 | 入口 | 说明 | |------|------|------| | 🚀 快速开始 | [README.md](./README.md) | 安装、启动、快速上手 | | 📖 使用手册 | [使用手册-2026-06-12.md](./08-用户指南/使用手册-2026-06-12.md) | 用户手册 | | 🔧 AI 工具手册 | [AI文件操作工具手册.md](./08-用户指南/AI文件操作工具手册.md) | 10 个文件操作工具 API 参考 | | 📋 项目进度 | [PROGRESS.md](./07-项目管理/PROGRESS.md) | 实时项目进展与状态 | | 📝 工作看板 | [todo.md](./todo.md) | 任务/bug 路踪（P0~P3 + aichat 交互专区） | | 🔍 审查队列 | [待审查.md](./待审查.md) | 代码审查登记+回填（67 条已审） | | ⚖️ 决策项 | [待决策.md](./待决策.md) | 需人工决策的产品/设计/排期 | | ⚙️ 技术文档 | [01-技术文档/](./01-技术文档/) | SQLite CRUD、Tauri IPC 等技术专题 | | 🏗️ 架构设计 | [02-架构设计/](./02-架构设计/) | 架构方案、设计决策、产品定位调整 | | 🔧 模块文档 | [03-模块文档/](./03-模块文档/) | 各 Crate 模块实现与设计 | | 📈 功能迭代 | [04-功能迭代/](./04-功能迭代/) | DEVFLOW-N 系列功能开发过程 | | 🔍 代码审查 | [05-代码审查/](./05-代码审查/) | 审查报告、代码质量分析 | | 🎨 前端开发 | [06-前端开发/](./06-前端开发/) | Vue 3 前端分析、优化、迁移指南 | | 📊 项目管理 | [07-项目管理/](./07-项目管理/) | 任务清单、开发计划、进度跟踪 | | 📚 用户指南 | [08-用户指南/](./08-用户指南/) | 使用手册、工具指南、FAQ | | 🐛 问题排查 | [09-问题排查/](./09-问题排查/) | 排查记录、根因分析 | --- ## 新文档放置规则 | 文档类型 | 放置位置 | |----------|----------| | 技术专题研究 | `01-技术文档/<主题名>.md` | | 架构设计/改进方案 | `02-架构设计/` | | Crate 模块实现文档 | `03-模块文档/` | | 功能开发过程记录 | `04-功能迭代/DEVFLOW-N.<名称>.md` | | 代码审查/走查报告 | `05-代码审查/` | | 前端优化/迁移指南 | `06-前端开发/` | | 项目状态/任务清单 | `07-项目管理/` | | 用户手册/配置指南 | `08-用户指南/` | --- ## 核心文档速查 | 文档 | 路径 | 说明 | |------|------|------| | 架构设计 | `../ARCHITECTURE.md` | 完整架构文档 | | 项目进展 | `./07-项目管理/PROGRESS.md` | 工作进展与交接 | | 工作看板 | `./todo.md` | 任务/bug 跟踪（含决策记录） | | Crate 结构 | `../ARCHITECTURE.md#四crate-结构` | 13 个 Crate 概览 | | 数据模型 | `../ARCHITECTURE.md#六数据模型` | SQLite 表结构定义 | | Phase 规划 | `../ARCHITECTURE.md#八phase-规划` | 5 个 Phase 路线图 | --- ## 技术栈 | 层 | 技术 | 说明 | |----|------|------| | Desktop | Tauri v2 | Rust 后端 + WebView 前端 | | Frontend | Vue 3 + TypeScript + Pinia | Arco Design 组件库 | | Engine | Rust Workspace (13 crate) | 多 crate 架构 | | Storage | SQLite (rusqlite) | 本地优先，零运维 | | AI | Multi-Provider | Claude/GLM/DeepSeek/OpenAI 兼容 | | Build | bun + Vite | 前端构建(`tauri.conf.json` 的 beforeDev/BuildCommand 即 `bun dev` / `bun run build`；单一 lockfile=bun.lock) |