@@ -11,7 +11,14 @@
 //!              网络调用不持全局锁——防 300s 超时阻塞其他 AI 命令）。
 //! @ai-context: 网络路径不单测（与 model_downloader 同口径）；payload 构建/
 //!              响应提取/JSON 解析为纯函数可单测。
+//! @ai-context: v0.11.6 M1 多 Provider 化：from_provider（BYOK Provider 直接
+//!              构建）+ from_settings_with_store（默认 Provider 接管 base_url/
+//!              model，无 Provider 配置回退旧字段——兼容迁移前状态）+
+//!              is_fallbackable/fallback_provider_ids（降级链纯函数：
+//!              Network/Server/Quota 瞬态可降级，Auth/Balance/Parse 归因
+//!              用户/响应不降级；实际 fallback 调用由任务层接线）。
 
+use crate::ai_provider::{AiProviderConfig, AiProviderStore};
 use crate::ai_settings::AiSettings;
 
 /// 单请求超时默认（秒；env SILICONFLOW_TIMEOUT_SECS 可覆盖）。
@@ -74,6 +81,17 @@ impl std::fmt::Display for AiClientError {
     }
 }
 
+impl AiClientError {
+    /// 是否可触发 Provider 降级（Network/Server/Quota 瞬态；Auth/Balance/
+    /// Parse 归因用户或响应——不降级，错误原样上抛引导）。
+    pub fn is_fallbackable(&self) -> bool {
+        matches!(
+            self,
+            AiClientError::Network(_) | AiClientError::Server(_) | AiClientError::Quota(_)
+        )
+    }
+}
+
 /// 共享 AI client（阻塞调用——command 层 spawn_blocking 包裹）。
 #[derive(Debug, Clone)]
 pub struct AiClient {
@@ -110,6 +128,34 @@ impl AiClient {
         Self { config }
     }
 
+    /// 从 Provider 配置构建（M1：BYOK 多 Provider 入口；密钥由 command 层
+    /// 按 scope 解析注入——env 优先，否则 per-provider 凭据）。
+    pub fn from_provider(provider: &AiProviderConfig, api_key: Option<String>) -> Self {
+        Self::new(AiClientConfig {
+            base_url: provider.base_url.clone(),
+            api_key: api_key.unwrap_or_default(),
+            model: provider.default_model.clone(),
+            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,
+        })
+    }
+
+    /// 旧入口升级：从设置 + Provider 存储解析（默认 Provider 接管
+    /// base_url/model；无 Provider 配置时回退旧字段——兼容迁移前状态）。
+    pub fn from_settings_with_store(
+        settings: &AiSettings,
+        stored_key: Option<String>,
+        store: &AiProviderStore,
+    ) -> Self {
+        if let Some(id) = store.effective_default_id() {
+            if let Some(p) = store.get(&id) {
+                return Self::from_provider(p, stored_key);
+            }
+        }
+        Self::from_settings(settings, stored_key)
+    }
+
     /// chat/completions 请求 → 原始 assistant 文本（未 parse；各适配器自行解析）。
     ///
     /// @ai-context: 供需要类型级解析的适配器使用（ai_text_filter 的
@@ -265,6 +311,22 @@ fn env_parse(key: &str, default: u64) -> u64 {
     std::env::var(key).ok().and_then(|v| v.parse().ok()).unwrap_or(default)
 }
 
+/// 降级链 Provider id 序列（纯函数）：默认 Provider + 其 fallback_order 中
+/// 存在且启用的 id（去重；M1 简单版：只解析顺序，实际 fallback 调用由
+/// 任务层接线——最多 fallback 一次）。
+pub fn fallback_provider_ids(store: &AiProviderStore, primary: &AiProviderConfig) -> Vec<String> {
+    let mut ids = vec![primary.id.clone()];
+    for id in &primary.fallback_order {
+        if id != &primary.id
+            && store.get(id).map(|p| p.enabled).unwrap_or(false)
+            && !ids.contains(id)
+        {
+            ids.push(id.clone());
+        }
+    }
+    ids
+}
+
 /// 单测独立文件（保持本文件 ≤300 行，AGENTS.md §3）。
 #[cfg(test)]
 #[path = "ai_client_tests.rs"]
 
@@ -3,9 +3,10 @@
 use std::sync::Mutex;
 
 use crate::ai_client::{
-    build_chat_payload, chat_completions_url, extract_content, parse_json_object, AiClient,
-    AiClientConfig, AiClientError,
+    build_chat_payload, chat_completions_url, extract_content, fallback_provider_ids, parse_json_object,
+    AiClient, AiClientConfig, AiClientError,
 };
+use crate::ai_provider::{preset_templates, AiProviderStore};
 use crate::ai_settings::AiSettings;
 
 /// env 操作互斥（防并行测试互相覆盖 SILICONFLOW_*——与 ai_cost_tests 同模式）。
@@ -160,3 +161,75 @@ fn chat_json_without_key_is_auth_error() {
         other => panic!("期望 Auth 错误，实际 {:?}", other.map(|_| ())),
     }
 }
