其他设备与手机
同步
Hyla 的配置——主题、字体、按键、智能体、飞书、Tailcat——就是一个文件。同步 让它在你用的每台电脑上保持一致,走一个它们都能访问的服务器:WebDAV 文件夹、S3 兼容的存储桶,或一个 GitHub 仓库。
快照在写入它的那台电脑上加密。服务器上只有密文:它读不到你的设置,别人拿到文件、没有口令也一样读不到。
同步什么
只有配置文件本身,hyla config path 指出的那一个。它记的是与默认值不同的部分,所以一台电脑同步之后,用的就是其它电脑的设置。
不同步 属于某台电脑的东西:会话和它们的终端、项目、边栏里的 SSH 与 K8s 主机、窗口尺寸、上次选中的会话。那些是这台电脑自己的。
存到哪里
| 服务器 | 要填的 |
|---|---|
| WebDAV——坚果云、Nextcloud、ownCloud | 地址(如 https://dav.jianguoyun.com/dav/)、用户名、应用密码 |
| S3 兼容——MinIO、R2、B2、OSS、COS | 服务地址、存储桶、前缀、区域、Access Key、Secret Key |
| GitHub | owner/name、路径(如 hyla/config.enc)、分支、Token——仓库请设为 私有,快照里虽然有你的密钥,但它们只是密文 |
在 WebDAV 地址下,Hyla 会建一个 hyla/ 文件夹;存储桶与仓库里用的是 hyla/config.enc。同一个服务器可以放别的东西。
口令
一句口令,在每台电脑上输入,用来加密和打开快照。它经 Argon2id 推出密钥,内容用 AES-256-GCM 加密:口令错了,或者文件在服务器上被改过,一点都打不开。
记住它。 没有找回的办法:没有口令,文件在任何一台电脑上都打不开,Hyla 也打不开。
口令和服务器的凭据只留在各台电脑上,和配置放在一起的 sync.json(只有你自己可读)。它们从不进入同步内容,所以快照里不会有它自己的钥匙。
什么时候同步
- 打开 Hyla 时:拉取一次,久未打开的那台电脑一开就是其它电脑的设置。
- 改动之后:改了设置,半分钟后推送一次,把这一串改动合成一次。关掉 自动同步 就只在你要求时同步。
- 你要求时:设置 › 同步 › 立即同步,或终端里的
hyla sync。
没有配置文件的电脑会取服务器上的那份,而不是把空的推上去。
两边都改过
同时改同一个设置并不常见,但会有。这时 本机这份保留:服务器那份另存为 config.remote-<机器名>-<时间>,然后推送覆盖服务器。你写的东西总会留一份,Hyla 会告诉你另一份放在哪。
命令行
hyla sync # 立即同步,和打开 Hyla 时一样
hyla sync status # 同步到哪里、上次到哪一步
hyla sync push # 把本机推送上去,不管服务器是什么
hyla sync pull # 取服务器的,不管本机是什么
hyla sync set backend webdav # 还有 webdav.url、webdav.user、webdav.password…
hyla sync set passphrase "…" # 每台电脑上都一样
hyla sync set auto on
hyla sync set 支持 backend(webdav、s3、github 或 off)、passphrase、auto、webdav.url|user|password、s3.endpoint|bucket|prefix|region|accessKey|secretKey、github.repo|path|branch|token。