feat(rag): v0.19.0~1 kb 派生索引与学习库问答（REQ-258/260）

Author: Aparencia

app/src-tauri/src/ai_chat_stream.rs

@@ -27,6 +27,9 @@ pub enum ChatStreamEvent {
     Failed { error_kind: String, message: String },
     /// 用户取消（content=已生成文本；消息落库标 aborted）
     Aborted { content: String },
+    /// v0.19.1（REQ-260）：学习库问答命中片段（本地恒可用——先于/独立于
+    /// 生成；无命中为空列表——前端按内容文案呈现）
+    KbHits { hits: Vec<crate::kb_search::KbHit> },
 }
 
 impl From<&AiClientError> for ChatStreamEvent {

app/src-tauri/src/ai_settings.rs

@@ -50,6 +50,13 @@ pub struct AiSettings {
     pub goal_plan_enabled: bool,
     /// v0.18.2（REQ-254）：目标规划预算档位（light/standard/deep；默认标准）。
     pub goal_plan_tier: String,
+    /// v0.19.1（REQ-260）：学习库问答生成独立闸门——命中片段列表恒可用
+    /// （本地零成本零上传），生成=最小片段上云 → content_gate + 本开关双闸门，
+    /// 默认关（ADR-029 决策 4/治理 §9）。
+    pub kb_qa_enabled: bool,
+    /// v0.19.1（REQ-260）：学习库问答片段预算档位（light/standard/deep；
+    /// 默认 standard——budget_allocator 档位硬顶复用）。
+    pub kb_qa_tier: String,
 }
 
 impl Default for AiSettings {
@@ -65,6 +72,8 @@ impl Default for AiSettings {
             refine_strategy: RefineStrategyPrefs::default(),
             goal_plan_enabled: false,
             goal_plan_tier: "standard".to_string(),
+            kb_qa_enabled: false,
+            kb_qa_tier: "standard".to_string(),
         }
     }
 }
@@ -121,6 +130,19 @@ impl AiSettings {
         Ok(())
     }
 
+    /// 学习库问答生成双闸门（v0.19.1 REQ-260）：content_gate + kb_qa 开关。
+    ///
+    /// @ai-context: 学习库问答检索在本地完成（命中列表恒可用——不受本闸门
+    ///              约束）；生成才上传**最小命中片段** → 在授权红线之上再设
+    ///              独立开关（默认关）。失败文案引导设置页「学习库」段。
+    pub fn kb_qa_gate(&self) -> Result<(), String> {
+        self.content_gate()?;
+        if !self.kb_qa_enabled {
+            return Err("学习库问答生成未开启（设置→AI 服务→学习库段打开开关；关闭时命中片段列表照常可用，零影响）".to_string());
+        }
+        Ok(())
+    }
+
     /// 非内容类 AI 调用门控（余额查询/测试连接：仅要求开关开启——避免关闭
     /// 状态下误以为功能可用；测试连接为配置验证操作不 gate，见 command 层）。
     /// 当前无消费方（预留——若未来余额查询/测试连接要求开启开关时启用），

app/src-tauri/src/ai_settings_tests.rs

@@ -63,6 +63,9 @@ fn save_load_roundtrip() {
         // v0.18.2：目标 AI 独立闸门 + 预算档位 roundtrip 保真
         goal_plan_enabled: true,
         goal_plan_tier: "deep".to_string(),
+        // v0.19.1：学习库问答生成独立闸门 + 预算档位 roundtrip 保真
+        kb_qa_enabled: true,
+        kb_qa_tier: "light".to_string(),
     };
     s.save(&path).expect("保存成功");
     let loaded = AiSettings::load(&path);
@@ -89,3 +92,14 @@ fn enabled_gate_only_checks_switch() {
     let s2 = AiSettings { enabled: true, ..AiSettings::default() };
     assert!(s2.enabled_gate().is_ok());
 }
