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

crates/df-nodes/src/ai_node_helpers.rs

@@ -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"
 }