数据库

IriX 的存储分两层：本地持久化使用 SQLite，远程数据库操作统一走 Rust。

本地持久化：SQLite

• 基于 sqflite_common_ffi，由 DatabaseManager 统一管理
• 所有设置统一存 settings 表，无 SharedPreferences
• 各领域数据有专属 store：
  • instance_store.dart（实例）
  • node_store.dart（节点）
  • trash_store.dart（回收站）
  • ai_settings.dart（AI 设置）

远程数据库：db_client

数据库	驱动
MySQL / MariaDB	纯 Rust 驱动
PostgreSQL	纯 Rust 驱动
Redis	纯 Rust 驱动

• 统一入口 db_request：连接测试、浏览、查询、管理
• 无 OpenSSL 依赖，部署更简单
• Dart 侧唯一业务入口：remote_db_service.dart（经 DbClientFfi 调用 xmc_db_client 动态库）

硬性约定

危险

所有远程数据库操作统一走 Rust，通过 lib/services/db_client_ffi.dart（DbClientFfi）调用 xmc_db_client 的 db_request 入口；禁止在 Dart 侧新增数据库客户端依赖。

调用链

业务代码
  │
  ▼
remote_db_service.dart        （唯一业务入口）
  │
  ▼
DbClientFfi（db_client_ffi.dart）
  │  FFI
  ▼
xmc_db_client 动态库
  │  纯 Rust 驱动
  ▼
MySQL / PostgreSQL / Redis