常见问题排查

常见问题及其解决方法。完整的功能 FAQ，请见快捷键与常见问题。

同步

我的笔记在设备之间不同步

• 确保两台设备都登录了同一个 iCloud 账户。同步跟随你的 iCloud 账户 —— App 内没有切换开关。
• 打开设置 → Sync Health，检查 iCloud Connection。如果显示 Not Signed In 或 Restricted，请在系统 iCloud 设置中修复。
• 如果 Sync Configuration 报告缺少 zone，使用它的 Fix 操作。
• 同步在后台运行，并非即时；给新设备一些时间来下载。

Sync Health 显示警告

警告（孤立附件、清理进行中）往往是暂时的 —— 一台设备正处于同步中途是正常的。等同步稳定后再重新检查。持续存在的错误值得完整读一遍；每一项检查都会说明它发现了什么。

「Rebuild from iCloud」—— 我该用它吗？

只有在某台设备真的卡死时，才作为最后手段使用。它会清空本地数据并从 iCloud 重新下载；未同步的本地更改会丢失（Jotaid 会先做备份）。如果拿不准，请在尝试之前自己先导出一份备份。

备份

我忘了备份密码

无法找回。备份加密从你的密码派生出密钥，所以密码丢了就意味着备份打不开。请务必把备份密码存放在安全的地方。

导入备份后没有恢复全部内容

导入是合并到你当前的库中，可能以部分成功结束 —— 例如，某些附件可能缺失。详情请查看导入报告。

导入与导出

我的 Markdown 文件夹导入后结构不对

文件夹导入会自动映射结构：文件夹本身变成一个 Project，顶层子文件夹变成 Theme，更深层的子文件夹则折叠为 #标签。请在导入前先把文件夹按这种方式排列好。

导入时有些文件被跳过了

超过约 10 MB，或不是 UTF-8 文本的文件会被跳过，并列在导入报告中。

我导出的文件缺少图片

导出只包含文本。若要把笔记和附件一起迁移，请改用加密的备份。参见同步、备份与导出。

AI

「Invalid API key」

重新检查你粘贴的是完整密钥、末尾没有多余空格，并且该密钥在 provider 一侧仍有配额/额度。参见 AI 配置。

AI 结果为空或被截断

模型很可能对这个任务来说太小了。换一个更大的模型，或换一个输出上限更高的 provider。

我找不到 AI 设置

AI 是 Pro 功能。请先解锁 Pro；AI 配置区域只有在解锁之后才会出现。参见解锁 Pro。

界面导航

我在 iPhone 上无法切换视图

在 iOS 上没有键盘快捷键。打开左侧抽屉（汉堡图标），然后点击 List、Canvas 或 Node。参见 macOS 与 iOS。

App 打开后是一片空白 / 一个记录框

这在首次启动时是正常的 —— Jotaid 从空白开始，而 iOS 会落到 Quick Note。参见首次启动。