lxy/DevFlow
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
39e0eac39dcee5e377613be4df94098feb09c9dc
DevFlow/docs/INDEX.md
T
lxy 8df4e33656 文档: 看板销账与登记 + 设计档六份 + 索引补录 
- 看板: 907 补注/909~941 登记与销账(含 929 模型停用根因与 4 处次生缺口、931 队列丢失、933/935/937 新需求、939 上下文瓶颈清单、941 C-r0 行为变更待拍板)
- 归档: 全量完成态条目/段落 + 只读核验销账 4 段迁 todo归档/2026-10-10.md(机械搬运零措辞改动,未完成项零丢失)
- 设计档: 输入框列表预览与自动编号 / 定时消息与待发箱持久化(统一 ai_outbox 底座) / 对话内定时延时任务 / 消息渲染管线重构(P0-P2 分期) / 上下文分层组装器落地方案(记账基点单一真值,与并行写者职责划清) / FileTree 大目录方案(推荐后端分页,否决虚拟滚动) / u-relay 运维手册
- 索引与事实修正: docs/INDEX crate 数 8→13 + 四子树补录 25 条 + 专项设计补录 27 条;纠正「项目无独立 ARCHITECTURE.md」等过时声明;统一 bun 口径
- CLAUDE.md: 新增「命名与代码风格」节(变量/方法名精简+准确;DRY·简洁·扩展性·高内聚低耦合·单一真值来源)
2026-10-10 08:09:25 +08:00

182 lines
13 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 文档索引
> 创建: 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 # 团队级基建部署与运维
├── 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) |
Reference in New Issue View Git Blame Copy Permalink