写给 restic 用户

Keelhaven 是前端，不是分支。它内置原版 restic（0.19.1），以子进程方式运行，写出来的就是普通的 restic 仓库。它做的每件事你都可以自己敲命令完成，它补上的是定时、钥匙串和菜单栏。

它执行了什么

什么时候	命令
新建计划	`restic init`
每次定时运行	`restic backup --json --tag keelhaven <文件夹>`
保留策略，备份成功后执行，最多每周一次	`restic forget --prune --tag keelhaven --keep-…`
验证，默认每周	`restic check`
恢复	`restic restore <快照> --target <新文件夹>`
你要求清理残留的锁时	`restic unlock`，从不带 `--remove-all`

整个应用同一时间只跑一个 restic 进程。forget 上的 --tag 是 0.9.1 之后才加的，为什么要紧，见下面「接入已有的仓库」。

保留策略的几个选项，对应的是这些 keep 参数：

选项	参数
保留全部（默认）	根本不执行 `forget`
保留一年	`--keep-last 3 --keep-daily 7 --keep-weekly 5 --keep-monthly 12`
保留一个月	`--keep-last 3 --keep-daily 7 --keep-weekly 4`
保留固定份数的备份	`--keep-last N`

仓库密码和存储密钥都在 macOS 钥匙串里。它们通过环境变量交给 restic： RESTIC_PASSWORD、AWS_SECRET_ACCESS_KEY、RESTIC_REST_PASSWORD，从不经过命令行参数，也不落盘。

这份环境是从零拼出来的：只有 PATH、HOME、TMPDIR、SSH_AUTH_SOCK，再加仓库地址和凭据。你会话里的其他变量一概不传。

在选目的地那一步展开高级选项，勾上接入该位置上已有的备份仓库。 Keelhaven 会拿你的密码去验证，不会新建任何东西。

其他机器留下的快照原样保留，恢复窗口里会和 Keelhaven 自己的快照列在一起。

保留策略也不会动它们，前提是版本在 0.9.1 之后。新版本的 forget 带着 --tag keelhaven 执行，只会处理 Keelhaven 自己创建的快照；restic 命令行或别的工具写进去的，会一直留着，要清理得你自己动手。

0.9.1 及更早的版本，会把保留策略用在仓库里的所有快照上。 如果仓库还有别的东西在写，请先升级，再打开保留策略。

一个仓库，只用一种保留策略。 每个计划给快照打的标签都一样，所以两个 Keelhaven 计划（或者两台装了 Keelhaven 的 Mac）共用一个仓库时，谁的保留策略先跑，就会同时作用在两边。要么给每个计划单独一个仓库，要么把它们的保留策略设成同一个。

仓库地址就是你想的那样：

bash

restic -r sftp:backup@nas.local:/backups/mac snapshots
restic -r sftp:backup@nas.local:/backups/mac restore latest --target ~/Restored

两边不会打架，restic 自己的锁管着。

没有「额外参数」输入框，这是有意的：--quiet 或 --verbose 会破坏进度条所依赖的 JSON 输出，--no-lock 会让「同一时间只跑一个」的保护失效。大家常要的参数做成了有名字的设置项：