优化: 清理无意义注释(走查编号前缀/过时历史标注/死代码注释)

crates/df-ai/src/anthropic_compat.rs

@@ -80,7 +80,7 @@ impl AnthropicCompatProvider {
     /// - `api_key`: API 密钥（Anthropic 用 x-api-key 头，非 Bearer）
     /// - `default_model`: 默认模型名称
     pub fn new(base_url: impl Into<String>, api_key: impl Into<String>, default_model: impl Into<String>) -> Self {
-        // SW-260618-10: reqwest Client 构建抽 crate::build_provider_client（与 OpenAI 共用 DRY）。
+        // reqwest Client 构建抽 crate::build_provider_client（与 OpenAI 共用 DRY）。
         let client = crate::build_provider_client();
         Self {
             client,
@@ -890,7 +890,7 @@ mod tests {
         assert!(!c.finished);
     }
 
-    /// error 事件 → error=Some + finished=false（R-P1-1：避免残缺响应被当正常完成入库，
+    /// error 事件 → error=Some + finished=false避免残缺响应被当正常完成入库，
     /// 由 stream_llm 识别 error 非空发 AiError + 丢弃残缺，与 OpenAI 路径 Err 一致）
     #[test]
     fn anthropic_error_event_yields_error_not_finished() {

crates/df-ai/src/anthropic_helpers.rs

@@ -61,12 +61,12 @@ pub(crate) struct AnthropicToolDef {
 /// Anthropic 同步响应
 #[derive(Debug, Deserialize)]
 pub(crate) struct AnthropicResponse {
-    // SW-260618-25: Anthropic 响应反序列化字段,保留以对齐响应结构(响应 id),标注意图消除 dead_code warning
+    // Anthropic 响应反序列化字段,保留以对齐响应结构(响应 id),标注意图消除 dead_code warning
     #[allow(dead_code)]
     id: String,
     pub model: String,
     pub content: Vec<AnthropicContentBlock>,
-    // SW-260618-25: Anthropic 响应反序列化字段,保留以备调试/未来消费(如日志记录调用终止原因),标注意图消除 dead_code warning
+    // Anthropic 响应反序列化字段,保留以备调试/未来消费(如日志记录调用终止原因),标注意图消除 dead_code warning
     #[allow(dead_code)]
     stop_reason: Option<String>,
     pub usage: AnthropicUsage,

crates/df-ai/src/context/mod.rs

@@ -275,7 +275,7 @@ impl ContextManager {
         self.messages.iter().map(|t| t.message.clone()).collect()
     }
 
-    /// 只读最近 N 条消息(尾部切片 clone)。BE2(AC-EFF-R2-1):断路器/探索熔断检查等只关心
+    /// 只读最近 N 条消息(尾部切片 clone)。BE2 断路器/探索熔断检查等只关心
     /// 最近消息的读路径,用本方法避免 all_messages_clone 每轮全量 clone(长对话每轮 O(n) 深克隆浪费)。
     /// 尾部顺序保持时间正序(与 all_messages_clone 一致,调用方从尾部反向扫即可)。
     pub fn recent_messages(&self, n: usize) -> Vec<ChatMessage> {
@@ -326,7 +326,7 @@ impl ContextManager {
 
     /// 弹出末尾连续的 assistant 消息（含其 tool_calls 三元组尾随 tool_result）
     ///
-    /// 用于「重新生成」(UX-02):删掉最后一条 AI 回复(可能跨多轮 tool_calls + tool_results
+    /// 用于「重新生成」删掉最后一条 AI 回复(可能跨多轮 tool_calls + tool_results
     /// 紧随其后),保留触发它的 user 消息,以便重跑 agentic loop 再生成。
     ///
     /// 语义:从末尾向前弹出,直到弹出至少一条 assistant 消息;若弹出 assistant 后紧邻的更早

crates/df-ai/src/context/sanitize.rs

@@ -34,7 +34,7 @@ use crate::provider::{ChatMessage, MessageRole, ToolCall};
 pub fn sanitize_messages(messages: Vec<ChatMessage>) -> Vec<ChatMessage> {
     use std::collections::HashSet;
 
-    // step 0（UX-09）：过滤 truncated 软删消息，不进 LLM 上下文。
+    // step 0过滤 truncated 软删消息，不进 LLM 上下文。
     // 编辑某条 user 消息后其后续消息标 truncated（保留 DB 可追溯），发送视图必须剔除，
     // 否则被编辑前的旧回复仍进入 LLM 历史，污染重生成语义。落库全量保留不受影响。
     let messages: Vec<ChatMessage> = messages

crates/df-ai/src/context_helpers.rs

@@ -1135,7 +1135,7 @@ mod tests {
     #[test]
     fn extract_key_info_single_huge_line_no_newline_compressed() {
         // 单行超大内容(50KB)原本逃逸压缩,现按字符数截断保留头尾。
-        // 注:read_file 已豁免压缩(BUG-260801),此处用 run_command 验证通用压缩路径。
+        // 注:read_file 已豁免压缩,此处用 run_command 验证通用压缩路径。
         let content = "x".repeat(50_000);
         let result = extract_key_info(&content, "run_command");
         assert!(result.len() < content.len(), "单行超长应压缩: {} >= {}", result.len(), content.len());
@@ -1149,7 +1149,7 @@ mod tests {
     fn extract_key_info_json_huge_string_field_truncated() {
         // JSON 对象中大字符串字段(单行少行)逃逸压缩。
         // 如 `{"path":"src/main.rs","content":"单行超大文本..."}`。
-        // 注:read_file 已豁免压缩(BUG-260801),此处用 run_command 验证通用压缩路径。
+        // 注:read_file 已豁免压缩,此处用 run_command 验证通用压缩路径。
         let large = "z".repeat(10_000);
         let content = format!("{{\"path\":\"src/main.rs\",\"content\":\"{}\"}}", large);
         let result = extract_key_info(&content, "run_command");
@@ -1171,7 +1171,7 @@ mod tests {
     #[test]
     fn extract_key_info_eleven_lines_triggers_compression() {
         // 边界:行数 == 11(刚超 kept_boundary=10)→ 触发压缩,含标记
-        // 注:read_file 已豁免压缩(BUG-260801),此处用 run_command 验证通用压缩路径。
+        // 注:read_file 已豁免压缩,此处用 run_command 验证通用压缩路径。
         let lines: Vec<String> = (1..=11).map(|i| format!("line {}", i)).collect();
         let content = lines.join("\n");
         let result = extract_key_info(&content, "run_command");
@@ -1185,7 +1185,7 @@ mod tests {
         // 边界:错误行恰在头部区间内(idx < head_end)→ 不重复插入(头部已含)
         // 错误行在尾部区间内(idx >= tail_start)→ 不重复插入(尾部已含)
         // 错误行在中间区间 → 标注 [行 N] 插入
-        // 注:read_file 已豁免压缩(BUG-260801),此处用 run_command 验证通用压缩路径。
+        // 注:read_file 已豁免压缩,此处用 run_command 验证通用压缩路径。
         let mut lines: Vec<String> = (1..=20).map(|i| format!("norm {}", i)).collect();
         // idx=2(头部区间 [0,5))错误行 → 头部已含,不在 error_lines(扫描跳过 head/tail)
         lines[2] = "error in head zone".to_string();
@@ -1347,7 +1347,7 @@ mod tests {
         assert_eq!(extract_pending_tc_id(""), None);
     }
 
-    // ── read_file 豁免压缩(BUG-260801: AI 定向读代码不应被折叠) ──
+    // ── read_file 豁免压缩AI 定向读代码不应被折叠) ──
     //
     // 根因:extract_key_info 的 JSON 分支对 content 字段(文件内容)行数 > 10 即折叠中间为
     // "(压缩中间内容)"。read_file limit=100 读 28KB(100 行)→ 触发 → AI 只拿到首尾各 5 行,

crates/df-ai/src/lib.rs

@@ -56,7 +56,7 @@ use reqwest::Client;
 // df-ai-core 直接暴露，供需要直接引用 trait crate 的下游（可选）。
 pub use df_ai_core;
 
-/// SW-260618-10: 构建 Provider 共用的 reqwest Client（OpenAI/Anthropic Provider::new DRY）。
+/// 构建 Provider 共用的 reqwest Client（OpenAI/Anthropic Provider::new DRY）。
 ///
 /// connect_timeout 30s 防连接阶段静默 hang（网络静默断）；不设总 timeout——reqwest 的
 /// `.timeout()` 会限制整个响应 body 时长，流式长生成任务会被误砍。读取阶段中途静默由上层

crates/df-ai/src/model_fetch_helpers.rs

@@ -239,7 +239,7 @@ mod tests {
         // SenseNova U1 系列是图像生成模型(走 /v1/images/generations,非 chat completions),
         // /v1/models 会返回但不应留为 chat 模型,否则用户选它对话会失败。
         assert!(is_non_chat_model("sensenova-u1-fast"));
-        assert!(is_non_chat_model("SenseNova-U1-Fast")); // 大小写无关
+        assert!(is_non_chat_model("SenseNova-ast")); // 大小写无关
         assert!(is_non_chat_model("sensenova-u1-pro"));
         // 通用图像生成命名也剔
         assert!(is_non_chat_model("infographic-v1"));

crates/df-ai/src/openai_compat.rs

@@ -47,7 +47,7 @@ impl OpenAICompatProvider {
     /// - `api_key`: API 密钥
     /// - `default_model`: 默认模型名称
     pub fn new(base_url: impl Into<String>, api_key: impl Into<String>, default_model: impl Into<String>) -> Self {
-        // SW-260618-10: reqwest Client 构建抽 crate::build_provider_client（与 Anthropic 共用 DRY）。
+        // reqwest Client 构建抽 crate::build_provider_client（与 Anthropic 共用 DRY）。
         // connect_timeout/回退策略集中此处，未来改一处即可（见 lib.rs::build_provider_client）。
         let client = crate::build_provider_client();
         Self {

crates/df-ai/src/openai_helpers.rs

@@ -67,7 +67,7 @@ pub(crate) struct OpenAiResponse {
 #[derive(Debug, Deserialize)]
 pub(crate) struct OpenAiChoice {
     pub message: OpenAiMessageResp,
-    // SW-260618-24: OpenAI 响应反序列化字段,保留以备调试/未来消费(如日志记录调用终止原因),标注意图消除 dead_code warning
+    // OpenAI 响应反序列化字段,保留以备调试/未来消费(如日志记录调用终止原因),标注意图消除 dead_code warning
     #[allow(dead_code)]
     pub finish_reason: Option<String>,
 }
@@ -84,7 +84,7 @@ pub(crate) struct OpenAiMessageResp {
 #[derive(Debug, Deserialize)]
 pub(crate) struct OpenAiToolCallResp {
     pub id: String,
-    // SW-260618-24: 反序列化 #[serde(rename="type")] 字段,保留以对齐 OpenAI 响应结构,标注意图消除 dead_code warning
+    // 反序列化 #[serde(rename="type")] 字段,保留以对齐 OpenAI 响应结构,标注意图消除 dead_code warning
     #[allow(dead_code)]
     #[serde(rename = "type")]
     pub call_type: String,

crates/df-ai/src/retry.rs

@@ -40,7 +40,7 @@ const JITTER_RATIO: f64 = 1.0;
 
 /// 一次尝试的分类结果 —— 在 anyhow 不透明化前决定是否值得重试。
 ///
-/// CR-30-1: 暴露给 agentic.rs 流前重试复用(Init 失败分类 Fatal/Retryable 决定是否重试)。
+/// 暴露给 agentic.rs 流前重试复用(Init 失败分类 Fatal/Retryable 决定是否重试)。
 #[derive(Debug)]
 pub enum AttemptOutcome<T> {
     /// 成功，携带结果。
@@ -60,7 +60,7 @@ pub fn is_reqwest_error_retryable(e: &reqwest::Error) -> bool {
 
 /// 判定 HTTP 状态码是否可重试: 5xx 与 429 重试，其余(含 4xx)不重试。
 ///
-/// CR-30-1: 暴露给 agentic.rs 流前重试复用(4xx Fatal 立即放弃,5xx/429 重试)。
+/// 暴露给 agentic.rs 流前重试复用(4xx Fatal 立即放弃,5xx/429 重试)。
 pub fn is_status_retryable(status: u16) -> bool {
     status == 429 || (500..600).contains(&status)
 }
@@ -91,7 +91,7 @@ pub fn backoff_delay(attempt: u32) -> Duration {
 /// 调用方约定: `attempt_fn` 内部应保留完整请求重发能力(每次重建 RequestBuilder)，
 /// 因为 reqwest::RequestBuilder 一次 `.send()` 后不可复用。
 ///
-/// CR-30-1: 仍 pub(crate)(complete() 内部用),流前重试 stream_recv/agentic 不走此函数
+/// 仍 pub(crate)(complete() 内部用),流前重试 stream_recv/agentic 不走此函数
 /// (流式 request 不可整体 retry_with_backoff 包裹,需在 agentic loop 内手写循环复用
 /// backoff_delay + is_status_retryable)。
 pub(crate) async fn retry_with_backoff<T, F, Fut>(