Monica 本地密码库

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 存储兼容契约，其中区分了核心格式、业务类型、未知字段保留和同步验收要求。 MDBX 是 Monica 正在推进的本地优先加密 vault 格式。它不是简单的密码表，而是围绕嵌套文件夹、附件、提交历史、冲突检测、tombstone 删除链路、快照恢复和 Tiga 安全模式设计的数据库格式。

如果你要在其他客户端接入 MDBX，请先读 MDBX workspace 说明 和 MDBX 客户端接入指南。完整格式规范在 mdbx/docs。

快速安装

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

已知限制

• 由于系统兼容性原因，Monica for Android 目前在部分小米 HyperOS 设备上无法创建通行密钥（Passkey）。可以尝试酷 U 提供的解决模块：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 对你有帮助，欢迎支持持续开发与安全投入。

你的支持将优先用于:

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

爱发电鸣谢

感谢每一位支持 Monica 的朋友！

本月打赏金额：¥36.66

---

开发者信息

项目分层（代码现状）

• 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 - 在国内托管 Monica，帮助中国大陆用户更快访问项目。
• Keyguard - Android 端密码管理器的交互设计与体验参考。
• PixelPlayer - Android 端密码库滚动条样式参考。
• Bitwarden - 开源密码管理生态、Vault 模型与同步能力的重要参考。
• KeePass - 本地密码库理念与 .kdbx 生态兼容的重要基础。
• Stratum Auth - 身份验证器体验、图标资源与相关兼容支持参考。
• Steam Desktop Authenticator - Steam maFile 格式、Steam Guard 与交易确认兼容性的参考。
• steamguard-cli - Steam Guard 登录、令牌迁移与确认协议实现的参考。
• AnotherVaporAuth - Steam 移动验证器、登录批准与确认流程体验的参考。

---

友情链接

• Linux.do
• TinadecOffice

---

Star History

---

贡献者

---

社区与支持

• Telegram 群组：加入 Monica 社区

---

许可证

Copyright (c) 2025 JoyinJoester

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

第三方图标标注

• 本项目本地打包了来自 Stratum Auth app 的图标资源（版本 v1.4.0，目录 icons / extraicons，GPL-3.0）。
• 银行卡/支付卡图标来源：本地目录 SVG Credit Card & Payment Icons（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 (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 才能启动副用户的辅助服务；实际更改仍限定于调用用户。

Monica Android

中文

• 修复部分笔记内容显示为 MDK|… 乱码的问题。附近设备同步接收的笔记，以及从数据库导出包恢复的笔记，曾以加密形式写入本地，笔记列表与详情直接显示了密文。现在接收和恢复的笔记保持笔记原有的存储格式；解锁后会自动将已受影响的笔记恢复为原文，包括已在编辑器中再次保存过的笔记，不改变修改时间和同步归属。

• 修复 HOTP 点击“生成下一个”后跳到列表最前面的问题。验证码顺序保留收藏优先级和手动排序，默认顺序不再随计数器更新而变化；计数器与同步修改时间仍正常更新。

• 修复 HOTP“生成下一个”按钮撑高磁贴的问题。所有验证码磁贴保留原有紧凑尺寸，生成按钮复用次码位置，减少内边距并适配文字大小；放大字号仍完整显示验证码和按钮，生成与复制互不误触。

• 卡包多选列表中的卡叠新增独立展开／收起按钮；收起后可长按拖动整组调整卡叠顺序，重新进入页面仍保留排序。展开与收起保留逐张选择和选择计数，排序不改变卡叠成员顺序或封面。

• 优化密码列表加载与滚动：减少滚动期间的页面重组，复用分类数据订阅，并避免相同数据快照重复生成脱敏列表；保留原有回顶、快速定位、返回位置、搜索、分组和数据处理规则。

• 新增独立 Root 授权，可替代 Shizuku 使用增强无障碍恢复和设置默认密码管理器；Root 通道无需安装或运行 Shizuku。

• 授权方式可切换，提供授权状态、重新授权与停用入口，命令失败后仍可停用 Root。只有主动确认后才请求 Root；无 Root、拒绝或超时会提示，不会自动切换授权方式。停用或切换方式后，排队请求和迟到的授权结果不会重新启用 Root。

• 无障碍恢复仍需手动启用后台保护和增强恢复，仅重连已开启的 Monica 服务；默认密码管理器保留配置备份、写入校验和恢复功能，仍需 Android 14 或更新版本。

English

• Fixed some notes showing garbled MDK|… text. Notes received through nearby device sync, or restored from a database export archive, were stored locally in encrypted form, so the note list and details displayed the ciphertext. Received and restored notes now keep the regular note storage format, and affected notes, including ones saved again from the editor, are restored to their original text after unlocking without changing modification times or sync ownership.

• Fixed HOTP moving to the front of the list after Generate Next. Authenticator ordering retains favorites and manual ranks, with a stable default order across counter updates. Counter values and modification timestamps still update normally for synchronization.

• Fixed the HOTP Generate Next button increasing tile height. All authenticator tiles retain their compact size, with the action using the next-code footer, reduced padding and text that fits the available space. Codes and labels remain complete at larger font sizes, with separate generation and copy actions.

• Added separate expand/collapse controls to card stacks in wallet multiselect. Long-press a collapsed stack to reorder stacks, with the order retained when reopening the wallet. Expansion preserves individual selections and counts; dragging keeps stack membership, internal card order and covers intact.

• Optimized password-list loading and scrolling by reducing page recompositions during scrolling, sharing category subscriptions, and avoiding repeated metadata copies for unchanged snapshots. Existing back-to-top, fast-scroll, position restoration, search, grouping, and data-handling behavior are preserved.

• Added direct Root authorization as an alternative to Shizuku for enhanced accessibility recovery and setting the default password manager. The Root backend works without Shizuku installed or running.

• Choose the authorization method, view its status, authorize again, or disable Root, including after a failed command. Root is requested only after explicit confirmation; unavailable access, denial, and timeouts are reported without switching backends automatically. Disabling Root or switching backends invalidates queued requests and late authorization results.

• Recovery still requires background protection and enhanced recovery to be enabled, and only reconnects an already enabled Monica service. Default manager changes retain configuration backups, verification, and restoration, and still require Android 14 or later.

• Make Monica Great Again！