lxy/DevFlow
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

文档: 看板销账与登记 + 设计档六份 + 索引补录

Browse Source 
- 看板: 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·简洁·扩展性·高内聚低耦合·单一真值来源)
This commit is contained in:
lxy
2026-10-10 08:09:25 +08:00
parent b37279f3a2
commit 8df4e33656
14 changed files with 1747 additions and 129 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/INDEX.md
+44 -57
View File
@@ -2,7 +2,7 @@
> 创建: 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-06-19 02-架构设计 核对优化(新增分类索引/补录缺失文档/命名规范);06-17 文档缺陷扫描通过(零死链)
> 历次: 2026-10-10 按 ls 对齐现存文件(crate 数 8→13;01/04/05/06 子树补录漏登文档);06-19 02-架构设计 核对优化(新增分类索引/补录缺失文档/命名规范);06-17 文档缺陷扫描通过(零死链)
---
@@ -15,57 +15,22 @@ docs/
├── 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
│ └── AntV-X6调研报告与引入计划-2026-06-30.md # 图可视化层选型(v3.1.7)+ 依赖图落地计划
│ ├── AntV-X6调研报告与引入计划-2026-06-30.md # 图可视化层选型(v3.1.7)+ 依赖图落地计划
│ ├── 多代理流水线实战经验-2026-10-03.md # 多代理流水线实战经验
│ └── 团队级基建-部署与运维-2026-10-05.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-07-20.md # 上下文管理现状评估、业界对标、7个发散方向与组合分析
│ ├── 上下文管理演进-任务技术设计-2026-07-20.md # T2命名空间/T4工作流DAG/T3结构化摘要技术设计与推演
│ ├── 上下文管理演进-执行计划-2026-07-20.md # Wave 划分、agent 并行策略、接口契约、验证 gate、回滚策略
│ ├── 多主题上下文管理愿景-2026-06-19.md # 多主题多摘要愿景（远期方向，关联 F-15/意图识别）
│ └── 查询效率优化方案-2026-06-19.md # 查询链路优化（SQL 下推/精确拉取/缓存/字段投影）
│ ├── 滚动规范/ # 长期维护的真相源 / 规范 / 决策记录
│ ├── 已编号方案/ # 带 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
@@ -79,7 +44,9 @@ docs/
│ ├── 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
│ ├── 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 问题）
@@ -112,15 +79,35 @@ docs/
│ ├── 任务模块问题分析-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 # (归档)复核已修项+回归审计
│ ├── 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
│ ├── View改造指南-2026-06-12.md
│ └── 前端架构技术债-2026-06-19.md # 前端架构技术债盘点
├── 07-项目管理/
│ ├── PROGRESS.md # 项目进展与交接记录
│ ├── Batch.md # 批次执行记录
│ ├── Phase1任务清单-2026-06-12.md
│ └── Phase2计划-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 更新）
@@ -176,7 +163,7 @@ docs/
| 架构设计 | `../ARCHITECTURE.md` | 完整架构文档 |
| 项目进展 | `./07-项目管理/PROGRESS.md` | 工作进展与交接 |
| 工作看板 | `./todo.md` | 任务/bug 跟踪（含决策记录） |
| Crate 结构 | `../ARCHITECTURE.md#四crate-结构` | 8 个 Crate 概览 |
| Crate 结构 | `../ARCHITECTURE.md#四crate-结构` | 13 个 Crate 概览 |
| 数据模型 | `../ARCHITECTURE.md#六数据模型` | SQLite 表结构定义 |
| Phase 规划 | `../ARCHITECTURE.md#八phase-规划` | 5 个 Phase 路线图 |
@@ -188,7 +175,7 @@ docs/
|----|------|------|
| Desktop | Tauri v2 | Rust 后端 + WebView 前端 |
| Frontend | Vue 3 + TypeScript + Pinia | Arco Design 组件库 |
| Engine | Rust Workspace (8 crate) | 多 crate 架构 |
| Engine | Rust Workspace (13 crate) | 多 crate 架构 |
| Storage | SQLite (rusqlite) | 本地优先，零运维 |
| AI | Multi-Provider | Claude/GLM/DeepSeek/OpenAI 兼容 |
| Build | npm + Vite | 前端构建（不要使用 bun） |
| Build | bun + Vite | 前端构建(`tauri.conf.json` 的 beforeDev/BuildCommand 即 `bun dev` / `bun run build`；单一 lockfile=bun.lock) |