KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #typescript #codex #cli #claude-code #mcp #rust #deepseek-harness #ai-agent

Monica

★ 921 Open GitHub ↗

Monica Pass，Password Management, 2FA Generator

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Monica 本地密码库</h1>

聚合 Bitwarden 与 KeePass 的本地优先密码库
Android / Browser · Local Vault · TOTP · WebDAV Backup

友情链接：
	<a href="https://linux.do" title="Linux.do">
		<img src="https://www.google.com/s2/favicons?domain=linux.do&sz=64" alt="Linux.do" width="22" />
		Linux.do
	</a>

[![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)
 
<a href="https://trendshift.io/repositories/27059" target="_blank"><img src="https://trendshift.io/api/badge/repositories/27059" alt="JoyinJoester%2FMonica | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

</div>

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

### 重要的事：
Monica Pass的开发者就是一个大啥比，现在他为了偷懒连代码都很少review了，还在群里说“反正ai写的比我好，我还不如ai呢”，大家不要相信这种人开发的软件，一定要好好的做好备份，数据隐私无价！不要把所有数据都放到这一个软件里面

官网入口: https://monica-pass.github.io/MonicaDocs/

> Monica for Windows 已归档。历史代码见: [Monica-for-Windows](https://github.com/JoyinJoester/Monica-for-Windows)
>
> Monica for Browser 已归档。新的 Monica Extension 正在重写开发中，敬请期待。
>
> 由于目前项目主要由我一人维护，时间与精力都比较有限，因此 Monica for Wear 暂时无法保持持续更新。现阶段我会将主要重心放在 Monica for Android 的功能完善、体验优化与稳定性维护上，也感谢大家的理解与支持。

---

## 用户先看

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

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

### MDBX 本地数据库格式
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)。

### 快速安装

Android:
1. 从 [Releases](https://github.com/Monica-Pass/Monica-for-Android/releases) 下载最新 APK。
2. 在 Android 8.0+ 设备安装并初始化主密码。

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

### 已知限制
- 由于系统兼容性原因，Monica for Android 目前在部分小米 HyperOS 设备上无法创建通行密钥（Passkey）。

---

## 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 对你有帮助，欢迎支持持续开发与安全投入。

<div align="center">
<img src="image/support_author.jpg" alt="Support Monica" width="320"/>
 
微信 / 支付宝扫码支持
</div>

你的支持将优先用于:
- 安全审计与加密方案强化。
- Android 体验优化与稳定性改进。
- 跨端功能统一与文档维护。

### 爱发电鸣谢

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

**本月打赏金额：¥10.00**

<table>
<tbody>
<tr><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="1503384107"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-blue.png" alt="1503384107" width="56" height="56" /></a> 1503384107 ¥180.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="名字太长会有傻子跟着念吗"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-orange.png" alt="名字太长会有傻子跟着念吗" width="56" height="56" /></a> 名字太长会有傻子跟着念吗 ¥20.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="洛初"><img src="https://pic1.afdiancdn.com/user/user_upload_osl/a3a8b7f7e037e52e0ce6a9251964a78c_w132_h132_s7.jpeg" alt="洛初" width="56" height="56" /></a> 洛初 ¥15.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="御坂07833号"><img src="https://pic1.afdiancdn.com/user/e40f486c7bb911ee8ca25254001e7c00/avatar/f4c8da76d80fd5a7cd276f6b5d7a6a54_w300_h300_s61.jpeg" alt="御坂07833号" width="56" height="56" /></a> 御坂07833号 ¥10.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_vR9n"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png" alt="爱发电用户_vR9n" width="56" height="56" /></a> 爱发电用户_vR9n ¥10.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_ff493"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_ff493" width="56" height="56" /></a> 爱发电用户_ff493 ¥10.00</td></tr>
<tr><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_a991e"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_a991e" width="56" height="56" /></a> 爱发电用户_a991e ¥10.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_U9rq"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-blue.png" alt="爱发电用户_U9rq" width="56" height="56" /></a> 爱发电用户_U9rq ¥10.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_d4f2c"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_d4f2c" width="56" height="56" /></a> 爱发电用户_d4f2c ¥10.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_edaa4"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_edaa4" width="56" height="56" /></a> 爱发电用户_edaa4 ¥10.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="海之南"><img src="https://pic1.afdiancdn.com/user/8a041df8860411edb23752540025c377/avatar/dad5974d3fca49d1aca5835d6818ea98_w2064_h2016_s3434.png" alt="海之南" width="56" height="56" /></a> 海之南 ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="重逢海风"><img src="https://pic1.afdiancdn.com/user/886243ac044b11edad3752540025c377/avatar/f50842fe3af48d89f4dfe2b95e2a4c66_w690_h647_s46.jpg" alt="重逢海风" width="56" height="56" /></a> 重逢海风 ¥5.00</td></tr>
<tr><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="yagaojun"><img src="https://pic1.afdiancdn.com/user/b3c6a738350e11ed8f3752540025c377/avatar/2322f1ee3d40356f3d97a4e93d0b4bb2_w1080_h1080_s91.jpeg" alt="yagaojun" width="56" height="56" /></a> yagaojun ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="可恶"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-orange.png" alt="可恶" width="56" height="56" /></a> 可恶 ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_97324"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_97324" width="56" height="56" /></a> 爱发电用户_97324 ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="Jursin"><img src="https://pic1.afdiancdn.com/user/user_upload_osl/34d612b1c80939392ab74bae307ae41a_w132_h132_s6.jpeg" alt="Jursin" width="56" height="56" /></a> Jursin ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="Memories white"><img src="https://pic1.afdiancdn.com/user/152f9a2c797011eba47252540025c377/avatar/505d7046fd33ebae8ff1af167177ef20_w800_h800_s409.jpeg" alt="Memories white" width="56" height="56" /></a> Memories white ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_hAKP"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png" alt="爱发电用户_hAKP" width="56" height="56" /></a> 爱发电用户_hAKP ¥5.00</td></tr>
<tr><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="森王"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-orange.png" alt="森王" width="56" height="56" /></a> 森王 ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_43357"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_43357" width="56" height="56" /></a> 爱发电用户_43357 ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="坏名字qwq"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-yellow.png" alt="坏名字qwq" width="56" height="56" /></a> 坏名字qwq ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="Draking"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-yellow.png" alt="Draking" width="56" height="56" /></a> Draking ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="希莉卡"><img src="https://pic1.afdiancdn.com/user/fd7a69c6e64c11f0b3cb52540025c377/avatar/5a619e16a1e05c140e7b838b556e0ca1_w1024_h1280_s179.jpeg" alt="希莉卡" width="56" height="56" /></a> 希莉卡 ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="airem"><img src="https://pic1.afdiancdn.com/user/26696d60ee9111ee832a5254001e7c00/avatar/1267d3f1a84cc1d6b6ea9e7ae4bac522_w791_h791_s327.jpeg" alt="airem" width="56" height="56" /></a> airem ¥5.00</td></tr>
<tr><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="Janson"><img src="https://pic1.afdiancdn.com/user/ad16e57c584511ef8a9152540025c377/avatar/d318e7eb2a040a0e53696a38eb982e52_w160_h160_s4.png" alt="Janson" width="56" height="56" /></a> Janson ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_0e739"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_0e739" width="56" height="56" /></a> 爱发电用户_0e739 ¥5.00</td></tr>
</tbody>
</table>

---

## 开发者信息

### 项目分层（代码现状）
- `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` 为准。
- 浏览器端技术栈: React + TypeScript + Vite（见 `Monica for Browser/package.json`）。
- 欢迎通过 Issue / PR 参与功能和安全改进。

---

## 致谢

Monica 的设计、兼容性适配与部分功能方向，受到了以下优秀开源项目和软件的启发与帮助：

- [Keyguard](https://github.com/AChep/keyguard-app) - 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 移动验证器、登录批准与确认流程体验的参考。

---

## 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)

---

## 贡献者

![贡献者](https://raw.githubusercontent.com/Monica-Pass/Monica/main/.github/assets/contributor-flag.svg)

---

## 社区与支持

- Telegram 群组：[加入 Monica 社区](https://t.me/+IZUDLL-vWOA1Y2U1)

---

## 许可证

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 的商标权归各自权利人所有。

Monica

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README