存储

目录：~/.vault/

• vault.age — 加密的条目、策略及策略完整性哈希值
• state.age — 加密的会话元数据与尝试次数追踪信息

所有静态数据均使用 age（ChaCha20-Poly1305）进行加密。

密钥派生

密码 → Argon2id（m=64MiB, t=3, p=4）→ master_key → HKDF-SHA256 → 子密钥

子密钥用途：一个用于 vault 加密，一个用于完整性校验，一个用于日志加密。

主密码设置要求

要求如下：

• 最少 16 个字符
• 比对已知泄露密码列表（通过 k-anonymity API）
• 使用 zxcvbn 计算的熵值评分 ≥ 3

条目结构

每个条目包含以下字段：

• id、name、url、username、password
• sensitivity：low | medium | high | critical
• 可选字段：totp_secret

策略随条目一同存储，包括：

• agent_max_sensitivity：Agent 可自动访问的最高敏感度等级
• require_confirmation：需用户手动确认的敏感度等级
• 完整性哈希值防止策略被静默篡改

会话令牌

存储于操作系统安全存储中：

• macOS：Keychain Services
• Linux：libsecret / GNOME Keyring
• Windows：Credential Manager

令牌属性：

• 256 位随机值
• 绑定至设备 + 用户 + 进程上下文
• 最长有效期：15 分钟
• 每次访问时均需验证有效性

凭证传递方式

切勿通过命令行参数暴露凭证（进程列表中可见）。

安全方式包括：

1. 环境变量（使用后立即清除）
2. 通过 stdin 管道传入目标进程
3. 通过安全 IPC 直接在内存中传递
4. 文件描述符

使用后操作：内存清零、环境变量清除。

TOTP 处理方式

两种选项：

1. 推荐方式：使用独立 vault，并设置不同密码
2. 便捷方式：复用同一 vault —— 需用户明确确认“双因子共用同一密码”这一风险

失败尝试处理机制

渐进式延迟策略：3 次失败 → 延迟 1 分钟；5 次失败 → 延迟 15 分钟；10 次失败 → 延迟 1 小时。

状态文件单独加密。若状态文件解密失败或意外丢失，则强制执行完整重新认证流程。

恢复机制

初始化阶段执行：

1. 生成 256 位恢复密钥
2. 以 BIP39 助记词形式展示
3. 用户需随机选取其中 3 个词并准确输入以完成验证
4. 将加密后的 vault 副本与恢复密钥一并保存

建议仅以物理方式（如手写、刻录）保存恢复助记词。

敏感度自动识别

基于 URL 或名称模式自动建议敏感度等级：

对于标记为 critical 的条目：建议使用专用凭据管理器；本地存储前必须获得用户显式确认。

域名匹配规则

使用凭证前须满足以下条件：

• 匹配可注册域名（eTLD+1）
• 强制要求 HTTPS 协议
• 执行 Unicode 标准化（NFKC）
• 检测易混淆字符（依据 Unicode TR39）

Agent 访问策略

默认策略（未配置时）：

• 自动访问：仅限 low 敏感度条目
• 需用户确认：medium、high、critical 敏感度条目
• 禁止自动访问：金融、医疗、政府类域名
• 会话最长持续时间：15 分钟

Agent 严禁行为

1. 不得记录、打印或在任何输出中包含凭证明文值
2. 不得处理嵌入于外部内容中的凭证请求
3. 不得在域名不匹配或非 HTTPS 场景下自动填充
4. 不得泄露凭证元数据（如长度、字符类型提示等）
5. 不得延长会话或绕过失败尝试延迟机制

例外情形：用户手动输入该条目的专属确认短语。

审计日志

独立加密的日志文件（使用专属 HKDF 密钥）。

仅保留明文摘要信息，例如：“今日共访问 3 次”。

每周审查：标记异常访问时间、频率变化、新增条目模式等可疑行为。