DevFlow/docs/02-架构设计/INDEX.md

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 选型代码复用
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	📐 设计	项目级知识图谱 + 任务队列:依赖解析 / 优先级调度

---

四、构想 / 改进方案 / 审查报告(主题命名)

瞬时构想、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 跑题改进试验:系统 prompt 加固 / 上下文钳制 / 行为约束

---

文档命名规范摘要

完整规范见 文档记录规范-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-架构设计/子目录/)。