feat(flags): 功能开关机制与 feed 捕获默认关

Author: Aparencia

app/src-tauri/src/feature_flags.rs

@@ -0,0 +1,63 @@
+//! 功能开关（v0.11.1；v4 §11.3：feed 相关能力默认关闭）。
+//!
+//! @ai-context: 项目"增强能力默认关闭"传统的统一开关位——feed_capture 控制
+//!              碎片快速捕获面的可见性与 command 准入（后端不信前端隐藏）；
+//!              JSON 持久化同 vocab/ai_settings 模式（缺失/损坏回退默认不阻断）。
+
+use serde::{Deserialize, Serialize};
+
+/// 功能开关集（新增开关必须默认 false——保守默认纪律）。
+#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct FeatureFlags {
+    /// feed 碎片快速捕获（v0.11.1 默认关——Phase 2 验证前不默认启用）
+    pub feed_capture: bool,
+}
+
+impl Default for FeatureFlags {
+    fn default() -> Self {
+        Self { feed_capture: false }
+    }
+}
+
+impl FeatureFlags {
+    /// 从 JSON 文件加载（缺失/损坏 → 内置默认，诚实降级不阻断启动）。
+    pub fn load(path: &std::path::Path) -> Self {
+        match std::fs::read_to_string(path) {
+            Ok(s) => serde_json::from_str(&s).unwrap_or_default(),
+            Err(_) => Self::default(),
+        }
+    }
+
+    /// 持久化（先写临时文件再 rename——原子写，防半截 JSON）。
+    pub fn save(&self, path: &std::path::Path) -> std::io::Result<()> {
+        let json = serde_json::to_string_pretty(self).unwrap_or_default();
+        let tmp = path.with_extension("json.tmp");
+        std::fs::write(&tmp, json)?;
+        std::fs::rename(&tmp, path)?;
+        Ok(())
+    }
+
+    /// 按名读取（白名单；未知开关 → None，诚实不猜）。
+    pub fn get(&self, name: &str) -> Option<bool> {
+        match name {
+            "feed_capture" => Some(self.feed_capture),
+            _ => None,
+        }
+    }
+
+    /// 按名写入（白名单；未知开关 → false 返回）。
+    pub fn set(&mut self, name: &str, value: bool) -> bool {
+        match name {
+            "feed_capture" => {
+                self.feed_capture = value;
+                true
+            }
+            _ => false,
+        }
+    }
+}
+
+#[cfg(test)]
+#[path = "feature_flags_tests.rs"]
+mod tests;

app/src-tauri/src/feature_flags_tests.rs

@@ -0,0 +1,54 @@
+//! feature_flags 单测（AAA 模式）。
+
+use crate::feature_flags::FeatureFlags;
+
+#[test]
+fn defaults_all_off() {
+    // Arrange/Act
+    let flags = FeatureFlags::default();
+    // Assert：保守默认——feed 捕获默认关
+    assert!(!flags.feed_capture);
+}
+
+#[test]
+fn set_get_roundtrip_and_unknown_rejected() {
+    // Arrange
+    let mut flags = FeatureFlags::default();
+    // Act/Assert：已知开关可写可读
+    assert!(flags.set("feed_capture", true));
+    assert_eq!(flags.get("feed_capture"), Some(true));
+    // 未知开关诚实拒绝（不猜不造）
+    assert!(!flags.set("nonexistent", true));
+    assert_eq!(flags.get("nonexistent"), None);
+}
+
+#[test]
+fn load_missing_or_corrupt_falls_back_default() {
+    // Arrange：不存在的路径与损坏内容
+    let missing = std::path::PathBuf::from("./no_such_feature_flags.json");
+    let dir = std::env::temp_dir().join("ff_corrupt_test");
+    let _ = std::fs::create_dir_all(&dir);
+    let corrupt = dir.join("corrupt.json");
+    let _ = std::fs::write(&corrupt, "{ not json !!");
+    // Act
+    let a = FeatureFlags::load(&missing);
+    let b = FeatureFlags::load(&corrupt);
+    // Assert：均回退默认（不阻断启动纪律）
+    assert_eq!(a, FeatureFlags::default());
+    assert_eq!(b, FeatureFlags::default());
+}
+
+#[test]
+fn save_and_reload_persists() {
+    // Arrange
+    let dir = std::env::temp_dir().join("ff_save_test");
+    let _ = std::fs::create_dir_all(&dir);
+    let path = dir.join("flags.json");
+    let mut flags = FeatureFlags::default();
+    flags.feed_capture = true;
+    // Act
+    flags.save(&path).expect("save");
+    let loaded = FeatureFlags::load(&path);
+    // Assert
+    assert!(loaded.feed_capture);
+}