maui-data-storage

用途

该技能为智能体提供在 .NET MAUI 应用中存储、检索和管理数据的最佳实践与模式，涵盖 SQLite、EF Core、Preferences、SecureStorage 以及跨平台文件系统访问。其目标是确保所有与数据相关的代码安全、可维护，并符合现代 MAUI 架构。

核心原则

1. 为正确的数据选择正确的存储
   • 敏感数据 → SecureStorage
   • 用户设置 → Preferences
   • 结构化关系数据 → SQLite/EF Core
   • 文件与导出 → FileSystem.AppDataDirectory
2. 跨平台一致性：始终使用 MAUI 抽象处理文件路径和存储。
3. 抽象：将存储逻辑封装在服务和接口中。
4. 性能：每个应用生命周期使用单一 SQLite 连接。
5. 安全：绝不在 Preferences 中存储密钥或令牌。

支持的存储机制

• SQLite（原生或 EF Core）
• Preferences
• SecureStorage
• 文件系统访问
• 基于 JSON 的本地存储

推荐的文件夹结构

├─ Services
│  └─ Data
│     ├─ Interfaces
│     └─ Models
└─ Database

/Services/Data /Services/Data/Interfaces /Services/Data/Models /Database

智能体使用指南

• 生成数据模型时，将其放在 /Services/Data/Models。
• 生成数据库访问时，创建：
  • IDatabaseService
  • DatabaseService
  • AppDbContext（如果使用 EF Core）
• 当被要求“存储用户设置”时，使用 Preferences。
• 当被要求“存储敏感数据”时，使用 SecureStorage。
• 当被要求“保存文件”时，使用 FileSystem.AppDataDirectory。

范围之外

• 认证令牌存储（由 maui-authentication 覆盖）
• UI 逻辑
• 云同步或远程数据库