使用文档
从创建第一个工作区，到多设备同步与恢复。
快速开始
1
打开应用启动 Secure Notes 后进入首页，点击「创建工作区」（列表为空时是「创建第一个工作区」）。
2
填写名称、目录与密码选择一个本机目录，设置库密码（12–1024 个字符）。工作盘后端默认按平台选择（macOS 为 APFS 加密映像）；如果目录里已有文件，必须勾选「我确认接管该目录」。
3
创建并进入点击「创建并进入」。创建后会立即加密保存第一份稳定版本并进入工作区详情；再次输入密码解锁即可访问工作目录。
内测版本：未登录云端账户时只允许 1 个工作区，此时「创建并进入」会被禁用并提示「本地模式仅支持一个工作区」。登录云端账户后不再限制。
使用 Obsidian / VS Code
解锁后，点击「打开 Obsidian」或「打开 VS Code」。编辑器无需安装插件，直接使用普通工作目录。
退出编辑前，请先点击「生成稳定版本」把工作区快照为密文，再点击「锁定」。锁定后笔记目录会被保留但设为只读，里面只留一个
.secure-notes-locked 占位文件——它记录了密文仓库的位置，请不要删除。如果编辑器或同步程序仍在写入，锁定会被拒绝并提示先关闭它们。快照与恢复
- 生成稳定版本：把当前工作目录完整快照为加密对象与提交。内容未变的文件会复用已有密文对象，不会重复写入。
- 恢复最近版本：从最近的密文提交恢复工作区内容（不会删除工作区里额外的文件）。
同步目标与多设备
- 在工作区详情展开「＋ 添加同步目标」，填写名称和目录（iCloud、Dropbox 或任意本地同步盘），点击「添加」。
- 同步前请先生成稳定版本并锁定工作区。
- 在目标行上点击「推送」把密文仓库传到目标（同一行还有「拉取」和「移除」）；在另一台设备展开「迁移目录 / 安全设置 / 连接已有工作区」，用「连接」填入同步目录与
vaultId，然后拉取。 - 首页的「全部拉取 / 全部推送」会逐个执行所有已启用的目标，并在首页显示成功、失败和冲突的结果条。
同步目录只出现密文仓库，不会出现明文工作目录。发现 HEAD 分叉时，应用会停止并保留本机版本，不会静默覆盖。推送只补齐目标缺少的文件，不会删除目标里已有的对象。
云端账户（可选）
点击右上角「云端未登录」可登录账户，把同一套密文对象同步到自有云端。服务端只保存密文，不接触你的库密码或笔记正文。云端与本地模式可同时使用。
云端默认只接受 64 MiB 以内的单个密文对象（Caddy 请求体上限 70 MB），而客户端允许 512 MiB。超过约 64 MiB 的文件推送云端会失败，这类大文件目前只能通过目录型同步目标传输。
锁定期间的意外文件与遗留挂载
如果锁定期间有别的程序往笔记目录写了文件，下次解锁不会自动并入：界面会弹窗显示文件数和字节数，让你选择「并入工作区」（加密保存后清空目录）、「清理这些文件」（直接删除，无法撤销）或「暂不处理」。
如果应用异常退出导致原生加密工作盘仍处于挂载状态，在工作区详情的「迁移目录 / 安全设置 / 连接已有工作区」里点击「检测并清理」。操作前请确认 Obsidian、VS Code 等编辑器已关闭。
备份与目录位置
「备份密文库」只在锁定后可用，备份只包含密文状态（vault.json、workspace-config.json、state.json、repo/、journal/、staging/），不包含原生工作盘映像，并只保留最近 5 份。备份目录是 <你选择的目录>.secure-notes-backups/<UTC 时间戳>-<随机串>/。
密文仓库不在笔记目录里，而在应用数据目录的
vaults/<目录名>/（macOS：~/Library/Application Support/com.securenotes.desktop/vaults；Windows：%LOCALAPPDATA%\\Secure Notes\\vaults；Linux：$XDG_DATA_HOME/secure-notes/vaults）。只复制笔记目录不会备份到任何密文。另外，那个目录名默认是笔记路径的哈希，但锁定后留下的占位文件记录了真实位置，所以移动或重命名笔记目录是安全的；一旦手工删掉占位文件，移动过的目录就可能找不到原来的库。安全提示
- 库密码请用密码管理器生成并手动粘贴，应用不会保存密码。
- 重要资料保留独立备份；原生加密映像与密文仓库之外，本机仍可能残留文件元数据。
- 密文对象隐藏的是文件名与路径，不隐藏文件数量、单个文件体积和快照次数。