新增: AI Chat多项增强(审批去重/编辑重发/导出/实体引用/会话置顶搜索)+任务推进链df-nodes落地

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

@@ -22,15 +22,15 @@ use super::stream_recv::stream_llm;
 use super::title::{ensure_conversation_title, spawn_ensure_title};
 use super::audit::process_tool_calls;
 
-use super::{AiChatEvent, AiSession};
+use super::{AiChatEvent, AiSession, ErrorType};
 
-/// Agentic 循环最大迭代次数
+/// Agentic 循环默认最大迭代次数（可配置项的默认值）
 ///
-/// 默认 10 轮。未来可配置接入点:接入 AppState(新增 `agent_config` 字段)/df-storage settings KV
-/// 表后,改为从配置读(默认值仍为 10)。当前项目无 agent 配置位(AppState/df-storage config 表
-/// 均无 agent 配置槽),故暂以常量承载,避免引入 AppState 新字段等大改(违反 P2 零行为变边界)。
-/// 接入路径:run_agentic_loop 签名增 `max_iterations: usize` 参数,调用方从 AppState 读取透传。
-pub const MAX_AGENT_ITERATIONS: usize = 10;
+/// 默认 10 轮。F-260616-01 已接入配置:AppState.agent_max_iterations(Arc<AtomicUsize>) +
+/// ai_set_agent_max_iterations command + Settings.vue 数字配置。调用方在 loop 入口
+/// load AtomicUsize 快照后透传 `max_iterations: usize` 形参，当前 loop 锁定边界，
+/// 热改下次发消息生效（与 llm_concurrency 传 Arc 实时反映的区别）。
+pub const DEFAULT_MAX_AGENT_ITERATIONS: usize = 10;
 
 // ============================================================
 // B-260615-09: generating 状态 RAII guard
