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

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

@@ -15,9 +15,9 @@
 //! - **读侧收敛**:停止按钮三态(可停 / 停中 / 停失败可重试)、MaxRoundsCard 是否弹等
 //!   判别逻辑由 `ConvState` 变体直接表达,不再靠多变量组合反推。
 //!
-//! # 收口后(批3+)
+//! # 当前架构
 //!
-//! 本模块是**纯逻辑、无 IO**的 enum + 转换守卫。批3 双轨收口后 `generating` bool
+//! 本模块是**纯逻辑、无 IO**的 enum + 转换守卫。`generating` bool
 //! 与 `CONV_STATE_ENABLED` 开关已退役,`ConvState` 成为唯一真相源:guard 接入点
 //! (`GeneratingGuard` new/reset/drop 时同步迁移 `ConvState`)无条件执行迁移 + emit。
 //!
@@ -52,7 +52,7 @@ use serde::{Deserialize, Serialize};
 ///   `ConvState` 是面向「生成生命周期」的写侧真相(写收敛)。两者正交:如 `Generating` 态
 ///   同时有审批挂起时,`ConvState=Generating` 而 `SessionState=AwaitingApproval`。
 ///
-/// 序列化(`Serialize`/`Deserialize`):批3 前端经事件总线读 enum 视图时使用(本批未接,
+/// 序列化(`Serialize`/`Deserialize`):前端经事件总线读 enum 视图时使用(本批未接,
 /// 预留,避免后续改动序列化兼容性)。
 #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
 #[serde(rename_all = "snake_case")]
@@ -150,9 +150,7 @@ impl ConvState {
     /// 审批挂起(读视图 `SessionState::AwaitingApproval`)期间 `ConvState` 仍是 `Generating`,
     /// 故本方法返回 true——审批挂起不算「停止生成」。
     ///
-    /// 预留:批2+ 读侧迁移(try_continue / ai_chat_stop / 前端停止三态)消费。
-    /// L2 读侧迁移(2026-06-22):已接入 ai_is_generating / ai_chat_stop / try_continue_agent_loop,
-    /// 不再标 allow(dead_code)(有真实消费方)。
+    /// 已接入 ai_is_generating / ai_chat_stop / try_continue_agent_loop,不再标 allow(dead_code)。
     pub fn is_active(self) -> bool {
         matches!(self, ConvState::Generating | ConvState::Compressed)
     }
@@ -162,8 +160,8 @@ impl ConvState {
     /// 读侧便利方法:用于 `ai_conversation_create` / `ai_chat_send` 等入口判断
     /// 「能否接新请求」。`Error` 态视为可接(用户重试即从 Error 起步)。
     ///
-    /// 双轨收口批1(2026-06-25):chat 域入口拦截(ai_regenerate / ai_chat_send /
-    /// ai_chat_edit)已接入,作真实读侧方法消费。删除 `allow(dead_code)` 标注。
+    /// chat 域入口拦截(ai_regenerate / ai_chat_send /
+    /// ai_chat_edit)已接入,作真实读侧方法消费。
     pub fn can_accept_request(self) -> bool {
         matches!(self, ConvState::Idle | ConvState::Error)
     }