加密功能
Mini Diary 的目标是:正文、批注和附件在落盘前就完成加密,磁盘上不出现明文内容。
日记库信封
diary.vault 是一个加密信封:
text
vaultId
scrypt 参数和 salt
用密码派生的 KEK 包裹的 DEK
用 DEK 派生的 payload key 加密的整库 JSON关键点:
- 密码不会保存;
- 密码通过 scrypt 派生 KEK;
- 每次创建库生成随机 32 字节 DEK;
- 密码只负责包裹 DEK,修改密码不需要重新加密全部日记;
- 所有加密块使用 AES-256-GCM,带认证标签;
- AAD 绑定版本、
vaultId和用途,篡改会解密失败。
默认 scrypt 参数:
text
N = 131072, r = 8, p = 1子密钥
DEK 不直接用于所有内容,而是通过 HKDF-SHA256 按用途派生:
text
payload-v1 日记库主体
attachment-v1 附件
annotation-v1 批注
sync-v1 Git 镜像条目
sync-token-v1 Git token
inkatt-manifest-v1 附件包清单不同用途不复用同一把子密钥。
附件
附件使用 MDAT v1 分块容器:
- 64 字节头;
- 1 MiB 默认分块;
- 每个分块独立 AES-256-GCM;
- nonce 由文件前缀和块号组成;
- AAD 绑定文件头、块号和明文长度;
- 文件头有 HMAC 校验;
- 支持流式写入、随机读取和视频 Range 请求。
因此大视频不需要整体读入内存,也不需要解密后才能 seek。
批注
批注文件按日期保存,每行一条独立密文:
- 使用
annotation-v1子密钥; - 每条记录独立 nonce;
- AAD 绑定日期和行号;
- 把记录移动到其他日期或位置会解密失败。
恢复密钥与包
.inkkey:
- 用独立备份密码包裹 DEK;
- 加密携带仓库地址和分支;
- 不含 token、代理、正文、附件。
.minidiary:
- 整库 ZIP64;
- 公钥 + 私钥双因子包裹 DEK;
- 正文、批注、附件全部以密文形式保存。
.inkatt:
- 附件包;
- 使用独立的包密钥包裹 DEK;
- 只包含附件文件和加密清单。
内存与日志
- 解锁后密钥只在主进程内存中;
- 锁定、退出和切换库时清除密钥缓存;
- 渲染进程拿不到 DEK 或原始文件句柄;
- 日志不记录密码、密钥、正文和附件名。
边界
加密能保护磁盘上的数据,但不能防止:
- 已解锁电脑被他人直接操作;
- 操作系统或恶意软件在内存中窃取密钥;
- 弱密码被离线暴力尝试;
- 备份密钥文件与密码同时泄露。
密码无法找回;迁移包密码和 .inkkey 备份密码同样无法找回。