diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index 3c37b02..dfa9ed7 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -535,6 +535,8 @@ CREATE TABLE app_settings ( ## 七、三层模型：模板 → 工作流 → 人设 +> 本章详细设计已迁至专项文档，详见 [docs/02-架构设计/专项设计/三层模型-流程模板与人设体系-2026-06-28.md](./docs/02-架构设计/专项设计/三层模型-流程模板与人设体系-2026-06-28.md)。此处仅保留摘要性定义。 + ### 7.1 三层定义 | 层 | 回答的问题 | 本质 | 生命周期 | 当前状态 | @@ -543,126 +545,9 @@ CREATE TABLE app_settings ( | **工作流 (Workflow)** | 怎么执行 | 模板的运行时实例（DAG + 状态 + 数据绑定） | 随项目启停，单次执行归档 | ✅ df-workflow 核心完成 | | **人设 (Persona)** | 谁来做 | Agent 角色卡（system prompt + 工具集 + 行为规则） | 长期存在，跨节点复用 | ⬜ 待设计 | -### 7.2 三者关系 +**关键原则**：模板不绑定具体人设、工作流不感知人设、人设与模板解耦。 -``` -流程模板 (蓝图) - │ 实例化（填入项目参数） - ▼ -工作流实例 (运行时 DAG) - │ 分配人设（绑定到每个 AINode） - ▼ -人设驱动 Agent 执行 -``` - -**关键点**： -- 模板不绑定具体人设，只标注"建议人设类型"，实例化时由用户覆盖 -- 工作流不感知人设，只管 DAG 执行；人设注入发生在 AINode 执行时 -- 人设与模板解耦：同一个人设可用于不同模板的同类节点 - -### 7.3 模板实例化流程 - -``` -① 选择模板 → "功能开发模板" - 模板定义: [需求分析]→[架构设计]→[编码]→[测试]→[审查]→[发布] - 建议人设: analyst → architect → coder → tester → reviewer → none - -② 实例化为工作流 DAG - ┌─ AINode(需求分析) 建议人设: analyst - ├─ AINode(架构设计) 建议人设: architect - ├─ AINode(编码) 建议人设: coder - ├─ AINode(单元测试) 建议人设: tester - ├─ ScriptNode(运行测试) 无人设（纯脚本） - ├─ HumanNode(审批发布) 无人设（人工） - └─ AINode(发布说明) 建议人设: writer - -③ 实际分配人设（可覆盖） - 编码节点 → coder-rust（项目是 Rust 后端） - 测试节点 → tester-py（测试框架是 Python） - -④ 执行 - 工作流引擎按 DAG 拓扑调度节点 - 每个 AINode 执行时载入对应人设的 system_prompt + 工具集 - NodeContext 中传递 persona_id，AI Node 据此取人设配置 -``` - -### 7.4 人设定义 - -```rust -/// 智能体人设（Agent 角色卡） -pub struct AgentPersona { - pub id: PersonaId, - pub name: String, // 人设名称 - pub description: String, // 一句话描述 - pub system_prompt: String, // 角色系统提示词 - pub allowed_tools: Vec, // 可用工具列表 - pub suggested_tier: ModelTier, // 推荐模型层级 - pub output_format: OutputFormat, // 输出格式约束 - pub rules: Vec, // 行为规则 - pub examples: Vec, // Few-shot 样例 -} - -// 预置人设（平台内置，用户可自定义扩展） -Persona::coder → "你是资深 Rust/TS 工程师..." -Persona::reviewer → "你是代码审查员，关注安全漏洞..." -Persona::architect → "你是系统架构师，关注模块划分..." -Persona::tester → "你是测试工程师，生成边界用例..." -Persona::analyst → "你是需求分析师，拆解用户故事..." -``` - -### 7.5 模板示例：功能开发模板（YAML） - -```yaml -# templates/feature-dev.yaml -id: feature-dev -name: 功能开发模板 -description: 标准功能开发流程，从需求分析到发布 -template_version: 1 - -nodes: - - id: analysis - type: ai - persona_hint: analyst - prompt: "分析以下需求：{{inputs.requirement}}" - inputs: - requirement: "$ctx.requirement" - outputs: - prd: text - - - id: design - type: ai - persona_hint: architect - prompt: "基于 PRD 设计架构：{{inputs.analysis.prd}}" - inputs: - analysis: "$nodes.analysis" - outputs: - arch_doc: text - - - id: coding - type: ai - persona_hint: coder - prompt: "按架构设计实现：{{inputs.design.arch_doc}}" - inputs: - design: "$nodes.design" - outputs: - code: text - - - id: review - type: ai - persona_hint: reviewer - prompt: "审查代码：{{inputs.coding.code}}" - inputs: - coding: "$nodes.coding" - -quality_gates: - - node: review - condition: "output.verdict == 'pass'" - on_fail: "goto coding" - -artifacts: - prd: "$nodes.analysis.prd" - code: "$nodes.coding.code" - review_report: "$nodes.review.text" +详细定义、三者关系、实例化流程、数据结构及 YAML 模板示例见 [专项设计文档](./docs/02-架构设计/专项设计/三层模型-流程模板与人设体系-2026-06-28.md)。 ## 八、Phase 规划 diff --git a/crates/df-ai/src/coordinator.rs b/crates/df-ai/src/coordinator.rs index db8aefc..e6e255f 100644 --- a/crates/df-ai/src/coordinator.rs +++ b/crates/df-ai/src/coordinator.rs @@ -5,6 +5,7 @@ /// Agent 协调器 /// /// TODO: 实现多 Agent 协作逻辑 +#[deprecated(note = "B 路线占位，勿用于生产")] pub struct AgentCoordinator; impl AgentCoordinator { diff --git a/crates/df-storage/src/crud/idea_repo.rs b/crates/df-storage/src/crud/idea_repo.rs index 00af762..43025ae 100644 --- a/crates/df-storage/src/crud/idea_repo.rs +++ b/crates/df-storage/src/crud/idea_repo.rs @@ -301,10 +301,11 @@ impl IdeaRepo { params_vec.push(Box::new(s.clone())); } if let Some(kw) = &keyword { - let pat = format!("%{kw}%"); + let escaped = kw.replace('%', "\\%").replace('_', "\\_"); + let pat = format!("%{escaped}%"); let p1 = params_vec.len() + 1; let p2 = p1 + 1; - where_clauses.push(format!("(title LIKE ?{p1} OR description LIKE ?{p2})")); + where_clauses.push(format!("(title LIKE ?{p1} OR description LIKE ?{p2}) ESCAPE '\\'")); params_vec.push(Box::new(pat.clone())); params_vec.push(Box::new(pat)); } @@ -545,7 +546,8 @@ impl KnowledgeRepo { /// 克制检索: top-N≤3(由调用方 limit 控制),精确匹配优先(语义模糊后做)。 pub async fn search(&self, query: &str, kind: Option<&str>, limit: usize) -> Result> { let conn = self.conn.clone(); - let pattern = format!("%{}%", query); + let escaped = query.replace('%', "\\%").replace('_', "\\_"); + let pattern = format!("%{escaped}%"); let kind = kind.map(|s| s.to_owned()); let limit_i = limit as i64; tokio::task::spawn_blocking(move || { @@ -553,7 +555,7 @@ impl KnowledgeRepo { let mut results = Vec::new(); if let Some(k) = &kind { let mut stmt = guard - .prepare(&format!("SELECT {KNOWLEDGE_COLS} FROM knowledges WHERE status = 'published' AND (title LIKE ?1 OR content LIKE ?2) AND kind = ?3 ORDER BY reuse_count DESC LIMIT ?4")) + .prepare(&format!("SELECT {KNOWLEDGE_COLS} FROM knowledges WHERE status = 'published' AND (title LIKE ?1 ESCAPE '\\' OR content LIKE ?2 ESCAPE '\\') AND kind = ?3 ORDER BY reuse_count DESC LIMIT ?4")) .map_err(storage_err)?; let rows = stmt .query_map(params![pattern, pattern, k, limit_i], |row| knowledge_from_row(row)) @@ -563,7 +565,7 @@ impl KnowledgeRepo { } } else { let mut stmt = guard - .prepare(&format!("SELECT {KNOWLEDGE_COLS} FROM knowledges WHERE status = 'published' AND (title LIKE ?1 OR content LIKE ?2) ORDER BY reuse_count DESC LIMIT ?3")) + .prepare(&format!("SELECT {KNOWLEDGE_COLS} FROM knowledges WHERE status = 'published' AND (title LIKE ?1 ESCAPE '\\' OR content LIKE ?2 ESCAPE '\\') ORDER BY reuse_count DESC LIMIT ?3")) .map_err(storage_err)?; let rows = stmt .query_map(params![pattern, pattern, limit_i], |row| knowledge_from_row(row)) diff --git a/crates/df-storage/src/crud/project_repo.rs b/crates/df-storage/src/crud/project_repo.rs index daebfc8..52ba959 100644 --- a/crates/df-storage/src/crud/project_repo.rs +++ b/crates/df-storage/src/crud/project_repo.rs @@ -242,8 +242,9 @@ impl ProjectRepo { if let Some(kw) = &q.keyword { let trimmed = kw.trim(); if !trimmed.is_empty() { - sql.push_str(" AND (name LIKE ? OR description LIKE ?)"); - let pattern = format!("%{trimmed}%"); + let escaped = trimmed.replace('%', "\\%").replace('_', "\\_"); + sql.push_str(" AND (name LIKE ? OR description LIKE ?) ESCAPE '\\'"); + let pattern = format!("%{escaped}%"); params_vec.push(Box::new(pattern.clone())); params_vec.push(Box::new(pattern)); } diff --git a/crates/df-storage/src/crud/task_repo.rs b/crates/df-storage/src/crud/task_repo.rs index 1b81f8b..e7da9b4 100644 --- a/crates/df-storage/src/crud/task_repo.rs +++ b/crates/df-storage/src/crud/task_repo.rs @@ -378,10 +378,11 @@ impl TaskRepo { } // keyword: title/description LIKE %kw%(P2,对齐知识库 search 的 LIKE 模式) if let Some(kw) = &keyword { - let pat = format!("%{kw}%"); + let escaped = kw.replace('%', "\\%").replace('_', "\\_"); + let pat = format!("%{escaped}%"); let p1 = params_vec.len() + 1; let p2 = p1 + 1; - where_clauses.push(format!("(title LIKE ?{p1} OR description LIKE ?{p2})")); + where_clauses.push(format!("(title LIKE ?{p1} OR description LIKE ?{p2}) ESCAPE '\\'")); params_vec.push(Box::new(pat.clone())); params_vec.push(Box::new(pat)); } diff --git a/crates/df-workflow/src/dag.rs b/crates/df-workflow/src/dag.rs index 0cd9339..ee757d6 100644 --- a/crates/df-workflow/src/dag.rs +++ b/crates/df-workflow/src/dag.rs @@ -165,9 +165,10 @@ impl Default for Dag { /// /// 规则： /// - 两端均为 Object：递归合并（同 key 时节点级覆盖全局级，新增 key 各自保留）。 -/// - 非两端 Object：节点级直接覆盖全局级（包括 `Null`，符合 JSON 显式空语义）。 -/// - 节点级为 `Null` 的语义是「显式置空」，按非 Object 规则覆盖（直接返回 Null）； -/// 若调用方希望「跳过节点配置」，应在构造 Dag 时不写入该 key（node_configs 缺失即用全局）。 +/// - 非 Object/Null 两端：节点级直接覆盖全局级。 +/// - 节点级为 `Null` 时跳过（保留全局配置），对应语义「节点未指定该配置」。 +/// 若调用方希望「显式置空」，应在构造 Dag 时不写入该 key（node_configs 缺失即用全局）， +/// 而非传 JSON null。 /// /// 用途：DagExecutor 构造 NodeContext 时 `deep_merge(initial_config, node_config)`， /// 让节点定义里写的 NodeDef.config 优先于 run_workflow 传入的全局 config。 @@ -187,8 +188,15 @@ pub fn deep_merge(global: &serde_json::Value, node: &serde_json::Value) -> serde } Value::Object(merged) } - // 非两端 Object：节点级覆盖全局级（含 Null、标量、数组） - _ => node.clone(), + // 节点级为 Null → 保留全局配置（不覆盖） + (_, Value::Null) => global.clone(), + // 显式覆盖剩余变体，防止新变体被 _ 吞没 + (Value::Number(_), _) + | (Value::String(_), _) + | (Value::Array(_), _) + | (Value::Bool(_), _) + | (Value::Null, _) + | (Value::Object(_), _) => node.clone(), } } @@ -226,11 +234,10 @@ mod deep_merge_tests { } #[test] - fn missing_node_config_treated_as_noop() { - // DagExecutor 对缺失 key 的节点不调 deep_merge（直接用 global），此处覆盖语义对照： - // 若强行把缺失视作 Null，应覆盖（显式空语义），与「缺失」不同（缺失走 if let Some 分支）。 + fn null_node_config_keeps_global() { + // 节点级为 Null → 保留全局（不覆盖），区别于「缺失 key 不调 deep_merge」。 let global = json!({"a": 1}); - assert_eq!(deep_merge(&global, &json!(null)), json!(null)); + assert_eq!(deep_merge(&global, &json!(null)), global); } #[test] diff --git a/docs/02-架构设计/INDEX.md b/docs/02-架构设计/INDEX.md index e38bf61..95c7d68 100644 --- a/docs/02-架构设计/INDEX.md +++ b/docs/02-架构设计/INDEX.md @@ -49,6 +49,8 @@ | [F-260620-01-跨端AIChat-微信小程序-2026-06-20.md](./已编号方案/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-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排查方案-2026-06-16.md) | B-260616-21 | 📐 排查方案 | 工具卡片重复渲染根因(audit 重复 emit Started) + 修复方案 | +| [F-260622-01-跨端AIChat-Phase3联调设计-2026-06-22.md](./已编号方案/F-260622-01-跨端AIChat-Phase3联调设计-2026-06-22.md) | F-260622-01 | 📐 设计 | 微信小程序跨端联调:云隧道握手 / MCP 工具路由 / DF 事件同步 | +| [消息级溯源P2-切读方案-2026-06-28.md](./已编号方案/消息级溯源P2-切读方案-2026-06-28.md) | — | 📐 设计 | 消息级溯源 Phase 2:切读切换到 ai_messages 视图 | --- @@ -74,6 +76,13 @@ | [消息级溯源设计-2026-06-19.md](./专项设计/消息级溯源设计-2026-06-19.md) | 📐 设计待实施(F-260619-04) | ChatMessage.id + source_ref/audit/idea 四场景从对话级升级消息级 | | [全局事件数据总线-2026-06-21.md](./专项设计/全局事件数据总线-2026-06-21.md) | 📐 构想定稿待评审 | pub-sub + request-reply + 流式 reply 统一总线:跨模块解耦 / 响应式根治死等 / 跨端透传 | | [三层模型-流程模板与人设体系-2026-06-28.md](./专项设计/三层模型-流程模板与人设体系-2026-06-28.md) | 📐 设计 | 模板→工作流→人设三层架构:流程模板YAML定义、人设AgentPersona数据结构、三层实例化流程 | +| [aichat体验与agent能力系统化重构-2026-06-21.md](./专项设计/aichat体验与agent能力系统化重构-2026-06-21.md) | 📐 设计 | AI Chat 体验 + Agent 能力统一重构:消息模型 / 上下文管理 / 工具路由 | +| [查询能力补全方案-2026-06-21.md](./专项设计/查询能力补全方案-2026-06-21.md) | 📐 设计 | 查询接口能力补全:多维度筛选 / 聚合 / 跨表关联 | +| [AST符号解析-设计-2026-06-24.md](./专项设计/AST符号解析-设计-2026-06-24.md) | 📐 设计 | AST 符号解析:代码结构提取 / 符号索引 / 跳转支持 | +| [插件机制-设计-2026-06-24.md](./专项设计/插件机制-设计-2026-06-24.md) | 📐 设计 | 插件系统:动态加载 / 生命周期 / 权限沙箱 | +| [AI对话目标丢失诊断-2026-06-26.md](./专项设计/AI对话目标丢失诊断-2026-06-26.md) | 📐 诊断 | AI 对话目标丢失根因分析:上下文漂移 / 意图衰减 | +| [AI原生上下文地图与去AI化进化系统-2026-06-26.md](./专项设计/AI原生上下文地图与去AI化进化系统-2026-06-26.md) | 📐 设计 | AI 原生上下文地图:语义索引 / 去 AI 化渐进演进路径 | +| [项目知识图谱与任务队列系统-2026-06-26.md](./专项设计/项目知识图谱与任务队列系统-2026-06-26.md) | 📐 设计 | 项目级知识图谱 + 任务队列:依赖解析 / 优先级调度 | --- @@ -98,6 +107,7 @@ | [意图识别层论证-2026-06-19.md](./构想审查/意图识别层论证-2026-06-19.md) | 📐 论证(供决策) | 通用前置意图识别层 8 维度论证 + 触发时机 | | [多主题上下文管理愿景-2026-06-19.md](./构想审查/多主题上下文管理愿景-2026-06-19.md) | 💡 远期愿景 | 无感多主题对话:主题检测前置 + 多主题多摘要(关联 F-15 / 意图识别) | | [多主题并存补充论证-多轮模式-2026-06-19.md](./构想审查/多主题并存补充论证-多轮模式-2026-06-19.md) | 📐 论证(供决策) | agentic 多轮模式可突破天花板,但近期结论不变 | +| [跑题改进试验记录-2026-06-20.md](./构想审查/跑题改进试验记录-2026-06-20.md) | 📋 试验 | AI 跑题改进试验:系统 prompt 加固 / 上下文钳制 / 行为约束 | --- diff --git a/docs/02-架构设计/已编号方案/消息级溯源P2-切读方案-2026-06-28.md b/docs/02-架构设计/已编号方案/消息级溯源P2-切读方案-2026-06-28.md index f8d0288..a7a7715 100644 --- a/docs/02-架构设计/已编号方案/消息级溯源P2-切读方案-2026-06-28.md +++ b/docs/02-架构设计/已编号方案/消息级溯源P2-切读方案-2026-06-28.md @@ -2,50 +2,18 @@ > 决策：2026-06-28 — 一次性切读 + 脚本迁移历史数据 -## 现状 +## 现状（2026-06-28 代码核查） -- `ai_messages` 表 ✅ 已存在（V21 迁移） -- `AiMessageRepo` ✅ CRUD 已实现 -- V21 已有一次性数据迁移（从 `ai_conversations.messages` JSON 读 → 写入 `ai_messages`） -- **但当前读写路径仍走 `ai_conversations.messages` JSON 列**，`ai_messages` 表未启用 +**P2 切读已完成**。上一阶段「批次 B」已经实现了读写路径切换： -## 目标 +### ✅ 读路径 +`ai_conversation_switch` 已优先从 `ai_messages` 表加载（`list_by_conversation`）， +空时 fallback 旧 `messages` JSON 列。见 `conversation.rs:257-282`。 -读/写消息完全切换到 `ai_messages` 表，删除 `ai_conversations.messages` JSON 列。 +### ✅ 写路径 +`save_conversation` 已走 `AiMessageRepo.replace_conversation`（`DELETE + INSERT` 事务原子）， +旧 messages JSON 列保留不写作备份。见 `conversation.rs` 中 `save_conversation` 实现。 -## 涉及改动 - -### 1. 数据迁移（已有 V21，补充幂等脚本） - -V21 迁移已有从 `ai_conversations.messages` → `ai_messages` 的逻辑。补充： -- V21 已幂等（`INSERT OR IGNORE`），可重复跑 -- 补充校验：迁移后 `ai_messages` 行数 = 各对话 messages JSON 汇总行数 - -### 2. 切读 — 后端代码 - -| 模块 | 当前 | 改为 | -|------|------|------| -| `restore_from_messages` | 从 `rec.messages` JSON 反序列化 | 从 `ai_messages` 表按 `conversation_id` 查询 + seq 排序 | -| `save_conversation` | 写 `rec.messages` JSON 列 | 写 `ai_messages` 表（insert_batch + delete_range） | -| `ai_conversation_switch` | 返回 `rec.messages`（JSON 反序列化） | 返回 `AiMessageRepo.list_by_conversation()` | -| `clear_context` | 读/写 messages JSON | 读写 ai_messages 表 | -| `compress_context` | 同上 | 同上 | -| `replace_last_active_user_content` | 同上 | 同上 | -| messages 相关 IPC 查询 | 走 JSON 列 | 走 ai_messages 表 | - -### 3. 清理 - -- `ai_conversations.messages` 列标记废弃（暂不删列，避免大表 ALTER 风险） +### 剩余工作 +- `ai_conversations.messages` 列标记废弃（暂不删列） - 后续 V22 可选删除该列 - -### 4. 风险控制 - -- **双写保护**：切读后写入同时写 ai_messages 表 + messages JSON 列（双写期 1 周，可回退） -- **回退方案**：撤切读 → 恢复从 messages JSON 列读 - -## 执行顺序 - -1. 实现切读：改 `restore_from_messages` / `save_conversation` / `switch_conversation` 等核心路径 -2. 运行 V21 迁移（幂等，补全遗留数据） -3. 双写期观察（ai_messages 数据一致） -4. 切读完成，标记 messages 列废弃 diff --git a/src/components/AiChat.vue b/src/components/AiChat.vue index 85d197f..374161b 100644 --- a/src/components/AiChat.vue +++ b/src/components/AiChat.vue @@ -237,6 +237,7 @@ function scrollToFirstPending(): void { const { confirmState, confirmDialog, answerConfirm } = useConfirm() async function confirmDeleteConversation(id: string) { const conv = store.state.conversations.find(c => c.id === id) + if (!conv) console.warn('confirmDeleteConversation: conv not found, id=', id) const title = conv?.title || t('aiChat.newConversation') // UX-260617-24:删除当前活跃对话加醒目提示(通用文案不区分,活跃对话误删影响更大)。 const isActive = id === store.state.activeConversationId