From 8d18918e39285c74be3ca238d32a81c73d7932d2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=BB=9D=E5=B0=98?= <237809796@qq.com> Date: Mon, 29 Jun 2026 00:16:39 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0:=20=E6=9E=B6=E6=9E=84?= =?UTF-8?q?=E8=AE=BE=E8=AE=A1=E6=96=87=E6=A1=A3=E7=8A=B6=E6=80=81=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=E4=BB=A3=E7=A0=81=E6=A0=B8=E9=AA=8C=E7=BB=93=E6=9E=9C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 经代码核验发现 9 份设计文档的状态标注严重滞后(标'待实施'但 实际已完整落地),本次批量同步: 已落地(核验确认): - 局部编辑工具:三层防御+三模式完整,仅文本不支持二进制 - 密钥迁移健壮性:空 key 不覆盖+即时迁移补密钥+阻断保存 - AST 符号解析:符号读取工具已注册+基线测试守护 - 查询能力补全:任务/项目/灵感均多维动态查询 - 条件表达式引擎:手写求值器+JSON Path+执行器集成+前端入口 - 工作流脚本边界:命令白名单/黑名单+危险关键词告警 - 消息拆分存储:消息表+全量迁移+读写全部切换 - 消息级溯源:消息 ID+四场景溯源+切读全部完成 部分落地: - 全局事件总线:基建+20 余个发射点就位,消费者未接(空转) 归档不实施: - 规格契约自检:核心价值已被求助协议+自审闸门覆盖,过度设计 --- docs/02-架构设计/INDEX.md | 22 +++++++++---------- .../专项设计/AST符号解析-设计-2026-06-24.md | 2 +- .../专项设计/patch_file工具设计-2026-06-15.md | 2 +- .../专项设计/全局事件数据总线-2026-06-21.md | 2 +- .../专项设计/密钥迁移健壮性-2026-06-15.md | 2 +- .../专项设计/工作流脚本执行边界-2026-06-15.md | 2 +- .../专项设计/条件表达式引擎-2026-06-15.md | 2 +- .../专项设计/查询能力补全方案-2026-06-21.md | 2 +- .../专项设计/消息拆分存储设计-2026-06-19.md | 2 +- .../专项设计/消息级溯源设计-2026-06-19.md | 2 +- .../专项设计/规格契约自检机制-2026-06-14.md | 2 +- 11 files changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/02-架构设计/INDEX.md b/docs/02-架构设计/INDEX.md index 95c7d68..63ceb91 100644 --- a/docs/02-架构设计/INDEX.md +++ b/docs/02-架构设计/INDEX.md @@ -61,24 +61,24 @@ | 文档 | 状态 | 核心内容 | |---|---|---| | [Agent架构说明-2026-06-14.md](./专项设计/Agent架构说明-2026-06-14.md) | 📐 现状盘点 | Agent 引擎单链 ReAct 能力边界(查实的事实,非构想) | -| [规格契约自检机制-2026-06-14.md](./专项设计/规格契约自检机制-2026-06-14.md) | 📐 设计待落地 | 活契约(锚点 + AI 自检 + 子代理)取代独立 spec | +| [规格契约自检机制-2026-06-14.md](./专项设计/规格契约自检机制-2026-06-14.md) | 🗄 归档(被其他机制覆盖) | 活契约(锚点 + AI 自检 + 子代理)取代独立 spec。**核验(2026-06-28):0 行代码,其核心价值(规格与实现一致性检查)已被 L1 求助协议 + ai_self_review gate 覆盖,归档不实施** | | [AiNode自审实施方案-2026-06-16.md](./专项设计/AiNode自审实施方案-2026-06-16.md) | ✅ ②-⑤已落地 | AiNode 自审闸门 + verdict DAG 阻断 | | [secret下沉与provider注入方案-2026-06-16.md](./专项设计/secret下沉与provider注入方案-2026-06-16.md) | ✅ 方案 B 全量落地 | secret 纯密钥下沉 df-storage | -| [patch_file工具设计-2026-06-15.md](./专项设计/patch_file工具设计-2026-06-15.md) | 📐 设计待实施(P0) | AI 局部编辑工具:old_text 精确匹配 + 三层防御 | +| [patch_file工具设计-2026-06-15.md](./专项设计/patch_file工具设计-2026-06-15.md) | ✅ 已落地(2026-06-28 核验) | AI 局部编辑工具:old_text 精确匹配 + 三层防御 + 三模式(old_text/replace_lines/anchor)。**仅文本(不支持二进制 encoding,合理设计)** | | [generating状态机加固-2026-06-15.md](./专项设计/generating状态机加固-2026-06-15.md) | 📐 设计 | generating 生命周期状态机(guard 收敛) | -| [密钥迁移健壮性-2026-06-15.md](./专项设计/密钥迁移健壮性-2026-06-15.md) | 📐 设计未实施 | 空 api_key 不覆盖未迁移态明文密钥 | -| [条件表达式引擎-2026-06-15.md](./专项设计/条件表达式引擎-2026-06-15.md) | 📐 设计(R-PD-3) | ConditionEngine 接线 + 条件边求值 | -| [工作流脚本执行边界-2026-06-15.md](./专项设计/工作流脚本执行边界-2026-06-15.md) | 📐 设计(R-PD-2) | ScriptNode 任意 shell 执行安全边界 | -| [查询效率优化方案-2026-06-19.md](./专项设计/查询效率优化方案-2026-06-19.md) | 📐 待评审(PERF-260619-01) | SQL 下推 / 精确拉取 / 缓存 / 字段投影 | +| [密钥迁移健壮性-2026-06-15.md](./专项设计/密钥迁移健壮性-2026-06-15.md) | ✅ 已落地(2026-06-28 核验) | 空 api_key 不覆盖未迁移态明文密钥(provider.rs:104-136 即时迁移补密钥 + 阻断保存) | +| [条件表达式引擎-2026-06-15.md](./专项设计/条件表达式引擎-2026-06-15.md) | ✅ 已落地(2026-06-28 核验) | ConditionEngine 手写求值器 + JSON Path/嵌套/数组索引/数值比较 + executor 集成 + 前端边条件编辑入口 | +| [工作流脚本执行边界-2026-06-15.md](./专项设计/工作流脚本执行边界-2026-06-15.md) | ✅ 已落地(2026-06-28 核验) | ScriptNode 命令执行安全边界:白名单/黑名单(env 配置)+ 危险关键词告警 | +| [查询效率优化方案-2026-06-19.md](./专项设计/查询效率优化方案-2026-06-19.md) | 📐 待评审(PERF-260619-01) | SQL 下推 / 精确拉取 / 缓存 / 字段投影。**核验:查询能力补全已落地(task/project/idea 均 keyword/order_by/limit/offset),性能优化待评审** | | [任务推进链实施路径-2026-06-16.md](./专项设计/任务推进链实施路径-2026-06-16.md) | 📐 规划定稿(D-01~04已决) | advance_task 走 df-nodes Node trait,4 阶段路径 | | [推进链阶段2实施路径-2026-06-16.md](./专项设计/推进链阶段2实施路径-2026-06-16.md) | 📐 设计(F-260616-06) | 工作流联动任务推进:task_id + 完成回调 + DAG 模板 | -| [消息拆分存储设计-2026-06-19.md](./专项设计/消息拆分存储设计-2026-06-19.md) | 📐 设计待实施(F-260619-03) | ai_messages 表 + V21 全量迁移 + 三阶段渐进切换(脏标记→双写→切读) | -| [消息级溯源设计-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-19.md](./专项设计/消息拆分存储设计-2026-06-19.md) | ✅ 已落地(2026-06-28 核验) | ai_messages 表 + V21 全量迁移 + 读写全部切到消息表(旧 JSON 列仅作老库兼容回退) | +| [消息级溯源设计-2026-06-19.md](./专项设计/消息级溯源设计-2026-06-19.md) | ✅ 已落地(2026-06-28 核验) | ChatMessage.id + source_ref/audit/idea 四场景从对话级升级消息级 + P2 切读全部完成 | +| [全局事件数据总线-2026-06-21.md](./专项设计/全局事件数据总线-2026-06-21.md) | 🟡 部分落地(基建就位,消费者未接) | pub-sub + request-reply + 流式 reply 统一总线。**核验(2026-06-28):基建(AI/工作流两路总线)+ 20+ emit 点双写就位,但真实订阅方/前端镜像/tunnel 透传均未接入(空转)。阶段 2-6 待真实痛点驱动** | | [三层模型-流程模板与人设体系-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-21.md](./专项设计/查询能力补全方案-2026-06-21.md) | ✅ 已落地(2026-06-28 核验) | 查询接口能力补全:task/project/idea 均 keyword/order_by/limit/offset 多维动态 WHERE | +| [AST符号解析-设计-2026-06-24.md](./专项设计/AST符号解析-设计-2026-06-24.md) | ✅ Phase1 已落地(2026-06-28 核验) | AST 符号解析:read_symbol 工具已注册(tool_registry.rs:1506-1547)+ 基线测试守护 | | [插件机制-设计-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 化渐进演进路径 | diff --git a/docs/02-架构设计/专项设计/AST符号解析-设计-2026-06-24.md b/docs/02-架构设计/专项设计/AST符号解析-设计-2026-06-24.md index 7c28a71..a22a401 100644 --- a/docs/02-架构设计/专项设计/AST符号解析-设计-2026-06-24.md +++ b/docs/02-架构设计/专项设计/AST符号解析-设计-2026-06-24.md @@ -1,6 +1,6 @@ # AST 符号解析 — Code Intelligence 设计 -> 日期:2026-06-24 | 状态:设计深化(2026-06-24:信息密度三态 + 主题压缩),Phase1 待实施 +> 日期:2026-06-24 | 状态:✅ Phase1 已落地(2026-06-28 核验:read_symbol 工具已注册 tool_registry.rs:1506-1547 + 基线测试守护) > 关联:memory [[devflow-info-density-concept]] / [[devflow-aichat-session-analysis-2026-06-22]] / plan gentle-gliding-book ## Context(为什么) diff --git a/docs/02-架构设计/专项设计/patch_file工具设计-2026-06-15.md b/docs/02-架构设计/专项设计/patch_file工具设计-2026-06-15.md index 52f74e4..69b949d 100644 --- a/docs/02-架构设计/专项设计/patch_file工具设计-2026-06-15.md +++ b/docs/02-架构设计/专项设计/patch_file工具设计-2026-06-15.md @@ -1,6 +1,6 @@ # Patch File 工具设计 -> 创建: 2026-06-15 | 状态: 设计定稿待实施 | 优先级: P0 +> 创建: 2026-06-15 | 状态: ✅ 已落地(2026-06-28 核验) | 优先级: P0 > 关联 todo: F-260615-06 [P0] --- diff --git a/docs/02-架构设计/专项设计/全局事件数据总线-2026-06-21.md b/docs/02-架构设计/专项设计/全局事件数据总线-2026-06-21.md index 49d2c05..659780f 100644 --- a/docs/02-架构设计/专项设计/全局事件数据总线-2026-06-21.md +++ b/docs/02-架构设计/专项设计/全局事件数据总线-2026-06-21.md @@ -1,6 +1,6 @@ # 全局事件数据总线设计 -> 2026-06-21 · 专项设计 · 状态:构想定稿待评审 +> 2026-06-21 · 专项设计 · 状态:🟡 部分落地(2026-06-28 核验:基建(AI/工作流两路总线)+ 20+ emit 点双写就位,但真实订阅方/前端镜像/tunnel 透传均未接入空转。阶段 2-6 待真实痛点驱动) > 关联:[[cross-end-rust-backend]] 三层跨端 / [[devflow-product-positioning]] ai-working 可扩展 / F-260620-01 跨端小程序 ## 背景与动机 diff --git a/docs/02-架构设计/专项设计/密钥迁移健壮性-2026-06-15.md b/docs/02-架构设计/专项设计/密钥迁移健壮性-2026-06-15.md index baea1cf..03d6ccc 100644 --- a/docs/02-架构设计/专项设计/密钥迁移健壮性-2026-06-15.md +++ b/docs/02-架构设计/专项设计/密钥迁移健壮性-2026-06-15.md @@ -3,7 +3,7 @@ > **真相源**(本文档唯一展开完整设计)。功能决策记录仅放摘要 + 指针。 > > 背景：R-PD-1（全局代码 review 2026-06-15 §🔴 P1 需设计）— 编辑 provider 提交空 `api_key` 时，无条件把 DB `api_key` 置空走 `INSERT OR REPLACE`，**未迁移态** provider 的明文密钥被静默覆盖成空 → keyring 也空 → resolve 返空 → provider 报废，密钥永久丢失。 -> 状态：📐 **设计完成，未实施** | 创建：2026-06-15 | 来源：全局代码 review 2026-06-15 +> 状态：✅ **已落地**(2026-06-28 核验:provider.rs:104-136 即时迁移补密钥 + 阻断保存 + secret.rs 启动迁移) | 创建：2026-06-15 | 来源：全局代码 review 2026-06-15 --- diff --git a/docs/02-架构设计/专项设计/工作流脚本执行边界-2026-06-15.md b/docs/02-架构设计/专项设计/工作流脚本执行边界-2026-06-15.md index e648f2e..019a5d9 100644 --- a/docs/02-架构设计/专项设计/工作流脚本执行边界-2026-06-15.md +++ b/docs/02-架构设计/专项设计/工作流脚本执行边界-2026-06-15.md @@ -2,7 +2,7 @@ > 来源：全局代码 review 2026-06-15 §🔴 P1 需设计 R-PD-2 > 日期：2026-06-15 -> 状态：设计待核对（推荐方案已定，落地前需用户确认力度） +> 状态：✅ 已落地(2026-06-28 核验:ScriptNode 命令执行安全边界 — env 白名单/黑名单 + 危险关键词告警,script_node.rs:40-155) --- diff --git a/docs/02-架构设计/专项设计/条件表达式引擎-2026-06-15.md b/docs/02-架构设计/专项设计/条件表达式引擎-2026-06-15.md index 1e2da0b..3357d0a 100644 --- a/docs/02-架构设计/专项设计/条件表达式引擎-2026-06-15.md +++ b/docs/02-架构设计/专项设计/条件表达式引擎-2026-06-15.md @@ -1,7 +1,7 @@ # 条件表达式引擎设计（R-PD-3 / T-260614-11） > 来源：全局代码 review `docs/05-代码审查/全局代码review-2026-06-15.md` §🔴 P1 需设计 R-PD-3 + 架构洞察第 4 条 -> 性质：设计文档（供用户核对方案），不含实现 +> 性质：✅ **已落地**(2026-06-28 核验:ConditionEngine 手写求值器 + JSON Path/嵌套/数组索引/数值比较 + executor feature flag 集成 + 前端边条件编辑入口 + 中英文翻译) > 关联：todo `T-260614-11 条件表达式引擎升级`、R-P2-13（set_skipped/set_waiting 已删） --- diff --git a/docs/02-架构设计/专项设计/查询能力补全方案-2026-06-21.md b/docs/02-架构设计/专项设计/查询能力补全方案-2026-06-21.md index 78484b0..c37fffb 100644 --- a/docs/02-架构设计/专项设计/查询能力补全方案-2026-06-21.md +++ b/docs/02-架构设计/专项设计/查询能力补全方案-2026-06-21.md @@ -1,6 +1,6 @@ # F-260621-02 查询能力维度补全方案(任务/项目/灵感) -> **状态**:方案设计(待办登记),待排期实施 +> **状态**:✅ **已落地**(2026-06-28 核验:task/project/idea 均 keyword/order_by/limit/offset 多维动态 WHERE) > **日期**:2026-06-21 > **范围**:DevFlow 任务/项目/灵感三实体**列表查询维度**补全 > **关联**:[PERF-260619-01 查询效率优化方案](./查询效率优化方案-2026-06-19.md)(查询**性能**,与本方案正交) / todo.md F-15-03 分页(本方案细化) diff --git a/docs/02-架构设计/专项设计/消息拆分存储设计-2026-06-19.md b/docs/02-架构设计/专项设计/消息拆分存储设计-2026-06-19.md index cb438a2..5594ce6 100644 --- a/docs/02-架构设计/专项设计/消息拆分存储设计-2026-06-19.md +++ b/docs/02-架构设计/专项设计/消息拆分存储设计-2026-06-19.md @@ -1,6 +1,6 @@ # 消息拆分存储设计 -> 创建:2026-06-19 | 编号:F-260619-03(消息拆分) | 状态:📐 设计待实施 +> 创建:2026-06-19 | 编号:F-260619-03(消息拆分) | 状态:✅ **已落地**(2026-06-28 核验:ai_messages 表 + V21 全量迁移 + 读写全部切到消息表,旧 JSON 列仅作老库兼容回退) > 关联任务:`消息拆分存储:ai_messages 表 + 全量迁移 + 三阶段渐进切换`(DevFlow 项目) > 关联灵感:b2e61a21 消息拆分存储 + 消息级溯源 + 知识脉络网络 > 关联设计:[消息级溯源设计-2026-06-19.md](./消息级溯源设计-2026-06-19.md)(本设计的前置依赖 + 消费方) diff --git a/docs/02-架构设计/专项设计/消息级溯源设计-2026-06-19.md b/docs/02-架构设计/专项设计/消息级溯源设计-2026-06-19.md index f71845a..634d544 100644 --- a/docs/02-架构设计/专项设计/消息级溯源设计-2026-06-19.md +++ b/docs/02-架构设计/专项设计/消息级溯源设计-2026-06-19.md @@ -1,6 +1,6 @@ # 消息级溯源设计 -> 创建:2026-06-19 | 编号:F-260619-04(消息级溯源) | 状态:📐 设计待实施 +> 创建:2026-06-19 | 编号:F-260619-04(消息级溯源) | 状态:✅ **已落地**(2026-06-28 核验:ChatMessage.id + source_ref/audit/idea 四场景全部完成 + P2 切读全部完成) > 关联任务:`消息级溯源:知识库/审计/灵感全链路从对话级升级到消息级`(DevFlow 项目) > 关联灵感:b2e61a21 消息拆分存储 + 消息级溯源 + 知识脉络网络 > 关联设计:[消息拆分存储设计-2026-06-19.md](./消息拆分存储设计-2026-06-19.md)(本设计的持久化基础) diff --git a/docs/02-架构设计/专项设计/规格契约自检机制-2026-06-14.md b/docs/02-架构设计/专项设计/规格契约自检机制-2026-06-14.md index cac565e..37b683a 100644 --- a/docs/02-架构设计/专项设计/规格契约自检机制-2026-06-14.md +++ b/docs/02-架构设计/专项设计/规格契约自检机制-2026-06-14.md @@ -1,6 +1,6 @@ # 规格契约自检机制 -> 创建：2026-06-13 | 阶段：设计定稿，待落地 +> 创建：2026-06-13 | 阶段：🗄️ 归档不实施(2026-06-28 核验:0 行代码。其核心价值「规格与实现一致性检查」已被 L1 求助协议 + ai_self_review gate 覆盖,过度设计) > 性质：设计说明 + 可执行规格基准。后续 `spec-verifier` agent、`/spec-check` skill、自检 hook 均从本文档推导。 ---