Monica 本地密码库

中文 | English | 日本語 | Tiếng Việt

Monica 是一个聚合 Bitwarden 与 KeePass 的本地密码库（Local Vault）。 它以本地存储优先为核心，帮助你在 Android 与浏览器端统一管理账号密码、2FA、私密笔记与敏感附件。

官网入口: https://joyinjoester.github.io/Monica/

Monica for Windows 已归档。历史代码见: Monica-for-Windows

---

用户先看

Monica 适合谁

• 需要本地优先密码管理，不希望账号数据托管到第三方云。
• 既使用 Bitwarden，也维护 KeePass (.kdbx) 数据。
• 需要 Android 日常使用，同时在浏览器里完成自动填充。

你能得到什么

• 本地加密保险箱: 登录信息、银行卡、身份信息、私密笔记、附件。
• 双生态聚合: Android 端包含 Bitwarden API/同步能力与 KeePass (.kdbx) 读写能力。
• 可选同步与备份: 通过自有 WebDAV 基础设施实现跨设备数据流转。
• 内置 TOTP: 在同一应用内完成密码与二次验证码管理。

快速安装

Android:

1. 从 Releases 下载最新 APK。
2. 在 Android 8.0+ 设备安装并初始化主密码。

浏览器插件 (Chrome / Edge):

1. 在 Monica for Browser 目录构建插件。
2. 打开 chrome://extensions/ 并启用开发者模式。
3. 选择“加载已解压的扩展程序”，导入 dist 目录。

---

Android 版本重点

核心功能

• 本地 Vault: 所有核心凭据本地加密存储。
• 聚合导入: 支持 KeePass 数据迁移与 Bitwarden 兼容接入。
• 智能检索: 按标题、域名、标签快速定位凭据。
• 生物识别解锁: 使用系统级生物识别能力提升安全与可用性。
• TOTP 管理: 统一存储并生成动态验证码。

实现说明（专业版）

• UI 层: Jetpack Compose + Material 3 + Navigation Compose。
• 数据层: Room（PasswordDatabase）+ DAO + Repository。
• 并发模型: Kotlin Coroutines + Flow。
• 依赖注入: Koin（应用启动于 MonicaApplication）。
• 安全能力: Android Keystore、EncryptedSharedPreferences、BiometricPrompt。
• 同步任务: WorkManager（AutoBackupWorker）用于自动 WebDAV 备份。
• 协议与集成: Retrofit + OkHttp（Bitwarden API）、kotpass（KeePass）、sardine-android（WebDAV）。

安全模型

• 加密算法: AES-256-GCM（认证加密）。
• 密钥派生: PBKDF2-HMAC-SHA256（高迭代参数）。
• 本地保护: 主密码哈希与安全配置由本地安全组件管理。
• 网络边界: 应用声明网络权限，主要用于 Bitwarden 联动与 WebDAV 备份/同步等在线能力。

---

赞助支持

如果 Monica 对你有帮助，欢迎支持持续开发与安全投入。

_{微信 / 支付宝扫码支持}

你的支持将优先用于:

• 安全审计与加密方案强化。
• Android 体验优化与稳定性改进。
• 跨端功能统一与文档维护。

---

开发者信息

项目分层（代码现状）

• 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: 自动填充服务与流程。
• takagi/ru/monica/passkey: Android 14+ Credential Provider 相关实现。
• takagi/ru/monica/workers: 后台任务（如自动 WebDAV 备份）。

当前已使用的成熟组件（仓库可验证）

• Android UI: Jetpack Compose, Material 3, 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 + ML Kit（二维码扫描）, Credentials API（Passkey）。

构建与贡献

• Android Studio: 最新稳定版。
• JDK: 17+。
• Android 配置: minSdk 26，targetSdk 34（见 Monica for Android/app/build.gradle）。
• 浏览器端技术栈: React + TypeScript + Vite（见 Monica for Browser/package.json）。
• 欢迎通过 Issue / PR 参与功能和安全改进。

---

许可证

Copyright (c) 2025 JoyinJoester

Monica 基于 GNU General Public License v3.0 开源发布。

第三方图标标注

• 本项目本地打包了来自 Stratum Auth app 的图标资源（版本 v1.4.0，目录 icons / extraicons，GPL-3.0）。
• 品牌名称与 Logo 的商标权归各自权利人所有。