@@ -98,6 +98,7 @@ pub(crate) async fn run_agentic_loop(
     conv_id: String,
     knowledge_config: crate::state::KnowledgeConfig,
     llm_concurrency: LlmConcurrency,
+    max_iterations: usize,
 ) {
     // B-260615-09: generating 状态由 RAII guard 收敛复位(正常 exit 显式 reset;panic/异常 Drop 兜底)
     let mut guard = GeneratingGuard::new(session_arc.clone());
@@ -124,6 +125,8 @@ pub(crate) async fn run_agentic_loop(
             guard.reset().await;
             let _ = app_handle.emit("ai-chat-event", AiChatEvent::AiError {
                 error: msg,
+                // ensure_resolved_key 失败 = key 缺失/钥匙串损坏,归 Auth
+                error_type: Some(ErrorType::Auth),
                 conversation_id: Some(conv_id.clone()),
             });
             return;
@@ -153,7 +156,7 @@ pub(crate) async fn run_agentic_loop(
     // 区分"正常收敛退出"与"达 MAX 被截断退出"——后者末轮 tool_calls 仍非空(tool_result 不再回传 LLM),属异常
     let mut converged = false;
 
-    for iteration in 0..MAX_AGENT_ITERATIONS {
+    for iteration in 0..max_iterations {
         // 用户请求停止 → 收尾退出（已生成文本已在上一轮入库）
         if stop_flag.load(Ordering::SeqCst) {
             let usage = df_ai::provider::TokenUsage {
@@ -316,19 +319,31 @@ pub(crate) async fn run_agentic_loop(
         // 全部自动执行完成 → 继续下一轮
     }
 
-    // 达 MAX 未收敛(LLM 末轮仍想调工具被截断,末轮 tool_result 不再回传 LLM):异常中断,提示用户
-    // 与 break 正常收敛(break→converged=true)区分:这里仍走入库+Completed,但前置发 AiError 警示
+    // 达 MAX 未收敛(LLM 末轮仍想调工具被截断,末轮 tool_result 不再回传 LLM):转入暂停态询问用户
+    // F-260616-03:不再 emit AiError + 走完成流程,改为 emit AiMaxRoundsReached + 保持 generating=true
+    // (仿审批等待 L313-316),等用户点继续(ai_continue_loop → try_continue_agent_loop 再跑 max_iterations 轮)
+    // 或点停止(ai_stop_loop → 走完成流程)。try_continue 重新 spawn run_agentic_loop,iteration 从 0 重计,
+    // 故续跑天然再跑 max_iterations 轮(决策 a),无需 reset 任何计数器。
     if !converged {
         tracing::warn!(
             conv_id = %conv_id,
-            max_iter = MAX_AGENT_ITERATIONS,
-            "[ai] agentic 循环达最大轮次(MAX_AGENT_ITERATIONS={})仍未收敛,可能未完成",
-            MAX_AGENT_ITERATIONS,
+            max_iter = max_iterations,
+            "[ai] agentic 循环达最大轮次(max_iterations={})仍未收敛,转暂停态询问用户(F-260616-03)",
+            max_iterations,
         );
-        let _ = app_handle.emit("ai-chat-event", AiChatEvent::AiError {
-            error: format!("达到最大轮次({} 轮),Agent 可能未完成(末轮工具结果未回传模型)", MAX_AGENT_ITERATIONS),
+        // 轮 token 落库(保留末轮已生成内容,续跑/停止都据此累加)
+        let usage = df_ai::provider::TokenUsage {
+            prompt_tokens: tokens.prompt(),
+            completion_tokens: tokens.completion(),
+            total_tokens: tokens.total(),
+        };
+        save_conversation(&session_arc, &db, &conv_id, Some(&usage), Some(&provider_config.default_model)).await;
+        // 暂停态保持 generating=true(防其他 send 抢占,仿审批),disarm guard 跳过 Drop 兜底复位
+        guard.disarm();
+        let _ = app_handle.emit("ai-chat-event", AiChatEvent::AiMaxRoundsReached {
             conversation_id: Some(conv_id.clone()),
         });
+        return; // generating 保持 true,等 ai_continue_loop / ai_stop_loop
     }
 
     // 正常完成
@@ -444,6 +459,8 @@ pub(crate) async fn try_continue_agent_loop(app: &AppHandle, state: &AppState) {
             tracing::warn!(error = %e, "[ai] try_continue 失败:无可用 provider");
             let _ = app.emit("ai-chat-event", AiChatEvent::AiError {
                 error: e,
+                // 无可用 provider(配置丢失/全删):用户需在 Settings 设 provider,归 ProviderConfig
+                error_type: Some(ErrorType::ProviderConfig),
                 conversation_id: Some(conv_id),
             });
             return;
@@ -466,6 +483,8 @@ pub(crate) async fn try_continue_agent_loop(app: &AppHandle, state: &AppState) {
     let app_handle = app.clone();
     let knowledge_config = state.knowledge_config.lock().await.clone();
     let llm_concurrency = state.llm_concurrency.clone();
+    // F-260616-01: loop 入口 load 快照，当前续生成 loop 锁定边界（热改下次发消息生效）
+    let max_iterations = state.agent_max_iterations.load(Ordering::SeqCst);
 
     // 恢复循环前通知前端新建 assistant 消息：审批(通过/拒绝)后新一轮文本
     // 不应追加到发起工具调用的旧消息，用 AiAgentRound 隔开
@@ -475,6 +494,6 @@ pub(crate) async fn try_continue_agent_loop(app: &AppHandle, state: &AppState) {
     });
 
     tauri::async_runtime::spawn(async move {
-        run_agentic_loop(session_arc, tools_arc, db, app_handle, provider_config, system_prompt, conv_id, knowledge_config, llm_concurrency).await;
+        run_agentic_loop(session_arc, tools_arc, db, app_handle, provider_config, system_prompt, conv_id, knowledge_config, llm_concurrency, max_iterations).await;
     });
 }