lxy/DevFlow
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4a396f4f88829d06c85f4b38be49022738587021
DevFlow/docs/INDEX.md
绝尘 998a2f243d 文档: 架构方案文档(意图识别论证+多主题愿景/论证+文档物理分类+边界清晰化) 
squash合并:
- 意图识别层论证(8维度+10业界佐证)
- 多主题上下文管理愿景+并存论证+补充论证(多轮agentic)
- 架构设计文档物理分类(四子目录+INDEX+命名规范+引用同步+边界清晰化)
- 前端架构技术债清单归档
2026-06-19 15:04:04 +08:00

12 KiB
Raw Blame History

DevFlow 文档索引

创建: 2026-06-10 | 当前阶段: Phase 2 本地优先开发流程验证 更新: 2026-06-19 | 02-架构设计 核对优化:新增 02-架构设计/INDEX.md 分类索引、补录 3 缺失文档(F-02/F-09/意图识别层)、F-09B 标注过时、文档记录规范 §八 补命名规范；查询效率优化方案补录；06-17 文档缺陷扫描通过(零死链)

目录结构

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-架构设计/
│   ├── INDEX.md                            # 本目录分类索引（按性质四类 + 命名规范摘要）
│   ├── 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-02-技能联想使用-实施机制设计-2026-06-16.md   # / 联想技能 → AI 调用执行机制
│   ├── F-05-多模态实施方案设计-2026-06-16.md     # 多模态 Phase2a/2b/2c 完整方案
│   ├── F-09-多会话并发架构设计-2026-06-19.md     # AiSession 多会话并发 B 阶段（当前真相源）
│   ├── F-09B-多会话并发设计-2026-06-16.md        # (过时·被 F-09 取代) 多会话 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 实施路径
│   ├── 意图识别层论证-2026-06-19.md             # 通用前置意图识别层 8 维度论证
│   ├── 多主题上下文管理愿景-2026-06-19.md       # 多主题多摘要愿景（远期方向，关联 F-15/意图识别）
│   └── 查询效率优化方案-2026-06-19.md             # 查询链路优化（SQL 下推/精确拉取/缓存/字段投影）
├── 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 安装、启动、快速上手
📖 使用手册 使用手册-2026-06-12.md 用户手册
🔧 AI 工具手册 AI文件操作工具手册.md 10 个文件操作工具 API 参考
📋 项目进度 PROGRESS.md 实时项目进展与状态
📝 工作看板 todo.md 任务/bug 路踪（P0~P3 + aichat 交互专区）
🔍 审查队列 待审查.md 代码审查登记+回填（67 条已审）
⚖️ 决策项 待决策.md 需人工决策的产品/设计/排期
⚙️ 技术文档 01-技术文档/ SQLite CRUD、Tauri IPC 等技术专题
🏗️ 架构设计 02-架构设计/ 架构方案、设计决策、产品定位调整
🔧 模块文档 03-模块文档/ 各 Crate 模块实现与设计
📈 功能迭代 04-功能迭代/ DEVFLOW-N 系列功能开发过程
🔍 代码审查 05-代码审查/ 审查报告、代码质量分析
🎨 前端开发 06-前端开发/ Vue 3 前端分析、优化、迁移指南
📊 项目管理 07-项目管理/ 任务清单、开发计划、进度跟踪
📚 用户指南 08-用户指南/ 使用手册、工具指南、FAQ
🐛 问题排查 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）
Reference in New Issue View Git Blame Copy Permalink