feat(fragments): feed 消费闭环命令（delete/移组/图片 resolve，REQ-201）

Author: Aparencia

app/src-tauri/src/commands_fragments.rs

@@ -144,6 +144,94 @@ pub fn list_group_fragments(state: State<'_, AppState>, group_id: i64) -> Result
     state.db.list_fragments_by_group(group_id).map_err(|e| e.to_string())
 }
 
+/// 移动碎片到组（None=移出组；用户纠错/重新归组——REQ-201 消费闭环）。
+///
+/// @ai-context: 与 capture_fragment 同开关准入（feed 能力默认关纪律对称——
+///              后端不信前端隐藏）；目标组存在性校验（不写孤儿引用）。
+#[tauri::command]
+pub fn update_fragment_group(
+    state: State<'_, AppState>,
+    fragment_id: i64,
+    group_id: Option<i64>,
+) -> Result<bool, String> {
+    require_feed_enabled(&state)?;
+    if fragment_id <= 0 {
+        return Err("无效的碎片 id".to_string());
+    }
+    if state.db.get_fragment(fragment_id).map_err(|e| e.to_string())?.is_none() {
+        return Err(format!("碎片不存在: {}", fragment_id));
+    }
+    if let Some(gid) = group_id {
+        if gid <= 0 {
+            return Err("无效的组 id".to_string());
+        }
+        if state.db.get_group(gid).map_err(|e| e.to_string())?.is_none() {
+            return Err(format!("笔记组不存在: {}", gid));
+        }
+    }
+    state
+        .db
+        .update_fragment_group(fragment_id, group_id)
+        .map_err(|e| e.to_string())
+}
+
+/// 删除碎片（REQ-201 用户主动删除——真删；绑定卡自动解绑保留）。
+///
+/// @ai-context: 开关准入同 capture_fragment（feed 能力对称纪律）；存在性校验
+///              前置（删不存在的碎片返回明确错误而非静默 false）。
+#[tauri::command]
+pub fn delete_fragment(state: State<'_, AppState>, fragment_id: i64) -> Result<bool, String> {
+    require_feed_enabled(&state)?;
+    if fragment_id <= 0 {
+        return Err("无效的碎片 id".to_string());
+    }
+    if state.db.get_fragment(fragment_id).map_err(|e| e.to_string())?.is_none() {
+        return Err(format!("碎片不存在: {}", fragment_id));
+    }
+    state.db.delete_fragment(fragment_id).map_err(|e| e.to_string())
+}
+
+/// 碎片图片 → 本地绝对路径（前端 convertFileSrc 消费；REQ-201 缩略图）。
+///
+/// @ai-context: resolve 先例同 resolve_note_image——WebView 不能直接读本地文件；
+///              本命令从库读 image_path 而非信任前端传参（防任意路径穿越），
+///              只放行 fragments/ 前缀；无图 → None（UI 降级文本预览）。
+#[tauri::command]
+pub fn resolve_fragment_image(
+    state: State<'_, AppState>,
+    fragment_id: i64,
+) -> Result<Option<String>, String> {
+    if fragment_id <= 0 {
+        return Err("无效的碎片 id".to_string());
+    }
+    let frag = state
+        .db
+        .get_fragment(fragment_id)
+        .map_err(|e| e.to_string())?
+        .ok_or_else(|| format!("碎片不存在: {}", fragment_id))?;
+    let Some(rel) = frag.image_path else { return Ok(None) };
+    // 只放行 fragments/ 前缀 + 防穿越（落盘时的白名单格式已由 image crate 把关）
+    let rel_trim = rel.trim_start_matches(['/', '\\']);
+    if !rel_trim.starts_with("fragments/") || rel_trim.split(['/', '\\']).any(|seg| seg == "..") {
+        eprintln!("[fragments] 异常图片路径被拒: {}", rel);
+        return Ok(None);
+    }
+    let abs = state.data_dir.join(rel_trim);
+    Ok(Some(abs.to_string_lossy().into_owned()))
+}
+
+/// feed 能力开关准入（capture/delete/移组共用——后端不信前端隐藏）。
+fn require_feed_enabled(state: &AppState) -> Result<(), String> {
+    let guard = state
+        .feature_flags
+        .lock()
+        .map_err(|e| format!("开关锁失败: {}", e))?;
+    if !guard.feed_capture {
+        return Err("feed 能力未启用（请在设置中开启 feed 捕获开关）".to_string());
+    }
+    Ok(())
+}
+
 /// base64 解码 + 解码验证并落盘碎片图片（返回 fragments/ 下相对路径）。
 ///
 /// @ai-context: image::load_from_memory 把关格式白名单（png/jpeg/webp/gif/bmp…

app/src-tauri/src/db_fragments.rs

@@ -108,9 +108,7 @@ impl Db {
         })
     }
 
