172 lines
10 KiB
Markdown
172 lines
10 KiB
Markdown
# DevFlow 文档索引
|
||
|
||
> 创建: 2026-06-10 | 当前阶段: Phase 2 本地优先开发流程验证
|
||
> 更新: 2026-06-17 | 文档缺陷扫描通过(零死链)；06-16/17 新增文档补录；aichat交互缺陷+后端Bug扫描登记
|
||
|
||
---
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
docs/
|
||
├── README.md # 快速开始与文档导航
|
||
├── INDEX.md # 本文件 — 文档导航
|
||
├── todo.md # 工作看板（任务/bug 跟踪，~1200 行含历史）
|
||
├── 待审查.md # 代码审查队列（CR 登记+回填，67 条已审）
|
||
├── 待决策.md # 需人工决策项（产品取舍/方向选型/排期）
|
||
├── 待决策论证-2026-06-16.md # (归档) 7 项决策论证（D-01~04 已定 / DEC-01~03 已闭环）
|
||
├── 01-技术文档/
|
||
│ ├── SQLite-CRUD模式-2026-06-12.md
|
||
│ └── Tauri-IPC模式-2026-06-12.md
|
||
├── 02-架构设计/
|
||
│ ├── Phase1架构决策-2026-06-12.md
|
||
│ ├── 业务系统设计-2026-06-12.md
|
||
│ ├── 产品定位调整-2026-06-12.md
|
||
│ ├── 前后端类型对齐-2026-06-12.md
|
||
│ ├── 对抗论证裁决报告-2026-06-12.md
|
||
│ ├── 功能决策记录-2026-06-14.md # 需求规格 + 设计决策规格
|
||
│ ├── 功能决策记录-归档-2026-06-14.md
|
||
│ ├── 功能创意池-2026-06-14.md # 5 架构创意（演化/时效/回溯/债务/契约）
|
||
│ ├── 经验记录-2026-06-14.md
|
||
│ ├── 文档记录规范-2026-06-14.md
|
||
│ ├── 规格契约自检机制-2026-06-14.md
|
||
│ ├── Agent架构说明-2026-06-14.md
|
||
│ ├── B-03-人工审批响应机制-2026-06-14.md
|
||
│ ├── aichat审查报告-2026-06-14.md # AI Chat 模块代码审查
|
||
│ ├── aichat异步审批构想-2026-06-14.md
|
||
│ ├── aichat交互体验改进方案-2026-06-14.md
|
||
│ ├── aichat授权体验改进方案-2026-06-14.md
|
||
│ ├── aichat信息密度构想-2026-06-14.md
|
||
│ ├── 任务推进构想-2026-06-14.md
|
||
│ ├── 任务推进链实施路径-2026-06-16.md # 4 阶段实施路径（阶段1决策已定）
|
||
│ ├── aichat流式Markdown渲染调研-2026-06-15.md # 流式渲染优化方案（rAF节流/块级diff/换库）
|
||
│ ├── patch_file工具设计-2026-06-15.md # patch_file 完整设计（API/三层防御/边界情况）
|
||
│ ├── 工作流审批审查报告-2026-06-14.md
|
||
│ ├── F-07-df-ai-core-trait下沉设计-2026-06-14.md
|
||
│ ├── 密钥迁移健壮性-2026-06-15.md
|
||
│ ├── 工作流脚本执行边界-2026-06-15.md
|
||
│ ├── 条件表达式引擎-2026-06-15.md
|
||
│ ├── generating状态机加固-2026-06-15.md
|
||
│ ├── AiNode自审实施方案-2026-06-16.md # AiNode 自审闸门+verdict DAG 阻断
|
||
│ ├── B-260616-21排查方案-2026-06-16.md # 工具卡重复渲染排查（audit去重+前端幂等）
|
||
│ ├── F-01-模型能力系统与智能路由设计-2026-06-16.md # 模型能力 Phase 3 设计
|
||
│ ├── F-05-多模态实施方案设计-2026-06-16.md # 多模态 Phase2a/2b/2c 完整方案
|
||
│ ├── F-09B-多会话并发设计-2026-06-16.md # 多会话 A/B 路线架构设计
|
||
│ ├── F-15-上下文管理增强设计-2026-06-16.md # 会话分段/压缩/裁剪设计
|
||
│ ├── secret下沉与provider注入方案-2026-06-16.md # secret 纯密钥下沉 df-storage 方案
|
||
│ └── 推进链阶段2实施路径-2026-06-16.md # advance_task 走 df-nodes 实施路径
|
||
├── 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
|
||
├── 05-代码审查/
|
||
│ ├── 全栈代码审查报告-2026-06-14.md # Rust+Tauri+Vue 全栈审查（5 代理并行）
|
||
│ ├── 架构与缺陷复核报告-2026-06-14.md # 复核已修项 + 回归审计 + 架构层补充（4 路并行）
|
||
│ ├── 近期改动代码审查-2026-06-15.md # 工作区 FR-S1/S7/S8 + 近 5 提交（3 路并行）
|
||
│ ├── 架构审查-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）
|
||
│ ├── 工作流审批审查报告-2026-06-14.md # (归档)工作流审批链路审查
|
||
│ ├── 前后端类型对齐-2026-06-12.md # (归档)Rust↔TS 类型契约核对
|
||
│ ├── 对抗论证裁决报告-2026-06-12.md # (归档)df-ideas 对抗评估裁决
|
||
│ └── 架构与缺陷复核报告-2026-06-14.md # (归档)复核已修项+回归审计
|
||
├── 06-前端开发/
|
||
│ └── View改造指南-2026-06-12.md
|
||
├── 07-项目管理/
|
||
│ ├── Phase1任务清单-2026-06-12.md
|
||
│ └── Phase2计划-2026-06-12.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](../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` | 完整架构文档 |
|
||
| 项目进展 | `../PROGRESS.md` | 工作进展与交接 |
|
||
| 工作看板 | `./todo.md` | 任务/bug 跟踪（含决策记录） |
|
||
| Crate 结构 | `../ARCHITECTURE.md#四crate-结构` | 8 个 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 (8 crate) | 多 crate 架构 |
|
||
| Storage | SQLite (rusqlite) | 本地优先，零运维 |
|
||
| AI | Multi-Provider | Claude/GLM/DeepSeek/OpenAI 兼容 |
|
||
| Build | npm + Vite | 前端构建（不要使用 bun） |
|