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

src-tauri/src/commands/ai/agentic/context_lifecycle.rs

@@ -4,7 +4,7 @@
 //!
 //! 触发条件:history_tokens > budget*0.6 且 保护区外有可压缩消息 且 未在压缩中。
 //!
-//! 流程(对齐阶段2 ai_chat_compress_context IPC 的 read-but-don't-mutate 模式):
+//! 流程(对齐 ai_chat_compress_context IPC 的 read-but-don't-mutate 模式):
 //! ① 读 active 克隆(不改 status / 不扣 token)→ 喂 LLM 出摘要;
 //! ② LLM 成功 → compress_old_messages(标 compressed + 扣 token)+ insert_at(摘要 system);
 //! ③ LLM 失败 → 消息状态完全不变(未改 status / 未扣 token),降级走原 build_for_request 裁剪。
@@ -17,11 +17,11 @@
 //!   注:延迟 mutate 的窗口(active_msgs 读出→LLM 出摘要期间)不持锁,但 loop 串行无并发
 //!       (本函数独占 session_arc,工具执行/审批分支在 stream 之后),故此窗口内 messages 不变。
 //!
-//! 安全(FR-S1):复用 loop 顶部已 build+验证 的 provider(不再 build_provider_for 重复 resolve
+//! 安全:复用 loop 顶部已 build+验证 的 provider(不再 build_provider_for 重复 resolve
 //!   keyring),api_key 经 df_storage::secret 闭环;summary/error payload/日志均不含 api_key。
 //!   is_compressing 防重入:set_compressing(true/false) 成对(LLM 调用前后均复位)。
 //!   单轮问答(history_tokens 未超 0.6*budget)不触发,零行为变化。
-//! F-260616-09 B 批2:messages 操作改 per_conv(设计 §4.2)。
+//! messages 操作改 per_conv。
 
 use std::sync::Arc;
 
@@ -51,7 +51,7 @@ const PROTECT_COUNT: usize = 6;
 ///   排障/对比用:置 false 即可观察无兜底时的裁剪效果。
 const KEYWORD_FALLBACK_ENABLED: bool = true;
 
-/// F-15 阶段3: 自动压缩(智能裁剪)——在 build_for_request 之前预处理。
+/// 自动压缩(智能裁剪)——在 build_for_request 之前预处理。
 ///
 /// 从 `run_agentic_loop` 抽取,行为零变更。返回值:
 /// - `true`:conv 已删除,调用方应立即 `return`(退出整个 loop)。
@@ -100,7 +100,7 @@ pub(super) async fn maybe_auto_compress(
                 conversation_id: Some(conv_id.to_string()),
             };
             let _ = app_handle.emit("ai-chat-event", ev.clone());
-            // L3 emit 双写:tunnel subscriber(阶段2)透传 miniapp
+            // L3 emit 双写:tunnel subscriber透传 miniapp
             let _ = app_handle.state::<AppState>().ai_event_bus.publish_event(ev);
             let (active_msgs, lang) = {
                 let mut session = session_arc.lock().await;
@@ -168,7 +168,7 @@ pub(super) async fn maybe_auto_compress(
                         summary: summary.nl_summary,
                     };
                     let _ = app_handle.emit("ai-chat-event", ev.clone());
-                    // L3 emit 双写:tunnel subscriber(阶段2)透传 miniapp
+                    // L3 emit 双写:tunnel subscriber透传 miniapp
                     let _ = app_handle.state::<AppState>().ai_event_bus.publish_event(ev);
                 }
                 Ok(None) => {
@@ -216,7 +216,7 @@ pub(super) async fn maybe_auto_compress(
                             );
                         }
                     }
-                    // BUG-260624-05:压缩失败不发 AiError——前端 AiError case 无条件 setStreaming(false)
+                    // 压缩失败不发 AiError——前端 AiError case 无条件 setStreaming(false)
                     // 误判生成结束(后端 loop 实际继续),致"压缩后停止"。降级为 warn(上方 line 957 已有)
                     // + compress_old_messages 兜底释放 token + build_for_request 裁剪,loop 继续 stream_llm,
                     // 用户自然看到后续回复。压缩降级对用户透明(非致命错误,不该停流)。