重构: 巨函数拆分 + 清理历史标记注释 + custom_prompt/停止按钮/tunnel 改进

2026-07-31 21:36:12 +08:00
parent 365af554da
commit bd9031d35d
73 changed files with 1421 additions and 1064 deletions
@@ -1,4 +1,4 @@
-//! 模型能力数据模型 — F-01 阶段1
+//! 模型能力数据模型。
 //!
 //! 单模型的完整描述(4 维度 + 路由控制)。纯数据结构,零 IO / 零 DB 依赖。
 //! df-storage 反序列化 DB 行时直接消费本模块类型;df-ai 探测器/路由器阶段 2-4 再用。
@@ -45,9 +45,9 @@ pub enum Capability {
 ///
 /// 序列化为 snake_case。原设计文档 §2.2 列 Free/Low/Medium/High,但 Free 变体形同虚设:
 /// 预设表(presets/models.json)0 条 free + 启发式从不赋 Free(只 Low/Medium/High),
-/// B-260618-05 删除 Free 死档变体。
+/// Free 死档变体已删除。
 ///
-/// 路由已解耦(2026-06-18 B-260618-03):provider /v1/models API 不返回 cost_tier,
+/// 路由已解耦:provider /v1/models API 不返回 cost_tier,
 /// 此维度 100% 靠预设表写死 + 模型名启发式猜,数据无客观依据不可信,不再参与硬路由
 /// (原 §6.1 `cost_tier <= max_cost` 过滤已删除)。枚举保留供未来出现真实判别源时再接回。
 #[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq, PartialOrd, Ord)]
@@ -63,7 +63,7 @@ pub enum CostTier {
 /// 设计文档 §2.2:Lite/Standard/Plus/Ultra。序列化为 snake_case。
 /// 派生 Ord:Lite < Standard < Plus < Ultra。
 ///
-/// 路由已解耦(2026-06-18 B-260618-03):provider /v1/models API 不返回 intelligence,
+/// 路由已解耦:provider /v1/models API 不返回 intelligence,
 /// 此维度 100% 靠预设表写死 + 模型名启发式猜,数据无客观依据不可信,不再参与硬路由
 /// (原 §6.1 `intelligence >= min_intelligence` 过滤已删除)。枚举保留供未来出现真实判别源时再接回。
 #[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq, PartialOrd, Ord)]
@@ -302,7 +302,7 @@ mod tests {
            assert_eq!(serde_json::from_str::<CostTier>(expected).unwrap(), variant);
        }
        // Ord:Low < Medium < High(枚举序,路由已解耦不再用于过滤,保留供未来判别源)。
-        // Free 变体已删除(B-260618-05:预设/启发式从不赋 Free,死档)。
+        // Free 变体已删除(预设/启发式从不赋 Free,死档)。
        assert!(CostTier::Low < CostTier::Medium);
        assert!(CostTier::Medium < CostTier::High);
    }
@@ -90,8 +90,8 @@ impl ChatMessage {

    /// 是否处于 active 态（status 为 None 或 "active"）。其余状态一律 false。
    ///
-    /// 正面白名单（F-15 §3.2）：仅认 None / "active"，新状态
-    /// （如阶段2 引入的 "archived_segment" / "compressed"）自动落入不 active 分支，
+    /// 正面白名单：仅认 None / "active"，新状态
+    /// （如"archived_segment" / "compressed"）自动落入不 active 分支，
    /// 无需每加一个状态就来这里改。当前取值 None/Some("active")/Some("truncated")
    /// 行为与旧反面排除完全等价（None=true / "active"=true / "truncated"=false）。
    pub fn is_active(&self) -> bool {
@@ -155,10 +155,9 @@ mod tests {

    #[test]
    fn is_active_whitelist() {
-        // F-15 §3.2 正面白名单：仅 None / "active" 为 true，其余一律 false。
+        // 正面白名单：仅 None / "active" 为 true，其余一律 false。
        // 零行为变化：None / "active" / "truncated" 与旧反面排除完全等价；
-        // "archived_segment" / "compressed"（阶段2 引入，当前代码未赋值）由白名单
-        // matches! 只认 None/active 自动落入 false，面向未来验证。
+        // "archived_segment" / "compressed" 由白名单 matches! 只认 None/active 自动落入 false。

        // None（构造默认值，向前兼容老 JSON）
        let m = ChatMessage::user("hi");
@@ -174,18 +173,18 @@ mod tests {
        m.status = Some(MessageStatus::Truncated);
        assert!(!m.is_active(), "truncated 应不 active");

-        // "archived_segment" — 阶段2 待引入，白名单自动隔离
+        // "archived_segment" — 白名单自动隔离
        let mut m = ChatMessage::user("hi");
        m.status = Some(MessageStatus::ArchivedSegment);
        assert!(!m.is_active(), "archived_segment 应不 active（白名单隔离）");

-        // "compressed" — 阶段2 待引入，白名单自动隔离
+        // "compressed" — 白名单自动隔离
        let mut m = ChatMessage::user("hi");
        m.status = Some(MessageStatus::Compressed);
        assert!(!m.is_active(), "compressed 应不 active（白名单隔离）");
    }

-    // ---------- F-260614-05 Phase 2a ContentPart ----------
+    // ---------- ContentPart ----------

    /// 老 JSON（无 parts 字段）反序列化时 parts 应为 None（向前兼容）
    #[test]
@@ -333,7 +332,7 @@ mod tests {
        assert_eq!(deserialized.reasoning_content, Some("thinking process".to_string()));
    }

-    // ---------- F-260619-04 消息级溯源:id 字段 ----------
+    // ---------- 消息级溯源:id 字段 ----------

    /// 所有便捷构造函数默认生成非 None 的 id(ULID 风格)
    #[test]
@@ -43,7 +43,7 @@ pub struct CompletionRequest {

 /// 多模态消息内容片。Text 片为字符串；Image 片可走 url 或 base64（二选一，base64 非空时 url 忽略）。
 ///
-/// F-260614-05 Phase 2a 后端：ContentPart 作为 `ChatMessage.parts` 的元素类型。
+/// ContentPart 作为 `ChatMessage.parts` 的元素类型。
 /// 设计上 `content: String`（纯文本主载荷）保持不变，多模态片挂在 `parts`：
 /// 这样未接入多模态的调用方（audit/title/commands/knowledge_inject 等读 content 当字符串）
 /// 零回归，避免一次性改全仓。provider 转换层在 `has_image()` 为真时把 parts 透传给
@@ -79,13 +79,13 @@ pub enum ContentPart {
 pub struct ChatMessage {
    /// 消息全局唯一 ID。用于消息级溯源(source_ref / audit message_id / idea source)。
    /// 构造时由 `new_message_id()` 生成;老 JSON 反序列化为 None(向前兼容)。
-    /// 消息拆分存储(F-260619-03)后,此 ID 即 `ai_messages.id` 列主键。
+    /// 消息拆分存储后,此 ID 即 `ai_messages.id` 列主键。
    /// 临时/派生消息(如 title 摘要)可显式赋 None(不溯源不落库)。
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    pub role: MessageRole,
    pub content: String,
-    /// 多模态内容片（F-260614-05 Phase 2a）。
+    /// 多模态内容片。
    ///
    /// `None`/空 → 纯文本消息（绝大多数场景，content 即全部载荷）。
    /// `Some(含 Image 片)` → 多模态消息，provider 在 `has_image()` 为真时把 parts
@@ -137,11 +137,11 @@ impl AnthropicCompatProvider {
                }
                MessageRole::User => {
                    Self::flush_tool_results(&mut messages, &mut pending_tool_results);
-                    // F-260614-05 Phase 2a: 多模态 user 消息 → content blocks 数组（text/image）。
+                    // 多模态 user 消息 → content blocks 数组（text/image）。
                    // 含图时把 content + parts 拍平成 blocks：Text 片 → {type:text}，
                    // Image 片 → {type:image, source:{type:base64, media_type, data}}。
                    // Anthropic 协议要求 image 必须内嵌 base64（不接受 URL 直传）。
-                    // 现状：前端（Phase2b）只产 base64 模式图片片，url 模式当前不可达。
+                    // 现状：前端只产 base64 模式图片片，url 模式当前不可达。
                    // 未来若加 url 图片输入，必须在 commands 层补 url→base64 预拉
                    //（provider 不发额外 HTTP），否则下方兜底会发空 data 致 Anthropic 400。
                    // 纯文本消息（无图）保持原字符串简写，与现有端点零回归。
@@ -149,36 +149,7 @@ impl AnthropicCompatProvider {
                        let blocks: Vec<serde_json::Value> = m
                            .flattened_parts()
                            .into_iter()
-                            .map(|p| match p {
-                                crate::provider::ContentPart::Text { text } => serde_json::json!({
-                                    "type": "text",
-                                    "text": text,
-                                }),
-                                crate::provider::ContentPart::Image { url, base64, media_type, alt: _ } => {
-                                    // p 已被 match 取得所有权，直接 move media_type/base64 避免大 base64 clone。
-                                    let mt = media_type.unwrap_or_else(|| "image/png".into());
-                                    let data = base64.unwrap_or_else(|| {
-                                        // 完整性兜底：当前 url 模式不可达（前端 Phase2b 只产 base64 图片片）。
-                                        // 若未来接入 url 图片输入而 commands 层未补 url→base64 预拉，
-                                        // 此处会发空 data 致 Anthropic 400，warn 留痕但不阻塞（避免静默吞数据）。
-                                        if url.is_some() {
-                                            warn!(
-                                                url = ?url,
-                                                "Anthropic user 消息含 Image(url) 但 base64 缺失，将发空 data（commands 层未补 url→base64 预拉）"
-                                            );
-                                        }
-                                        String::new()
-                                    });
-                                    serde_json::json!({
-                                        "type": "image",
-                                        "source": {
-                                            "type": "base64",
-                                            "media_type": mt,
-                                            "data": data,
-                                        }
-                                    })
-                                }
-                            })
+                            .map(Self::content_part_to_block)
                            .collect();
                        messages.push(serde_json::json!({ "role": "user", "content": blocks }));
                    } else {
@@ -193,7 +164,7 @@ impl AnthropicCompatProvider {
                    }
                    if let Some(calls) = &m.tool_calls {
                        for tc in calls {
-                            // B-260618-25: arguments 非法 JSON(流式中断残留 / ToolCall::new 默认空串)
+                            // arguments 非法 JSON(流式中断残留 / ToolCall::new 默认空串)
                            // → 空 object 兜底。Anthropic/GLM 要求 tool_use.input 必为 object,
                            // null 直触发 1214「messages 参数非法」。
                            let input: serde_json::Value = serde_json::from_str(&tc.function.arguments)
@@ -215,13 +186,13 @@ impl AnthropicCompatProvider {
        }
        Self::flush_tool_results(&mut messages, &mut pending_tool_results);

-        // B-260619-03: 合并相邻 user 块。Anthropic 协议要求 user/assistant 严格交替,连续 user
+        // 合并相邻 user 块。Anthropic 协议要求 user/assistant 严格交替,连续 user
        // 触发 GLM 1214。场景:drainQueue 续发(前一轮以 tool_result 结尾 + 新 user)→ flush 把
        // tool_result 转成 user 后紧跟 push 新 user → 连续两 user。合并成一条 user 含
        // [tool_result..., text] blocks(Anthropic 允许一条 user 多 blocks),打破恶性循环。
        Self::merge_consecutive_users(&mut messages);

-        // B-260626-01: 保证首条为 user(Anthropic 协议硬性要求 messages[0].role == "user")。
+        // 保证首条为 user(Anthropic 协议硬性要求 messages[0].role == "user")。
        // 上游绕过 ContextManager::sanitize_messages 的调用方(标题生成 / 知识注入 / 工作流 AI
        // 节点等直接构造 CompletionRequest 的路径)可能传入首条 assistant 的序列——会话恢复、
        // 续发或历史片段截取时,真正的首条 user 已被裁剪/压缩掉,直接发触发 precheck
@@ -237,7 +208,7 @@ impl AnthropicCompatProvider {
                .map(|d| AnthropicToolDef {
                    name: d.function.name,
                    description: Some(d.function.description).filter(|s| !s.is_empty()),
-                    // B-260618-25: input_schema 非 object(未来误用)→ 兜底 {"type":"object"},
+                    // input_schema 非 object(未来误用)→ 兜底 {"type":"object"},
                    // 防 Anthropic 拒非法 tool schema(当前全走 object_schema 恒 object,纯防御)。
                    input_schema: if d.function.parameters.is_object() {
                        d.function.parameters
@@ -260,6 +231,43 @@ impl AnthropicCompatProvider {
        }
    }

+    /// 单个 ContentPart → Anthropic content block（text/image）。
+    /// - Text 片 → {type:text, text}
+    /// - Image 片 → {type:image, source:{type:base64, media_type, data}}
+    ///   base64 内嵌；url 模式当前不可达，兜底发空 data + warn（保留原行为）。
+    ///   match 取得 p 所有权后直接 move media_type/base64，避免大 base64 clone。
+    fn content_part_to_block(p: crate::provider::ContentPart) -> serde_json::Value {
+        match p {
+            crate::provider::ContentPart::Text { text } => serde_json::json!({
+                "type": "text",
+                "text": text,
+            }),
+            crate::provider::ContentPart::Image { url, base64, media_type, alt: _ } => {
+                let mt = media_type.unwrap_or_else(|| "image/png".into());
+                let data = base64.unwrap_or_else(|| {
+                    // 完整性兜底：当前 url 模式不可达（前端只产 base64 图片片）。
+                    // 若未来接入 url 图片输入而 commands 层未补 url→base64 预拉，
+                    // 此处会发空 data 致 Anthropic 400，warn 留痕但不阻塞（避免静默吞数据）。
+                    if url.is_some() {
+                        warn!(
+                            url = ?url,
+                            "Anthropic user 消息含 Image(url) 但 base64 缺失，将发空 data（commands 层未补 url→base64 预拉）"
+                        );
+                    }
+                    String::new()
+                });
+                serde_json::json!({
+                    "type": "image",
+                    "source": {
+                        "type": "base64",
+                        "media_type": mt,
+                        "data": data,
+                    }
+                })
+            }
+        }
+    }
+
    /// 将累积的 tool_result 块作为一条 user 消息 flush 进消息列表
    fn flush_tool_results(
        messages: &mut Vec<serde_json::Value>,
@@ -272,7 +280,7 @@ impl AnthropicCompatProvider {
        messages.push(serde_json::json!({ "role": "user", "content": blocks }));
    }

-    /// B-260619-03: 合并相邻 user 消息为一条(content 拼成 blocks 数组)。
+    /// 合并相邻 user 消息为一条(content 拼成 blocks 数组)。
    /// Anthropic 协议要求 user/assistant 严格交替,连续 user 触发 1214。
    /// 触发场景:flush_tool_results 把 tool_result 转 user 后紧跟新 user(drainQueue 续发,
    /// 前一轮以 tool_result 结尾)。合并成一条 user 含 [tool_result..., text] blocks,合法。
@@ -305,7 +313,7 @@ impl AnthropicCompatProvider {
        }
    }

-    /// B-260626-01: 保证 messages 首条为 user(Anthropic 协议硬性要求 messages[0].role=="user")。
+    /// 保证 messages 首条为 user(Anthropic 协议硬性要求 messages[0].role=="user")。
    ///
    /// 上游绕过 `ContextManager::sanitize_messages` 的调用方(标题生成 / 知识注入 / 工作流 AI
    /// 节点等直接构造 CompletionRequest 的路径)可能传入首条 assistant 的序列——会话恢复、续发
@@ -342,7 +350,7 @@ impl AnthropicCompatProvider {
    }

    /// 生成 messages 诊断摘要(每条 role + content 形态 + tool 标记),不含敏感数据。
-    /// B-260618-27: 1214 类错误时随 bail 文案直达前端 raw,定位哪条/字段非法。
+    /// 1214 类错误时随 bail 文案直达前端 raw,定位哪条/字段非法。
    fn summarize_messages(messages: &[serde_json::Value]) -> String {
        let lines: Vec<String> = messages
            .iter()
@@ -385,7 +393,7 @@ impl AnthropicCompatProvider {
        format!("{} msgs: {}", lines.len(), lines.join(" | "))
    }

-    /// B-260618-27: 协议预检——扫 messages 发现确定非法形态,命中返回原因(仅诊断不修复)。
+    /// 协议预检——扫 messages 发现确定非法形态,命中返回原因(仅诊断不修复)。
    /// 覆盖:首条非 user / 连续同 role / tool_use input 非 object / 空 content / orphan tool_result
    /// (tool_use_id 无前置 tool_use,常见于裁剪/过滤后 assistant 被删但 tool_result 留)。
    fn precheck_messages(messages: &[serde_json::Value]) -> Result<(), String> {
@@ -415,25 +423,7 @@ impl AnthropicCompatProvider {
                        return Err(format!("#{} user content 空数组", i));
                    }
                    for b in blocks {
-                        match b.get("type").and_then(|t| t.as_str()).unwrap_or("") {
-                            "tool_use" => {
-                                let id = b.get("id").and_then(|t| t.as_str()).unwrap_or("");
-                                tool_use_ids.push(id);
-                                if !b.get("input").map(|v| v.is_object()).unwrap_or(false) {
-                                    return Err(format!("#{} tool_use input 非 object", i));
-                                }
-                            }
-                            "tool_result" => {
-                                let tid = b.get("tool_use_id").and_then(|t| t.as_str()).unwrap_or("");
-                                if !tid.is_empty() && !tool_use_ids.contains(&tid) {
-                                    return Err(format!(
-                                        "#{} orphan tool_result(tid={} 无前置 tool_use)",
-                                        i, tid
-                                    ));
-                                }
-                            }
-                            _ => {}
-                        }
+                        Self::check_block(b, i, &mut tool_use_ids)?;
                    }
                }
                _ => {}
@@ -442,6 +432,36 @@ impl AnthropicCompatProvider {
        Ok(())
    }

+    /// 校验单个 content block（precheck_messages 内部用）。
+    /// - tool_use: 收集 id,校验 input 为 object
+    /// - tool_result: 校验 tool_use_id 有前置 tool_use（非 orphan）
+    fn check_block<'a>(
+        b: &'a serde_json::Value,
+        idx: usize,
+        tool_use_ids: &mut Vec<&'a str>,
+    ) -> Result<(), String> {
+        match b.get("type").and_then(|t| t.as_str()).unwrap_or("") {
+            "tool_use" => {
+                let id = b.get("id").and_then(|t| t.as_str()).unwrap_or("");
+                tool_use_ids.push(id);
+                if !b.get("input").map(|v| v.is_object()).unwrap_or(false) {
+                    return Err(format!("#{} tool_use input 非 object", idx));
+                }
+            }
+            "tool_result" => {
+                let tid = b.get("tool_use_id").and_then(|t| t.as_str()).unwrap_or("");
+                if !tid.is_empty() && !tool_use_ids.contains(&tid) {
+                    return Err(format!(
+                        "#{} orphan tool_result(tid={} 无前置 tool_use)",
+                        idx, tid
+                    ));
+                }
+            }
+            _ => {}
+        }
+        Ok(())
+    }
+
    /// 统一鉴权头：x-api-key + anthropic-version
    fn auth_headers(&self, rb: reqwest::RequestBuilder) -> reqwest::RequestBuilder {
        rb.header("x-api-key", &self.api_key)
@@ -457,7 +477,7 @@ impl LlmProvider for AnthropicCompatProvider {
        req.stream = false;
        let body = self.convert_request(req);

-        // B-260618-27: 协议预检——命中非法 bail 含 messages 摘要,把 GLM 模糊 1214 转明确诊断
+        // 协议预检——命中非法 bail 含 messages 摘要,把 GLM 模糊 1214 转明确诊断
        if let Err(reason) = Self::precheck_messages(&body.messages) {
            let summary = Self::summarize_messages(&body.messages);
            warn!(%reason, %summary, "Anthropic messages 协议预检失败");
@@ -466,9 +486,8 @@ impl LlmProvider for AnthropicCompatProvider {

        debug!(model = %body.model, "Anthropic 同步调用");

-        // 指数退避重试(B-260616-07): 包裹 send + 状态码判定。
-        // 同时补 FR-R4 遗漏: Anthropic 同步路径此前无单请求 timeout(建连后挂起会无限 hang)，
-        // 此处加 60s timeout，与 OpenAI 路径对齐。
+        // 指数退避重试: 包裹 send + 状态码判定。
+        // 同时补单请求 timeout(Anthropic 同步路径无 timeout 会 hang),此处加 60s,与 OpenAI 路径对齐。
        let label = format!("Anthropic[{}]", body.model);
        retry_with_backoff(&label, move |_| {
            let client = self.client.clone();
@@ -488,7 +507,7 @@ impl LlmProvider for AnthropicCompatProvider {
                let resp = match rb.send().await {
                    Ok(r) => r,
                    Err(e) => {
-                        // B-260618-26: 记 reqwest 错误源因链(is_*/source)。原仅 Display
+                        // 记 reqwest 错误源因链(is_*/source)。原仅 Display
                        // "error sending request for url" 无法定位 reset/TLS/超时/body 真因。
                        tracing::error!(
                            is_timeout = e.is_timeout(),
@@ -580,7 +599,7 @@ impl LlmProvider for AnthropicCompatProvider {
        req.stream = true;
        let body = self.convert_request(req);

-        // B-260618-27: 协议预检——命中非法 bail 含 messages 摘要,把 GLM 模糊 1214 转明确诊断
+        // 协议预检——命中非法 bail 含 messages 摘要,把 GLM 模糊 1214 转明确诊断
        if let Err(reason) = Self::precheck_messages(&body.messages) {
            let summary = Self::summarize_messages(&body.messages);
            warn!(%reason, %summary, "Anthropic messages 协议预检失败");
@@ -589,9 +608,9 @@ impl LlmProvider for AnthropicCompatProvider {

        debug!(model = %body.model, "Anthropic 流式调用");

-        // BUG-2026-07-07: send 阶段需 timeout 防 hang(实测 GLM 偶发建连后长时间不返回)。
+        // send 阶段需 timeout 防 hang(实测 GLM 偶发建连后长时间不返回)。
        // 注意:不能用 reqwest 的 .timeout()——它是整个请求(含 body 读取)的总超时,
-        // 流式长生成任务会被误砍(build_provider_client 注释已明确)。改用 tokio::time::timeout
+        // 流式长生成任务会被误砍。改用 tokio::time::timeout
        // 包裹 send().await,只管建连+首响应头,不管后续 body 读取(后续由 stream_llm idle timeout 兜底)。
        // 60s 选型:正常 send(建连+收 200 headers)<5s,60s 足够宽容。
        let send_future = self
@@ -638,9 +657,9 @@ impl LlmProvider for AnthropicCompatProvider {
            anyhow::bail!("Anthropic 流式 API 错误 {}: {}", status, text);
        }

-        // BUG-2026-07-17 根治: 原生 SSE 解析器替代 eventsource-stream(同 openai_compat)。
+        // 原生 SSE 解析器替代 eventsource-stream(同 openai_compat)。
        let mut usage_accum: Option<TokenUsage> = None;
-        // B-260618-28: MidStream error(如 GLM 1214 messages 非法)时附 messages 摘要定位哪条非法。
+        // MidStream error(如 GLM 1214 messages 非法)时附 messages 摘要定位哪条非法。
        let messages_summary = Self::summarize_messages(&body.messages);

        let sse = crate::sse_parser::SseStream::new(resp.bytes_stream());
@@ -870,7 +889,7 @@ mod tests {
        assert!(acc.is_none());
    }

-    // ---------- F-260614-05 Phase 2a 多模态 convert_request ----------
+    // ---------- 多模态 convert_request ----------

    /// 含图 user 消息 → content blocks（text + image source.base64）
    #[test]
@@ -931,7 +950,7 @@ mod tests {
        assert_eq!(user_msg.get("content").and_then(|c| c.as_str()), Some("hello"));
    }

-    // ---------- B-260626-01: ensure_leading_user（首条 assistant → 补 user 占位,保留上下文）----------
+    // ---------- ensure_leading_user（首条 assistant → 补 user 占位,保留上下文）----------

    /// 辅助:构造 assistant(tool_use) 消息
    fn msg_assistant_with_tool_use(text: &str, tool_id: &str, tool_name: &str) -> ChatMessage {
@@ -941,7 +960,7 @@ mod tests {
        )
    }

-    /// B-260626-01: 精确复现线上 bug——多轮 [asst(tool_use), tool_result] 链,首条 assistant。
+    /// 精确复现线上场景——多轮 [asst(tool_use), tool_result] 链,首条 assistant。
    /// 补一条 user 占位后:首条 user、tool_use/tool_result 配对完整保留、precheck 通过。
    /// (原"砍"策略会把每对三元组砍掉,多轮砍到空,丢失全部工具调用历史——"补"策略零丢失。)
    #[test]
@@ -981,7 +1000,7 @@ mod tests {
        );
    }

-    /// B-260626-01: 首条 assistant 无 tool_use → 补占位,首条 user,原上下文保留。
+    /// 首条 assistant 无 tool_use → 补占位,首条 user,原上下文保留。
    #[test]
    fn anthropic_ensure_leading_user_plain_assistant() {
        let provider = AnthropicCompatProvider::new("https://api.anthropic.com", "k", "claude-3-5-sonnet");
@@ -1007,7 +1026,7 @@ mod tests {
        assert!(AnthropicCompatProvider::precheck_messages(&body.messages).is_ok());
    }

-    /// B-260626-01: 正常序列(user 开头)不补占位——零回归验证。
+    /// 正常序列(user 开头)不补占位——零回归验证。
    #[test]
    fn anthropic_ensure_leading_user_normal_sequence_unchanged() {
        let provider = AnthropicCompatProvider::new("https://api.anthropic.com", "k", "claude-3-5-sonnet");
@@ -1033,7 +1052,7 @@ mod tests {
        assert!(AnthropicCompatProvider::precheck_messages(&body.messages).is_ok());
    }

-    /// B-260626-01: 线上 3 轮工具调用场景(6 条 [asst(tu),tool_result]×3,首条 assistant)。
+    /// 线上 3 轮工具调用场景(6 条 [asst(tu),tool_result]×3,首条 assistant)。
    /// 补一个 user 占位后全部保留,验证多轮链不丢数据、precheck 通过(原"砍"策略此场景砍到空)。
    #[test]
    fn anthropic_ensure_leading_user_three_round_chain() {
@@ -1070,7 +1089,7 @@ mod tests {
        );
    }

-    /// B-260626-01: 空 messages(异常会话经 sanitize 清空)→ convert 补 1 条 user 占位,
+    /// 空 messages(异常会话经 sanitize 清空)→ convert 补 1 条 user 占位,
    /// 避免发空 messages 触发 precheck "messages 为空"(降级让会话能继续)。
    #[test]
    fn anthropic_ensure_leading_user_empty_messages_gets_placeholder() {
@@ -20,7 +20,7 @@ fn cfg(max_tokens: u32) -> ContextConfig {

 #[test]
 fn estimate_message_counts_parts_tokens() {
-    // F-260614-05 多模态回归：含图消息的大段 base64 必须计入 token 预算，
+    // 多模态回归：含图消息的大段 base64 必须计入 token 预算，
    // 否则 history_tokens 严重低估 → build_for_request 不裁剪 → provider 超限。
    let est = TokenEstimator::default();

@@ -263,7 +263,7 @@ fn system_over_budget_trims_to_protect_zone() {
    );
 }

-// ── F-15 阶段1 辅助方法单测 ──
+// ── 辅助方法单测 ──

 #[test]
 fn compress_old_messages_marks_compressed_and_returns_refs() {
@@ -430,7 +430,7 @@ fn build_eviction_units_keeps_triplet_atomic_public() {
    );
 }

-// ── F-260619-04 P1 消息级溯源:last_assistant/last_user message_id ──
+// ── 消息级溯源:last_assistant/last_user message_id ──

 #[test]
 fn last_assistant_message_id_returns_latest() {
@@ -165,7 +165,7 @@ impl ContextManager {
        // 未超预算 → 直接返回全量（仍做畸形配对自愈，防历史中毒触发 provider 500 死循环）
        if self.history_tokens <= available {
            let sanitized = Self::sanitize_messages(self.all_messages_clone());
-            // 阶段2 出口断言:占位配对完整性,失败降级 TOOL_MISSING_PREFIX 自愈(防 400 orphan)
+            // 出口断言:占位配对完整性,失败降级 TOOL_MISSING_PREFIX 自愈(防 400 orphan)
            return (
                Self::assert_placeholder_pairing(sanitized, PLACEHOLDER_INTEGRITY_ENABLED),
                false,
@@ -191,7 +191,7 @@ impl ContextManager {
                "history (~{} tokens) 超预算 ({}) 但无可淘汰单元(全在保护区 {} 条),发送兜底可能触发 provider 超限",
                self.history_tokens, available, PROTECT_COUNT
            );
-            // B-260626-01: 兜底全量也过 sanitize(对齐分支 1/3),防绕过序列修复直送 provider
+            // 兜底全量也过 sanitize(对齐分支 1/3),防绕过序列修复直送 provider
            // 触发"首条 assistant 非法"/orphan/连续 role。原裸返 all_messages_clone 不过滤
            // truncated/中毒三元组/首条非法——是主 loop 唯一的 sanitize 漏洞(大体量 tool_result
            // 致超预算且保护区满时命中)。异常会话(开头连续 assistant/tool 无 user)经
@@ -214,7 +214,7 @@ impl ContextManager {
            trim_end, removed
        );
        let sanitized = Self::sanitize_messages(msgs);
-        // 阶段2 出口断言:占位配对完整性,失败降级 TOOL_MISSING_PREFIX 自愈(防 400 orphan)
+        // 出口断言:占位配对完整性,失败降级 TOOL_MISSING_PREFIX 自愈(防 400 orphan)
        (
            Self::assert_placeholder_pairing(sanitized, PLACEHOLDER_INTEGRITY_ENABLED),
            true,
@@ -350,7 +350,7 @@ impl ContextManager {
        self.messages.iter().map(|t| &t.message)
    }

-    /// F-260619-04 P1 消息级溯源:取末条指定 role 消息的 id(ULID)。
+    /// 消息级溯源:取末条指定 role 消息的 id(ULID)。
    ///
    /// 从尾部反向扫描(末条消息命中即停,避免全量 O(n) 正扫累积),返回最近一条
    /// `role` 匹配且 `id` 非空消息的 id。无匹配或老消息无 id → None(向前兼容:
@@ -417,7 +417,7 @@ impl ContextManager {
        &self.config
    }

-    /// 可变消息切片（供阶段2 标记 status="compressed"/"archived_segment" + 调整 token）
+    /// 可变消息切片（供标记 status="compressed"/"archived_segment" + 调整 token）
    ///
    /// 调用方约定:仅改 `message.status` / `message.content`,不增删条目(增删走
    /// [`push`] / [`insert_at`]),否则 `history_tokens` 会与实际脱钩。
@@ -427,7 +427,7 @@ impl ContextManager {

    /// 在给定位置插入一条消息(其余向后移),并把它计入 token 预算(active 才计)。
    ///
-    /// 供阶段2 在压缩点插入摘要 system 消息。`index` 越界则 panic(对齐 Vec::insert 语义,
+    /// 供压缩点插入摘要 system 消息。`index` 越界则 panic(对齐 Vec::insert 语义,
    /// 调用方负责算合法 index,如 `compress_end` 已由 `compress_old_messages` 校验)。
    pub fn insert_at(&mut self, index: usize, message: ChatMessage) {
        let tokens = self.estimator.estimate_message(&message);
@@ -449,7 +449,7 @@ impl ContextManager {
    /// - 工具调用三元组(Head + Tail* + 紧随的 Standalone Assistant)在同一单元
    /// - 保护区 `[protect_start, len)` 内的消息不纳入任何单元
    ///
-    /// 公开供阶段2 会话分段(`archived_segment` 按组原子标记)与压缩定位共用。
+    /// 公开会话分段(`archived_segment` 按组原子标记)与压缩定位共用。
    pub fn build_eviction_units(&self, protect_start: usize) -> Vec<EvictionUnit> {
        let mut units = Vec::new();
        let mut i = 0usize;
@@ -488,7 +488,7 @@ impl ContextManager {
    /// 不参与二次压缩,幂等)。`protect_start` 为保护区起点(如 `len - PROTECT_COUNT`)。
    pub fn has_compressible_messages(&self, protect_start: usize) -> bool {
        let end = protect_start.min(self.messages.len());
-        // BUG-260624-05:排除 system 角色(压缩摘要 / 话题切换锚点)。这些是上下文锚点非压缩目标——
+        // 排除 system 角色(压缩摘要 / 话题切换锚点)。这些是上下文锚点非压缩目标——
        // 若计入,压缩摘要 insert_at(0) 落在可压缩区 [0..protect_start) 且 is_active(status=None),
        // 致每轮 has_compressible 恒 true → 无限循环压缩(用户报"压缩后每轮提示已压缩并停止")。
        // compress_old_messages 不改:被调用时仍标旧 system 摘要 compressed(被新摘要替代,防堆积)。
@@ -498,7 +498,7 @@ impl ContextManager {
    }

    /// 把保护区 `[0, compress_end)` 范围内的 active 消息标记为 `status="compressed"`,
-    /// 同步从 `history_tokens` 扣除其 token,返回被压缩消息的克隆(供阶段2 喂 LLM 摘要)。
+    /// 同步从 `history_tokens` 扣除其 token,返回被压缩消息的克隆(供喂 LLM 摘要)。
    ///
    /// **幂等**:已 compressed(或任何 !active)的消息跳过,不会被二次压缩;`history_tokens`
    /// 也只扣首次标记的 token。返回的 Vec 仅含**本次新标记**的消息(已 compressed 的不返)。
@@ -151,7 +151,7 @@ pub fn sanitize_messages(messages: Vec<ChatMessage>) -> Vec<ChatMessage> {
        sanitized
    };

-    // step 3.5(阶段2 占位配对完整性):反向 orphan 检测 —— tool_result 无对应 tool_call 头 → 丢。
+    // step 3.5(占位配对完整性):反向 orphan 检测 —— tool_result 无对应 tool_call 头 → 丢。
    //
    // 根因(解 400 orphan):审批挂起占位 tool_result(内容 audit/cache.rs:PENDING_APPROVAL_PLACEHOLDER)
    // 经 step3(正向 orphan:头无 result→丢头 + 其 result)或 build_eviction_units(预算裁剪从三元组
@@ -227,7 +227,7 @@ pub fn drop_reverse_orphans(messages: Vec<ChatMessage>) -> Vec<ChatMessage> {
    filtered
 }

-/// 发送视图出口断言(阶段2 占位配对完整性):确保所有 tool_result(含审批占位)都有
+/// 发送视图出口断言(占位配对完整性):确保所有 tool_result(含审批占位)都有
 /// 对应 tool_call 头,失败降级 TOOL_MISSING_PREFIX 自愈。
 ///
 /// **职责**:在消息即将发给 LLM 前(`build_for_request` 出口)最后一道防线:若仍有
@@ -470,7 +470,7 @@ mod tests {
        assert_eq!(msgs.len(), 3, "正常三元组不应被 sanitize 剔除");
    }

-    // ── 阶段2 占位配对完整性(解 400 orphan):反向 orphan 检测 + 出口自愈 ──
+    // ── 占位配对完整性(解 400 orphan):反向 orphan 检测 + 出口自愈 ──

    #[test]
    fn sanitize_drops_reverse_orphan_tool_result() {
@@ -47,7 +47,7 @@ impl Default for TokenEstimator {
 impl TokenEstimator {
    /// 估算单条消息的 token 数（保守估计）
    ///
-    /// F-260614-05 多模态回归修正：`msg.parts` 中的 Image.base64 与 Text.text 同样计入预算。
+    /// 多模态回归修正：`msg.parts` 中的 Image.base64 与 Text.text 同样计入预算。
    /// 此前只算 `content`，含图消息的大段 base64(可达 25 万 tokens)被完全忽略，致
    /// `history_tokens` 严重低估 → build_for_request 误判未超预算 → provider 超限 400/500。
    /// 这里把 parts 的文本/base64 按同一 chars_ratio 粗估累加(base64 视为密集字符，0.35 偏保守)。
@@ -58,7 +58,7 @@ impl TokenEstimator {
                match p {
                    crate::provider::ContentPart::Text { text } => char_count += text.chars().count(),
                    crate::provider::ContentPart::Image { base64, url, .. } => {
-                        // CR-260618-11#2:0.35 按 base64 字节数粗估,显著高于厂商实际(OpenAI 按像素非字节)。
+                        // 0.35 按 base64 字节数粗估,显著高于厂商实际(OpenAI 按像素非字节)。
                        // 偏保守致含图消息 token 高估、过度裁剪;降值(如 0.10~0.15)需独立评估裁剪边界,本次不改值仅标注。
                        // base64 优先（多模态主载荷），url 次之；url 模式无字节，仅按 URL 长度估
                        if let Some(b) = base64 {
@@ -145,7 +145,7 @@ pub enum MessageGroup {

 /// 带有 token 缓存和分组信息的消息条目
 ///
-/// 字段 `pub`：供阶段2 IPC 经 `ContextManager::messages_mut()` 拿到可变切片后,
+/// 字段 `pub`：供 IPC 经 `ContextManager::messages_mut()` 拿到可变切片后,
 /// 直接改 `message.status` / 读 `token_count` 做 token 重算(Mutex 单线程访问,
 /// 同 crate 内安全)。结构体本身也 `pub`(返回类型对外可见)。
 pub struct TrackedMessage {
@@ -408,7 +408,7 @@ pub fn extract_key_info(content: &str, tool_name: &str) -> String {
                        *field = serde_json::Value::String(out.join("\n"));
                        truncated = true;
                    } else if s.chars().count() > TOOL_RESULT_JSON_STR_FIELD_MAX {
-                        // BUG-260628-01:单行/少行大字符串绕过行级截断(实测 53/94 次零效果)。
+                        // 单行/少行大字符串绕过行级截断(实测 53/94 次零效果)。
                        // 按字符数截断保留头尾,保证压缩至少生效。
                        let head: String = s.chars().take(TOOL_RESULT_JSON_STR_FIELD_MAX / 2).collect();
                        let tail: String = s.chars().skip(s.chars().count().saturating_sub(TOOL_RESULT_JSON_STR_FIELD_MAX / 2)).collect();
@@ -439,7 +439,7 @@ pub fn extract_key_info(content: &str, tool_name: &str) -> String {
    let total = lines.len();
    let kept_boundary = TOOL_RESULT_HEAD_LINES + TOOL_RESULT_TAIL_LINES;
    if total <= kept_boundary {
-        // BUG-260628-01:行数少但内容超大的情况(单行 50KB),行级截断无效。
+        // 行数少但内容超大的情况(单行 50KB),行级截断无效。
        // 按字符数截断保证压缩至少生效。
        let char_count = content.chars().count();
        if char_count > TOOL_RESULT_CHAR_LIMIT {
@@ -524,7 +524,7 @@ fn is_error_line(line: &str) -> bool {

 /// 淘汰单元：连续消息范围 [..end) + token 总和
 ///
-/// `pub` 供 `build_eviction_units` 的返回类型对外可见(阶段2/3 调用方读 `end` / `token_sum`)。
+/// `pub` 供 `build_eviction_units` 的返回类型对外可见(调用方读 `end` / `token_sum`)。
 pub struct EvictionUnit {
    pub end: usize,
    pub token_sum: u32,
@@ -541,7 +541,7 @@ pub const PROTECT_COUNT: usize = 6;
 /// 此类 id 必然无匹配 tool_result，是历史中毒的标志，sanitize 时据此剔除畸形三元组。
 pub const TOOL_MISSING_PREFIX: &str = "tool_missing_";

-/// 阶段2(path_auth 审批链重构):占位配对完整性(解 400 orphan)常量开关。
+/// 占位配对完整性(解 400 orphan)常量开关。
 ///
 /// 根因:审批挂起占位 tool_result(内容为 audit/cache.rs:PENDING_APPROVAL_PLACEHOLDER)
 /// 与其 tool_call 头经 sanitize/compress 裁剪后丢配对头 → orphan tool_result(无头)→
@@ -1118,7 +1118,7 @@ mod tests {

    #[test]
    fn extract_key_info_single_huge_line_no_newline_compressed() {
-        // BUG-260628-01:单行超大内容(50KB)原本逃逸压缩,现按字符数截断保留头尾。
+        // 单行超大内容(50KB)原本逃逸压缩,现按字符数截断保留头尾。
        let content = "x".repeat(50_000);
        let result = extract_key_info(&content, "read_file");
        assert!(result.len() < content.len(), "单行超长应压缩: {} >= {}", result.len(), content.len());
@@ -1130,7 +1130,7 @@ mod tests {

    #[test]
    fn extract_key_info_json_huge_string_field_truncated() {
-        // BUG-260628-01:JSON 对象中大字符串字段(单行少行)逃逸压缩。
+        // JSON 对象中大字符串字段(单行少行)逃逸压缩。
        // 如 `{"path":"src/main.rs","content":"单行超大文本..."}`。
        let large = "z".repeat(10_000);
        let content = format!("{{\"path\":\"src/main.rs\",\"content\":\"{}\"}}", large);
@@ -1243,7 +1243,7 @@ mod tests {
        assert!(toks.contains(&"now".to_string()));
    }

-    // ── 阶段2 占位配对完整性:is_pending_placeholder / extract_pending_tc_id ──
+    // ── 占位配对完整性:is_pending_placeholder / extract_pending_tc_id ──

    #[test]
    fn is_pending_placeholder_new_with_marker() {
@@ -38,9 +38,9 @@ pub mod persona;
 pub mod plan_executor;
 pub mod provider;
 pub mod router;
-// CR-30-1: 流前重试退避对外复用。complete() 的 retry_with_backoff 仍 crate 内用,
+// 流前重试退避对外复用。complete() 的 retry_with_backoff 仍 crate 内用,
 // stream_recv/agentic 流前重试需复用 backoff_delay(jitter)+is_status_retryable(Fatal 分类)
-// 避免重写退避/分类逻辑(对齐决策 F-260616-07 a1)。改 pub mod 后对外仅暴露纯函数 + 常量。
+// 避免重写退避/分类逻辑。改 pub mod 后对外仅暴露纯函数 + 常量。
 pub mod retry;
 pub mod sse_parser;
 pub mod namespace_store;
@@ -1,4 +1,4 @@
-//! 厂商模型列表拉取 — F-01 阶段3
+//! 厂商模型列表拉取。
 //!
 //! 按 `provider_type` 分派拉取厂商模型列表,过滤非 chat 模型,返回模型名 Vec。
 //! `fetch_and_probe` 在拉取基础上对每个模型名调 `model_probe::probe` 探测出完整 `ModelConfig`。
@@ -1,4 +1,4 @@
-//! 模型探测器 — F-01 阶段2
+//! 模型探测器。
 //!
 //! 给定模型名,产出完整 `ModelConfig`(4 维度 + 路由控制 + 探测来源标注)。
 //!
@@ -100,7 +100,7 @@ mod tests {
        assert_eq!(m.model_id, "glm-4");
        assert_eq!(m.probe_source, Some(ProbeSource::PresetTable));
        assert_eq!(m.modalities, vec![Modality::Text]);
-        // B-260618-04:预设表不再写死 cost_tier/intelligence,由 serde default 兜底中性值
+        // 预设表不写死 cost_tier/intelligence,由 serde default 兜底中性值
        assert_eq!(m.intelligence, IntelligenceTier::Standard);
        assert_eq!(m.cost_tier, CostTier::Medium);
    }
@@ -177,7 +177,7 @@ mod tests {
    fn heuristic_flash_keeps_neutral_tier() {
        let m = probe("unknown-flash");
        assert_eq!(m.probe_source, Some(ProbeSource::Heuristic));
-        // B-260618-04:cost/intel 一律中性,不靠名字猜
+        // cost/intel 一律中性,不靠名字猜
        assert_eq!(m.intelligence, IntelligenceTier::Standard);
        assert_eq!(m.cost_tier, CostTier::Medium);
    }
@@ -261,7 +261,7 @@ mod tests {

    #[test]
    fn probe_preset_beats_heuristic() {
-        // "glm-4-flash" 精确命中预设表;B-260618-04 后预设/启发式档位都中性,
+        // "glm-4-flash" 精确命中预设表;预设/启发式档位都中性,
        // 此处仅校验 source 标注为 PresetTable
        let m = probe("glm-4-flash");
        assert_eq!(m.probe_source, Some(ProbeSource::PresetTable));
@@ -1,4 +1,4 @@
-//! 模型探测器 — 纯逻辑子模块(F-01 阶段2)
+//! 模型探测器 — 纯逻辑子模块。
 //!
 //! 从 `model_probe.rs` 抽离的纯函数实现(预设表加载 / 启发式推断 / 词素判定)。
 //! 无 IO、无外部状态,crate 内经 `model_probe::probe` 间接复用 —
@@ -36,7 +36,7 @@ pub(super) fn presets() -> &'static [ModelConfig] {
 /// 模型名启发式推断。仅推断功能性维度(modalities/capabilities),
 /// cost_tier / intelligence 一律返中性默认(Medium / Standard)。
 ///
-/// 取舍:B-260618-04 — 模型名关键词猜档位(flash→Lite、4o→High、pro→Plus)无依据,
+/// 取舍:模型名关键词猜档位(flash→Lite、4o→High、pro→Plus)无依据,
 /// 厂商定价/智力与命名无关,瞎填会污染路由器过滤(intelligence >= min / cost_tier <= max)。
 /// 改中性默认,真实档位由用户手填或更高阶探测源(如厂商 API/定价表)提供。
 ///
@@ -49,7 +49,7 @@ pub(super) fn heuristic_infer(model_id: &str) -> ModelConfig {
    let name = model_id.to_lowercase();
    let mut modalities: Vec<Modality> = Vec::new();
    let mut capabilities: Vec<Capability> = Vec::new();
-    // 中性默认:不靠模型名猜档位(B-260618-04)
+    // 中性默认:不靠模型名猜档位
    let cost_tier = CostTier::Medium;
    let intelligence = IntelligenceTier::Standard;

@@ -220,7 +220,10 @@ mod tests {
        let p1 = ns.store("tool_a", content);
        let p2 = ns.store("tool_b", content);
        assert_eq!(ns.len(), 1, "相同内容应去重");
-        assert_eq!(ns.read(&p1), ns.read(&p2));
+        // read(&mut self) 返回 Option<&str> 借用 ns，两次调用须各自转 owned 避免双重可变借用
+        let r1 = ns.read(&p1).map(str::to_owned);
+        let r2 = ns.read(&p2).map(str::to_owned);
+        assert_eq!(r1, r2);
    }

    #[test]
@@ -114,7 +114,7 @@ impl OpenAICompatProvider {
                    crate::provider::MessageRole::Assistant => "assistant",
                    crate::provider::MessageRole::Tool => "tool",
                };
-                // F-260614-05 Phase 2a: 多模态 content（须在 move m.tool_calls 之前算，借用 m）。
+                // 多模态 content（须在 move m.tool_calls 之前算，借用 m）。
                // 含图消息走 content 数组（text/image_url）；纯文本走字符串简写
                // （保持与现有纯文本端点零回归）。image_url 支持 data URI（base64）与 http(s) URL。
                let content = if m.has_image() {
@@ -176,7 +176,7 @@ impl OpenAICompatProvider {
            })
            .collect();

-        // B-260626-01: 保证首条 user/system(OpenAI 协议要求首条非 assistant/tool)。
+        // 保证首条 user/system(OpenAI 协议要求首条非 assistant/tool)。
        // 对齐 AnthropicCompatProvider::ensure_leading_user:上游绕过 sanitize 的调用方
        // (标题生成/知识注入/工作流 AI 节点等直构造 CompletionRequest 的路径)可能传入首条
        // assistant 的序列(会话恢复/续发/片段截取),补 user 占位保留上下文,首条合法。
@@ -231,7 +231,7 @@ impl OpenAICompatProvider {
        }
    }

-    /// B-260626-01: 保证 messages 首条为 user/system(OpenAI 协议要求首条非 assistant/tool)。
+    /// 保证 messages 首条为 user/system(OpenAI 协议要求首条非 assistant/tool)。
    ///
    /// 对齐 `AnthropicCompatProvider::ensure_leading_user`。上游绕过 `ContextManager::sanitize_messages`
    /// 的调用方(标题生成/知识注入/工作流 AI 节点等直构造 CompletionRequest 的路径)可能传入首条
@@ -307,8 +307,8 @@ impl LlmProvider for OpenAICompatProvider {

        debug!(model = %openai_req.model, "OpenAI 同步调用");

-        // 指数退避重试(B-260616-07): 包裹 send + 状态码判定。
-        // 单请求 60s timeout 保持不变(FR-R4)，重试是额外层: 3 次 × 60s 最坏 180s，
+        // 指数退避重试: 包裹 send + 状态码判定。
+        // 单请求 60s timeout 保持不变,重试是额外层: 3 次 × 60s 最坏 180s,
        // 由 retry_with_backoff 内部 30s 总预算主动止损。
        let label = format!("OpenAI[{}]", openai_req.model);
        retry_with_backoff(&label, move |_| {
@@ -386,7 +386,7 @@ impl LlmProvider for OpenAICompatProvider {

        debug!(model = %openai_req.model, "OpenAI 流式调用");

-        // BUG-2026-07-07: send 阶段需 timeout 防 hang(同 Anthropic 路径)。
+        // send 阶段需 timeout 防 hang(同 Anthropic 路径)。
        // 不能用 reqwest .timeout()(会砍流式 body),改用 tokio::time::timeout 包裹 send。
        let send_future = self
            .client
@@ -414,7 +414,7 @@ impl LlmProvider for OpenAICompatProvider {
            anyhow::bail!("LLM 流式 API 错误 {}: {}", status, body);
        }

-        // BUG-2026-07-17 根治: 原生 SSE 解析器替代 eventsource-stream 库。
+        // 原生 SSE 解析器替代 eventsource-stream 库。
        // eventsource-stream 在 Windows 上对 Deepseek 等响应报 "error decoding response body"
        // (严格 UTF-8 + SSE 协议校验,跨 chunk 字符/不完整事件均报错且不可恢复)。
        // 原生解析器:bytes 累积 + from_utf8_lossy 宽松处理 + \n\n 分隔,容错不中断流。
@@ -616,7 +616,7 @@ mod tests {
        assert!(!c.finished);
    }

-    // ---------- F-260614-05 Phase 2a 多模态 convert_request ----------
+    // ---------- 多模态 convert_request ----------

    /// 含图消息 → content 数组（text + image_url data URI）；纯文本 → 字符串简写
    #[test]
@@ -672,9 +672,9 @@ mod tests {
        assert_eq!(msg.content, serde_json::Value::String("hello".into()));
    }

-    // ---------- B-260626-01: ensure_leading_user（首条非 user/system → 补 user 占位,OpenAI 对称 Anthropic）----------
+    // ---------- ensure_leading_user（首条非 user/system → 补 user 占位,OpenAI 对称 Anthropic）----------

-    /// B-260626-01: 首条 assistant → 补 user 占位(对齐 Anthropic)。上游绕过 sanitize 的
+    /// 首条 assistant → 补 user 占位(对齐 Anthropic)。上游绕过 sanitize 的
    /// 调用方(title/knowledge_inject/工作流节点)可能传入首条 assistant 序列,补占位保留上下文。
    #[test]
    fn openai_ensure_leading_user_first_assistant_gets_placeholder() {
@@ -699,7 +699,7 @@ mod tests {
        assert_eq!(out.messages[2].role.as_str(), "user");
    }

-    /// B-260626-01: 正常序列(user 开头)不补占位——零回归。
+    /// 正常序列(user 开头)不补占位——零回归。
    #[test]
    fn openai_ensure_leading_user_normal_unchanged() {
        let provider = OpenAICompatProvider::new("https://api.openai.com", "k", "gpt-4o");
@@ -20,7 +20,7 @@ use std::time::Duration;
 use rand::Rng;
 use tracing::warn;

-/// 最多尝试次数(含初次)。B-260616-07: 3 次 = 初次 + 2 次重试。
+/// 最多尝试次数(含初次)。3 次 = 初次 + 2 次重试。
 ///
 /// 配置化 TODO: 未来接入 per-provider config(`AiProviderRecord.config` JSON)或全局开关
 /// (`useSetting('df-ai-max-retries')`)时改为读取配置。当前低频后台调用，常量足够。
@@ -71,8 +71,8 @@ pub fn is_status_retryable(status: u16) -> bool {
 /// jitter 用 `rand::thread_rng().gen_range(-0.5..0.5)` 生成 ±50% 比例，避免多客户端同步重试风暴。
 /// 以毫秒粒度计算后向下取整(避免秒级截断把 0.9s 砍成 0)。
 ///
-/// CR-30-1: 暴露 pub 供 src-tauri/agentic.rs 流前重试复用(对齐决策 F-260616-07 a1
-/// "复用 retry.rs backoff_delay 退避 1s→2s→4s+jitter")，避免重写退避逻辑。
+/// 暴露 pub 供 src-tauri/agentic.rs 流前重试复用
+/// ("复用 retry.rs backoff_delay 退避 1s→2s→4s+jitter"),避免重写退避逻辑。
 pub fn backoff_delay(attempt: u32) -> Duration {
    let base_ms = BASE_BACKOFF_SECS.saturating_mul(1u64 << (attempt - 1)) * 1000;
    // ±50% jitter，相对 base 时长的浮动比例
@@ -1,26 +1,23 @@
-//! 模型路由器 — F-01 阶段4
+//! 模型路由器。
 //!
-//! 纯函数核心,零 IO / 零状态。给定 TaskRequirements + 候选池,返回最优 ModelConfig。
-//! 不接调用点(那是阶段5:agentic.rs / title.rs / knowledge_inject.rs / project.rs /
+//! 不接调用点(那是调用方:agentic.rs / title.rs / knowledge_inject.rs / project.rs /
 //! df-ideas / df-nodes ai_node.rs)。
 //!
-//! 设计来源:docs/02-架构设计/已编号方案/F-01-模型能力系统与智能路由设计-2026-06-16.md §6.1。
-//!
-//! ModelRouter 为单元结构,select 是无状态关联函数(对齐任务规格,非设计文档的 `&self` 方法)。
+//! ModelRouter 为单元结构,select 是无状态关联函数。

-// 阶段5: 调用点经 `df_ai::router::{Modality, Capability, CostTier, IntelligenceTier}`
-// 直接 import 维度枚举构造 TaskRequirements(对齐任务规格 import 风格),re-export 避免调用点
+// 调用点经 `df_ai::router::{Modality, Capability, CostTier, IntelligenceTier}`
+// 直接 import 维度枚举构造 TaskRequirements,re-export 避免调用点
 // 各自从 df_ai_core::model 取(跨 crate 路径冗长)。select/select_model_id 仅借用枚举,无重定义。
-// 注:CostTier/IntelligenceTier 路由已解耦(2026-06-18 B-260618-03)——provider /v1/models API
+// 注:CostTier/IntelligenceTier 路由已解耦——provider /v1/models API
 // 不返回这两维度,数据无客观依据不可信,不参与硬路由;re-export 保留供未来真实判别源。
 pub use df_ai_core::model::{Capability, CostTier, IntelligenceTier, Modality, ModelConfig};

 /// 任务对模型的需求(3 维度)。
 ///
-/// 由调用点构造(阶段5),描述本次调用需要什么模态/能力/上下文,
+/// 由调用点构造,描述本次调用需要什么模态/能力/上下文,
 /// 交 ModelRouter::select 在候选池中选最优模型。
 ///
-/// 路由已解耦(2026-06-18 B-260618-03):原 `min_intelligence`/`max_cost` 两字段删除。
+/// 路由已解耦:原 `min_intelligence`/`max_cost` 两字段删除。
 /// provider /v1/models API 不返回 cost_tier/intelligence,这两维度 100% 靠预设表写死 +
 /// 模型名启发式猜,数据无客观依据不可信,不应参与硬路由。枚举(CostTier/IntelligenceTier)
 /// 保留供未来出现真实判别源时再接回。
@@ -49,7 +46,7 @@ impl ModelRouter {
    /// 4. 窗口够大 — context_window >= estimated_context
    /// 5. max_by_key 选最优:纯 weight 主导(权重高者胜)
    ///
-    /// 路由已解耦(2026-06-18 B-260618-03):原「智力达标」/「成本可控」两步删除,
+    /// 路由已解耦:原「智力达标」/「成本可控」两步删除,
    /// 原第 7 步排序的 `Reverse(cost_tier)` 同权重选便宜也已删除——排序纯 weight 主导。
    /// cost_tier/intelligence 数据无客观依据(provider /v1/models 不返回,靠预设表+模型名
    /// 启发式猜),不参与硬路由。枚举保留供未来真实判别源再接回。
@@ -63,7 +60,7 @@ impl ModelRouter {
    }
 }

-/// 阶段5 调用点 helper — 路由选模型并直接返回 model_id(纯函数)。
+/// 调用点 helper — 路由选模型并直接返回 model_id(纯函数)。
 ///
 /// 给定 TaskRequirements + 候选池,返回最优模型的 `model_id`。
 /// 调用点用法:`provider.model_configs`(Vec<ModelConfig>)→ `select_model_id(&req, &pool)`
@@ -106,7 +103,7 @@ mod tests {
        }
    }

-    // ── 阶段5 select_model_id helper ──
+    // ── select_model_id helper ──

    #[test]
    fn select_model_id_empty_pool_returns_none() {
@@ -248,7 +245,7 @@ mod tests {
        );
    }

-    // ── 步骤 4(原智力/成本过滤已解耦 B-260618-03):窗口够大 ──
+    // ── 步骤 4(原智力/成本过滤已解耦):窗口够大 ──

    #[test]
    fn context_window_insufficient() {
@@ -316,13 +313,13 @@ mod tests {
    #[test]
    fn all_dimensions_match_picks_best() {
        // 3+ 候选各维度参差,验证过滤链全过 + max_by_key 纯 weight 选最优。
-        // (B-260618-03:智力/成本过滤已解耦,原步骤 4/5 删除,候选 d 不再因 intelligence 滤掉)
+        // (智力/成本过滤已解耦,原步骤 4/5 删除,候选 d 不再因 intelligence 滤掉)
        //
        // 候选:
        //  a: weight 60  → 通过全部过滤,key=60
        //  b: weight 80  → 通过,key=80 — weight 最高档(与 c 并列)
        //  c: weight 80  → 通过,key=80 — 同 weight 80,max_by_key 并列返回最后
-        //  d: weight 90  → 通过(B-260618-03 后 intelligence 不参与过滤),key=90 — weight 最高,胜
+        //  d: weight 90  → 通过(intelligence 不参与过滤),key=90 — weight 最高,胜
        //  e: enabled=false → 步骤 1 滤掉
        //
        // 预期:d 胜(weight 90 最高,不再被 intelligence 滤掉)
@@ -1,6 +1,6 @@
 //! 原生 SSE 流式解析器 — 替代 eventsource-stream 库
 //!
-//! BUG-2026-07-17 根治: eventsource-stream 0.2 在 Windows 上对 Deepseek 等 provider
+//! eventsource-stream 0.2 在 Windows 上对 Deepseek 等 provider
 //! 的 SSE 响应解析时报 "Transport error: error decoding response body" 错误。
 //!
 //! 根因分析:
@@ -51,7 +51,7 @@ impl EnvSnapshot {
            return snap;
        }
        // 首次探测:同步逻辑包到 spawn_blocking,避免阻塞 async runtime。
-        // BUG-2026-07-18 根治: probe_version 内 std::process::Command::output() 无 timeout,
+        // probe_version 内 std::process::Command::output() 无 timeout,
        // Windows 上 python/node 若是 Microsoft Store App Execution Alias(用户未装但开了
        // "应用执行别名"),`python --version` 触发 Store 重定向、process 不退出 → output()
        // 永久阻塞 → spawn_blocking 线程永不返回 → detect().await 永久挂 → run_agentic_loop
@@ -33,8 +33,8 @@ pub enum ShellType {
 impl Default for ShellType {
    fn default() -> Self {
        // L1 环境感知:Windows 默认 PowerShell 系(非 Cmd)。PowerShell 对引号/$变量/Unicode 处理
-        // 远优于 cmd,从根上避 kms 类引号转义地狱(seq26-52 撞墙 20+ 次)。AI 写文件执行见 env_profile。
-        // BUG-260623-04:优先 pwsh(PS7,支持 && 运算符)——LLM 训练数据 Unix 多,普遍生成 `cd x && y`,
+        // 远优于 cmd,从根上避 kms 类引号转义地狱。AI 写文件执行见 env_profile。
+        // 优先 pwsh(PS7,支持 && 运算符)——LLM 训练数据 Unix 多,普遍生成 `cd x && y`,
        // PS5 不支持 && 致命令失败(实测会话 6acb7f9b `cd ... && git init` InvalidEndOfLine)。
        // 探测失败(未装 pwsh)回退 PS5。探测结果 OnceLock 缓存(只探一次)。
        // 注:Default trait 为同步签名,这里只能读取已探测的缓存结果(若未探测则返回 false,退回 PowerShell)。
@@ -146,7 +146,7 @@ pub async fn execute(request: ShellRequest) -> anyhow::Result<ShellResult> {
    // 对齐 tool_registry.rs:514「进程已终止」文案名副其实。tokio 1.52.3 支持。
    cmd.kill_on_drop(true);

-    // B-260619-01: Windows 下创建子进程默认弹控制台窗口(cmd/powershell 黑窗闪现)。
+    // Windows 下创建子进程默认弹控制台窗口(cmd/powershell 黑窗闪现)。
    // CREATE_NO_WINDOW(0x0800_0000) 标志抑制窗口创建,后台静默执行。
    // tokio::process::Command 在 Windows 自带 creation_flags 方法(无需 std CommandExt trait)。
    #[cfg(windows)]
@@ -7,7 +7,7 @@
 //! 评估来源由 [`EvaluatedBy`] 三态标记：`Llm`（LLM 深度评估）/ `Heuristic`（主动选启发式，
 //! 无 provider）/ `HeuristicFallback`（LLM 调用失败降级）。前端可据此显示评估深度标签。
 //!
-//! LLM prompt 构造与 JSON 解析在 F-260614-03 接入：[`AdversarialEngine::evaluate_with_llm`]
+//! LLM prompt 构造与 JSON 解析在后续接入：[`AdversarialEngine::evaluate_with_llm`]
 //! 构造三角色辩论 prompt（正方/反方/分析师），调一次 `complete()` 要求返回对齐结构的 JSON，
 //! 解析失败/字段缺失/枚举非法 → `bail` 触发降级（[`AdversarialEngine::evaluate`] 已兜底）。
 //!
@@ -42,7 +42,7 @@ pub struct AdversarialEngine {
    /// 可选 LLM provider。Some → 优先 LLM 评估（失败降级启发式）；None → 纯启发式。
    /// 构造注入（与 IdeaPromoter::new(policy) 同一模式），批量评估复用同一 provider。
    provider: Option<Arc<dyn LlmProvider>>,
-    /// F-01 阶段5: 候选模型池。非空时 evaluate_with_llm 经 select_model_id 路由选模型;
+    /// 候选模型池。非空时 evaluate_with_llm 经 select_model_id 路由选模型;
    /// 空(None provider 或未注入池)→ model 留空由 provider impl 回填自身 default_model
    /// (与接入前行为一致,平稳过渡)。
    model_pool: Vec<ModelConfig>,
@@ -54,7 +54,7 @@ impl AdversarialEngine {
        Self { provider: Some(provider), model_pool: Vec::new() }
    }

-    /// F-01 阶段5: 注入 provider + 候选模型池构造。池非空时 evaluate_with_llm 走路由。
+    /// 注入 provider + 候选模型池构造。池非空时 evaluate_with_llm 走路由。
    pub fn with_pool(provider: Arc<dyn LlmProvider>, model_pool: Vec<ModelConfig>) -> Self {
        Self { provider: Some(provider), model_pool }
    }
@@ -101,7 +101,7 @@ impl AdversarialEngine {
    /// analyst.final_assessment 自洽性等），待产品决策，当前逻辑原样保留不调整。
    async fn evaluate_with_llm(&self, idea: &Idea, provider: &Arc<dyn LlmProvider>) -> Result<AdversarialEval> {
        let prompt = build_adversarial_prompt(idea);
-        // F-01 阶段5: 智能路由 — 对抗评估 TaskRequirements(Standard,无工具)。
+        // 智能路由 — 对抗评估 TaskRequirements(Standard,无工具)。
        // 池非空 → select_model_id 选最优 model_id;池空/无匹配 → 留空由 provider impl
        // 回填自身 default_model(与接入前行为一致,平稳过渡)。
        let eval_req = df_ai::router::TaskRequirements {
@@ -421,7 +421,7 @@ mod tests {
    }

    // ────────────────────────────────────────────────────────────
-    // LLM 路径测试（F-260614-03）
+    // LLM 路径测试
    // ────────────────────────────────────────────────────────────

    /// mock LlmProvider：按构造时给定的响应文本回放，仅供 adversarial 单测。
@@ -84,7 +84,7 @@ pub enum Recommendation {
 }

 // ============================================================
-// LLM 对抗评估 — prompt 构造 / JSON 解析（F-260614-03）
+// LLM 对抗评估 — prompt 构造 / JSON 解析
 // ============================================================

 /// LLM 角色 / 输出契约的系统级约束。
@@ -45,7 +45,7 @@ impl Node for AiNode {
    async fn execute(&self, ctx: NodeContext) -> NodeResult {
        tracing::info!("AiNode 执行: node_id={}", ctx.node_id);

-        // FR-S1 注入链：provider 经 df_storage::secret 在 AiNode 内存解析，api_key 不进 config。
+        // provider 经 df_storage::secret 在 AiNode 内存解析，api_key 不进 config。
        let p = resolve_and_parse(&self.db, &ctx.config, &ctx.inputs).await?;
        let provider: Box<dyn LlmProvider> = provider_from_params(&p);

@@ -117,12 +117,12 @@ impl Node for AiNode {
                "properties": {
                    "prompt": { "type": "string", "description": "用户提示词（若无则取上游 prompt 输出）" },
                    "system_prompt": { "type": "string", "description": "系统提示词（可选）" },
-                    "provider_id": { "type": "string", "description": "AI Provider ID（FR-S1：密钥经 df_storage::secret 解析，不进 config；留空走默认 provider）" },
+                    "provider_id": { "type": "string", "description": "AI Provider ID（密钥经 df_storage::secret 解析，不进 config；留空走默认 provider）" },
                    "model": { "type": "string", "description": "模型名（可选，留空用 record.default_model）" },
                    "temperature": { "type": "number", "description": "温度 0.0~2.0（可选）" },
                    "max_tokens": { "type": "integer", "description": "最大生成 token（可选，anthropic 协议无值时默认 4096）" },
                    "base_url": { "type": "string", "description": "（已废弃过渡）明文 API 地址，改用 provider_id" },
-                    "api_key": { "type": "string", "description": "（已废弃过渡）明文 API 密钥，改用 provider_id；FR-S1 下经 secret 解析" }
+                    "api_key": { "type": "string", "description": "（已废弃过渡）明文 API 密钥，改用 provider_id；密钥经 secret 解析" }
                },
                // SW-260618-15: prompt/provider_id 均"留空走兜底"(prompt 取上游、provider_id 走默认 provider),与 required 矛盾。改 required=[] 对齐 execute 运行时,防前端按 schema 误拒合法配置。
                "required": []
@@ -231,7 +231,7 @@ mod tests {
    }

    // ============================================================
-    // resolve_provider 双路径测试(FR-S1 注入链核心)
+    // resolve_provider 双路径测试(注入链核心)
    // ============================================================

    /// 内存 DB 插 provider(可选 is_default)，返回 (db, provider_id)。
@@ -10,7 +10,7 @@ use std::sync::Arc;

 use df_ai::df_ai_core::model::{Modality, ModelConfig};
 use df_ai::provider::LlmProvider;
-// F-01 阶段5: AiNode 路由 — 节点 config.model_id 优先;否则按 TaskRequirements 路由
+// AiNode 路由 — 节点 config.model_id 优先;否则按 TaskRequirements 路由
 // (默认 Standard + needs_tool_use=true)。池空/无匹配兜底 record.default_model。
 use df_ai::router::{select_model_id, TaskRequirements};
 use df_storage::crud::AiProviderRepo;
@@ -22,7 +22,7 @@ use df_workflow::node::{NodeOutput};
 /// AI 节点解析后的参数（execute 与参数解析解耦，便于单测覆盖取值/默认/校验逻辑）
 ///
 /// provider 配置（base_url/api_key/protocol/default_model）经 `resolve_provider` 从 DB
-/// ai_providers 表查 record + 经 df_storage::secret 解析密钥得到，**不进 config（FR-S1）**。
+/// ai_providers 表查 record + 经 df_storage::secret 解析密钥得到，**不进 config**。
 /// api_key 仅存于本结构体内存（AiNode 进程内存），不落 NodeContext.config / NodeOutput.data。
 #[derive(Debug)]
 pub(crate) struct AiNodeParams {
@@ -37,7 +37,7 @@ pub(crate) struct AiNodeParams {

 /// 经 `resolve_provider` 从 ai_providers 表 + df_storage::secret 解析后的 provider 构造要素。
 ///
-/// api_key 字段：明文，FR-S1 下全程不出 AiNode 进程内存（不进 config/output/schema）。
+/// api_key 字段：明文，全程不出 AiNode 进程内存（不进 config/output/schema）。
 #[derive(Debug, Clone)]
 pub(crate) struct ResolvedProvider {
    /// 协议类型：openai_compat（默认）/ anthropic（GLM 订阅 / Claude 官方）— 从 record.provider_type 映射
@@ -47,12 +47,12 @@ pub(crate) struct ResolvedProvider {
    pub api_key: String,
    /// model 为空时的占位（record.default_model 或 "gpt-4o-mini"），避免 provider 构造 panic
    pub default_model: String,
-    /// F-01 阶段5: 候选模型池(来自 record.model_configs)。parse_params 路由用:
+    /// 候选模型池(来自 record.model_configs)。parse_params 路由用:
    /// config.model 留空时经 select_model_id 选最优;池空兜底 default_model。
    pub model_pool: Vec<ModelConfig>,
 }

-/// 经 ai_providers 表 + df_storage::secret 解析 provider 构造要素（FR-S1 注入链核心）。
+/// 经 ai_providers 表 + df_storage::secret 解析 provider 构造要素（注入链核心）。
 ///
 /// 三路径（优先级从高到低）：
 /// 1. **provider_id 优先**：config["provider_id"] 存在 → `AiProviderRepo::get_by_id` 查 record →
@@ -114,7 +114,7 @@ pub(crate) async fn resolve_provider(
    let plain_key = config.get("api_key").and_then(|v| v.as_str());
    if let (Some(base_url_str), Some(api_key_str)) = (plain_base, plain_key) {
        tracing::warn!(
-            "AiNode 明文 api_key/base_url 经 config 注入已废弃, 改用 provider_id (FR-S1). \
+            "AiNode 明文 api_key/base_url 经 config 注入已废弃, 改用 provider_id. \
             老路径将在后续版本移除"
        );
        let base_url = base_url_str.to_string();
@@ -201,7 +201,7 @@ pub(crate) fn parse_params(
        .ok_or_else(|| anyhow::anyhow!("AiNode 缺少必填参数: prompt（config 或上游输入均无）"))?;

    // ── 可选参数 ──
-    // model 解析优先级(F-01 阶段5):config.model 显式指定 > 路由选优(provider.model_pool 非空时)
+    // model 解析优先级:config.model 显式指定 > 路由选优(provider.model_pool 非空时)
    //   > 空(CompletionRequest.model 留空由 provider impl 回填 default_model,行为不变)。
    //   注:provider.model_pool 在 provider move 进 AiNodeParams 前先借引用路由,选中的 model_id
    //   填入 CompletionRequest.model;provider.default_model 仍是 build_provider 兜底用。
@@ -213,7 +213,7 @@ pub(crate) fn parse_params(
    let model = if !config_model.is_empty() {
        config_model
    } else {
-        // F-01 阶段5: AiNode 默认路由 — needs_tool_use=true(工作流无人值守 AI 步骤
+        // AiNode 默认路由 — needs_tool_use=true(工作流无人值守 AI 步骤
        // 常含工具调用,如检索/生成;无需工具的节点应在 config 显式指定 model)。
        // select_model_id None(池空/无匹配)→ 空串(由 provider impl 回填 default_model)。
        let node_req = TaskRequirements {
@@ -289,10 +289,10 @@ pub(crate) fn truncate_for_summary(s: &str) -> String {
    format!("{truncated}…")
 }

-/// 阶段3 自审闸门决策(纯函数,便于单测覆盖各 verdict/gate 组合)。
+/// 自审闸门决策(纯函数,便于单测覆盖各 verdict/gate 组合)。
 ///
 /// 仅当 `gate==true` 且 `verdict=="fail"` 时阻断。verdict="unknown"(LLM 输出不可靠)
-/// 与 "pass" 均不阻断 —— unknown 保持人定权(阶段2 保守语义不变)。
+/// 与 "pass" 均不阻断 —— unknown 保持人定权(保守语义不变)。
 pub(crate) fn gate_should_block(gate: bool, verdict: &str) -> bool {
    gate && verdict == "fail"
 }
@@ -74,7 +74,7 @@ impl Node for AiSelfReviewNode {
    async fn execute(&self, ctx: NodeContext) -> NodeResult {
        tracing::info!("AiSelfReviewNode 执行: node_id={}", ctx.node_id);

-        // FR-S1 注入链：provider 经 df_storage::secret 在 AiNode 内存解析，api_key 不进 config。
+        // provider 经 df_storage::secret 在 AiNode 内存解析，api_key 不进 config。
        let p = resolve_and_parse(&self.db, &ctx.config, &ctx.inputs).await?;

        // ── 读任务(需求 + 产出) ──
@@ -195,7 +195,7 @@ impl Node for AiSelfReviewNode {
            "model": response.model,
        }));

-        // ── 阶段3: 自审闸门(F-260616-07 决策 a 步骤③) ──
+        // ── 自审闸门 ──
        // config["gate"]==true 时,AiSelfReviewNode 从「自审辅助」升级为「DAG 节点闸门」:
        //   verdict="fail"   → 返回 Err → executor first_err 中止后续层(下游 human_review 不跑)
        //                       → 工作流 failed → ②-4 回调退回 in_review(对齐工作流失败语义)
@@ -214,7 +214,7 @@ impl Node for AiSelfReviewNode {
        //   C) executor 闸门检查钩子(节点 execute 后 executor 读 output.verdict):改 DagExecutor
        //      核心循环,牵动所有节点,风险/范围不符「最简不破坏」。
        // 选 A:语义最贴近「自审结果作为闸门」(自审节点自行决定放行/阻断),且 gate 可按节点
-        // config 开关(默认 false = 阶段2 行为不变,模板/前端零强制改动,向后兼容)。
+        // config 开关(默认 false = 辅助模式行为不变,模板/前端零强制改动,向后兼容)。
        let gate_enabled = ctx
            .config
            .get("gate")
@@ -241,10 +241,10 @@ impl Node for AiSelfReviewNode {
                "type": "object",
                "properties": {
                    "task_id": { "type": "string", "description": "自审目标任务 ID(必填)" },
-                    "provider_id": { "type": "string", "description": "AI Provider ID(FR-S1:密钥经 secret 解析不进 config;留空走默认 provider)" },
+                    "provider_id": { "type": "string", "description": "AI Provider ID(密钥经 secret 解析不进 config;留空走默认 provider)" },
                    "model": { "type": "string", "description": "模型名(可选,留空用 record.default_model)" },
                    "max_tokens": { "type": "integer" },
-                    "gate": { "type": "boolean", "description": "阶段3 闸门开关:false(默认)=自审辅助,verdict 仅透传展示;true=自审结果作 DAG 闸门,verdict=fail 返回 Err 阻断下游(工作流 failed → ②-4 退回),verdict=unknown/pass 放行" }
+                    "gate": { "type": "boolean", "description": "闸门开关:false(默认)=自审辅助,verdict 仅透传展示;true=自审结果作 DAG 闸门,verdict=fail 返回 Err 阻断下游(工作流 failed → ②-4 退回),verdict=unknown/pass 放行" }
                },
                "required": ["task_id", "provider_id"]
            }),
@@ -411,18 +411,18 @@ mod tests {
    }

    // ============================================================
-    // 阶段3 自审闸门(gate_should_block)单测
+    // 自审闸门(gate_should_block)单测
    // ============================================================
    //
    // gate 决策矩阵:
-    //   gate=false(默认,阶段2 行为) → 任何 verdict 都放行(辅助模式)
+    //   gate=false(默认,辅助模式行为) → 任何 verdict 都放行(辅助模式)
    //   gate=true + verdict=pass     → 放行
    //   gate=true + verdict=unknown  → 放行(LLM 不可靠时不阻断,人定权)
    //   gate=true + verdict=fail     → 阻断(返回 Err,工作流 failed)

    #[test]
    fn gate_disabled_never_blocks_any_verdict() {
-        // gate 默认 false(阶段2 兼容):无论 verdict 如何都不阻断,自审仅辅助展示
+        // gate 默认 false:无论 verdict 如何都不阻断,自审仅辅助展示
        assert!(!gate_should_block(false, "fail"), "gate 关闭时 fail 也不阻断");
        assert!(!gate_should_block(false, "pass"), "gate 关闭时 pass 放行");
        assert!(!gate_should_block(false, "unknown"), "gate 关闭时 unknown 放行");
@@ -40,7 +40,7 @@ impl Node for HumanNode {
            .and_then(|v| v.as_u64())
            .unwrap_or(3600);

-        // F-260615-01: 解析 select_type(缺省 Single,向后兼容)。非 "multiple" 一律按 Single 处理。
+        // 解析 select_type(缺省 Single,向后兼容)。非 "multiple" 一律按 Single 处理。
        let select_type = match config.get("select_type").and_then(|v| v.as_str()) {
            Some("multiple") => SelectType::Multiple,
            _ => SelectType::Single,
@@ -74,7 +74,7 @@ impl Node for HumanNode {
                    Ok(WorkflowEvent::HumanApprovalResponse {
                        execution_id, node_id, decision, decisions, comment,
                    }) if execution_id == ctx.execution_id && node_id == ctx.node_id => {
-                        // F-260615-01: 归一化决策集合(优先用 decisions 数组,空则回退兼容 decision 单值)
+                        // 归一化决策集合(优先用 decisions 数组,空则回退兼容 decision 单值)
                        //   select_type=Single → 决策数必须 =1
                        //   select_type=Multiple → 决策数必须 ≥1
                        //   options 空 → 允许自由文本(仅受数量约束);
@@ -91,24 +91,26 @@ impl Node for HumanNode {
                        let each_valid = picked.iter().all(|d| !d.is_empty())
                            && (options.is_empty() || picked.iter().all(|d| options.contains(d)));
                        if count_ok && each_valid {
-                            // F-260616-06 阶段2: 拒绝语义化。
+                            // 拒绝语义化。
                            //   审批拒绝此前与同意一样返 Ok —— 语义反转(审批被拒却报"成功"),
                            //   下游无法据 failed 触发退回/重做。
                            //   现:decision 命中拒绝关键字(见 REJECT_KEYWORDS)→ 返 Err
                            //   "人工审批被拒绝(用户选择: <decision>)",executor Err 分支 set_failed
-                            //   → 工作流 failed 状态 → 阶段2 推进链可据 failed 触发退回。
+                            //   → 工作流 failed 状态 → 推进链可据 failed 触发退回。
                            // 行为变更:审批拒绝从 Ok → Err,标注(同步通知主代理)。
                            if contains_reject(&picked) {
                                let primary = picked.first().cloned().unwrap_or_default();
                                let comment_str = comment.unwrap_or_default();
+                                // 意见后缀:空 comment 不拼接,非空才追加(避免空括号)
+                                let suffix = if comment_str.is_empty() {
+                                    String::new()
+                                } else {
+                                    format!("；意见: {}", comment_str)
+                                };
                                return Err(anyhow::anyhow!(
                                    "人工审批被拒绝(用户选择: {}){}",
                                    primary,
-                                    if comment_str.is_empty() {
-                                        String::new()
-                                    } else {
-                                        format!("；意见: {}", comment_str)
-                                    }
+                                    suffix,
                                ));
                            }
                            // 输出统一含 decisions 数组;保留 decision 取首项(向后兼容下游消费者)
@@ -225,7 +227,7 @@ mod tests {
    }

    /// 发一条审批响应到事件总线（模拟前端 approve_human_approval IPC 走完后的链路）。
-    /// F-260615-01: 单选调用方仅填 decision;多选调用方填 decisions。
+    /// 单选调用方仅填 decision;多选调用方填 decisions。
    async fn send_response(
        event_bus: &EventBus,
        execution_id: &str,
@@ -244,7 +246,7 @@ mod tests {
            .await;
    }

-    /// F-260615-01: 多选响应发送助手(填 decisions 数组,decision 留空)
+    /// 多选响应发送助手(填 decisions 数组,decision 留空)
    async fn send_response_multi(
        event_bus: &EventBus,
        execution_id: &str,
@@ -568,9 +570,9 @@ mod tests {
        assert_eq!(sm.get(&"h".to_string()), NodeStatus::Cancelled);
    }

-    // ===== F-260615-01: 多选审批覆盖 =====
+    // ===== 多选审批覆盖 =====

-    /// F-260615-01: select_type=multiple + 多 decisions(均∈options) → 返回 decisions 数组
+    /// select_type=multiple + 多 decisions(均∈options) → 返回 decisions 数组
    #[tokio::test]
    async fn multiple_select_returns_decisions_array() {
        let bus = EventBus::new();
@@ -596,7 +598,7 @@ mod tests {
        assert_eq!(out.data["comment"], json!("多选"));
    }

-    /// F-260615-01: select_type=single 缺省 + decisions 多个 → 校验失败(count!=1)忽略后超时
+    /// select_type=single 缺省 + decisions 多个 → 校验失败(count!=1)忽略后超时
    #[tokio::test]
    async fn single_select_rejects_multiple_decisions_then_timeout() {
        let bus = EventBus::new();
@@ -618,7 +620,7 @@ mod tests {
        assert!(err.contains("超时"), "single 下多 decisions 应被忽略后超时, 实际: {}", err);
    }

-    /// F-260615-01: select_type=multiple 但 decisions 含 ∉ options 的项 → 非法忽略后超时
+    /// select_type=multiple 但 decisions 含 ∉ options 的项 → 非法忽略后超时
    #[tokio::test]
    async fn multiple_select_invalid_option_ignored_then_timeout() {
        let bus = EventBus::new();
@@ -644,7 +646,7 @@ mod tests {
        assert!(err.contains("超时"), "含非法 option 应被忽略后超时, 实际: {}", err);
    }

-    /// F-260615-01: 兼容旧调用方 —— 不填 select_type(缺省 single) + 只填 decision 单值,应正常通过
+    /// 兼容旧调用方 —— 不填 select_type(缺省 single) + 只填 decision 单值,应正常通过
    /// (即所有未改造的现有 Request 均按 single 解析,零改动)
    #[tokio::test]
    async fn default_single_with_legacy_decision_single_value() {
@@ -664,10 +666,10 @@ mod tests {
        assert_eq!(out.data["decisions"], json!(["同意"]), "兼容回退后 decisions 应含单值");
    }

-    // ===== F-260616-06 阶段2: 审批拒绝语义化(行为变更: 拒绝从 Ok → Err) =====
+    // ===== 审批拒绝语义化(行为变更: 拒绝从 Ok → Err) =====

-    /// F-260616-06: 默认 options `["同意","拒绝"]` 下选「拒绝」→ Err（不再 Ok）。
-    /// 阶段2 推进链依赖工作流 failed 触发退回，故拒绝必须让节点返 Err → executor set_failed。
+    /// 默认 options `["同意","拒绝"]` 下选「拒绝」→ Err（不再 Ok）。
+    /// 推进链依赖工作流 failed 触发退回，故拒绝必须让节点返 Err → executor set_failed。
    #[tokio::test]
    async fn reject_decision_returns_error() {
        let bus = EventBus::new();
@@ -697,7 +699,7 @@ mod tests {
        );
    }

-    /// F-260616-06: 同一 options 下选「同意」→ Ok（通过路径不回归）。
+    /// 同一 options 下选「同意」→ Ok（通过路径不回归）。
    #[tokio::test]
    async fn approve_decision_still_ok() {
        let bus = EventBus::new();
@@ -718,7 +720,7 @@ mod tests {
        assert_eq!(out.data["decision"], json!("同意"));
    }

-    /// F-260616-06: 英文 reject 关键字同样识别为拒绝 → Err（归一化大小写/空白）。
+    /// 英文 reject 关键字同样识别为拒绝 → Err（归一化大小写/空白）。
    /// 多关键字覆盖走 reject_keyword_detection_normalized 纯单元测试,此处仅验证端到端一条。
    #[tokio::test]
    async fn english_reject_keyword_returns_error() {
@@ -744,7 +746,7 @@ mod tests {
        );
    }

-    /// F-260616-06: 多选场景,picked 含一项拒绝 → 整单拒绝 → Err
+    /// 多选场景,picked 含一项拒绝 → 整单拒绝 → Err
    /// （选了「驳回」即驳回,即便同时选了「同意」）。
    #[tokio::test]
    async fn multiple_select_with_one_reject_returns_error() {
@@ -776,7 +778,7 @@ mod tests {
        assert!(err.contains("拒绝"), "多选含拒绝项应返 Err, 实际: {}", err);
    }

-    /// F-260616-06: options 空的自由文本场景 —— 明确拒绝词("拒绝")仍返 Err,
+    /// options 空的自由文本场景 —— 明确拒绝词("拒绝")仍返 Err,
    /// 其余自由文本(非拒绝词)仍按通过处理(向后兼容,不阻断自由反馈)。
    #[tokio::test]
    async fn empty_options_free_text_reject_keyword_still_errors() {
@@ -793,7 +795,7 @@ mod tests {
        assert!(err.contains("拒绝"), "自由文本明确为拒绝词仍应 Err, 实际: {}", err);
    }

-    /// F-260616-06: options 空的自由文本场景 —— 非拒绝词自由文本仍返 Ok（不误伤自由反馈）。
+    /// options 空的自由文本场景 —— 非拒绝词自由文本仍返 Ok（不误伤自由反馈）。
    /// （empty_options_allows_free_text 已覆盖 "改成先做B方案" → Ok,此处补一条非拒绝中文短句。）
    #[tokio::test]
    async fn empty_options_non_reject_free_text_still_ok() {
@@ -810,7 +812,7 @@ mod tests {
        assert_eq!(out.data["decision"], json!("再讨论一下"));
    }

-    /// F-260616-06 单元: 关键字判定函数归一化(去空白+小写)与边界。
+    /// 单元: 关键字判定函数归一化(去空白+小写)与边界。
    #[test]
    fn reject_keyword_detection_normalized() {
        assert!(is_reject_decision("拒绝"));
@@ -3,9 +3,9 @@
 //! 从 human_node.rs 抽离的纯函数/常量(execute 与关键字判定解耦,便于单测覆盖)。
 //! HumanNode 的 struct + impl 仍保留在 human_node.rs(impl 块约束)。
 //!
-//! B-260615-05 / CR-260618-15: 拒绝语义化保留(executor set_failed → 推进链退回)。
+//! 拒绝语义化保留(executor set_failed → 推进链退回)。

-/// F-260616-06 阶段2: 拒绝语义化关键字。
+/// 拒绝语义化关键字。
 /// decision 归一化(去空白 + 小写)后命中此集合 → 审批拒绝 → 节点返 Err(触发工作流 failed)。
 ///
 /// 识别范围（避免误伤）：
@@ -1,4 +1,4 @@
-//! 任务推进节点 — advance_task 推进链触发器(F-260616-02)
+//! 任务推进节点 — advance_task 推进链触发器。
 //!
 //! 实现推进链的唯一 status 写入路径(D-260616-03 落 df-nodes Node):
 //!   1. 读当前 TaskRecord(取 from status)
@@ -1,8 +1,8 @@
-//! 任务推进状态机 — 7 态合法转换定义(F-260616-01)
+//! 任务推进状态机 — 7 态合法转换定义。
 //!
 //! 独立模块,非挂在 df-types::TaskStatus enum 上(对齐 D-260616-03「推进链业务逻辑落
 //! df-nodes」)。本模块只做「给定 from/to 是否合法」的纯函数判定,不触碰存储层
-//! (原子写 SQL 在 task_advance_node.rs 完成,见 F-260616-02)。
+//! (原子写 SQL 在 task_advance_node.rs 完成)。
 //!
 //! 7 态(与 df-types::TaskStatus / 前端对齐,D-260616-01):
 //!   todo / in_progress / in_review / testing / done / blocked / cancelled
@@ -124,7 +124,7 @@ pub fn is_regression(from: &str, to: &str) -> bool {
    matches!((from, to), (IN_REVIEW, IN_PROGRESS) | (TESTING, IN_REVIEW))
 }

-/// 工作流联动任务「失败退一步」的目标态映射(F-260616-06 ②-4)。
+/// 工作流联动任务「失败退一步」的目标态映射。
 ///
 /// 工作流失败时,任务不应停留在失败前向目标态,需回退到上一闸门重做。映射表:
 ///   - testing     → in_review(测试失败退回重审)
@@ -1,4 +1,4 @@
-//! 任务推进链 DAG 模板(F-260616-06 阶段2 / D-260616-03)
+//! 任务推进链 DAG 模板。
 //!
 //! 推进链前向转换的工作流拓扑描述(声明式,纯数据)。DagDef 只描述节点与边,
 //! 执行逻辑靠 DagExecutor 驱动各 Node trait 的 execute —— 模板本身不跑逻辑。
@@ -51,7 +51,7 @@ fn in_progress_template() -> DagDef {

 /// in_review → testing:AiNode 自审 → HumanNode 核对。
 ///
-/// 拓扑:ai → human 串行。阶段3(本批)起 ai_self_review 启用 gate:true:
+/// 拓扑:ai → human 串行。ai_self_review 启用 gate:true:
 ///   - verdict=fail → AiSelfReviewNode 返回 Err → 工作流 failed(不经 human_review)
 ///     → ②-4 失败回调退回 in_review(review_rounds+=1)。
 ///   - verdict=unknown/pass → 放行 human_review,人定最终是否推进。
@@ -59,9 +59,9 @@ fn in_progress_template() -> DagDef {
 /// 通过则完成回调(②-3)推进 status 到 testing。
 fn testing_template() -> DagDef {
    let mut dag = DagDef::new();
-    // 决策 a 步骤③:ai_self_review 节点类型对齐 state.rs 注册的独立自审节点
+    // 决策:ai_self_review 节点类型对齐 state.rs 注册的独立自审节点
    // (四维度 prompt + JSON 解析兜底 + 写回 output_json 加 review 子字段)。
-    // 阶段3:gate=true 启用自审闸门(verdict=fail 阻断下游,工作流 failed)。
+    // gate=true 启用自审闸门(verdict=fail 阻断下游,工作流 failed)。
    dag.add_node(
        "ai_self_review",
        "ai_self_review",
@@ -135,13 +135,13 @@ mod tests {
        // 节点类型(决策 a 步骤③:ai_self_review 独立节点类型)
        let ai = dag.nodes.get("ai_self_review").expect("ai_self_review 存在");
        assert_eq!(ai.node_type, "ai_self_review");
-        // 阶段3:gate=true 启用自审闸门(verdict=fail 阻断下游)
+        // gate=true 启用自审闸门(verdict=fail 阻断下游)
        let gate = ai
            .config
            .get("gate")
            .and_then(|v| v.as_bool())
            .expect("ai_self_review config 应含 gate");
-        assert!(gate, "testing 模板 ai_self_review 应启用 gate:true(阶段3 闸门)");
+        assert!(gate, "testing 模板 ai_self_review 应启用 gate:true(闸门)");
        let human = dag.nodes.get("human_review").expect("human_review 存在");
        assert_eq!(human.node_type, "human");
        // 边方向:ai → human
@@ -7,7 +7,7 @@

 /// 内容图引用(README 内的架构图/截图等,喂 vision 用)。
 /// 采样层只收集 alt+src,Phase 2 上线后由 commands 层读 base64 喂 vision。
-/// 当前 ChatMessage.content:String(F-260614-05 未做)走纯文本降级,
+/// 当前 ChatMessage.content:String(多模态未做)走纯文本降级,
 /// 此结构仅为采样层留接口,不读 base64。
 #[derive(Debug, Clone, PartialEq, Eq)]
 pub struct ImageRef {
@@ -53,7 +53,7 @@ fn ai_provider_from_row(row: &Row<'_>) -> std::result::Result<AiProviderRecord,
        config: row.get("config")?,
        created_at: row.get("created_at")?,
        updated_at: row.get("updated_at")?,
-        // F-260614-04: enabled/weight 列老库经 v19 迁移补建,DEFAULT 1 / DEFAULT 50。
+        // enabled/weight 列老库经 v19 迁移补建,DEFAULT 1 / DEFAULT 50。
        // from_row 按 i32 取列值兼容(SQLite 无真 BOOLEAN),0→false/非0→true。
        enabled: row.get::<_, i32>("enabled").unwrap_or(1) != 0,
        // weight 读侧 clamp [0,100]:与 insert/update_full 落库的 `.min(100)` 对齐,
@@ -95,7 +95,7 @@ fn ai_tool_execution_from_row(row: &Row<'_>) -> std::result::Result<AiToolExecut
    Ok(AiToolExecutionRecord {
        id: row.get("id")?,
        conversation_id: row.get("conversation_id")?,
-        // F-260619-04:message_id 列老库经 v21 迁移补建。unwrap_or(None) 兜底:
+        // message_id 列老库经 v21 迁移补建。unwrap_or(None) 兜底:
        // 新库空表直接有列;老库行 ALTER 后 NULL;极端情况(迁移未跑/手工删列)防御。
        message_id: row.get("message_id").unwrap_or(None),
        tool_call_id: row.get("tool_call_id")?,
@@ -124,7 +124,7 @@ impl_repo!(
        let is_default = if rec.is_default { 1i32 } else { 0i32 };
        // model_configs:Vec<ModelConfig> → JSON 字符串落 TEXT 列
        let model_configs_json = serde_json::to_string(&rec.model_configs).unwrap_or_else(|_| "[]".into());
-        // F-260614-04: enabled/weight 落库(SQLite 无 BOOLEAN,i32 承载)。
+        // enabled/weight 落库(SQLite 无 BOOLEAN,i32 承载)。
        let enabled_i = if rec.enabled { 1i32 } else { 0i32 };
        let weight_i = rec.weight.min(100) as i32;
        conn.execute(
@@ -420,7 +420,7 @@ mod tests {
    use crate::models::AiProviderRecord;
    use df_ai_core::model::{Capability, IntelligenceTier, Modality, ModelConfig};

-    /// model_configs DB roundtrip + 老库空兼容(F-01 阶段1)
+    /// model_configs DB roundtrip + 老库空兼容
    #[tokio::test]
    async fn ai_provider_model_configs_roundtrip_and_old_db_compat() {
        let db = Database::open_in_memory().await.expect("open_in_memory");
@@ -20,7 +20,7 @@ use super::{now_millis_str, storage_err, validate_column_name};

 /// `knowledges` 表对应 `KnowledgeRecord` 15 个字段的列名(顺序与结构体一致)。
 ///
-/// 多处 `search`/`search_vector` 内联 COLS 串的 DRY 收口(CR-260615-03):集中一处定义,
+/// 多处 `search`/`search_vector` 内联 COLS 串的 DRY 收口:集中一处定义,
 /// 配合下方 `KNOWLEDGE_COL_COUNT` 断言,任一处加列漏改会被测试 `test_knowledge_cols_matches_record`
 /// 立即捕获(`knowledge_from_row` 按 name 取列,SELECT 漏列会运行时 rusqlite 报错,故提前断言)。
 ///
@@ -38,7 +38,7 @@ const KNOWLEDGE_COLS_WITH_EMBEDDING: &str = concat!(

 /// `ideas` 表对应 `IdeaRecord` 14 个字段的列名(顺序与结构体一致)。
 ///
-/// 同 KNOWLEDGE_COLS 的列漂移防护(CR-260615-03):idea 表 INSERT/UPDATE/from_row 三处
+/// 同 KNOWLEDGE_COLS 的列漂移防护:idea 表 INSERT/UPDATE/from_row 三处
 /// 各写一份列名串,加列须三处同步(如 V24 加 related_ids 即三处齐改),漏一处
 /// 只在运行时 rusqlite 报错(INSERT 列数与参数数不匹配 / from_row 取不到列)。集中一处
 /// 定义 + 配合 `IDEA_COL_COUNT` 断言 + 测试 `test_idea_cols_matches_record`,加列漏改即捕获。
@@ -147,7 +147,7 @@ fn knowledge_event_from_row(row: &Row<'_>) -> std::result::Result<KnowledgeEvent
 // ============================================================

 // ============================================================
-// IdeaQuery — 多条件查询入参(F-260621-02 status 下沉 + 关键词 + 排序 + 分页)
+// IdeaQuery — 多条件查询入参(status 下沉 + 关键词 + 排序 + 分页)
 // ============================================================

 /// 灵感多条件查询入参。
@@ -256,7 +256,7 @@ impl_repo!(
 // KnowledgeRepo 的整体更新已由 impl_repo! 宏统一生成的 update_full 提供。

 impl IdeaRepo {
-    /// 多条件查询:动态 WHERE 拼接(status / keyword) + 白名单排序 + 分页(F-260621-02)。
+    /// 多条件查询:动态 WHERE 拼接(status / keyword) + 白名单排序 + 分页。
    ///
    /// 复用 `KnowledgeRepo::search` 的动态 WHERE 模式:if-let 分支按可选条件拼 SQL 片段,
    /// 各分支化参数绑定到 `?N` 占位符。`order_by` 经 `validate_idea_order_by` 白名单校验后
@@ -925,7 +925,7 @@ mod tests {
    use super::*;
    use crate::db::Database;

-    // ---------- COLS 漂移防护(CR-260615-03) ----------
+    // ---------- COLS 漂移防护 ----------

    /// KNOWLEDGE_COLS 列数须等于 KNOWLEDGE_COL_COUNT(任一处漂移:加列漏改 / 串错位 → 立即失败)。
    /// `knowledge_from_row` 按 name 取列,SELECT 漏列会在运行时被 rusqlite 报错;此断言提前到测试期捕获。
@@ -1,4 +1,4 @@
-//! AI 消息 Repo — ai_messages 表(F-260619-03 消息拆分存储)
+//! AI 消息 Repo — ai_messages 表(消息拆分存储)
 //!
 //! 每条 ChatMessage 一行的独立表,替代 `ai_conversations.messages` 整对话 JSON 列存。
 //! 全专用方法(insert_batch / list_by_conversation / delete_range / update_status /
@@ -239,7 +239,6 @@ impl AiMessageRepo {

    /// 全量重写对话的消息(单事务 DELETE + INSERT OR IGNORE,原子)。
    ///
-    /// F-260619-03 批次 B(save_conversation 写路径切 ai_messages)的核心方法:
    /// 全量重写语义——以入参 records 为该对话的**唯一真相**,先删该 conv 全部旧行再批量插。
    /// 单事务保证「删 + 插」原子,无中间空窗(reload 不会读到半删半插的中间态)。
    ///
@@ -472,7 +471,7 @@ mod tests {
        assert_eq!(got[0].content, "替换后的结果", "其他消息不应被改");
    }

-    // ---------- replace_conversation(F-260619-03 批次 B)----------
+    // ---------- replace_conversation ----------

    /// replace_conversation 全量重写:删旧 + 插新原子,list 一致
    #[tokio::test]
@@ -12,7 +12,7 @@
 //! - [`mod@conversation_repo`]:AiProviderRepo/AiConversationRepo/AiToolExecutionRepo
 //! - [`mod@idea_repo`]:IdeaRepo/KnowledgeRepo/KnowledgeEventsRepo + 向量工具
 //! - [`mod@idea_eval_repo`]:IdeaEvalRepo(灵感评估历史追加型审计表 idea_evaluations,V22)
-//! - [`mod@message_repo`]:AiMessageRepo(F-260619-03 消息拆分存储,全专用方法不走宏)
+//! - [`mod@message_repo`]:AiMessageRepo(消息拆分存储,全专用方法不走宏)
 //!
 //! re-export(`pub use ...::*`)保持 `df_storage::crud::XxxRepo` /
 //! `df_storage::crud::is_allowed_column` 路径不变,**调用方零改动**。
@@ -17,7 +17,7 @@ use super::impl_repo;
 use super::{normalize_stored_path, now_millis_str, storage_err, validate_column_name};

 // ============================================================
-// 项目查询入参(F-260621-02 P2/P3 查询维度补全)
+// 项目查询入参(P2/P3 查询维度补全)
 // ============================================================

 /// 项目列表查询条件(可选字段,全 None = 当前 list_active 全量行为)。
@@ -204,7 +204,7 @@ impl ProjectRepo {
        .map_err(storage_err)?
    }

-    /// 按条件查询未删除项目(F-260621-02 P2/P3:关键词搜索 + 排序 + 分页)。
+    /// 按条件查询未删除项目(P2/P3:关键词搜索 + 排序 + 分页)。
    ///
    /// 复用 `KnowledgeRepo::search` 动态 WHERE 拼接模式:按可选字段 if-let 拼 SQL 子句 +
    /// 分支化参数绑定。始终排除 `deleted_at IS NOT NULL`(软删),与 `list_active` 行为对齐。
@@ -119,8 +119,8 @@ impl SettingsRepo {
 pub fn allowed_columns_for(table: &str) -> Option<&'static [&'static str]> {
    Some(match table {
        "ideas" => &[
-            // IDEA-FIX-02: id\created_at 不列入 — 主键与创建时间不可通过通用 update_field 改写
-            // (对标 tasks 白名单 B-260616-16 同款防护,防篡改主键/伪造创建时间)
+            // id\created_at 不列入 — 主键与创建时间不可通过通用 update_field 改写
+            // (对标 tasks 白名单同款防护,防篡改主键/伪造创建时间)
            "title", "description", "status", "priority", "score", "tags", "source",
            "promoted_to", "ai_analysis", "scores", "related_ids", "updated_at",
        ],
@@ -141,15 +141,15 @@ pub fn allowed_columns_for(table: &str) -> Option<&'static [&'static str]> {
            // 否则破坏「review_rounds 唯一写入路径」收口、引入旁路写导致计数错乱。
            "project_id", "title", "description", "priority", "branch_name",
            "assignee",
-            // workflow_def_id / base_branch: 预留字段,阶段4 Git/workflow_defs 集成前无写入路径。
+            // workflow_def_id / base_branch: 预留字段,Git/workflow_defs 集成前无写入路径。
            // 当前推进链用硬编码三模板(task_workflow_templates.rs,不建 workflow_defs 表,
-            // tasks.workflow_def_id 留 None),无任何代码写这两列。白名单列入仅为阶段4 预留 +
+            // tasks.workflow_def_id 留 None),无任何代码写这两列。白名单列入仅为预留 +
            // 允许手动/未来填充,勿判死代码删除。base_branch 同理(code kind 闸门接 git 前预留)。
            "workflow_def_id", "base_branch",
            // output_json:ai_execute 写产出 / ai_self_review 读产出自审 / human_review 展示对象
            // (决策 a:task 中心,产出跟 task 走)。非状态机收口字段,合法可写。
            "output_json",
-            // idea_id(F-260619-01 任务关联灵感,1对1 单向):任务可关联/解关联一条灵感,
+            // idea_id(任务关联灵感,1对1 单向):任务可关联/解关联一条灵感,
            // 非状态机收口字段,合法可写(idea_id 存在性由外键约束 + 上层校验兜底)。
            "idea_id",
            // 知识图谱 Phase 1 V29 三列(对标设计 §2.1):非状态机收口字段,合法可写。
@@ -160,7 +160,7 @@ pub fn allowed_columns_for(table: &str) -> Option<&'static [&'static str]> {
            // 走专用方法 set_status_for_aggregation,不经通用 update_field。
            "queue", "parent_id", "content_json",
            "updated_at",
-            // TODO(B-260616-16): project_id 跨表存在性校验待 commands/task.rs 层补。
+            // TODO: project_id 跨表存在性校验待 commands/task.rs 层补。
            //   通用 CRUD 层(db repo)只懂表/列语义,不持有跨表业务约束(查 projects 表存在性)。
            //   project_id 当前可在白名单内改写,合法目标存在性由上层命令层校验。
        ],
@@ -218,7 +218,7 @@ pub(crate) fn validate_column_name(field: &str, table: &str) -> Result<()> {
    match allowed_columns_for(table) {
        Some(cols) if cols.contains(&field) => Ok(()),
        Some(_) => Err(Error::Storage(format!("表 {} 不允许的字段名: {}", table, field))),
-        // 未登记表保守拒绝(FR-S6: 原放行 Ok,若未来未登记表走通用查询路径,列名直进字符串拼接即 SQL 注入;与 is_allowed_column 的 None=>false 对齐)
+        // 未登记表保守拒绝:原放行 Ok,若未来未登记表走通用查询路径,列名直进字符串拼接即 SQL 注入;与 is_allowed_column 的 None=>false 对齐
        None => Err(Error::Storage(format!("表 {} 未登记列白名单,拒绝防注入", table))),
    }
 }
@@ -47,7 +47,7 @@ fn task_from_row(row: &Row<'_>) -> std::result::Result<TaskRecord, rusqlite::Err
 }

 // ============================================================
-// 任务列表查询入参(F-260621-02 查询维度补全)
+// 任务列表查询入参(查询维度补全)
 // ============================================================

 /// 任务列表动态查询入参。全可选,空 query = 等价当前全量行为(向后兼容)。
@@ -213,7 +213,7 @@ impl TaskRepo {
        .map_err(storage_err)?
    }

-    /// 原子推进任务状态(任务推进链 F-260616-02 唯一 status 写入路径)
+    /// 原子推进任务状态(任务推进链唯一 status 写入路径)
    ///
    /// 下沉 SQL `WHERE id=? AND status=?expected` 做 CAS(Compare-And-Swap)防 TOCTOU:
    /// 并发推进/旁路修改若已改 status,affected_rows==0,本方法返回 None,调用方
@@ -296,7 +296,7 @@ impl TaskRepo {
        .map_err(storage_err)?
    }

-    /// 动态条件列出未删除任务(F-260621-02 查询维度补全)。
+    /// 动态条件列出未删除任务(查询维度补全)。
    ///
    /// 复用 KnowledgeRepo::search 的「动态 WHERE + 参数绑定」模式,但用累积式条件收集
    /// (Vec<String> WHERE 子句 + Vec<rusqlite::Value> 参数)替代 if-let 二分支——
@@ -528,7 +528,7 @@ impl TaskRepo {
    ///
    /// 本方法返回 `Vec<(status, count)>`(SQL GROUP BY 一次查询,数据量小 ~50 无压力),
    /// 聚合规则的具体判定由调用方(commands 层)实现 —— 本层只提供原始计数,不持有
-    /// 业务聚合逻辑(CRUD 层只懂表/列语义,对标 B-260616-16 跨表校验下沉思路)。
+    /// 业务聚合逻辑(CRUD 层只懂表/列语义,对标跨表校验下沉思路)。
    pub async fn count_children_by_status(
        &self,
        parent_id: &str,
@@ -23,12 +23,12 @@ pub fn run(conn: &Connection) -> Result<()> {

    // 迁移步骤链: 顺序执行,跳过已应用的版本(current_version < N 才跑)。
    // 新增版本时,在此数组追加一项 (N, migrate_vN) 即可,无需改逻辑。
-    // V20 = F-260619-01(任务关联灵感 idea_id);V21 = 消息拆分存储 + audit message_id;
+    // V20 = 任务关联灵感 idea_id;V21 = 消息拆分存储 + audit message_id;
    // V22 = 灵感评估历史持久化(idea_evaluations 追加型审计表);
    // V23 = knowledges.embedding_status 列(嵌入失败可补偿重试);
    // V24 = ideas.related_ids 列(灵感间关联关系持久化打底);
    // V25 = idea_evaluations (idea_id, version) 唯一约束(评估版本并发重复兜底);
-    // V26 = F-260621-02 任务索引缺口补全(priority/assignee,对齐 idx_tasks_status 同类索引)。
+    // V26 = 任务索引缺口补全(priority/assignee,对齐 idx_tasks_status 同类索引)。
    // V27 = TD-260621-05 审批状态统一(ai_tool_executions.status executed→completed,
    //       对齐 DTO 契约 audit/mod.rs:53 只列 completed + 前端 i18n auditLog.status 无 executed 键 +
    //       治 AuditLog executed 记录显示错位蓝pending标签+raw"executed")。
@@ -290,7 +290,7 @@ fn migrate_v14(conn: &Connection) -> Result<()> {
    Ok(())
 }

-/// V15: 幂等补 tasks.review_rounds 列(review 退回累计轮数,F-260616-04)
+/// V15: 幂等补 tasks.review_rounds 列(review 退回累计轮数)
 ///
 /// 任务推进链状态机退回时累加:in_review→in_progress / testing→in_review 各 +1,
 /// 由 advance_task(df-nodes::task_advance_node)原子写入。默认 0(从未退回过的任务)。
@@ -343,7 +343,7 @@ fn migrate_v17(conn: &Connection) -> Result<()> {
    Ok(())
 }

-/// V18: 幂等补 ai_providers.model_configs 列(模型能力配置,F-01 阶段1)
+/// V18: 幂等补 ai_providers.model_configs 列(模型能力配置)
 ///
 /// 模型 4 维度(模态/能力/价格/智力)+ 路由控制配置 JSON 字符串。TEXT NULL 向后兼容:
 /// 老库行默认 NULL,from_row 经 deserialize_model_configs 解析为空 Vec(配合 default_model 过渡)。
@@ -358,7 +358,7 @@ fn migrate_v18(conn: &Connection) -> Result<()> {
    Ok(())
 }

-/// V19: 幂等补 ai_providers.enabled + ai_providers.weight 列(F-260614-04 多 Provider 负载均衡池)
+/// V19: 幂等补 ai_providers.enabled + ai_providers.weight 列(多 Provider 负载均衡池)
 ///
 /// - `enabled INTEGER NOT NULL DEFAULT 1`:provider 是否进入负载均衡池。
 ///   老库行迁移后默认 1(所有现存 provider 默认启用,单 provider 路径零变化)。
@@ -374,21 +374,21 @@ fn migrate_v19(conn: &Connection) -> Result<()> {
            "ALTER TABLE ai_providers ADD COLUMN enabled INTEGER NOT NULL DEFAULT 1",
            [],
        )?;
-        tracing::info!("v19: 补建 ai_providers.enabled 列(多 Provider 负载均衡池,F-260614-04)");
+        tracing::info!("v19: 补建 ai_providers.enabled 列(多 Provider 负载均衡池)");
    }
    if !column_exists(conn, "ai_providers", "weight") {
        conn.execute(
            "ALTER TABLE ai_providers ADD COLUMN weight INTEGER NOT NULL DEFAULT 50",
            [],
        )?;
-        tracing::info!("v19: 补建 ai_providers.weight 列(多 Provider 负载均衡池,F-260614-04)");
+        tracing::info!("v19: 补建 ai_providers.weight 列(多 Provider 负载均衡池)");
    }
    conn.execute("INSERT INTO schema_version (version) VALUES (?)", [19])?;
    tracing::info!("迁移 v19 完成");
    Ok(())
 }

-/// V20:幂等补 tasks.idea_id 列(F-260619-01 任务关联灵感,1对1 单向)
+/// V20:幂等补 tasks.idea_id 列(任务关联灵感,1对1 单向)
 ///
 /// 任务可关联到一条灵感(任务→灵感单向),复用 projects.idea_id 模式
 /// (REFERENCES ideas(id) 外键)。TEXT NULL 向后兼容:老库行默认 NULL,TaskRecord
@@ -401,7 +401,7 @@ fn migrate_v20(conn: &Connection) -> Result<()> {
            "ALTER TABLE tasks ADD COLUMN idea_id TEXT REFERENCES ideas(id)",
            [],
        )?;
-        tracing::info!("v20: 补建 tasks.idea_id 列(任务关联灵感,F-260619-01)");
+        tracing::info!("v20: 补建 tasks.idea_id 列(任务关联灵感)");
    }
    conn.execute("INSERT INTO schema_version (version) VALUES (?)", [20])?;
    tracing::info!("迁移 v20 完成");
@@ -433,7 +433,7 @@ fn migrate_v21(conn: &Connection) -> Result<()> {
    // 1. 建 ai_messages 表(IF NOT EXISTS 幂等)
    conn.execute_batch(V21_SQL)?;

-    // 2. 幂等补 ai_tool_executions.message_id 列(消息级溯源 audit,F-260619-04)
+    // 2. 幂等补 ai_tool_executions.message_id 列(消息级溯源 audit)
    //    表存在性兜底:run() 正常流程下 V9 已先建该表,但测试/手动调用可能跳过 V9。
    //    表不存在时跳过 ALTER(新库会由 V9_SQL 建表带 message_id 列;此处只补老库已有表)。
    let tool_exec_table_exists: bool = conn
@@ -564,7 +564,7 @@ fn migrate_v21(conn: &Connection) -> Result<()> {
 ///
 /// 不登记通用列白名单(allowed_columns_for):本表走专用 list_by_idea,
 /// 宏生成的 query/update_field 未登记表会被 validate_column_name 保守拒绝
-/// (FR-S6),与追加型审计语义一致(历史不改),不开放通用写路径。
+/// 与追加型审计语义一致(历史不改),不开放通用写路径。
 fn migrate_v22(conn: &Connection) -> Result<()> {
    conn.execute_batch(V22_SQL)?;
    conn.execute("INSERT INTO schema_version (version) VALUES (?)", [22])?;
@@ -661,7 +661,7 @@ fn migrate_v25(conn: &Connection) -> Result<()> {
    Ok(())
 }

-/// V26:补建 tasks 表 priority/assignee 索引(F-260621-02 索引缺口)
+/// V26:补建 tasks 表 priority/assignee 索引(索引缺口)
 ///
 /// list_by_query 已支持 priority/assignee 过滤下推(TaskQuery.priority/assignee),
 /// 但缺索引 → 数据量增长后全表扫描。补建索引对齐已有的 idx_tasks_status /
@@ -1219,7 +1219,7 @@ CREATE TABLE IF NOT EXISTS tasks (
    priority    INTEGER NOT NULL DEFAULT 2,
    branch_name TEXT,
    assignee    TEXT,
-    -- F-260619-01 任务关联灵感(1对1 单向,复用 projects.idea_id 模式)。老库由 V20 迁移补列。
+    -- 任务关联灵感(1对1 单向,复用 projects.idea_id 模式)。老库由 V20 迁移补列。
    idea_id     TEXT REFERENCES ideas(id),
    created_at  TEXT NOT NULL,
    updated_at  TEXT NOT NULL
@@ -1265,7 +1265,7 @@ CREATE TABLE IF NOT EXISTS node_executions (
 -- 索引
 CREATE INDEX IF NOT EXISTS idx_tasks_project_id ON tasks(project_id);
 CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status);
-- V26 补建(F-260621-02 索引缺口):priority/assignee 过滤下推索引,新库一次性建;
+-- V26 补建(索引缺口):priority/assignee 过滤下推索引,新库一次性建;
 -- 老库由 migrate_v26 CREATE INDEX IF NOT EXISTS 补建,两边索引定义须一致。
 CREATE INDEX IF NOT EXISTS idx_tasks_priority ON tasks(priority);
 CREATE INDEX IF NOT EXISTS idx_tasks_assignee ON tasks(assignee);
@@ -1395,7 +1395,7 @@ CREATE TABLE IF NOT EXISTS ai_tool_executions (
    decided_by      TEXT
 );

-- F-260619-03 消息拆分存储:每条 ChatMessage 一行的独立表。
+-- 消息拆分存储:每条 ChatMessage 一行的独立表。
 -- 与 V21 迁移建表 SQL 镜像(V21 用于老库 ALTER,此处给新库直接建最终态)。
 -- 改动须两边同步(V21_SQL 见下方)。
 CREATE TABLE IF NOT EXISTS ai_messages (
@@ -1451,7 +1451,7 @@ CREATE TABLE IF NOT EXISTS app_settings (
 ";

 // ============================================================
-// 单元测试 — V21 迁移幂等安全(新库/老库/坏数据三态,F-260619-03)
+// 单元测试 — V21 迁移幂等安全(新库/老库/坏数据三态)
 // ============================================================

 #[cfg(test)]
@@ -1673,7 +1673,7 @@ mod tests {
    }

    // ============================================================
-    // V20 迁移幂等安全(F-260619-01 任务关联灵感)
+    // V20 迁移幂等安全(任务关联灵感)
    // ============================================================

    /// 构造最小老库 schema:tasks 表(无 idea_id 列,模拟 V1 建表老形态)+ schema_version。
@@ -94,7 +94,7 @@ pub struct TaskRecord {
    #[serde(skip_serializing_if = "Option::is_none")]
    #[serde(default)]
    pub output_json: Option<String>,
-    /// 关联灵感 ID(F-260619-01,1对1 单向,任务→灵感)。
+    /// 关联灵感 ID(1对1 单向,任务→灵感)。
    /// 复用 projects.idea_id 模式(REFERENCES ideas(id) 外键),可空(任务可不关联灵感)。
    /// 老任务无 idea_id → None。#[serde(default)] 兼容旧前端 JSON(无该字段时为 None)。
    #[serde(default)]
@@ -291,7 +291,7 @@ pub struct AiProviderRecord {
    pub base_url: String,
    pub default_model: String,
    pub models: Option<String>,       // JSON array of model names
-    /// 模型能力配置数组(F-01 阶段1,4 维度 + 路由控制)。
+    /// 模型能力配置数组(4 维度 + 路由控制)。
    /// DB TEXT 列存 JSON 字符串,from_row 经 deserialize_model_configs 解析。
    /// 向后兼容:老库 NULL/空/老字符串数组 → 空 Vec 或转默认 ModelConfig。default_model 保留过渡。
    #[serde(default, deserialize_with = "deserialize_model_configs")]
@@ -300,11 +300,11 @@ pub struct AiProviderRecord {
    pub config: Option<String>,       // JSON extra config
    pub created_at: String,
    pub updated_at: String,
-    /// provider 是否进入负载均衡池(F-260614-04)。false = 仅作为配置存在,不参与主链路由/选池。
+    /// provider 是否进入负载均衡池。false = 仅作为配置存在,不参与主链路由/选池。
    /// 老库迁移默认 1(单 provider 路径零变化)。
    #[serde(default = "default_enabled")]
    pub enabled: bool,
-    /// provider 在负载均衡池中的选择权重(0-100,F-260614-04)。高权重优先被选为主;
+    /// provider 在负载均衡池中的选择权重(0-100)。高权重优先被选为主;
    /// 同权重时退化近似轮询。老库迁移默认 50。
    #[serde(default = "default_weight")]
    pub weight: u32,
@@ -371,9 +371,9 @@ pub struct AiConversationRecord {
 pub struct AiToolExecutionRecord {
    pub id: String,
    pub conversation_id: Option<String>,
-    /// 消息级溯源:工具调用所属的 ChatMessage.id(F-260619-04)。
+    /// 消息级溯源:工具调用所属的 ChatMessage.id。
    /// NULL = 老库行 / 消息级溯源未启用期的记录 / 无法关联的调用。
-    /// 升级后,audit 写入从 ContextManager 取当前 assistant 消息 id 填入(P1 接入,P0 只建列)。
+    /// 升级后,audit 写入从 ContextManager 取当前 assistant 消息 id 填入。
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub message_id: Option<String>,
    pub tool_call_id: String,
@@ -387,7 +387,7 @@ pub struct AiToolExecutionRecord {
    pub decided_by: Option<String>,   // human/auto
 }

-/// 消息记录(ai_messages 表,F-260619-03 消息拆分存储)。
+/// 消息记录(ai_messages 表,消息拆分存储)。
 ///
 /// 每条 ChatMessage 一行,替代 `ai_conversations.messages` 的整对话 JSON 列存。
 /// 主键 `id` = ChatMessage.id(构造时 ULID 风格生成),(conversation_id, seq) UNIQUE
@@ -1,4 +1,4 @@
-//! FR-S1 api_key 密钥管理 — 真实密钥存 OS keyring,DB `api_key` 列迁移后存空串。
+//! api_key 密钥管理 — 真实密钥存 OS keyring,DB `api_key` 列迁移后存空串。
 //!
 //! **下沉层(方案 B,2026-06-16)**：原位于 `src-tauri/src/commands/ai/secret.rs`,
 //! 下沉纯密钥逻辑(get/set/delete/resolve/ensure/migrate + failcount sidecar)到 df-storage,
@@ -67,7 +67,7 @@ fn write_failcounts(map: &HashMap<String, u32>) {
        text.push('\n');
    }
    if let Err(e) = fs::write(failcount_path(), text) {
-        tracing::debug!("[FR-S1] 迁移失败计数文件写入失败(忽略): {}", e);
+        tracing::debug!("[密钥迁移] 迁移失败计数文件写入失败(忽略): {}", e);
    }
 }

@@ -172,14 +172,14 @@ pub async fn migrate_secrets_to_keyring(repo: &AiProviderRepo) -> anyhow::Result
            let n = record_migration_fail(&p.id);
            if n >= MIGRATION_FAIL_THRESHOLD {
                tracing::warn!(
-                    "[FR-S1] provider {} keyring 迁移已连续失败 {} 次,明文 api_key 长期滞留 SQLite 文件(无加密)。\
+                    "[密钥迁移] provider {} keyring 迁移已连续失败 {} 次,明文 api_key 长期滞留 SQLite 文件(无加密)。\
                     建议:1) 确认 OS 钥匙串可用(Win Credential Manager / macOS Keychain);\
                     2) keyring 后端异常时排查对应平台后端;3) 必要时手动在设置中重新保存密钥触发写入",
                    p.id, n
                );
            } else {
                tracing::warn!(
-                    "[FR-S1] keyring 迁移失败 {} (累计 {}/{},保留明文下次重试): {}",
+                    "[密钥迁移] keyring 迁移失败 {} (累计 {}/{},保留明文下次重试): {}",
                    p.id, n, MIGRATION_FAIL_THRESHOLD, e
                );
            }
@@ -188,14 +188,14 @@ pub async fn migrate_secrets_to_keyring(repo: &AiProviderRepo) -> anyhow::Result
        let pid = p.id.clone();
        p.api_key.clear();
        if let Err(e) = repo.insert(p).await {
-            tracing::warn!("[FR-S1] 迁移后清空 DB api_key 失败 {}: {}", pid, e);
+            tracing::warn!("[密钥迁移] 迁移后清空 DB api_key 失败 {}: {}", pid, e);
        }
        // 迁移成功 → 清零该 provider 的失败计数(下次若再出现失败从 1 重新累计)
        clear_migration_failcount(&pid);
        migrated += 1;
    }
    if migrated > 0 {
-        tracing::info!("[FR-S1] {} 条 provider 密钥迁移至 OS keyring", migrated);
+        tracing::info!("[密钥迁移] {} 条 provider 密钥迁移至 OS keyring", migrated);
    }
    Ok(migrated)
 }
@@ -241,7 +241,7 @@ mod tests {

    #[test]
    fn resolve_prefers_db_when_non_empty() {
-        // DB api_key 非空 → 直接返回 DB 值,不触发 keyring(FR-S1 兼容未迁移老库)
+        // DB api_key 非空 → 直接返回 DB 值,不触发 keyring(兼容未迁移老库)
        // 纯逻辑路径,不碰 OS keyring,CI 任意 OS 安全。
        let rec = AiProviderRecord {
            id: "t1".into(), name: "t".into(), provider_type: "openai_compat".into(),
@@ -84,7 +84,7 @@ pub trait TunnelClient: Send + Sync {

    /// 发送原始事件(桌面端 → 云后端 → 小程序),payload 为 AiChatEvent 序列化 JSON Value
    ///
-    /// Phase3 阶段2(D2 全 19 变体透传):EventBus subscriber 把 AiChatEvent Value 经此方法
+    /// D2 全 19 变体透传:EventBus subscriber 把 AiChatEvent Value 经此方法
    /// 透传(不经 TunnelEvent 强类型子集)。与 [`send_event`](TunnelClient::send_event) 伴行,
    /// 后者保留作高频子集快捷方式(D5 强类型保留)。非阻塞入队,连接断开返 NotConnected。
    async fn send_raw_event(&self, payload: serde_json::Value) -> Result<()>;
@@ -4,7 +4,7 @@ use serde::{Deserialize, Serialize};

 use crate::types::{ExecutionId, NodeId};

-/// 人工审批选择类型(F-260615-01)
+/// 人工审批选择类型
 /// - Single: 单选(decision 单值),缺省值,向后兼容现有调用方
 /// - Multiple: 多选(decisions 数组)
 ///
@@ -100,7 +100,7 @@ pub enum WorkflowEvent {
        title: String,
        description: String,
        options: Vec<String>,
-        /// F-260615-01: 选择类型,缺省 Single(向后兼容)
+        /// 选择类型,缺省 Single(向后兼容)
        #[serde(default)]
        select_type: SelectType,
    },
@@ -109,7 +109,7 @@ pub enum WorkflowEvent {
        execution_id: ExecutionId,
        node_id: NodeId,
        decision: String,
-        /// F-260615-01: 多选结果(Single 模式长度=1,Multiple 模式长度≥1)
+        /// 多选结果(Single 模式长度=1,Multiple 模式长度≥1)
        #[serde(default)]
        decisions: Vec<String>,
        comment: Option<String>,
@@ -6,7 +6,7 @@ use std::collections::HashMap;
 /// DAG 定义 — 可序列化/反序列化，用于持久化和模板
 #[derive(Serialize, Deserialize, Clone, Debug)]
 pub struct DagDef {
-    // BUG-260621-01: nodes/edges 加 #[serde(default)]。
+    // nodes/edges 加 #[serde(default)]。
    // 前端 run_workflow 推进链传空 dag `{}`(设计意图:空 dag + target_status →
    // workflow.rs:91 dag.nodes.is_empty() 进 template_for 自动选模板)。原无 default
    // 时,`{}` 在 Tauri IPC 入口反序列化 DagDef 即报 `missing field nodes`,挡在选模板
@@ -91,7 +91,7 @@ impl Default for DagDef {
 mod tests {
    use super::*;

-    // BUG-260621-01: 前端 run_workflow 推进链传空 dag `{}`,serde 必须能反序列化
+    // 前端 run_workflow 推进链传空 dag `{}`,serde 必须能反序列化
    // 成空 DagDef(非报 missing field),后续 workflow.rs:91 dag.nodes.is_empty()
    // 进 template_for 选模板。nodes/edges 加 #[serde(default)] 前此用例会失败。
    #[test]
@@ -98,27 +98,27 @@ impl DagExecutor {
                let mut any_edge_passed = false; // 任一入边放行(含无条件边)
                if let Some(preds) = adjacency_in.get(node_id) {
                    for (pred_id, cond) in preds {
-                        if let Some(out) = outputs.get(pred_id) {
-                            if eval_conditions {
-                                if let Some(cond) = cond {
-                                    has_any_cond_edge = true;
-                                    // 以 source output.data 为 context 求值;失败保守 false
-                                    let passed = ConditionEngine::evaluate(cond, &out.data)
-                                        .unwrap_or(false);
-                                    if passed {
-                                        inputs.insert(pred_id.clone(), out.clone());
-                                        any_edge_passed = true;
-                                    }
-                                } else {
-                                    // 无 condition 的入边:无条件放行(必收集)
-                                    inputs.insert(pred_id.clone(), out.clone());
-                                    any_edge_passed = true;
-                                }
-                            } else {
-                                // flag 关:condition 完全忽略,旧行为全收集
-                                inputs.insert(pred_id.clone(), out.clone());
-                                any_edge_passed = true;
+                        let Some(out) = outputs.get(pred_id) else {
+                            continue;
+                        };
+
+                        // flag 关:condition 完全忽略,旧行为全收集;
+                        // flag 开 + 无 condition 入边:无条件放行(必收集);
+                        // flag 开 + 有 condition 入边:以 source output.data 为 context 求值,
+                        //   失败保守 false(对齐引擎语义)。
+                        let passed = match (eval_conditions, cond) {
+                            (false, _) => true,
+                            (true, None) => true,
+                            (true, Some(c)) => {
+                                ConditionEngine::evaluate(c, &out.data).unwrap_or(false)
                            }
+                        };
+                        if eval_conditions && cond.is_some() {
+                            has_any_cond_edge = true;
+                        }
+                        if passed {
+                            inputs.insert(pred_id.clone(), out.clone());
+                            any_edge_passed = true;
                        }
                    }
                } else {