绝尘
7911bc292c
审查回填(均 ✅ PASS):
- CR-22 摘要不改 updated_at / CR-23 P2 批次A 读 / CR-24 批次B 写 / CR-25 跑题P0 /
CR-26 跑题P1 / CR-27 跑题P2(6维度全过,topic 无破坏 + 双高置信保守)
跨端 AI Chat 设计(F-260620-01):
- 三层架构 df-tunnel/df-relay/df-miniapp + Rust 云后端选型(代码复用/类型一致/团队版演进)
- todo 规划跨端 P1-P4 + 跑题修复 P0-P2
跑题改进试验记录:
- db 基线(3 长对话:assistant 文本仅 4-5%,95% tool_result,47% echo)
- 5 类跑题现象与 P0-P2 五改进精准对应 + 四层测试计划 + 迭代过程
12 KiB
12 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 选型代码复用 |
| 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) + 修复方案 |
三、专项设计文档(无编号,主题命名)
跨多个跟踪项的专题设计 / 审查发现派生方案。子目录:专项设计/
| 文档 | 状态 | 核心内容 |
|---|---|---|
| Agent架构说明-2026-06-14.md | 📐 现状盘点 | Agent 引擎单链 ReAct 能力边界(查实的事实,非构想) |
| 规格契约自检机制-2026-06-14.md | 📐 设计待落地 | 活契约(锚点 + AI 自检 + 子代理)取代独立 spec |
| AiNode自审实施方案-2026-06-16.md | ✅ ②-⑤已落地 | AiNode 自审闸门 + verdict DAG 阻断 |
| secret下沉与provider注入方案-2026-06-16.md | ✅ 方案 B 全量落地 | secret 纯密钥下沉 df-storage |
| patch_file工具设计-2026-06-15.md | 📐 设计待实施(P0) | AI 局部编辑工具:old_text 精确匹配 + 三层防御 |
| generating状态机加固-2026-06-15.md | 📐 设计 | generating 生命周期状态机(guard 收敛) |
| 密钥迁移健壮性-2026-06-15.md | 📐 设计未实施 | 空 api_key 不覆盖未迁移态明文密钥 |
| 条件表达式引擎-2026-06-15.md | 📐 设计(R-PD-3) | ConditionEngine 接线 + 条件边求值 |
| 工作流脚本执行边界-2026-06-15.md | 📐 设计(R-PD-2) | ScriptNode 任意 shell 执行安全边界 |
| 查询效率优化方案-2026-06-19.md | 📐 待评审(PERF-260619-01) | SQL 下推 / 精确拉取 / 缓存 / 字段投影 |
| 任务推进链实施路径-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 | 📐 设计待实施(F-260619-03) | ai_messages 表 + V21 全量迁移 + 三阶段渐进切换(脏标记→双写→切读) |
| 消息级溯源设计-2026-06-19.md | 📐 设计待实施(F-260619-04) | ChatMessage.id + source_ref/audit/idea 四场景从对话级升级消息级 |
四、构想 / 改进方案 / 审查报告(主题命名)
瞬时构想、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-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-架构设计/子目录/)。