Monica 本地密码库

**中文** | [English](README_EN.md) | [日本語](README_JA.md) | [Tiếng Việt](README_VI.md) | [Русский](README_RU.md) | [黑羽川](彩蛋语言备份/README_Nya.md) Monica App Icon

聚合 Bitwarden 与 KeePass 的本地优先密码库

Android · Local Vault · TOTP · WebDAV Backup

[![Release](https://img.shields.io/github/v/release/Monica-Pass/Monica-for-Android?style=flat-square)](https://github.com/Monica-Pass/Monica-for-Android/releases) [![Downloads](https://img.shields.io/github/downloads/Monica-Pass/Monica-for-Android/total?style=flat-square)](https://github.com/Monica-Pass/Monica-for-Android/releases) [![Last Commit](https://img.shields.io/github/last-commit/Monica-Pass/Monica-for-Android?style=flat-square)](https://github.com/Monica-Pass/Monica-for-Android/commits) [![QQ群](https://img.shields.io/badge/QQ群-1087865010-12B7F5?style=flat-square&logo=tencentqq&logoColor=white)](https://qm.qq.com/q/2vTdTkHV3u) [![Telegram](https://img.shields.io/badge/Telegram-Monica%20Community-26A5E4?style=flat-square&logo=telegram&logoColor=white)](https://t.me/+IZUDLL-vWOA1Y2U1) [![爱发电](https://img.shields.io/badge/爱发电-JoyinJoester-ea4aaa?style=flat-square)](https://afdian.com/a/JoyinJoester) [![Ko-fi](https://img.shields.io/badge/Ko--fi-joyinjoester-29ABE0?style=flat-square&logo=kofi&logoColor=white)](https://ko-fi.com/joyinjoester) [![PayPal](https://img.shields.io/badge/PayPal-Support%20Monica-FFD140?style=flat-square&logo=paypal&logoColor=00457C)](https://www.paypal.com/ncp/payment/BHSYWK73CA8FW) [![Liberapay · EUR](https://img.shields.io/badge/Liberapay-EUR-F6C915?style=flat-square&logo=liberapay&logoColor=black)](https://liberapay.com/JoyinJoester)
JoyinJoester%2FMonica | Trendshift
Monica 是一个聚合 **Bitwarden** 与 **KeePass** 的本地密码库（Local Vault）。 它以本地存储优先为核心，帮助你在 Android 设备上统一管理账号密码、2FA、私密笔记与敏感附件。 官网入口: https://monica-pass.github.io/MonicaDocs/ --- ## 用户先看 ### Monica 适合谁 - 需要本地优先密码管理，不希望账号数据托管到第三方云。 - 既使用 Bitwarden，也维护 KeePass (`.kdbx`) 数据。 - 需要在 Android 应用和手机浏览器中使用自动填充。 ### 你能得到什么 - 本地加密保险箱: 登录信息、银行卡、身份信息、私密笔记、附件。 - 双生态聚合: Android 端包含 Bitwarden API/同步能力与 KeePass (`.kdbx`) 读写能力。 - 可选同步与备份: 通过自有 WebDAV 基础设施实现跨设备数据流转。 - 内置 TOTP: 在同一应用内完成密码与二次验证码管理。 ### MDBX 本地数据库格式 跨端开发与 AI 适配请先遵守 [Monica MDBX 存储兼容契约](docs/storage/MDBX-CROSS-CLIENT-CONTRACT.zh-CN.md)，其中区分了核心格式、业务类型、未知字段保留和同步验收要求。 MDBX 是 Monica 正在推进的本地优先加密 vault 格式。它不是简单的密码表，而是围绕嵌套文件夹、附件、提交历史、冲突检测、tombstone 删除链路、快照恢复和 Tiga 安全模式设计的数据库格式。 如果你要在其他客户端接入 MDBX，请先读 [MDBX workspace 说明](mdbx/README.md) 和 [MDBX 客户端接入指南](mdbx/CLIENT_INTEGRATION_GUIDE.zh-CN.md)。完整格式规范在 [mdbx/docs](mdbx/docs/README.zh-CN.md)。 ### 快速安装 1. 从 [Releases](https://github.com/Monica-Pass/Monica-for-Android/releases) 下载最新 APK。 2. 在 Android 8.0+ 设备安装并初始化主密码。 ### 已知限制 - 由于系统兼容性原因，Monica for Android 目前在部分小米 HyperOS 设备上无法创建通行密钥（Passkey）。可以尝试酷 U 提供的解决模块：[HyperMonica](https://github.com/Wuming155/HyperMonica)。 --- ## 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 对你有帮助，欢迎支持持续开发与安全投入。
Support Monica
微信 / 支付宝扫码支持

通过 PayPal 支持 Monica Liberapay · EUR (€)

你的支持将优先用于: - 安全审计与加密方案强化。 - Android 体验优化与稳定性改进。 - 跨端功能统一与文档维护。 ### 爱发电鸣谢 感谢每一位支持 Monica 的朋友！ **本月打赏金额：¥36.66**
1503384107
1503384107
¥180.00		半夏微凉
半夏微凉
¥50.00		名字太长会有傻子跟着念吗
名字太长会有傻子跟着念吗
¥40.00		一生
一生
¥30.00		LINGYU
LINGYU
¥20.00		洛初
洛初
¥15.00
Memory15
Memory15
¥10.00		爱发电用户_70c34
爱发电用户_70c34
¥10.00		NovaX
NovaX
¥10.00		爱发电用户_rywF
爱发电用户_rywF
¥10.00		御坂07833号
御坂07833号
¥10.00		PVPWHGAME
PVPWHGAME
¥10.00
爱发电用户_ff493
爱发电用户_ff493
¥10.00		爱发电用户_a991e
爱发电用户_a991e
¥10.00		爱发电用户_U9rq
爱发电用户_U9rq
¥10.00		不二
不二
¥10.00		爱发电用户_edaa4
爱发电用户_edaa4
¥10.00		爱发电用户_VYtU
爱发电用户_VYtU
¥6.66
爱发电用户_e928c
爱发电用户_e928c
¥6.00		Hin
Hin
¥5.00		爱发电用户_f85f8
爱发电用户_f85f8
¥5.00		Alans1gn
Alans1gn
¥5.00		Eamon
Eamon
¥5.00		哇哦
哇哦
¥5.00
爱发电用户_xj7t
爱发电用户_xj7t
¥5.00		Kiana Kaslana
Kiana Kaslana
¥5.00		海之南
海之南
¥5.00		重逢海风
重逢海风
¥5.00		yagaojun
yagaojun
¥5.00		可恶
可恶
¥5.00
爱发电用户_97324
爱发电用户_97324
¥5.00		Jursin
Jursin
¥5.00		Memories white
Memories white
¥5.00		爱发电用户_hAKP
爱发电用户_hAKP
¥5.00		森王
森王
¥5.00		爱发电用户_43357
爱发电用户_43357
¥5.00
坏名字qwq
坏名字qwq
¥5.00		Draking
Draking
¥5.00		lingtsuki
lingtsuki
¥5.00		airem
airem
¥5.00		Janson
Janson
¥5.00		爱发电用户_0e739
爱发电用户_0e739
¥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`: 自动填充服务与流程。 - `takagi/ru/monica/passkey`: Android 14+ Credential Provider 相关实现。 - `takagi/ru/monica/workers`: 后台任务（如自动 WebDAV 备份）。 - `mdbx`: Monica MDBX 本地数据库格式的 Rust workspace 与客户端接入文档。 ### 当前已使用的成熟组件（仓库可验证） - 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 配置: `compileSdk 35`，`targetSdk 34`，`minSdk 26`（见 `Monica for Android/app/build.gradle`）。 - Android 构建基线: AGP `8.6.0`，Kotlin `2.0.21`，Compose BOM `2026.03.00`（Material3 跟随 BOM）。 - 版本信息以 `Monica for Android/gradle/libs.versions.toml` 与 `Monica for Android/app/build.gradle` 为准。 - 欢迎通过 Issue / PR 参与功能和安全改进。 --- ## 致谢 Monica 的设计、兼容性适配与部分功能方向，受到了以下优秀开源项目和软件的启发与帮助： - [AtomGit](https://atomgit.com/Monica-Pass/Monica) - 在国内托管 Monica，帮助中国大陆用户更快访问项目。 - [Keyguard](https://github.com/AChep/keyguard-app) - Android 端密码管理器的交互设计与体验参考。 - [PixelPlayer](https://github.com/PixelPlayerHQ/PixelPlayer) - Android 端密码库滚动条样式参考。 - [Bitwarden](https://bitwarden.com/) - 开源密码管理生态、Vault 模型与同步能力的重要参考。 - [KeePass](https://keepass.info/) - 本地密码库理念与 `.kdbx` 生态兼容的重要基础。 - [Stratum Auth](https://github.com/stratumauth/app) - 身份验证器体验、图标资源与相关兼容支持参考。 - [Steam Desktop Authenticator](https://github.com/Jessecar96/SteamDesktopAuthenticator) - Steam maFile 格式、Steam Guard 与交易确认兼容性的参考。 - [steamguard-cli](https://github.com/dyc3/steamguard-cli) - Steam Guard 登录、令牌迁移与确认协议实现的参考。 - [AnotherVaporAuth](https://github.com/freefrank/AnotherVaporAuth) - Steam 移动验证器、登录批准与确认流程体验的参考。 --- ## 友情链接 - [Linux.do](https://linux.do) - [TinadecOffice](https://github.com/Tinadec/TinadecOffice) --- ## Star History [![Star History Chart](https://api.star-history.com/svg?repos=Monica-Pass/Monica-for-Android&type=Date)](https://star-history.com/#Monica-Pass/Monica-for-Android&Date) --- ## 贡献者 ![贡献者](.github/assets/contributor-flag.svg) --- ## 社区与支持 - Telegram 群组：[加入 Monica 社区](https://t.me/+IZUDLL-vWOA1Y2U1) --- ## 许可证 Copyright (c) 2025 JoyinJoester Monica 基于 [GNU General Public License v3.0](LICENSE) 开源发布。 ## 第三方图标标注 - 本项目本地打包了来自 [Stratum Auth app](https://github.com/stratumauth/app) 的图标资源（版本 [v1.4.0](https://github.com/stratumauth/app/releases/tag/v1.4.0)，目录 [icons](https://github.com/stratumauth/app/tree/v1.4.0/icons) / [extraicons](https://github.com/stratumauth/app/tree/v1.4.0/extraicons)，GPL-3.0）。 - 银行卡/支付卡图标来源：本地目录 [SVG Credit Card & Payment Icons](svg-credit-card-payment-icons-main)（Apache-2.0）。 - 品牌名称与 Logo 的商标权归各自权利人所有。 ## F-Droid contact For F-Droid metadata or packaging issues, contact: joyin8888@foxmail.com ### Shizuku default password manager / 默认密码管理器 The Android 14+ helper in developer and autofill settings adapts the secure-settings transaction logic from [cr-zhichen/password-manager-switch](https://github.com/cr-zhichen/password-manager-switch) (MIT, copyright 2026 cr-zhichen). It targets the installed Monica edition for the current Android user, verifies writes, and supports restoring the previous configuration. The original MIT notice is included in `app/src/main/assets/licenses/password-manager-switch.txt`. 开发者设置与自动填充设置中的 Shizuku 入口参考上述原项目（MIT），用于 HyperOS 隐藏第三方密码管理器设置入口的情况。仅设置当前 Monica 版本，不导入原项目的自更新等功能；系统设置读回成功不代表所有 HyperOS 通行密钥流程均已验证。 On multi-user devices, Shizuku may also require Monica to be installed for the owner user before starting the helper for a secondary user. Only the calling user settings are changed. 多用户设备上，Shizuku 可能需要主用户也安装 Monica 才能启动副用户的辅助服务；实际更改仍限定于调用用户。