---
description: "Jotaid 最常被问到的疑问，以及 iCloud 同步、备份、导入导出与 AI 出问题时的排查步骤。"
---
<!--
  Markdown representation of https://docs.jotaid.com/zh/guide/troubleshooting
  Generated by scripts/gen-markdown-variants.mjs — do not edit by hand.
  Served from the canonical URL under `Accept: text/markdown`.
-->

# 常见问题

先是几个最常被问到的疑问，然后是按现象分类的排查步骤。快捷键与手势见[快捷键](https://docs.jotaid.com/zh/guide/shortcuts-faq)。

## 一般疑问

### 我如何解锁 Pro？

免费的 Inbox 版本本身就完全可用。当你想要 Pro 时，解锁界面会提供**年度订阅**或**一次性购买**——两者解锁的功能相同。参见 [解锁 Pro](https://docs.jotaid.com/zh/guide/unlock-pro)。

### 我需要账户吗？

不需要账户。Jotaid 是本地优先的，数据存储在你的设备上。可选的 iCloud 同步使用你现有的 Apple ID。

### 我的数据存储在哪里？

在你的设备上，存于 Jotaid 的本地存储中。如果你启用了 iCloud 同步，一份副本也会存在你的私有 iCloud 里。你的 AI API 密钥存储在系统钥匙串（Keychain）中，除了在你调用所选服务商时之外，绝不离开你的设备。

### JOTAID 会用我的笔记训练 AI 吗？

不会。AI 功能只会把内容发送给**你**配置的服务商，且仅在你触发某个功能时发送。不会为训练收集任何东西。

### 我可以不用 AI 使用 JOTAID 吗？

可以。所有核心功能——编辑、三层结构组织、backlinks、图谱和矩阵——都无需任何 AI 配置即可工作。AI 是可选的 Pro 层。

### 我如何把笔记移出 Inbox？

创建一个 Project（Pro），然后把笔记移进去。在免费版中，所有内容都存放在 Inbox。

### 如果我丢失了备份密码会怎样？

加密备份在没有密码的情况下无法恢复——密码用于派生加密密钥。请把它妥善保管。

## 同步

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

- 确保**两台设备都登录了同一个 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 文本的文件会被跳过，并列在导入报告中。

### 我导出的文件缺少图片

导出只包含文本。若要把笔记**和**附件一起迁移，请改用加密的**备份**。参见[同步](https://docs.jotaid.com/zh/guide/sync)。

## AI

### 「Invalid API key」

重新检查你粘贴的是完整密钥、末尾没有多余空格，并且该密钥在 provider 一侧仍有配额/额度。参见 [AI 配置](https://docs.jotaid.com/zh/guide/ai-setup)。

### AI 结果为空或被截断

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

### 我找不到 AI 设置

AI 是 Pro 功能。请先解锁 Pro；AI 配置区域只有在解锁之后才会出现。参见[解锁 Pro](https://docs.jotaid.com/zh/guide/unlock-pro)。

## 界面导航

### 我在 iPhone 上无法切换视图

在 iOS 上没有键盘快捷键。打开**左侧抽屉**（汉堡图标），然后点击 Note、Node 或 Theme。参见[界面视图](https://docs.jotaid.com/zh/guide/canvas)。

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

这在首次启动时是正常的 —— Jotaid 从空白开始，而 iOS 会落到 Quick Note。参见[简介](https://docs.jotaid.com/zh/guide/getting-started)。
