Plainva同步兼容性
更新日期：2026-10-21
如果 WebDAV、CalDAV 或 S3 服务返回登录页面或不完整的资源列表，Plainva 会报告同步错误。它不会将该响应视为空文件夹或空日历列表，也不会据此执行推断出的删除操作。此规则适用于桌面端和移动端。
如果本地文件因权限或读取错误而无法上传，任务及其错误会保留在队列中。请恢复文件访问权限后重新同步。只有确实不存在的文件才会被视为缺失；访问失败不会被记录为上传成功。
即使多次重命名，离线编辑也会保留。Plainva 会先完成相关移动，再上传当前内容；操作失败时，依赖它的任务会等待。如果远程源不存在，Plainva 会将本地仍保留的文件或文件夹内容上传到新位置。无法读取的内容会留在队列中并显示错误，以便重试。
删除确认仅适用于实际执行的那次删除。连接错误后重试或重启时，确认仍然有效；在同一位置新建的文件不会继承它。暂停批量删除时的额外确认和恢复选项，只影响当时显示的任务。更新前已在队列中的大量删除任务，可能需要再次确认。
两台设备在完成同步之前，把日志条目追加到同一篇日记中，这并不是冲突：Plainva会按时间合并这些条目，并保留两台设备的每一行——即使两台设备各自独立创建了当天的日记，同样如此。对笔记的其他任何同时更改，仍按以往的方式处理。参见日志。
你在 Plainva 中创建的文件夹，会在云端的仓库文件夹内部创建。在 0.8.3 及更早版本中，Plainva 还会在 Google Drive、OneDrive 或 Dropbox 的顶层（或仓库使用前缀时在 S3 存储桶的顶层）额外创建一个同名的空文件夹。Plainva 不会自行删除这些副本；确认这样的顶层文件夹为空且不属于你的仓库文件夹后，你可以删除它。
带变音符号的字母有两种存储方式：ü 可以存为一个字符，也可以存为 u 加一个组合用的分音符。macOS 和 iOS 通常保留第二种形式（例如在访达中创建的文件夹），许多服务器和其他系统则使用第一种。Plainva 将两者视为同一个名称：它会读写已经存在的文件或文件夹，沿用本设备或云端存储它的形式，不会重命名任何内容。你在 Plainva 中创建的名称以第一种形式存储。只有当同一个文件夹中确实同时存在两种形式，或者两个名称仅大小写不同时，Plainva 才会在 两种写法，同一个文件 下列出这一对：它不同步第二种写法，也不会删除任何内容，无论是在本设备还是在云端。重命名其中一个，同步就会照常继续。
Plainva通过可互换的同步适配器来同步仓库。本页展示今天你可以使用哪些服务——直接集成、通过WebDAV协议，或通过服务商自己的桌面同步客户端。
直接集成
| 服务商 | 状态 | 说明 |
|---|---|---|
| 本地文件夹 | 可用 | 无需任何设置；外部更改（例如由其他同步工具产生的）会被自动检测到。 |
| WebDAV / Nextcloud | 可用，已通过Nextcloud验证 | 服务器URL、用户名，以及（推荐）一个应用密码。 |
| Google Drive | 可用（自备凭据） | 需要你自己的Google Cloud项目，参见Google Drive BYO指南。 |
| OneDrive | 可用 | 通过浏览器登录（PKCE，无需密钥）。Plainva已内置自己的应用注册——只需选择OneDrive并连接即可，无需任何设置。使用你自己的（免费）Entra应用注册仍然是可选项（参见OneDrive与Dropbox（BYO）指南）。 |
| Dropbox | 可用 | 通过浏览器登录（PKCE，无需密钥）。Plainva已内置自己的Dropbox应用——只需选择Dropbox并连接即可，无需任何设置。使用你自己的（免费）Dropbox应用仍然是可选项（参见OneDrive与Dropbox（BYO）指南）。 |
| S3兼容对象存储 | 可用（2026-07-04新增，原生验证尚待进行） | AWS S3、Cloudflare R2、Backblaze B2、MinIO、Wasabi、Hetzner等等——只需要一个endpoint、存储桶、区域和一对API密钥；无需浏览器登录。 |
可通过WebDAV使用的服务
WebDAV适配器支持标准WebDAV协议，因此以下服务理论上应该都可以正常使用。它们尚未逐一验证过——欢迎反馈。以下地址是典型的模式，请在服务商的官方文档中再次确认，并尽量使用应用密码而不是主密码。
| 服务 | 典型WebDAV地址 |
|---|---|
| Nextcloud（自建或托管） | https://<server>/remote.php/dav/files/<user>/ |
| ownCloud | https://<server>/remote.php/dav/files/<user>/ |
| Koofr | https://app.koofr.net/dav/Koofr |
| Strato HiDrive | https://webdav.hidrive.strato.com |
| MagentaCLOUD（德国电信） | https://magentacloud.de/remote.php/dav/files/<user>/ |
| GMX Mediacenter | https://webdav.mc.gmx.net |
| WEB.DE online storage | https://webdav.smartdrive.web.de |
| Hetzner Storage Box | https://<user>.your-storagebox.de |
| Synology NAS | 启用WebDAV Server套件，然后使用https://<nas>:5006 |
| QNAP NAS | 在系统中启用WebDAV；地址参见QNAP文档 |
| Seafile | 启用SeafDAV，然后使用https://<server>/seafdav |
通过服务商的桌面同步客户端（本地文件夹）
在原生集成到来之前，你可以使用任何桌面客户端能够保持本地文件夹同步的服务。此时Plainva会把该仓库当作一个本地文件夹处理，并自动检测外部更改。
重要提示： 请把仓库文件夹设置为”始终保留在此设备上” / “可离线使用”。仅在线的占位文件（按需下载、online-only、流式模式）可能会干扰索引和同步。
每个文件夹只用一种方式： 对于一个仓库文件夹，要么使用服务商的桌面客户端，要么使用 Plainva 自己的同步，切勿同时使用两者。同一文件夹中的两个同步工具会把每次更改上传两次，并可能重复创建文件夹——例如其中一个以与另一个不同的 Unicode 形式写入带重音的字母时。
- OneDrive（资源管理器集成；请为仓库文件夹关闭按需下载）
- Dropbox（桌面客户端；请为仓库文件夹避免使用”仅在线”）
- Google Drive桌面版（为仓库文件夹使用”镜像”模式而不是”流式”模式）
- iCloud Drive（Windows版或macOS版iCloud；把该文件夹设置为”保留已下载的内容”）
- Syncthing / Resilio Sync（点对点方式，完全不涉及任何云服务商）
关于新集成的说明（2026-07-04）
OneDrive、Dropbox和S3兼容存储自2026-07-04起已直接集成（见上表）——比总体规划（§13.3）中原定的阶段安排更早。Plainva为OneDrive和Dropbox内置了自己的应用注册——因此你不需要自己的客户端ID或App Key；这些字段已经预先填好，你只需连接即可。自备应用ID仍然是可选项（例如出于企业限制的需要）；参见OneDrive与Dropbox（BYO）指南。桌面同步客户端方式（见上文）仍将作为一种替代选项保留。
刻意未规划
- 作为API集成的iCloud： 苹果没有为iCloud Drive提供官方的第三方API。请改用本地iCloud文件夹（见上文）。
- 将Syncthing作为内置服务商： 无需如此——Plainva可以配合任何由Syncthing（iPhone和iPad上为Synctrain）保持同步的本地文件夹使用（见上文）。
- Proton Drive / Mega： 没有官方API，或者只有难以集成的API（端到端加密、C++ SDK）。持续观察中。
- 观察清单（按需评估）：pCloud、Box、Filen、SFTP。