fix(ai): 任务预检密钥源统一与 Ollama 免密钥测试连接（v0.11.6 M1）

Author: Aparencia

app/src-tauri/src/ai_client.rs

@@ -49,6 +49,8 @@ pub struct AiClientConfig {
     pub timeout_secs: u64,
     pub max_retries: u32,
     pub max_tokens: u32,
+    /// 本地端点（Ollama 等免密钥推理；空密钥不触发 Auth 检查——本地优先叙事）
+    pub is_local: bool,
 }
 
 /// 归一化 AI 错误（REQ-145 失败原因四类 + 服务端/解析补充）。
@@ -121,6 +123,7 @@ impl AiClient {
             timeout_secs: env_parse("SILICONFLOW_TIMEOUT_SECS", DEFAULT_TIMEOUT_SECS),
             max_retries: env_parse("SILICONFLOW_RETRIES", DEFAULT_MAX_RETRIES as u64) as u32,
             max_tokens: env_parse(MAX_TOKENS_ENV, DEFAULT_MAX_TOKENS as u64) as u32,
+            is_local: false,
         })
     }
 
@@ -138,6 +141,8 @@ impl AiClient {
             timeout_secs: env_parse("SILICONFLOW_TIMEOUT_SECS", DEFAULT_TIMEOUT_SECS),
             max_retries: env_parse("SILICONFLOW_RETRIES", DEFAULT_MAX_RETRIES as u64) as u32,
             max_tokens: env_parse(MAX_TOKENS_ENV, DEFAULT_MAX_TOKENS as u64) as u32,
+            // Why: Ollama 本地端点无需密钥；空密钥不触发 Auth 检查——本地优先叙事
+            is_local: provider.kind == crate::ai_provider::ProviderKind::Ollama,
         })
     }
 
@@ -162,7 +167,7 @@ impl AiClient {
     ///              parse_response 做 TextFilterResponse 反序列化）；
     ///              chat_json = chat_text + parse_json_object 的组合。
     pub fn chat_text(&self, system: &str, user: &str) -> Result<String, AiClientError> {
-        if self.config.api_key.trim().is_empty() {
+        if !self.config.is_local && self.config.api_key.trim().is_empty() {
             return Err(AiClientError::Auth("未配置 API 密钥（设置页保存或配置环境变量）".to_string()));
         }
         let payload = build_chat_payload(&self.config.model, system, user, self.config.max_tokens);

app/src-tauri/src/ai_client_tests.rs

@@ -155,13 +155,31 @@ fn chat_json_without_key_is_auth_error() {
         timeout_secs: 5,
         max_retries: 0,
         max_tokens: 20000,
+        is_local: false,
     });
     match client.chat_json("sys", "usr") {
         Err(AiClientError::Auth(_)) => {}
         other => panic!("期望 Auth 错误，实际 {:?}", other.map(|_| ())),
     }
 }
 
+#[test]
+fn chat_json_without_key_skips_auth_when_local() {
+    // Why: Ollama 本地端点无需密钥——is_local=true 时空密钥不触发 Auth 拒绝
+    let client = AiClient::new(AiClientConfig {
+        base_url: "http://127.0.0.1:11434/v1".to_string(),
+        api_key: "".to_string(),
+        model: "llama3".to_string(),
+        timeout_secs: 5,
+        max_retries: 0,
+        max_tokens: 20000,
+        is_local: true,
+    });
+    // is_local 时空密钥应跳过 Auth 检查，实际会触发网络/传输错误（非 Auth）
+    let result = client.chat_json("sys", "usr");
+    assert!(!matches!(result, Err(AiClientError::Auth(_))), "is_local 不应返回 Auth 错误");
+}
+
 // ---- v0.11.6 M1：Provider 化 + 降级链（Task 3 纯函数层）----
 
 #[test]
@@ -172,6 +190,18 @@ fn from_provider_builds_config_from_provider() {
     assert_eq!(client.config.base_url, p.base_url);
     assert_eq!(client.config.model, p.default_model);
     assert_eq!(client.config.api_key, "sk-p1");
+    // Why: Ollama 预设 is_local=true；云端预设（SiliconFlow）is_local=false
+    assert!(!client.config.is_local, "云端 Provider is_local=false");
+}
+
+#[test]
+fn from_provider_sets_is_local_for_ollama() {
+    // Why: Ollama 本地端点无需密钥——is_local=true 确保空密钥不触发 Auth 拒绝
+    let ollama_preset = preset_templates().into_iter().find(|p| p.kind == crate::ai_provider::ProviderKind::Ollama)
+        .expect("Ollama 预设存在");
+    let client = AiClient::from_provider(&ollama_preset, None);
+    assert!(client.config.is_local, "Ollama Provider is_local=true");
+    assert!(client.config.api_key.is_empty(), "Ollama 空密钥预期");
 }
 
 #[test]

app/src-tauri/src/ai_text_filter.rs

@@ -168,6 +168,7 @@ impl AiTextFilterAdapter {
             // 2026-08-21 真机排查：显式输出上限（缺省时 DeepSeek 8192 token
             // 硬切 JSON 截断）——与共享 client 同默认，env 可覆盖
             max_tokens: self.config.max_tokens,
+            is_local: false,
         });
         let raw = client
             .chat_text(&system, &user)

app/src-tauri/src/commands_ai_enrich.rs

@@ -84,10 +84,9 @@ pub async fn ai_enrich_start(
     }
     let mock = std::env::var(MOCK_ENV).map(|v| v == "1").unwrap_or(false);
     if !mock {
-        let env_key = std::env::var("SILICONFLOW_API_KEY").ok().filter(|k| !k.is_empty());
-        let stored = st.ai_credentials.load_key("default")?;
-        if env_key.is_none() && stored.is_none() {
-            return Err("未配置 API 密钥（设置页保存密钥或配置环境变量 SILICONFLOW_API_KEY）".to_string());
+        let has_key = crate::commands_ai_providers::resolve_default_provider_key(&st)?.is_some();
+        if !has_key {
+            return Err("未配置 API 密钥（请在设置页 AI 服务提供商中配置）".to_string());
         }
     }
     // F1 修复（2026-08-21）+ 审查修复（2026-08-21）：任务去重——按

app/src-tauri/src/commands_ai_refine.rs

@@ -133,10 +133,9 @@ pub async fn ai_refine_start(
     let mock = std::env::var(MOCK_ENV).map(|v| v == "1").unwrap_or(false);
     // ② 密钥解析（env > 凭据库）；非 mock 且无密钥 → 明确错误（不创建任务）
     if !mock {
-        let env_key = std::env::var("SILICONFLOW_API_KEY").ok().filter(|k| !k.is_empty());
-        let stored = st.ai_credentials.load_key("default")?;
-        if env_key.is_none() && stored.is_none() {
-            return Err("未配置 API 密钥（设置页保存密钥或配置环境变量 SILICONFLOW_API_KEY）".to_string());
+        let has_key = crate::commands_ai_providers::resolve_default_provider_key(&st)?.is_some();
+        if !has_key {
+            return Err("未配置 API 密钥（请在设置页 AI 服务提供商中配置）".to_string());
         }
     }
     // ②b F1 修复（2026-08-21）+ 审查修复（2026-08-21）：任务去重——按