+
+#[test]
+fn kb_qa_gate_requires_content_gate_plus_kb_switch() {
+    // 双闸门（v0.19.1 REQ-260）：默认关（命中列表不受约束——生成才闸）
+    let s = AiSettings::default();
+    assert!(s.kb_qa_gate().is_err(), "默认状态生成必须被拦截");
+    let mut s2 = AiSettings { enabled: true, authorized: true, ..AiSettings::default() };
+    assert!(s2.kb_qa_gate().is_err(), "content_gate 过但 kb 开关未开仍拦截");
+    s2.kb_qa_enabled = true;
+    assert!(s2.kb_qa_gate().is_ok(), "双闸门齐开放行");
+}

app/src-tauri/src/commands_ai_chat.rs

@@ -28,16 +28,24 @@ const CHAT_SYSTEM_PROMPT: &str =
 /// 单条消息最大字符数（防误粘贴巨文——超限明确拒绝而非静默截断）。
 const MAX_MESSAGE_CHARS: usize = 16000;
 
-/// 新建会话（标题可空——默认"新对话"）。
+/// 新建会话（标题可空——默认"新对话"；retrieval=true = 学习库问答模式，
+/// v0.19.1——创建时定死，已有会话不改语义）。
 #[tauri::command]
-pub fn chat_create_session(state: State<'_, AppState>, title: Option<String>) -> Result<ChatSession, String> {
+pub fn chat_create_session(
+    state: State<'_, AppState>,
+    title: Option<String>,
+    retrieval: Option<bool>,
+) -> Result<ChatSession, String> {
     let title = title.unwrap_or_default();
     if title.chars().count() > 100 {
         return Err("会话标题过长（≤100 字符）".to_string());
     }
     let id = state
         .db
-        .insert_chat_session(if title.trim().is_empty() { None } else { Some(title.trim()) })
+        .insert_chat_session(
+            if title.trim().is_empty() { None } else { Some(title.trim()) },
+            retrieval.unwrap_or(false),
+        )
         .map_err(|e| e.to_string())?;
     validate_session(&state, id)
 }
@@ -110,13 +118,24 @@ pub async fn chat_send(
     if content.chars().count() > MAX_MESSAGE_CHARS {
         return Err("消息过长（≤16000 字符）".to_string());
     }
+    let session = validate_session(&state, session_id)?;
+    // v0.19.1（REQ-260）：学习库问答会话——命中列表恒可用（本地能力不受
+    // content_gate 约束），生成走 kb 双闸门 → 整链分流入 commands_ai_chat_kb
+    if session.retrieval {
+        return crate::commands_ai_chat_kb::kb_chat_send(
+            &state,
+            session_id,
+            &content,
+            resend_message_id,
+            channel,
+        );
+    }
     let settings = state
         .ai_settings
         .lock()
         .map_err(|e| format!("AI 设置锁中毒: {}", e))?
         .clone();
     settings.content_gate()?; // 授权红线：enabled + authorized 双闸门（默认关）
-    let session = validate_session(&state, session_id)?;
     // 先解析客户端（Provider/密钥缺失 → 明确报错，不落无应答的用户消息）
     let (client, provider_id) = resolve_chat_client(&state, &session)?;
     let model = client.config.model.clone();
@@ -165,13 +184,17 @@ pub async fn chat_regenerate(
     session_id: i64,
     channel: Channel<ChatStreamEvent>,
 ) -> Result<(), String> {
+    let session = validate_session(&state, session_id)?;
+    // v0.19.1：学习库问答会话重生成——重跑检索 + 生成整链
+    if session.retrieval {
+        return crate::commands_ai_chat_kb::kb_chat_regenerate(&state, session_id, channel);
+    }
     let settings = state
         .ai_settings
         .lock()
         .map_err(|e| format!("AI 设置锁中毒: {}", e))?
         .clone();
     settings.content_gate()?;
-    let session = validate_session(&state, session_id)?;
     // 先解析客户端（Provider/密钥失败 → 不删旧回答，保留可重发状态）
     let (client, _provider_id) = resolve_chat_client(&state, &session)?;
     let model = client.config.model.clone();