忆伴 Memora

本地优先的 AI 个人记忆助手
记住你忘掉的事，数据永远在你手里。

功能 · 截图 · 开始 · 架构 · 贡献 · 许可

---

关于

忆伴（Memora）是一款本地优先的 AI 个人记忆助手。所有数据使用 SQLCipher 加密存储在设备本地，不依赖任何云端服务。

适用于：

• 容易遗忘物品位置、待办事项的用户
• 需要记录用药、就诊等提醒的用户
• 希望快速捕捉生活信息并随时检索的用户

功能特性

功能	说明
快速记忆录入	文字输入，自动解析为结构化记忆（标题、时间、人物、物品、地点、标签）
本地记忆库	浏览、搜索（FTS5 全文检索）、编辑、删除，支持中文分词
智能问答助手	自然语言提问，基于本地记忆给出有据可查的回答，附带来源卡片
本地提醒	关联记忆的一次性提醒，系统通知调度，支持小憩与取消
物品位置追踪	自动登记物品位置，记录移动历史，随时查询"钥匙在哪"
每日记忆训练	基于真实记忆自动生成训练卡片，简单间隔重复巩固记忆
应用锁	生物识别 + 系统密码保护，数据库解锁前不可访问
加密备份	一键导出加密备份文件，支持恢复与完整性校验

截图预览

        

     

快速开始

环境要求

• Flutter >= 3.44.0（stable channel）
• Dart >= 3.12.0
• Xcode（iOS 开发）
• iOS 15.0+（基准机型：iPhone 13 Pro Max）

安装运行

# 克隆仓库
git clone https://github.com/lijianxue/memora.git
cd memora

# 安装依赖
flutter pub get

# 生成 Drift 数据库代码
dart run build_runner build

# 运行
flutter run

或使用一键脚本：

chmod +x scripts/run_local.sh
./scripts/run_local.sh

运行测试

# 单元测试 & Widget 测试
flutter test

# 集成测试（需要模拟器/真机）
flutter test integration_test/

技术架构

lib/
  app/          路由（GoRouter）、主题（ThemeProfile）、启动流程
  core/         AI 能力网关、全局常量
  features/     功能模块（垂直切片）
    assistant/  智能问答
    backup/     加密备份
    item/       物品位置
    memory/     记忆录入与管理
    reminder/   本地提醒
    settings/   设置
    training/   记忆训练
  data/         Drift 数据库、平台适配器、仓库实现

层	技术选型
框架	Flutter 3.44 / Dart 3.12
状态管理	Riverpod
路由	GoRouter（底部四Tab导航）
数据库	Drift + SQLCipher + FTS5（中文全文检索）
加密	SQLCipher（数据库）+ flutter_secure_storage（密钥管理）
通知	flutter_local_notifications
生物识别	local_auth

设计理念：本地优先、离线可用、AI 可替换可降级。v1 使用规则引擎实现智能问答，零外部依赖，无云端调用。

项目结构

memora/
  lib/                  Dart 源码
  test/                 单元测试 & Widget 测试
  integration_test/     端到端集成测试
  docs/                 产品文档、架构决策、设计稿
  assets/               品牌资源
  scripts/              本地开发脚本
  ios/                  iOS 平台配置

贡献指南

欢迎贡献！请参阅 CONTRIBUTING.md 了解开发环境搭建、代码规范和 PR 流程。

更新日志

详见 CHANGELOG.md。

License

MIT © lijianxue