中文 | English | 日本語 | Tiếng Việt | Русский | 黑羽川
Monica 是一个聚合 Bitwarden 与 KeePass 的本地密码库（Local Vault）。
它以本地存储优先为核心，帮助你在 Android 设备上统一管理账号密码、2FA、私密笔记与敏感附件。
官网入口: https://monica-pass.github.io/MonicaDocs/
用户先看
Monica 适合谁
- 需要本地优先密码管理，不希望账号数据托管到第三方云。
- 既使用 Bitwarden，也维护 KeePass (
.kdbx) 数据。
- 需要在 Android 应用和手机浏览器中使用自动填充。
你能得到什么
- 本地加密保险箱: 登录信息、银行卡、身份信息、私密笔记、附件。
- 双生态聚合: Android 端包含 Bitwarden API/同步能力与 KeePass (
.kdbx) 读写能力。
- 可选同步与备份: WebDAV 备份及远端库同步、OneDrive 备份与文件访问，以及配对后的局域网传输。
- 内置 TOTP: 在同一应用内完成密码与二次验证码管理。
MDBX 本地数据库格式
跨端开发与 AI 适配请先遵守 Monica MDBX 存储兼容契约，其中区分了核心格式、业务类型、未知字段保留和同步验收要求。
MDBX 是 Monica 正在推进的本地优先加密 vault 格式。它不是简单的密码表，而是围绕嵌套文件夹、附件、提交历史、冲突检测、tombstone 删除链路、快照恢复和 Tiga 安全模式设计的数据库格式。
如果你要在其他客户端接入 MDBX，请先读 MDBX workspace 说明 和 MDBX 客户端接入指南。完整格式规范在 mdbx/docs。
快速安装
- 从 Releases 下载最新 APK。
- 在 Android 8.0+ 设备安装并初始化主密码。
已知限制
- 由于系统兼容性原因，Monica for Android 目前在部分小米 HyperOS 设备上无法创建通行密钥（Passkey）。可以尝试酷 U 提供的解决模块：HyperMonica。
Android 版本重点
核心功能
- 本地 Vault: 所有核心凭据本地加密存储。
- 聚合导入: 支持 KeePass 数据迁移与 Bitwarden 兼容接入。
- 智能检索: 按标题、域名、标签快速定位凭据。
- 生物识别解锁: 使用系统级生物识别能力提升安全与可用性。
- TOTP 管理: 统一存储并生成动态验证码。
实现说明
- UI 层: Jetpack Compose + Material 3 Expressive + Navigation Compose。
- 数据层: Room（
PasswordDatabase）+ DAO + Repository，并接入原生 KDBX 与 MDBX 存储。
- 并发模型: Kotlin Coroutines + Flow。
- 依赖装配: 通过构造函数、工厂及应用入口显式传递依赖。
- 安全能力: Android Keystore、EncryptedSharedPreferences、BiometricPrompt。
- 同步任务: WorkManager（
AutoBackupWorker）用于自动 WebDAV 备份。
- 协议与集成: Retrofit + OkHttp（Bitwarden API）、kotpass（KeePass）、sardine-android（WebDAV）。
安全模型
- 本地敏感字段: 由
SecurityManager 使用 AES-256-GCM 认证加密。
- 本地主密码校验及 MDK 密码包装密钥：PBKDF2-HMAC-SHA256，1.0.327 新写入使用 600,000 次迭代。历史 100,000 次 PBKDF2 和 Argon2id 数据保留兼容，成功验证原密码后迁移，保留原 MDK 与记录密文。
- 便携加密备份：兼容 V1 使用 PBKDF2-HMAC-SHA256／100,000 次，增强 V2 使用 600,000 次；备份格式与本地主密码保护分别处理。
- 主密码找回：安全问题答案加本次系统锁屏凭据确认（Android 11+），一次性授权在取消、后台或锁定时撤销。新答案采用随机盐与 600,000 次 PBKDF2-HMAC-SHA256，旧 SHA-256 答案和备份保留兼容；尝试次数跨页面和进程重启保留。
- Bitwarden、KeePass 与 MDBX: 使用各自格式和配置规定的加密及密钥派生方式。
- 本地保护: 主密码哈希与安全配置由本地安全组件管理。
- 网络边界: 应用声明网络权限，用于 Bitwarden、WebDAV、OneDrive、局域网传输和更新检查等功能。
赞助支持
如果 Monica 对你有帮助，欢迎支持持续开发与安全投入。
你的支持将优先用于:
- 安全审计与加密方案强化。
- Android 体验优化与稳定性改进。
- 跨端功能统一与文档维护。
爱发电鸣谢
感谢每一位支持 Monica 的朋友！
本月打赏金额：¥5.00
开发者信息
项目分层（代码现状）
takagi/ru/monica/ui: Compose 页面与组件。takagi/ru/monica/data: Room 实体、DAO、数据库迁移。takagi/ru/monica/repository: 数据访问封装。takagi/ru/monica/security: 加密、密钥与鉴权相关实现。takagi/ru/monica/bitwarden: API、加密、映射、同步与视图模型。takagi/ru/monica/autofill_ng: 自动填充服务与流程。takagi/ru/monica/passkey: Android 14+ Credential Provider 相关实现。takagi/ru/monica/workers: 后台任务（如自动 WebDAV 备份）。mdbx: Monica MDBX 本地数据库格式的 Rust workspace 与客户端接入文档。
主要组件（源码可验证）
- Android UI: Jetpack Compose, Material 3 Expressive, Navigation Compose。
- 数据与状态: Room, DataStore Preferences, ViewModel。
- 安全: Android Keystore, EncryptedSharedPreferences, BiometricPrompt。
- 网络与协议: Retrofit, OkHttp, Kotlinx Serialization。
- 同步与生态: sardine-android(WebDAV), kotpass(KeePass), Bitwarden API 对接。
- 异步与任务: Coroutines, Flow, WorkManager。
- 其他能力: CameraX + ZXing（二维码扫描）, Credentials API（Passkey）。
构建与贡献
下表对应当前开发源码，不代表这些版本已包含在最新发布的 APK 中。
| 组件 | 当前源码配置 |
|---|
| 构建 JDK / Java 与 Kotlin 字节码 | JDK 17 / target 11 |
| Android SDK | compile 37 · target 34 · minimum 26（Android 8.0） |
| Gradle Wrapper / Android Gradle Plugin | 9.7.0 / 9.3.1 |
| Kotlin / KSP | 2.4.21 / 2.3.13 |
| Compose BOM | 2026.09.00 |
| Material 3 Expressive | 1.5.0-rc01，独立固定，不随 BOM |
| Room / Navigation Compose | 2.8.5 / 2.10.2 |
| Lifecycle Runtime 与 ViewModel | 2.11.0 |
| DataStore / WorkManager / CameraX | 1.3.0 / 2.12.0 / 1.6.2 |
使用与当前 AGP 兼容的 Android Studio，或直接运行 Gradle Wrapper。构建前准备 SDK Platform 37、Android NDK、Rust 和 cargo-ndk；JNI 库会从源码构建。
版本以依赖目录、Gradle Wrapper和应用构建配置为准。完整环境准备见 Android 构建说明。
This is the beginning of the README. Read the rest at the original. Read the full README ↗
