# KeyKeep
**纯本地密码与 Token 保险库 —— 数据只在你自己的手机里**
不注册账号，不连云，不同步。整个保险库是一个 AES-256-GCM 认证加密容器，
主密码经 Argon2id 派生密钥；`vault.bin` 被拷走、被云盘自动备份、被别的 App 翻到，
拿到的也只是一串乱码。只有你亲手点「测试」的那一刻，某一个 Token 才会离开这台手机。
---
## ✨ 特性
**保险库本体**
- 🔐 **单文件加密容器**：`filesDir/vault.bin` 一个文件装下所有条目，不是 SQLCipher、不引 NDK，
解锁时全量解密进内存——条目量小（< 1 万），搜索直接走内存，零 native 依赖
- 🔑 **三把钥匙开同一把锁**：主密码 / 恢复码 / 指纹分别包装同一个数据密钥（DEK），
**改主密码只重包装 DEK，密文一个字节都不动**
- 🧂 **Argon2id 慢哈希**：BouncyCastle 纯 Java 实现，m=19 MiB / t=2 / p=1 起步，
参数写进容器头可演进；本机解锁净耗时 289 ms
- 💾 **双副本自愈**：写入走 `tmp → fsync → rename` 原子替换，另留一份 `vault.bak` 副副本；
主文件校验不过时自动回退副副本，不让你因为一次异常关机丢掉整库
**解锁与防护**
- 🖐️ **指纹解锁**：BiometricPrompt + CryptoObject（`BIOMETRIC_STRONG`），
`setInvalidatedByBiometricEnrollment(true)`——增删指纹后旧的包装密钥立即失效
- ⏳ **自动锁定**：退后台立即 / 1 分钟 / 5 分钟 / 从不，默认 1 分钟；
弹指纹框期间不会误锁
- 🚦 **失败限速**：连续错 5 次起指数退避（15s → 30s → 60s…，上限 5 分钟）
- 📵 **全程防截屏**：`FLAG_SECURE`，截图与录屏都是黑屏
**条目与使用**
- 🗂️ **三种条目**：密码（用户名/密码/网址/备注）、Token/API Key（Provider/环境/Key）、安全笔记；
类型页签 + 关键词搜索 + 标签
- 🎲 **随机密码生成器**：长度与字符集可勾选，每类至少出一个 + Fisher-Yates 打乱，SecureRandom
- 📋 **剪贴板守卫**：复制敏感字段后定时清空（默认 60s，可配）；Android 12L+ 标记
`EXTRA_IS_SENSITIVE`，系统不弹预览；期间你自己复制了别的东西就绝不碰你的剪贴板
**Token 检测（只做两家）**
- 🧪 **DeepSeek**：可用性 / 可用模型列表 / 余额（多币种）
- 🧪 **Z.ai Coding Plan**：额度与用量（术语只说「额度/用量」，不叫余额）
- 🛡️ **不信 HTTP 200**：Z.ai 出错时也返回 200，适配层一律以 `body.success` / `body.code`
判成败，并把这条写进了代码注释
- ⏱️ **60s 限频**：同一条目一分钟内不重复打第三方接口
- 🚫 **可以整个关掉**：设置里打开「仅保存，不联网测试」后，检测入口直接提示，不发任何请求
**备份**
- 📦 **`.vault` 加密容器导出/导入**：与主库同构但 magic 不同（`KKVB`），
备份体**用独立的随机 DEK** + 单独的备份密码包装——备份密码泄露不会连累主库
- 🔁 **导入即整体替换**：用于换机或恢复；导入要求先解锁，且备份密码忘了就真作废
## 🧱 加密是怎么搭的
```
主密码 ─Argon2id─▶ KEK₁ ─┐
恢复码 ─Argon2id─▶ KEK₂ ─┼─▶ DEK（随机 256 bit）══AES-256-GCM══▶ 条目密文
指纹 ─Keystore─▶ KEK₃ ─┘
落盘 vault.bin（主）+ vault.bak（副）
写入 tmp → fsync → rename，主坏副好自动恢复
出网 只有点「测试」这一条
App ──HTTPS──▶ DeepSeek / Z.ai，只发该条目的 Key
```
容器布局（小端，字段定长、无分隔符）：
```
头部 magic "KKVL" 4B · version 1B · kdfAlgo 1B · 参数 12B
salt 16B · recSalt 16B · bodyNonce 12B · flags 1B
wrapPw 60B · wrapRec 60B · wrapKs 60B（启用指纹时才有）
正文 bodyLen 4B · body = GCM(DEK, JSON 条目)
AAD = magic + version + bodyNonce
AAD 只绑 magic + version + bodyNonce，于是：
- body 与每个 wrap 的完整性各自由自己的 GCM tag 保证
- 防「A 库的头配 B 库的正文」，同时保证改主密码不必重加密全部条目
- 备份容器 magic 换成 KKVB，两种文件互相当对方解会直接认证失败
```
## 🚀 快速开始
**下载**：