WebDAV 云同步
Serpent 支持通过 WebDAV 服务器在多台电脑之间同步资源库。全局配置服务器、每个资源库单独绑定,之后双向自动同步:本地变更上传、云端变更拉取。
同步概览
- 在通用设置里配置 一个或多个 WebDAV 服务器;每个资源库单独绑定服务器与远端文件夹。
- 同步是双向的:本地导入、修改或删除资产会自动上传;云端变化会自动拉取到本地。
- 自动同步按库开启:保存绑定后立即同步一次,之后按设置的轮询间隔检查云端变化;本地导入、改标签、改描述等在最后一次改动约 5 秒后上传(与轮询间隔独立)。
- 未同步的文件会在卡片右下角显示状态。可在设置 → 同步关掉。同步进行时不再用 toast 提示「正在同步 / 已同步」。左上角资源库切换器旁仍显示连接状态图标(绿色链接 = 自动同步开启,灰色断开 = 未开启,悬停可见说明)。
配置 WebDAV 服务器(全局设置)
打开「通用设置」→「同步」,添加同步服务器:
- 服务器地址:以
http://或https://开头,可填写 NAS 或共享目录的 WebDAV 路径(例如https://nas.local/dav/share/)。 - 用户名 / 密码:服务器凭据。密码经系统安全存储加密保存(macOS 钥匙串 / Windows DPAPI),不会明文落盘。
- 允许自签名证书或 HTTP:自建服务器未配置正式证书时勾选此项。
- 在卡片上显示同步状态:默认开启。关掉后卡片右下角不再出现同步标记。
- 保存后可测试连接;连接失败会给出可读原因(地址无效、DNS、TLS、认证等)。

绑定资源库(资源库设置)
打开「资源库设置」→「同步」:
- 同步状态:显示未同步 / 同步中 / 上次同步时间。
- 服务器:选择该资源库绑定的服务器;切换时自动测试连接。
- 同步文件夹名:远端目录名,默认与资源库同名。最终远端位置为
服务器地址/同步文件夹名称/。 - 自动同步:开启后本地变更自动上传、云端变化自动拉取。
- 轮询间隔(秒):云端变化检查频率,默认 5 秒。资源库较大时建议填写更长的轮询时间,避免频繁检查拖慢网络与磁盘。
- 保存:保存绑定;开启自动同步时会立即触发一次同步。

同步行为
- 首次同步会把本库的资产、元数据与清单上传到服务器;之后每次同步只传输有变化的文件。元数据包括人手与 AI 的标签、描述、评 分,以及收藏。合集成员当前不同步。
- 链接文件夹里的文件当前不会同步。
- 两台设备修改同一文件时,输家版本会保存为「名称 (conflict-…)」的冲突副本,不会静默覆盖。
- 自动同步与手动同步互斥;同步失败只记录日志,不打扰用户。
- 从云端拉到新文件、新文件夹或标签后,侧栏、画布和当前选中资产的 Inspector 会自己更新,不必手动刷新。若仍停留在旧标签,按 F5 也会重拉当前选中项的标签。还没有任何文件的空文件夹不会出现在远端,对端也就看不到。
- 在一台电脑上移动或重命名文件夹、移动或重命名文件后,另一台同步完成时应出现在新位置,侧栏里不再留下已经没有文件的旧目录。
打开同步资源库
「打开资源库」→「打开同步资源库…」:
- 选择已配置的服务器;
- 面板列出该服务器上的同步库(按远端清单识别,可跨设备继续使用);
- 选择目标保存位置后打开,远端内容下载到本地。
服务器要求支持文件上传/下载(PUT/GET)。
