注意：此插件目前处于 Alpha 开发阶段。WebDAV 同步功能已完全实现，GitHub 和 iCloud 等其他云盘服务仍在开发中。欢迎测试使用并反馈，但在同步重要数据时请务必备份。
一款强大的 Obsidian 插件，支持将笔记自动同步到多种云盘服务，提供端到端加密保护，让您的笔记既安全又便捷。
- 端到端加密：所有文件在上传前使用 AES-256 加密，保护您的隐私
- WebDAV 支持：可通过 WebDAV 协议连接坚果云等服务，已实现完整同步功能
- 智能同步：支持双向同步、本地到远程、远程到本地三种同步模式
- 自动同步：文件变更时自动同步到云盘，支持增量同步以提高效率
- 定时同步：支持设置定时同步间隔，可自定义同步频率
- 选择性同步：可配置需要同步的文件类型和排除特定文件夹
- 基本操作支持：支持文件创建、修改、删除等操作的同步
- 冲突处理：提供基本的冲突解决策略，支持保留本地版本、远程版本或最新版本
注意：由于插件处于测试阶段，目前仅支持从源码安装。未来稳定版将通过 Obsidian 插件市场发布。
git clone https://github.com/ai-bytedance/obsidian-cloud-sync.git
cd obsidian-cloud-sync
npm install
npm run build
将生成的 main.js、manifest.json 和 styles.css 复制到您的 Obsidian 库的 .obsidian/plugins/cloud-sync/ 目录下。
- 安装并启用插件后，点击插件设置
- 设置加密密钥（请妥善保管，丢失将无法恢复已加密文件）
- 选择要使用的云盘服务
- 配置相应的云盘凭据
- 设置同步文件夹路径和同步策略
- 点击"测试连接"按钮，确认连接成功后开始使用
- 已完整实现，支持所有同步功能
- 支持多种WebDAV服务商，包括坚果云、NextCloud等
- 提供智能延迟功能，避免触发坚果云免费版API限制
- 需要配置WebDAV服务器地址、用户名和密码
- 开发中，当前仅包含设置界面
- 计划使用GitHub仓库存储数据，支持公开和私有仓库
- 需要配置GitHub用户令牌和仓库信息
- 开发中，当前仅包含设置界面
- 计划需要配置iCloud账号和密码
- 开发状态：UI已实现，后端功能开发中
- 需要在Google Cloud Console创建项目
- 配置 OAuth 客户端 ID 和客户端密钥
- 开发状态：规划中
- 需要在Microsoft Azure Portal注册应用
- 配置客户端 ID 和客户端密钥
- 开发状态：规划中
- Beta 版本说明：当前版本已经过初步测试，但可能仍有部分功能不稳定
- 加密密钥安全：请务必备份您的加密密钥，密钥丢失将导致无法恢复已加密文件
- 网络依赖：同步功能依赖网络连接，请确保网络稳定
- API 限制：云盘 API 可能有调用频率和流量限制，过于频繁的同步可能触发限制
- 大文件同步：大文件同步可能需要较长时间，请耐心等待
- 冲突处理：可在高级设置中选择您偏好的冲突处理策略
- Markdown链接转换：插件会在上传时将Obsidian特有的链接格式（如
[[内部链接]]和![[图片]]）转换为标准Markdown格式（如[内部链接](内部链接)和），以便在其他Markdown编辑器中正常显示。请注意，这可能会影响某些特殊格式的链接，尤其是代码块中的内容。
插件目前处于Alpha开发阶段，功能和稳定性仍在进一步开发和优化中。待实现完整功能并经过足够测试后，将提交到 Obsidian 插件市场审核。
目前只有WebDAV服务（如坚果云、NextCloud等）已完整实现。GitHub和iCloud等其他服务仍在开发中，尚不可用。
- 确认您的凭据正确无误
- 检查网络连接是否正常
- 检查服务器地址是否包含完整的协议前缀（如https://）
- 若为WebDAV，确认路径末尾是否需要斜杠
- 尝试重新授权
- 检查网络连接
- 确认云盘空间是否充足
- 启用调试模式查看详细日志
- 尝试重新授权云盘
- 尝试更改同步策略
- 重启 Obsidian 后再试
更换加密密钥会导致无法解密之前加密的文件，建议：
- 先备份所有文件
- 更改加密密钥
- 重新同步所有文件
- 在每台设备上安装插件
- 使用相同的云盘账号和加密密钥
- 配置相同的同步设置
- 推荐使用双向同步模式
插件开发者为这款插件付出了大量的时间与精力。如果你觉得这个插件很有用，就支持一下开发吧！
