🗺️ Monica 全局文档导航
摘要
欢迎来到 Monica 官方文档中心。本文按「快速上手 / 角色场景 / 技术规范」组织，帮助你用最短路径找到对应文档。
🚀 快速开始
如果你第一次阅读文档，建议按以下顺序：
- 认识项目：阅读 📖 项目介绍，快速了解 Monica 的定位与能力边界。
- 掌握全景：阅读 🎯 功能总览，先看一遍主要页面与交互入口。
- 第一轮上手：按 📝 快速开始 完成安装、初始化与首条记录保存。
- 深入配置：继续阅读下面的专题文档，选择与你场景匹配的章节。
👥 角色导航
按使用者身份快速进入对应区域：
🙋 普通用户
- 📖 项目介绍：认识 Monica 的目标、核心能力与适用场景。
- 🎯 功能总览：快速建立功能地图，了解主要模块。
- 📝 快速开始：一步步完成首次安装与首次使用。
- ⌨️ 自动填充与保底机制：解决不同 App 的兼容问题与兜底方案。
🔐 安全与隐私关注用户
- 📦 WebDAV 备份格式规范：掌握备份包结构、加密与恢复流程。
- 🔄 本地存储与加密技术文档：了解本地数据库加密、主密码派生与硬件级保护策略。
🧑💻 开发者与贡献者
- 🧱 MDBX 规范索引：明确 MDBX 文档结构与核心阅读顺序。
- 📚 MDBX 规范文档导航：查看核心规范 / 实现指导分层说明。
- 📄 规范与实现任务：在低端模型任务分解框架下查阅可落地开发项。
🛠️ 开发者与技术规范（Developer Specifications）
面向开源贡献者与需要做实现兼容、审核或二次集成的用户。
🌐 通用技术文档
- 📦 WebDAV 备份格式规范：定义备份目录结构、字段约束与恢复逻辑。
- 🔄 本地存储与加密技术文档：阐明本地持久化、密钥派生与安全边界。
- ⌨️ 自动填充与保底机制：描述自动填充链路、可访问性兜底与操作说明。
🧱 MDBX 专题：导航与总览
MDBX 是 Monica 的本地优先加密数据库规范体系。以下内容按建议顺序阅读：
- 📚 MDBX 规范索引 — 阅读建议、文档分层与术语边界。
- 🧭 MDBX 规范文档导航 — 核心规范与实现指导的文档治理规则。
📏 MDBX 核心规范层（第 00-05 部分）
这些文档用于定义行为约束、数据模型与安全底线：
- 🤖 MDBX 执行模型规则 — 执行优先级、禁止事项与验收方法。
- 📋 MDBX 产品规范 — 项目目标、领域模型与主约束。
- 💾 MDBX 存储与同步规范 — storage 结构、增量写入与冲突处理。
- 🛡️ MDBX 安全规范 — Tiga 三档模式与加密要求。
- 🗺️ MDBX 路线图与验收规范 — 交付边界、验收标准与风险清单。
🧩 MDBX 实现指导层（第 06-09 部分）
实现阶段可按以下文档执行：
- 📄 MDBX RFC 结构与文档约定 — 统一的文档约定与实现规则。
- 🗃️ MDBX SQLite 初版 Schema 规范 — 表结构、索引与对象映射。
- 📝 MDBX 低端模型任务拆分清单 — 可执行任务与分解策略。
- 🔧 MDBX 实现补完计划 — 当前实现状态、差距与推进路径。
🎯 Monica Pass CLI 与生态接入
- 💻 Monica Pass CLI 开发文档 — Human Mode / Agent Mode、认证策略、JSON 接口与未来扩展。
📑 项目信息
核心要素
| 属性 | 内容 |
|---|---|
| 项目类型 | 本地优先开源密码管理器 |
| 核心格式 | MDBX（加密密码数据库） |
| 支持平台 | Android 8.0+ / Web |
| 开源协议 | GNU GPL v3.0 |
| 设计目标 | 离线可用、长期存档、多设备同步 |
| 安全基线 | Argon2id + XChaCha20-Poly1305 + Tiga 三档模式 |
🔗 重要链接
- 官方仓库：GitHub JoyinJoester/Monica
- 最新版本：Release 页面
- 许可证：GNU GPL v3.0
- 问题反馈：GitHub Issues