绝尘
535525c2f6
- 定义 AI Native vs 传统范式的差异(人从操作者→决策者) - 优先级矩阵:P0人设+多Agent → P1模板+Git/CI → P2审批+算法 - 明确不做方向(全自动/MCP/跨端)及理由 - Agent架构说明添加前向引用 - 注册文档到架构 INDEX
16 KiB
16 KiB
02-架构设计 索引
创建:2026-06-19 | 维护:本目录文档增删时同步 上级索引:../INDEX.md 命名规范:见本目录 文档记录规范-2026-06-14.md §九「文档命名规范」
本目录是 DevFlow 的架构设计 / 设计决策 / 设计方案 / 构想文档集合(不含实现流水,流水走 PROGRESS.md;不含审查报告,审查走 05-代码审查/)。
按性质分四类,每类一个子目录:
| 子目录 | 内容 |
|---|---|
| 滚动规范/ | 长期维护的真相源 / 规范 / 决策记录 |
| 已编号方案/ | 带 F/B/CR 编号的方案文档 |
| 专项设计/ | 无编号的主题设计 / 审查派生方案 |
| 构想审查/ | 瞬时构想 / UX 改进方案 / 模块审查报告 / 论证 |
一、规范与决策记录(滚动维护)
长期维护的真相源 / 规范文档,跨多个 Sprint 持续追加。子目录:滚动规范/
| 文档 | 状态 | 核心内容 |
|---|---|---|
| 业务系统设计-2026-06-12.md | 🏗 ARCHITECTURE 载体 | 项目无独立 ARCHITECTURE.md,本文档为实质载体:产品定位 / crate 结构 / 数据模型 / Phase 规划 |
| Phase1架构决策-2026-06-12.md | 📐 ADR | Phase 1 引擎骨架阶段架构级选型(ADR-001 引擎不绑定业务 等) |
| 功能决策记录-2026-06-14.md | 📋 滚动 | 功能需求规格 + 设计决策规格(为什么这么定 / 要做什么)。最高频引用(67 入链) |
| 功能决策记录-归档-2026-06-14.md | 🗄 归档只读 | 从主文档归档:纯流水 / 老 Sprint 决策 / UX 微调 / 已被取代细节 |
| 经验记录-2026-06-14.md | 📋 滚动 | 踩坑 / 约定 / 技巧 / bug 排查教训 |
| 文档记录规范-2026-06-14.md | 📐 规范 | 文档路由规则 / 职责矩阵 / 命名规范 / 治理 hook |
| 功能创意池-2026-06-14.md | 💡 待评估 | 5 架构创意(演化 / 时效 / 回溯 / 债务 / 契约),评估通过才转 concept |
二、架构设计方案(已编号,F/B/CR 系列)
带功能 / bug / review 编号的方案文档,编号对应 todo.md / 待审查.md 跟踪项。子目录:已编号方案/
| 文档 | 编号 | 状态 | 核心内容 |
|---|---|---|---|
| F-01-模型能力系统与智能路由设计-2026-06-16.md | F-260614-01 | ✅ 已落地(路由改方向) | 模型配置四维度 / 探测器 / 厂商拉取 / 路由器 |
| F-02-技能联想使用-实施机制设计-2026-06-16.md | F-260614-02 | 📐 设计 | / 联想技能 → AI 调用执行机制 |
| F-05-多模态实施方案设计-2026-06-16.md | F-260614-05 | 🚧 阶段1-2已落地(形态偏离) | 多模态 content/parts 设计 + provider 适配 |
| F-07-df-ai-core-trait下沉设计-2026-06-14.md | F-260614-07 | ✅ 已落地 | LlmProvider trait 下沉新 crate df-ai-core |
| F-09-多会话并发架构设计-2026-06-19.md | F-260616-09 | 📐 草案 | AiSession 单例 → 多会话并发(B 阶段)。当前真相源 |
| F-09B-多会话并发设计-2026-06-16.md | F-260616-09 | 🗄 过时(被 F-09 取代) | 06-16 旧版,行号已过期。保留回溯,新设计看 F-09 |
| F-15-上下文管理增强设计-2026-06-16.md | F-260616-15 | 📐 设计 | ContextManager 分段 / 压缩 / 裁剪 |
| F-260620-01-跨端AIChat-微信小程序-2026-06-20.md | F-260620-01 | 📐 草案(灵感 4495fbcd 待晋升) | 微信小程序 ↔ Rust 云后端(df-relay) ↔ DevFlow 桌面端(df-tunnel)实时同步,Rust 选型代码复用 |
| F-260622-01-跨端AIChat-Phase3联调设计-2026-06-22.md | F-260622-01 | 📐 设计草案 | F-260620-01 Phase3 实施续篇:三层就绪后如何接线联调(协议统一+桥接方案) |
| 消息级溯源P2-切读方案-2026-06-28.md | F-260619-04-P2 | ✅ 已落地 | 消息级溯源 P2 一次性切读 + 脚本迁移历史数据 |
| B-03-人工审批响应机制-2026-06-14.md | B-260614-03 | ✅ 已落地(B-03a) | HumanNode execute subscribe/send/select 完整审批链 |
| B-260616-21排查方案-2026-06-16.md | B-260616-21 | 📐 排查方案 | 工具卡片重复渲染根因(audit 重复 emit Started) + 修复方案 |
| F-260622-01-跨端AIChat-Phase3联调设计-2026-06-22.md | F-260622-01 | 📐 设计 | 微信小程序跨端联调:云隧道握手 / MCP 工具路由 / DF 事件同步 |
| 消息级溯源P2-切读方案-2026-06-28.md | — | 📐 设计 | 消息级溯源 Phase 2:切读切换到 ai_messages 视图 |
三、专项设计文档(无编号,主题命名)
跨多个跟踪项的专题设计 / 审查发现派生方案。子目录:专项设计/
| 文档 | 状态 | 核心内容 |
|---|---|---|
| Agent架构说明-2026-06-14.md | 📐 现状盘点 | Agent 引擎单链 ReAct 能力边界(查实的事实,非构想) |
| 规格契约自检机制-2026-06-14.md | 🗄 归档(被其他机制覆盖) | 活契约(锚点 + AI 自检 + 子代理)取代独立 spec。核验(2026-06-28):0 行代码,其核心价值(规格与实现一致性检查)已被 L1 求助协议 + ai_self_review gate 覆盖,归档不实施 |
| AiNode自审实施方案-2026-06-16.md | ✅ ②-⑤已落地 | AiNode 自审闸门 + verdict DAG 阻断 |
| secret下沉与provider注入方案-2026-06-16.md | ✅ 方案 B 全量落地 | secret 纯密钥下沉 df-storage |
| patch_file工具设计-2026-06-15.md | ✅ 已落地(2026-06-28 核验) | AI 局部编辑工具:old_text 精确匹配 + 三层防御 + 三模式(old_text/replace_lines/anchor)。仅文本(不支持二进制 encoding,合理设计) |
| generating状态机加固-2026-06-15.md | 📐 设计 | generating 生命周期状态机(guard 收敛) |
| 密钥迁移健壮性-2026-06-15.md | ✅ 已落地(2026-06-28 核验) | 空 api_key 不覆盖未迁移态明文密钥(provider.rs:104-136 即时迁移补密钥 + 阻断保存) |
| 条件表达式引擎-2026-06-15.md | ✅ 已落地(2026-06-28 核验) | ConditionEngine 手写求值器 + JSON Path/嵌套/数组索引/数值比较 + executor 集成 + 前端边条件编辑入口 |
| 工作流脚本执行边界-2026-06-15.md | ✅ 已落地(2026-06-28 核验) | ScriptNode 命令执行安全边界:白名单/黑名单(env 配置)+ 危险关键词告警 |
| 查询效率优化方案-2026-06-19.md | 📐 待评审(PERF-260619-01) | SQL 下推 / 精确拉取 / 缓存 / 字段投影。核验:查询能力补全已落地(task/project/idea 均 keyword/order_by/limit/offset),性能优化待评审 |
| 任务推进链实施路径-2026-06-16.md | 📐 规划定稿(D-01~04已决) | advance_task 走 df-nodes Node trait,4 阶段路径 |
| 推进链阶段2实施路径-2026-06-16.md | 📐 设计(F-260616-06) | 工作流联动任务推进:task_id + 完成回调 + DAG 模板 |
| 消息拆分存储设计-2026-06-19.md | ✅ 已落地(2026-06-28 核验) | ai_messages 表 + V21 全量迁移 + 读写全部切到消息表(旧 JSON 列仅作老库兼容回退) |
| 消息级溯源设计-2026-06-19.md | ✅ 已落地(2026-06-28 核验) | ChatMessage.id + source_ref/audit/idea 四场景从对话级升级消息级 + P2 切读全部完成 |
| 全局事件数据总线-2026-06-21.md | 🟡 部分落地(基建就位,消费者未接) | pub-sub + request-reply + 流式 reply 统一总线。核验(2026-06-28):基建(AI/工作流两路总线)+ 20+ emit 点双写就位,但真实订阅方/前端镜像/tunnel 透传均未接入(空转)。阶段 2-6 待真实痛点驱动 |
| 三层模型-流程模板与人设体系-2026-06-28.md | 📐 设计 | 模板→工作流→人设三层架构:流程模板YAML定义、人设AgentPersona数据结构、三层实例化流程 |
| aichat体验与agent能力系统化重构-2026-06-21.md | 📐 设计 | AI Chat 体验 + Agent 能力统一重构:消息模型 / 上下文管理 / 工具路由 |
| 查询能力补全方案-2026-06-21.md | ✅ 已落地(2026-06-28 核验) | 查询接口能力补全:task/project/idea 均 keyword/order_by/limit/offset 多维动态 WHERE |
| AST符号解析-设计-2026-06-24.md | ✅ Phase1 已落地(2026-06-28 核验) | AST 符号解析:read_symbol 工具已注册(tool_registry.rs:1506-1547)+ 基线测试守护 |
| 插件机制-设计-2026-06-24.md | 📐 设计 | 插件系统:动态加载 / 生命周期 / 权限沙箱 |
| AI对话目标丢失诊断-2026-06-26.md | 📐 诊断 | AI 对话目标丢失根因分析:上下文漂移 / 意图衰减 |
| AI原生上下文地图与去AI化进化系统-2026-06-26.md | 📐 设计 | AI 原生上下文地图:语义索引 / 去 AI 化渐进演进路径 |
| 项目知识图谱与任务队列系统-2026-06-26.md | 📐 设计 | 项目级知识图谱 + 任务队列:依赖解析 / 优先级调度 |
| 工程系统设计-2026-06-29.md | ✅ 已落地 | 项目多工程(Module) + Git 状态查询 + 文件浏览器 + Git AI 工具(只读3+写3) |
| 架构债迁移设计-2026-06-29.md | 📐 设计草案 | #8/#15/#18/#19 架构债迁移路径(AI状态机抽离/IPC错误结构化/配置统一/连接池) |
四、构想 / 改进方案 / 审查报告(主题命名)
瞬时构想、UX 改进方案、模块审查报告、架构论证。子目录:构想审查/
| 文档 | 状态 | 核心内容 |
|---|---|---|
| 任务推进构想-2026-06-14.md | 📐 AI-First 推进链设计 | 任务由 AI 执行 → AI 自审 → 人工核对(人转审批者) |
| aichat审查报告-2026-06-14.md | 📋 审查(AR-1~11) | aichat 全链路 6 块发现 + 修复进度对照 |
| aichat异步审批构想-2026-06-14.md | 💡 构想 | 审批 pending 不卡对话 |
| aichat交互体验改进方案-2026-06-14.md | 📐 待讨论 | 消息编辑 / 流式渲染 / 对话管理 等非授权交互 |
| aichat授权体验改进方案-2026-06-14.md | 📐 待讨论 | tool_calls 风险分流授权机制 |
| aichat信息密度构想-2026-06-14.md | 💡 构想 | 卡片折叠 + 会话详情面板 |
| aichat流式Markdown渲染调研-2026-06-15.md | 📐 调研(未实施) | AR-1 流式渲染优化:rAF 节流 / 块级 diff / 换库 |
| 工作流审批审查报告-2026-06-14.md | 📋 审查 | 审批链路对抗审查(头号 bug human_node.rs:41 缺 await) |
| 对抗论证裁决报告-2026-06-12.md | 🗄 归档 | 项目方向三路对抗论证裁决(方向有价值 scope 须砍) |
| 产品定位调整-2026-06-12.md | 📐 方向 | 从「想法到代码」到「想法到创作」 |
| 前后端类型对齐-2026-06-12.md | 🗄 已过时 | ts-rs 代码生成未采用,正文枚举表不反映代码。实际形态以 crates/df-types/src/types.rs 为准(见正文顶部实施状态块) |
| 多主题并存论证-2026-06-19.md | 📐 论证(供决策) | 多主题交织并行 8 维度论证:SOTA 准确率天花板 + 副作用工具误判代价 → 近期不做 |
| 意图识别层论证-2026-06-19.md | 📐 论证(供决策) | 通用前置意图识别层 8 维度论证 + 触发时机 |
| 多主题上下文管理愿景-2026-06-19.md | 💡 远期愿景 | 无感多主题对话:主题检测前置 + 多主题多摘要(关联 F-15 / 意图识别) |
| 多主题并存补充论证-多轮模式-2026-06-19.md | 📐 论证(供决策) | agentic 多轮模式可突破天花板,但近期结论不变 |
| 跑题改进试验记录-2026-06-20.md | 📋 试验记录 | AI Chat 长对话跑题根因治:测试计划+迭代过程+改进前基线+遗留 |
| AI-Native方向与路线图-2026-06-29.md | 📐 方向 | AI Native 优先级矩阵:P0人设+多Agent→P1模板+Git/CI→P2审批政策+算法验证 |
根目录文档(不在子目录)
| 文档 | 状态 | 核心内容 |
|---|---|---|
| 单对话并行多轮-设计-2026-06-20.md | 📐 设计 | aichat B 路线:单对话内 AI 拆子流并行跑,加速多文件/多方案/多模块对比 |
| 单对话并行多轮-Phase0落地路线图-2026-06-20.md | 📐 路线图 | 承接设计 Phase 1/2/3 实施前必须补齐的机制(Phase 0 = 物理可行性地基) |
文档命名规范摘要
完整规范见 文档记录规范-2026-06-14.md §九。摘要:
| 类别 | 命名格式 | 示例 |
|---|---|---|
| 功能 / bug / review 方案 | <编号>-<主题>-<日期>.md |
F-09-多会话并发架构设计-2026-06-19.md |
| 滚动维护文档 | <主题>-<日期>.md(不带编号) |
功能决策记录-2026-06-14.md |
| 专题设计 / 构想 | <主题>-<日期>.md(主题含领域前缀如 aichat / 工作流) |
aichat审查报告-2026-06-14.md |
被取代 / 过时文档:不删,文件顶部加 ## 实施状态 或 > 过时 块标注,本索引「状态」列标 🗄。
物理分类说明(2026-06-19):本目录按性质分四个子目录物理归档(滚动规范 / 已编号方案 / 专项设计 / 构想审查),INDEX.md 留根做分类索引。文档间引用统一用相对路径(同子目录
./、跨子目录../子目录/、跨 docs 目录../../02-架构设计/子目录/)。