+
+// ---- v0.11.6 M1：Provider 化 + 降级链（Task 3 纯函数层）----
+
+#[test]
+fn from_provider_builds_config_from_provider() {
+    let mut p = preset_templates().remove(0);
+    p.id = "p1".to_string();
+    let client = AiClient::from_provider(&p, Some("sk-p1".to_string()));
+    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");
+}
+
+#[test]
+fn from_settings_resolves_default_provider_when_set() {
+    let mut store = AiProviderStore::default();
+    let mut p = preset_templates().remove(0);
+    p.id = "prov-a".to_string();
+    p.default_model = "model-a".to_string();
+    store.providers.push(p);
+    store.default_provider_id = Some("prov-a".to_string());
+    let client = AiClient::from_settings_with_store(
+        &crate::ai_settings::AiSettings::default(),
+        Some("sk-x".to_string()),
+        &store,
+    );
+    assert_eq!(client.config.model, "model-a");
+    assert_eq!(client.config.base_url, "https://api.siliconflow.cn/v1");
+}
+
+#[test]
+fn from_settings_falls_back_to_legacy_fields_without_store() {
+    // 测试隔离：宿主可能已设 SILICONFLOW_MODEL——锁内清除后走旧字段解析
+    with_env_locked(|| {
+        let client = AiClient::from_settings_with_store(
+            &crate::ai_settings::AiSettings::default(),
+            Some("sk-x".to_string()),
+            &AiProviderStore::default(),
+        );
+        // 空 store → 回退旧字段解析（兼容迁移前状态）
+        assert_eq!(client.config.model, crate::ai_settings::DEFAULT_AI_MODEL);
+    });
+}
+
+#[test]
+fn fallback_chain_skips_auth_balance_errors() {
+    use crate::ai_client::AiClientError;
+    assert!(AiClientError::Network("x".into()).is_fallbackable());
+    assert!(AiClientError::Server("x".into()).is_fallbackable());
+    assert!(AiClientError::Quota("x".into()).is_fallbackable());
+    assert!(!AiClientError::Auth("x".into()).is_fallbackable());
+    assert!(!AiClientError::Balance("x".into()).is_fallbackable());
+    assert!(!AiClientError::Parse("x".into()).is_fallbackable());
+}
+
+#[test]
+fn fallback_chain_order_resolves_provider_sequence() {
+    let mut store = AiProviderStore::default();
+    let mk = |id: &str| {
+        let mut p = preset_templates().remove(0);
+        p.id = id.to_string();
+        p
+    };
+    store.providers.push(mk("a"));
+    store.providers.push(mk("b"));
+    store.providers.push(mk("c"));
+    store.default_provider_id = Some("a".to_string());
+    let mut a = store.get("a").unwrap().clone();
+    a.fallback_order = vec!["b".to_string(), "ghost".to_string(), "c".to_string()];
+    let ids = fallback_provider_ids(&store, &a);
+    assert_eq!(ids, vec!["a".to_string(), "b".to_string(), "c".to_string()]);
+}