云同步配置指南

云同步是什么

工作方式：你在本机修改待办 → 软件写入本地数据库 → 后台上传到坚果云 → 其他设备拉取并合并。

开始之前：你需要准备什么

坚果云：生成 WebDAV 应用密码

步骤 1 — 进入安全设置

1. 登录 坚果云网页版
2. 右上角头像 → 账户信息
3. 左侧 安全选项 → 第三方应用管理

步骤 2 — 添加应用密码

1. 点击 添加应用密码
2. 应用名称填 FloatingTodo（任意，便于识别）
3. 生成密码后 立即复制

步骤 3 — 记下连接信息

FloatingTodo 内配置

步骤 1 — 打开云同步设置

设置 → 找到分区标题 云同步（WebDAV） → 开启 启用云同步。

若本地待办尚未写入 SQLite、或迁移未完成，标题右侧会出现数据库图标（叠层圆柱形），点击可执行本地数据迁移/修复（与坚果云上传无关）。

步骤 2 — 填写连接信息

步骤 3 — 测试连接

点击 测试连接：

• 成功：提示「已连接，目录 FloatingTodo 已就绪」
• 失败：见下方常见问题

步骤 4 — 首次同步

点击 立即同步。也可手动开启 自动同步（默认关闭；开启后默认约每 10 分钟双向同步，可在设置中改为 5 / 10 / 15 / 30 分钟）。WebDAV 无实时推送，急用请点「立即同步」。

会同步什么？不会同步什么？

默认同步

不同步（留在本机）

设置页提供 同步内容 多选，可单独关闭番茄、设置等模块。

多设备怎么用

第二台电脑（推荐流程）

1. 安装 同版本 FloatingTodo
2. 用 同一坚果云账号 配置 WebDAV（可复用同一应用密码，或新建一个应用）
3. 测试连接 → 立即同步 → 待办应出现

注意事项

云端目录结构（仅供查看，请勿手改）

FloatingTodo/
  manifest.json       ← 全局版本号、最后更新时间
  snapshot.json       ← 全量快照（定期生成，用于恢复）
  changes/
    00000001.json     ← 增量变更批次
    00000002.json

常见问题与排错

同步日志路径：%APPDATA%\floating-todo\logs\sync.log

安全与隐私

卸载与退出

• 关闭云同步 ≠ 删除云端文件；需到坚果云网页手动删除 FloatingTodo/ 文件夹
• 卸载软件 不删除本地数据库；重装后可继续使用
• 更换坚果云账号：在软件内修改配置 → 建议先 导出 JSON 备份 → 再同步到新账号目录

获取帮助

• 软件内：设置 → 云同步（WebDAV）→ 云同步配置指南（打开本页）
• 坚果云 WebDAV 官方帮助：help.jianguoyun.com
• 官网：floatingtodo.top

连接参数速查