跳到主要内容

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 也会重拉当前选中项的标签。还没有任何文件的空文件夹不会出现在远端,对端也就看不到。
  • 在一台电脑上移动或重命名文件夹、移动或重命名文件后,另一台同步完成时应出现在新位置,侧栏里不再留下已经没有文件的旧目录。

打开同步资源库​

「打开资源库」→「打开同步资源库…」:

  1. 选择已配置的服务器;
  2. 面板列出该服务器上的同步库(按远端清单识别,可跨设备继续使用);
  3. 选择目标保存位置后打开,远端内容下载到本地。

服务器要求支持文件上传/下载(PUT/GET)。

打开同步资源库