---
description: "Jotaid 的 iCloud 同步：没有开关、跟着 Apple ID 走，以及 Sync Health 的三项检查与「从 iCloud 重建」这个最后手段。"
---
<!--
  Markdown representation of https://docs.jotaid.com/zh/guide/sync
  Generated by scripts/gen-markdown-variants.mjs — do not edit by hand.
  Served from the canonical URL under `Accept: text/markdown`.
-->

# 同步

Jotaid 是**本地优先**的：所有功能完全离线可用，数据存在你自己的设备上。iCloud 同步是叠加在上面的**可选层**，不是运行的前提。

## 没有同步开关

Jotaid 通过 **iCloud（CloudKit）**同步，让 Mac 与 iPhone 上的笔记保持一致。

**App 内没有开关**——登录了 iCloud 就在后台同步，没登录就纯本地工作，两种状态下功能都完整。要改变同步，去**系统设置**里登录或退出 iCloud。

之所以不做这个开关：它会变成一个你以为关掉了、实际状态却和系统不一致的第二真相源。

> **多项目同步属于 Pro**
>
> Inbox 的同步免费档就有。跨多个 project 的同步需要 [Pro](https://docs.jotaid.com/zh/guide/pricing)。

## 离线时

断网时保存的笔记会**排队**，网络恢复后自动同步——你会看到「笔记已加入队列」的提示。不需要手动重试，也不必等它完成才能继续写。

## Sync Health

**设置 → 数据同步** 会实时跑三项检查：

| 检查 | 看什么 |
|------|--------|
| **iCloud 连接** | 账户可用、已退出，还是受限 |
| **同步配置** | iCloud 那边是否已经准备好接收——没就绪时给一个 **Fix** 按钮 |
| **数据完整性** | 孤立附件与结构问题；同步进行中会暂停此项检查 |

它**不显示「上次同步时间」或待处理条数**。同步的时机由 iCloud 自己安排，这类数字既不准确也不可操作，显示出来只会让人盯着它焦虑。

## 从 iCloud 重建

Sync Health 里有一个 **从 iCloud 重建**。它会**清空本地数据并从 iCloud 重新下载全部内容**。

> **这是最后手段**
>
> - 尚未同步上去的本地更改**会丢失**
> - Jotaid 会在动手前**先做一份备份**
> - 重建失败时会**恢复你原有的本地资料库**，不会两头落空
> - 清空完成后需要**退出并重启 App** 才能完成重新同步
>
> 只在设备明显卡住、且提示建议这么做时使用。

## 什么不会同步

- **AI API Key** 存在系统钥匙串里，不进 iCloud，也不随备份走
- **界面偏好**（主题、字号档）是每台设备各自的

## 下一步

- [备份与恢复](https://docs.jotaid.com/zh/guide/backup) —— 与 iCloud 无关的第二份保险
- [常见问题](https://docs.jotaid.com/zh/guide/troubleshooting) —— 同步不动时怎么查
- [免费版 vs Pro](https://docs.jotaid.com/zh/guide/pricing) —— 多项目同步属于哪一档