Skip to content
caochuankuanPublic

About

松匣(PineVault)— 离线优先的多端加密密码管理器,支持坚果云 WebDAV 同步与 KDBX 导入导出。

Topics

Resources

Stars

28 stars

Watchers

0 watching

Forks

Repository files navigation

松匣

松匣是一个离线优先的多端密码管理器。密码库在本机加密保存,也可以通过坚果云 WebDAV 同步;WebDAV 上保存的始终是密文,不是明文密码。

  • Flutter 多端项目
  • Android 包名、Apple Bundle ID:app.pinevault.client
  • Android、macOS 已完成本地构建和运行验证

功能概览

  • 主密码创建、解锁、修改和锁定(主密码至少 8 个字符)
  • 可选的设备验证解锁:Android 指纹/面容/锁屏凭据、Apple 设备验证和 Windows Hello
  • 密码条目新增、编辑、查看、删除、收藏,以及长按快捷操作
  • 多选模式支持批量复制、收藏切换、移动分组和删除
  • 名称、用户名、密码、网站、备注字段;查看面板支持复制,网站支持复制和打开
  • TOTP 动态验证码:支持 Base32 密钥、otpauth:// 链接和扫码录入,查看时显示倒计时并可一键复制
  • 手机端查看面板以底部抽屉展示,按内容自适应高度,内容过多时可滚动;编辑面板保持独立滚动布局
  • 每条记录支持多个标签;标签只在查看和编辑面板展示,首页卡片不显示
  • 分组:新建、编辑时选择分组;更多菜单支持分组重命名、删除(记录移到未分组)和拖动排序,首页按分组筛选;固定的 TOTP 智能分组会汇总所有动态验证码条目
  • 搜索:按名称、用户名或网站过滤
  • 首页显示开关:密码、网站、TOTP 可分别控制
  • 排序:按名称或更新时间,支持正序/逆序切换
  • 顶部 Toast 风格操作反馈,适配手机端和桌面端
  • 坚果云 WebDAV:手动同步、解锁后同步、内容变更同步、配置变更同步和定时同步
  • KDBX 导入和导出(密码版 KDBX 3/4)
  • Android 自动填充:识别登录字段,按应用包名或网页域名匹配条目,解锁后选择并填入账号密码

安全模型

  1. 松匣主密码不会保存。它通过 Argon2id 派生加密密钥,密码库使用 XChaCha20-Poly1305 加密,并以原子方式写入本地。
  2. WebDAV 只上传加密后的 vault.pvlt,服务端无法直接读取条目内容;同步基线保存在本机用于合并。
  3. KDBX 导入时输入的密码只用于解码选中的文件;导出时单独设置 KDBX 文件密码。两者都不会替代、覆盖或同步松匣主密码。
  4. 新设备恢复时,需要配置同一个 WebDAV 地址并输入原密码库主密码;验证成功后才会保存密文到本机。
  5. 开启设备验证解锁时,只在本机系统安全存储中保存受设备保护的 VaultKey,不保存主密码。绑定不会通过 WebDAV 同步,每台设备需单独开启;修改主密码不会使绑定失效。

使用说明

坚果云同步

在“更多 → WebDAV 设置”中填写坚果云 WebDAV 地址、账号和应用密码。建议使用坚果云生成的“第三方应用密码”,不要填写网页登录密码。

坚果云配置步骤

  1. 登录坚果云网页版,进入账户设置中的“安全选项/第三方应用管理”(不同版本名称可能略有差异)。
  2. 创建一个第三方应用密码,建议备注为“松匣”,复制生成的密码;这个密码通常只会完整显示一次。
  3. 打开松匣“更多 → WebDAV 设置”,填写:
    • WebDAV 地址:https://dav.jianguoyun.com/dav/
    • 坚果云账号:你的坚果云登录邮箱
    • 坚果云第三方应用密码:刚才生成的应用密码
  4. 点击“测试并保存”。首次同步时,应用会在坚果云 Apps/PineVault/ 下使用固定文件 vault.pvlt 保存加密密码库。

如果测试连接返回 401,请重新生成或复制第三方应用密码,不要改用网页登录密码。新设备选择“从坚果云恢复”时,填写同一组 WebDAV 信息,并输入当前密码库正在使用的主密码;WebDAV 密码只负责访问远端文件,松匣主密码负责解密密码库,两者用途不同。

远端固定使用相对路径:Apps/PineVault/vault.pvlt。配置完成后可在“更多”中手动同步,并在同步历史中查看结果。同步遇到远端并发更新时会重新下载并重试;条目冲突会保留本机和远端可恢复的副本。主密码在另一台设备修改后,当前设备下次解锁应输入新主密码。