-    /// 移动碎片到组（None=移出；用户纠错/结算归组共用）。
-    /// 登记豁免 dead_code：碎片移动 UI 随 v0.11.3+ 结算面建设接线。
-    #[allow(dead_code)]
+    /// 移动碎片到组（None=移出；用户纠错/结算归组共用；v0.11.4 命令接线）。
     pub fn update_fragment_group(&self, id: i64, group_id: Option<i64>) -> Result<bool> {
         self.with_conn(|conn| {
             let affected = conn.execute(
@@ -121,6 +119,34 @@ impl Db {
         })
     }
 
+    /// 按 id 读取碎片；不存在返回 None（delete/移组命令的存在性校验）。
+    pub fn get_fragment(&self, id: i64) -> Result<Option<Fragment>> {
+        self.with_conn(|conn| {
+            let mut stmt = conn.prepare(&format!(
+                "SELECT {} FROM fragments WHERE id = ?1",
+                FRAGMENT_COLUMNS
+            ))?;
+            let mut rows = stmt.query_map(params![id], row_to_fragment)?;
+            match rows.next() {
+                Some(Ok(f)) => Ok(Some(f)),
+                Some(Err(e)) => Err(e.into()),
+                None => Ok(None),
+            }
+        })
+    }
+
+    /// 删除碎片（v0.11.4 REQ-201 用户主动删除——真删非归档）。
+    ///
+    /// @ai-context: 绑定闪卡经 flashcards.fragment_id ON DELETE SET NULL 自动
+    ///              解绑保留（学习循环资产不被碎片删除连带——身份诚实：
+    ///              卡已生成即独立资产）；结算归档走 set_fragment_status 不删。
+    pub fn delete_fragment(&self, id: i64) -> Result<bool> {
+        self.with_conn(|conn| {
+            let affected = conn.execute("DELETE FROM fragments WHERE id = ?1", params![id])?;
+            Ok(affected > 0)
+        })
+    }
+
     /// 标记碎片状态（v0.11.3 结算归档：active↔archived）。
     pub fn set_fragment_status(&self, id: i64, status: &str) -> Result<bool> {
         self.with_conn(|conn| {

app/src-tauri/src/db_fragments_tests.rs

@@ -3,7 +3,6 @@
 use crate::db::Db;
 use crate::db_fragments::NewFragment;
 use crate::types::NewNoteGroup;
-
 /// 内存库。
 fn mem_db() -> Db {
     Db::open(":memory:").expect("内存库打开")
@@ -137,3 +136,58 @@ fn delete_group_keeps_fragments() {
     assert_eq!(fetched[0].id, f.id);
     assert_eq!(fetched[0].group_id, None);
 }
+
+#[test]
+fn delete_fragment_removes_and_detaches_cards() {
+    // Arrange：碎片 + 绑定卡（fragment_id 外键）
+    let db = mem_db();
+    let group = db
+        .create_group(&NewNoteGroup {
+            name: "消费组".to_string(),
+            terrain: "feed".to_string(),
+            kind: "topic".to_string(),
+            domain_tag: Some("beauty".to_string()),
+            source: "route".to_string(),
+            series_key: None,
+            route_reason: None,
+        })
+        .expect("group");
+    let f = db.create_fragment(&frag("待删碎片", None, Some(group.id))).expect("f");
+    let card = db
+        .create_card(&crate::db_flashcards::NewFlashcard {
+            group_id: group.id,
+            note_id: None,
+            fragment_id: Some(f.id),
+            front: "线索".to_string(),
+            back: "验证".to_string(),
+            kind: "fact".to_string(),
+            state_json: "{}".to_string(),
+            due_at: 0,
+        })
+        .expect("card");
+    // Act：真删碎片
+    assert!(db.delete_fragment(f.id).expect("delete"));
+    // Assert：碎片消失；卡保留且 fragment_id 解绑（SET NULL——卡是独立资产）
+    assert!(db.get_fragment(f.id).expect("get").is_none());
+    let fetched = db.get_card(card.id).expect("get").expect("卡应保留");
+    assert_eq!(fetched.fragment_id, None);
+}
+
+#[test]
+fn get_fragment_roundtrip_and_missing() {
+    // Arrange
+    let db = mem_db();
+    let f = db.create_fragment(&frag("可查碎片", None, None)).expect("f");
+    // Act/Assert：存在返回完整记录；不存在返回 None
+    let got = db.get_fragment(f.id).expect("get").expect("应存在");
+    assert_eq!(got.text, "可查碎片");
+    assert_eq!(got.status, "active");
+    assert!(db.get_fragment(9999).expect("get").is_none());
+}
+
+#[test]
+fn delete_missing_fragment_returns_false() {
+    // Arrange/Act/Assert：删不存在的碎片诚实返回 false（不报错不panic）
+    let db = mem_db();
+    assert!(!db.delete_fragment(9999).expect("delete"));
+}