1. 创建
你选一个父目录和名字，比如 ~/存档。
- FolderSafe 创建
~/.存档.foldersafe/data.sparsebundle：一个 AES-256 加密的 APFS 稀疏映像包，密码就是你的主密码。 - 旁边写入
vault.json：里面是主密码的加密副本，分别用你的助记词和（如果开启）Touch ID 钥匙加密。 - 它会挂载映像、写入标记、推出、再用你的密码重新解锁，并解密助记词副本来核对。全部通过后才交给你。
FolderSafe 是怎么工作的
FolderSafe 没有自己发明加密算法。它调用 macOS 自带的加密磁盘映像，再补上日常真正用得到的部分：文件夹留在原位、Touch ID、助记词找回和自动上锁。
一个 FolderSafe 文件夹的一生
2. 解锁
输入密码、按指纹，或用 12 个助记词。
- 映像被挂载到文件夹路径本身（
~/存档），并带nobrowse选项，所以桌面和 Finder 侧栏不会出现磁盘图标。 - 挂载前会先确认文件夹是空的，避免你误放进去的文件被盖住。
3. 使用
就是一个普通文件夹。
- 直接打开、编辑、保存。“移入文件夹”会复制整个目录，并把每个文件和原件逐一比对。
- FolderSafe 会给卷做标记，让 Spotlight 不去索引它，避免文件名进入系统索引。
4. 上锁
点“上锁”、合上屏幕、锁屏、闲置，或退出软件。
- 卷被推出。如果还有程序打开着里面的文件，FolderSafe 会告诉你是哪个程序，由你决定是否强制上锁。
- 文件夹变回一个空的、只读的、带锁图标的文件夹，里面只有一个打开 FolderSafe 的快捷方式。
自己用“磁盘工具”也能做
核心部分你可以手动完成：打开“磁盘工具”，选择文件 > 新建映像 > 空白映像，格式选 APFS，加密选 256 位 AES，映像格式选稀疏捆绑磁盘映像，然后存储。双击并输入密码即可打开，推出就是上锁。加密强度完全一样，只是磁盘会出现在 /Volumes 而不是你的文件夹里，没有 Touch ID 和助记词，也没有东西会替你自动上锁。
FolderSafe 在此之上补了什么
挂载回原文件夹位置、通过安全芯片钥匙实现的 Touch ID、能重置密码的 12 个助记词、睡眠/锁屏/闲置/退出时自动上锁、带逐项校验的移入、菜单栏开关，以及创建时的自检。
诚实的边界
加密保护的是静止状态的文件。文件夹一旦解锁，macOS 就把它当普通文件夹对待：以你的账户运行的程序、脚本和 AI 智能体都能读取。FolderSafe 用自动上锁把这个窗口压到最小，但无法让已解锁的文件夹对你运行的软件“隐身”。
里面是什么
原生 Swift 应用，Apple silicon and Intel 通用。加密内核是一个独立的小型库，有自己的测试。
- 磁盘映像通过 macOS 的
hdiutil和diskutil image工具操作；没有内核扩展，也没有后台守护进程。 - 助记词：标准 BIP39 词表（128 位），推导出 X25519 密钥，用来解开密码的加密副本。
- Touch ID：在安全芯片（Secure Enclave）里生成的 P-256 密钥，私钥永远不离开芯片。
- 主密码通过管道交给 macOS，从不出现在命令行参数里。
怎么测试的
0.1.0 版在真实加密映像上通过了端到端测试：错误密码、中文和 emoji 路径、文件被占用时不能普通上锁、改密码中途中断仍可找回，以及逐文件校验的复制。