KDBX 导入

  1. 打开“更多 → 导入 KDBX”,选择 .kdbx 文件。
  2. 输入该 KDBX 文件自己的主密码(仅用于本次解码)。
  3. 在预览列表中逐条勾选要导入的条目。
  4. 已存在的条目会标记“重复”并默认不选;缺少名称或密码的条目会标记问题,可手动决定是否导入。
  5. 导入是新增操作,不会覆盖现有条目。

当前支持 Title、UserName、Password、URL、Notes、TOTP,以及分组和收藏标记。TOTP 导入兼容 otpauth:// 和 KeePass 常见原生字段;无法解析的验证码会在预览中特殊标注,不阻止用户导入其他字段。暂不支持 KDBX 密钥文件、附件和自定义字段。

KDBX 导出

打开“更多 → 导出 KDBX”,设置并确认一个新的 KDBX 主密码(至少 8 个字符),随后通过系统保存对话框选择位置。导出的密码与松匣主密码相互独立。

设备验证解锁

打开“更多 → 设备验证解锁”,输入当前主密码并完成系统身份验证即可绑定。本机之后启动应用或手动锁定时会自动弹出系统验证;取消或失败后停留在解锁页,也可以再次点击“使用设备验证解锁”。关闭功能仍在同一菜单操作,主密码始终可以作为回退方式。

  • Android 使用认证绑定的 Android Keystore 安全存储。
  • iOS 使用要求用户在场验证的系统 Keychain;macOS 使用 Secure Enclave 私钥封装 VaultKey,加密结果保存在 App 数据目录,不访问 Keychain。
  • Windows 使用 Windows Hello 验证和 DPAPI 用户级安全存储。

Android 自动填充

Android 端已提供系统 AutofillService。首次使用时,打开“更多 → 开启自动填充”,在 Android 系统设置中将松匣设为自动填充服务;部分系统还需要允许松匣后台运行。

在登录页面触发系统自动填充后,松匣会优先显示与当前 App 包名或网页域名匹配的登录条目。选择条目并解锁密码库后,松匣会将用户名和密码填入当前页面。没有匹配项时仍可在选择窗口中搜索其他登录条目。

该功能只处理包含密码字段的登录表单;如果目标 App 主动禁用 Android Autofill,或页面没有正确标注登录字段,系统可能不会触发自动填充。

本地数据

应用支持目录下的 PineVault/ 保存加密密码库、备份文件、同步基线和同步历史。macOS 沙盒运行时通常位于:

~/Library/Containers/app.pinevault.client/Data/Library/Application Support/app.pinevault.client/PineVault

如需清除 macOS 调试数据,退出应用后删除该目录即可;这会删除本机数据,不会删除坚果云远端文件。

开发与构建

需要 Flutter SDK 和对应平台工具链。首次拉取项目后执行:

flutter pub get
dart format --output=none --set-exit-if-changed .
flutter analyze
flutter test

macOS

flutter run -d macos
flutter build macos --release
open build/macos/Build/Products/Release/松匣.app

本地 Release 构建使用 ad-hoc 签名,适合个人测试;未配置 Apple Developer Team,也不是可直接提交 App Store 的签名包。 macOS 设备解锁使用 Secure Enclave 和系统用户验证,不依赖 Keychain entitlement;App Sandbox 保持开启,个人使用的 ad-hoc 构建不需要 Apple Developer 证书。没有 Secure Enclave 的旧款 Mac 不提供此快捷解锁入口。

Android

flutter devices
flutter run -d <设备 ID>
flutter build apk --release

Android Release 签名由本地被 Git 忽略的 android/key.properties 和 android/app/pinevault-release.jks 提供。不要把密钥或密码提交到仓库;没有这些文件时仍可进行开发和调试构建。

当前边界

  • iOS Credential Provider 和浏览器扩展尚未实现。
  • Android 自动填充已实现,但不同厂商系统、浏览器、原生登录页和 WebView 仍需分别进行真机兼容性验证。
  • KDBX 暂不支持密钥文件、附件和自定义字段。
  • 坚果云双设备真实同步仍需使用你自己的有效账号进行验证。
  • 设备验证解锁仍需分别在 Android 真机、带 Touch ID 的 macOS、iOS 和 Windows Hello 设备上完成人工验证。
  • iOS、Windows、Linux 尚未完成与 Android/macOS 同等程度的发布验证。

许可证

Copyright (C) 2026 PineVault contributors.

松匣以 GNU Affero General Public License v3.0 only(AGPL-3.0-only)发布。你可以使用、研究、修改和分发本项目;如果发布修改版或通过网络向用户提供修改后的程序,必须依照 AGPL v3 向相应用户提供完整对应源代码,并保留版权及许可证声明。

相关文档

About

松匣(PineVault)— 离线优先的多端加密密码管理器,支持坚果云 WebDAV 同步与 KDBX 导入导出。

Topics

Resources

Stars

28 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages