Skip to main content
本指南涵盖使用 Craft 时可能遇到的常见问题及解决方法。展开以下各节，找到与您问题匹配的主题。

​
先从这里开始

以下三项检查可解决大多数问题：
  1. 在您使用的每台设备上将 Craft 更新至最新版本。
  2. 重启应用，或在网页应用中重新加载页面。
  3. 检查您的操作系统版本。 Craft 要求 macOS 12 或更高版本、iOS 或 iPadOS 15 或更高版本，或 Windows 10 或更高版本。
部分故障排除内容位于对应的功能文档中：

​
同步问题

大多数同步问题可通过诊断面板进行诊断和修复。打开设置 → 诊断，查看当前同步状态、手动触发同步，或直接向我们的团队报告同步错误。
Windows 版 Craft 和网页应用没有诊断面板。在这些平台上，请参阅Windows 和网页应用问题了解替代方法。
Craft 中的诊断设置面板，显示同步状态、故障排除链接、同步历史记录和重置同步选项
立即同步和报告同步错误随时可以安全使用。立即重置同步会丢弃尚未上传到服务器的本地更改，且无法恢复。仅在支持团队要求时使用。
最快的解决方法是完全关闭并重新启动 Craft。
  1. 打开活动监视器（通过 Spotlight 搜索，或前往应用程序 → 实用工具）
  2. 在列表中找到 Craft
  3. 选中后点击顶部的停止（⊗）按钮
  4. 重新打开 Craft
重启后，打开设置 → 诊断，查看面板顶部的同步状态。
首先，确认您在每台设备上使用相同的账户和登录方式登录。即使邮箱地址看起来相同，使用邮箱和通过 Apple 登录创建的是不同的账户。查看您的邮箱地址：
您的邮箱地址显示在文档列表左上角头像旁边。
如果您的邮箱以 @privaterelay.appleid.com 结尾，说明您使用了通过 Apple 登录进行注册。这是 Apple 生成的中继地址，并非您的真实邮箱。请确保在每台设备上使用相同的 Apple ID。
在 Mac、iPhone 和 iPad 上，打开设置 → 诊断，点击立即同步。应用将尝试重启同步进程。在 Windows 和网页应用上没有诊断面板，请重启应用或重新加载页面。如果立即同步未能解决问题：
  1. 退出 Craft 账户（设置 → 账户 → 退出登录）
  2. 强制退出应用
  3. 等待 30 秒，重新打开 Craft 并重新登录
如果文档在某台设备上显示而在另一台上不显示，请再次检查两台设备上的账户和登录方式（参见上方的文档未在设备间同步）。
VPN、广告拦截器（如 AdGuard）和网络监控工具（如 Little Snitch）可能会阻止 Craft 同步。
  1. 暂时禁用该工具
  2. 重启 Craft
  3. 检查同步是否恢复
浏览器扩展（如 Hush 和 Plume Guard）也可能阻止访问 Craft 的服务器。
企业防火墙和隐私程序可能会阻止 Craft 的流量。如果您使用的是工作网络，请联系 IT 部门允许以下域名：
  • api.craft.do
  • docs.craft.do
  • res.craft.do
另请参阅：无法在网页应用或 Windows 上访问 Craft。
在诊断面板中，同步历史记录一行会显示 新增、上传 和 已同步 的数量。当 新增 和 上传 均为 0 时，表示没有待上传的内容，因此文档并未卡在同步队列中。出现这种情况时，内容丢失通常源于以下原因之一：
  • 您登录了不同的账户。 使用邮箱登录和通过 Apple 登录会创建不同的账户。请参阅上方的文档未在设备间同步。
  • 您查看的是不同的空间。 从头像处打开空间列表，逐一检查每个空间。
  • 文档已被删除。 检查最近删除，然后参阅存储与恢复。
不要使用立即重置同步来查找丢失的内容。它会丢弃尚未上传的本地更改，可能将显示问题变成永久性数据丢失。
如果继续使用 Apple 登录后进入了没有文档的账户，但使用邮箱和验证码登录可以看到所有内容，说明您的 Apple 登录已不再与 Craft 账户关联。这通常发生在您通过验证码更改账户邮箱地址之后。更改邮箱会移除通过 Apple 登录的关联，因此下次继续使用 Apple 时会创建一个新的空账户。您的内容仍保存在原账户中。使用邮箱和验证码登录即可访问。要重新关联 Apple 登录，请在 Mac、iPhone 或 iPad 上打开设置 → 账户 → 邮箱地址 → 继续使用 Apple。
重新关联前请注意三点：新空账户仍持有您的 Apple ID 时，关联会被拒绝，需先删除该空账户。如果您的账户是任何团队的成员，关联同样会被拒绝。关联后，Craft 的邮箱地址会更新为 Apple 发送的邮箱，可能是您之前的地址。账户无法合并，如果您在两个账户中都添加了内容，请联系支持团队。
文件上传与文档同步是分开进行的，上传失败不会影响文字编辑或其他文档的同步。Craft 会在上传失败后最多重试三次，随后停止。如果文件未出现在其他设备上：
  1. 检查网络连接，以及网络上是否有 VPN、代理或广告拦截器。
  2. 删除该块并重新添加文件。
  3. 如果文件较大，尝试使用较小的版本。文件大小上限取决于您的订阅方案，超过上限的文件在上传开始前就会被拒绝。
如果同一文件每次都上传失败，请将文件类型、大小和屏幕录制一并发送给我们。参见报告错误。

​
登录问题

在 Mac 上选择继续使用 Apple 时，系统会提示您输入密码。这是 Apple 的安全机制。
请输入您的 macOS 用户账户密码，而非 Apple ID 的密码。如果输入了 Apple ID 密码，提示框会再次出现，且不显示任何错误信息。
某些浏览器扩展、广告拦截器或私有网络可能会阻止您访问 Craft。常见症状包括找不到服务器或页面无法加载。已知会导致此问题的应用：
  • Hush
  • Plume Guard（Plume HomePass 应用中的安全 DNS 功能）
请尝试以下步骤：
  1. 暂时禁用扩展或工具
  2. 在工具配置中将 Craft 的域名标记为安全
  3. 尝试切换到其他网络
如果问题在切换网络和使用蜂窝数据后仍然存在，请联系支持团队。

​
编辑问题

Craft 会合并所有打开该文档的设备上的编辑内容。对不同块的更改会保留两台设备各自的结果。当两台设备在完成同步前更改了同一个块的同一部分时，服务器上的版本会被保留，另一台设备上输入的文字可能被替换。建议操作：
  1. 关闭其他设备上的该文档。在网页应用中，关闭显示该文档的多余浏览器标签页。
  2. 在继续编辑前，等待每台设备完成同步。在 Mac、iPhone 和 iPad 上，可在设置 → 诊断中查看同步状态。
  3. 将每台设备上的 Craft 更新至最新版本。
如果在只有一台设备打开文档的情况下文字仍然消失，请向我们发送屏幕录制、应用版本和操作系统版本。参见报告错误。
如果网页编辑器在使用过程中出现重绘或闪烁，请按以下步骤排查原因：
  1. 重新加载页面。
  2. 在禁用扩展的隐私窗口中打开 Craft，以排除扩展的影响。
  3. 将浏览器更新至最新版本。
  4. 尝试其他浏览器，确认闪烁是否跟随出现。
如果问题持续存在，请向我们发送屏幕录制、浏览器名称和版本，以及浏览器控制台的截图。参见获取诊断数据。

​
性能问题

快速解决方案：
  1. 通过活动监视器重启应用（步骤参见上方的诊断显示为离线）
  2. 关闭未使用的标签页和窗口
  3. 检查窗口管理应用（如 Magnet、Rectangle）是否已更新至最新版本
联系支持时请提供以下信息：
  • 您是否在使用外部存储空间？
  • 是否使用了任何窗口管理应用？
  • 是否使用了任何第三方文本编辑工具？
  • 系统设置 → 隐私与安全性 → 辅助功能的截图
  • 重启应用是否有帮助？
  • 多个标签页和窗口是否会触发此问题？
对于持续性卡顿，请向我们发送 Spindump。步骤请参见下方报告错误中的获取诊断数据。
请检查以下内容：
  1. 您运行的是哪个 Windows 版本？
  2. 您是否连接到公司网络或 VPN？
  3. 重启应用是否能恢复正常性能？
  4. 重启电脑是否能恢复正常性能？
如果问题持续存在，请录制一段全屏视频展示该问题并发送给支持团队。其他日志信息请参见下方报告错误中的获取诊断数据。
要在 macOS 上将 Grammarly 桌面应用与 Craft 配合使用：
1

下载 Grammarly

从 grammarly.com/desktop 获取桌面应用。
2

启动 Grammarly

安装完成后打开应用。
3

授予辅助功能权限

按照应用内指引，在系统设置 → 隐私与安全性 → 辅助功能中启用 Grammarly。
4

重启 Craft

退出并重新打开 Craft 应用。
选中文本块时，Grammarly 小组件应会出现。

​
macOS 特定问题

如果 App Store 中只显示打开按钮而非更新按钮：
1

强制退出 App Store

2

重新打开 App Store

3

搜索 Craft Docs

4

打开应用详情页

点击应用标题进入完整详情页面。
5

检查更新按钮是否出现

此消息出现的原因是 Mac 上存在来自之前安装的残留文件。通常发生在 Craft 从多个来源安装时（例如同时从 App Store 和 Setapp 安装）。
1

从应用程序中删除 Craft

2

清除容器文件夹

在 Finder 中，前往前往 → 前往文件夹，逐一粘贴以下路径并删除其中的内容：
3

清理残留文件

如果提示仍然出现，在 Group Containers 和 Containers 文件夹中搜索包含 craft、lukilabs 或 lukiapp 的项目并将其删除。
4

重新安装 Craft

从您偏好的来源全新安装 Craft。

​
iOS / iPadOS 特定问题

您可以通过分享菜单向 Craft 共享文本和链接。直接共享照片或文件可能会产生无法使用的链接。方式一：复制并粘贴
  1. 在分享菜单中选择复制
  2. 打开 Craft
  3. 粘贴到目标文档中
方式二：下载后添加
  1. 将文件保存到设备
  2. 在 Craft 中，点击左下角的 + 按钮
  3. 选择文件
  4. 选中该文件

​
Windows 和网页应用问题

如果您使用的是公司设备或网络，公司的代理服务器可能阻止了访问。请联系 IT 部门允许以下域名：
  • api.craft.do
  • docs.craft.do
  • res.craft.do
此消息表示应用已失去与互联网或我们服务器的连接。应用将自动尝试重新连接。应对措施：
  • 检查网络连接。 确保连接处于活动且稳定状态。
  • 暂停编辑。 在连接恢复之前，避免进行修改，以防数据丢失。
  • 重新加载页面。 如果连接稳定且没有未保存的更改，可以刷新页面。
连接恢复后，该提示将自动消失。
在网页应用中，某些粘贴的链接（如 LinkedIn）可能显示获取数据失败而非缩略图。我们用于获取链接预览的第三方服务被部分提供商屏蔽，这是我们无法直接控制的外部问题。仍然有效的功能：
  • 点击链接可正常打开
  • 仅网页应用受影响
  • 仅个人 LinkedIn 主页链接受影响
  • 公司 LinkedIn 链接可正常显示
  • 所有 LinkedIn 缩略图在 macOS、iOS 和 iPad 上均可正常显示
Windows 版 Craft 会在后台检查更新并自动下载。新版本准备就绪时，应用内会出现横幅提示，下次退出并重新打开 Craft 时更新即会生效。如果您从 Microsoft Store 安装了 Craft，由 Store 负责下载，Craft 随后会显示横幅提示您重启。
关闭窗口不等于退出应用。Craft 会继续在系统托盘中运行，请使用托盘图标的退出 Craft 选项完全关闭应用。参见关闭窗口后 Craft 仍在运行。
手动更新：
  1. 卸载 Windows 版 Craft
  2. 从 craft.do/download 或 Microsoft Store 下载最新版本
在 Windows 上，点击关闭（X）按钮只会隐藏窗口，Craft 会继续在任务栏右端的系统托盘中运行。这是预期行为，目前没有关闭此行为的设置。
  • 完全退出 Craft： 右键点击系统托盘中的 Craft 图标，选择退出 Craft。
  • 恢复窗口显示： 点击托盘图标，或从其右键菜单中选择打开 Craft。
在 3.4.0 版本之前，从开始菜单打开 Craft 时，若应用已最小化到托盘，窗口不会恢复显示，只能通过托盘图标恢复。如遇此问题，请更新至 3.4.0 或更高版本。
Windows 版 Craft 没有诊断面板，同步问题中描述的同步操作在此平台上不可用。请按以下步骤操作：
1

重启应用

从系统托盘退出应用（而非关闭窗口），然后重新打开 Craft。
2

更新至最新版本

参见如何更新 Windows 版 Craft。
3

检查 VPN、代理或 DNS 过滤

企业 VPN、代理和 DNS 过滤是 Windows 上同步失败的常见原因。断开连接后重新测试。
4

确认账户和登录方式

须与其他设备保持一致。参见文档未在设备间同步。
5

请 IT 部门允许 Craft 的域名

在托管设备上，请允许 *.craft.do。Craft 使用多个子域名来处理同步、资源和内容，仅允许其中一部分会导致应用的部分功能无法正常使用。
如果同步仍然失败，请将屏幕录制、Craft 版本和 Windows 版本一并发送给我们。参见报告错误。
Windows 版 Craft 在无法将窗口和标签页布局写入磁盘时会显示以下提示。
  • 磁盘空间严重不足。 Craft 已没有可写入的空间。请清理系统驱动器上的可用空间，然后重启 Craft。
  • 无法保存标签页状态。 另一个程序锁定了 Craft 的数据文件。请重启 Craft，如果问题仍然存在，请重启 Windows。
两条提示均与已保存的标签页布局相关，而非文档本身。但磁盘空间不足也可能影响其他写入操作，建议无论哪种情况都释放磁盘空间。

​
订阅问题

如果您最近完成了升级，但 Craft 仍然显示免费版限制（1,500 个块），应用可能尚未刷新您的订阅状态。
  1. 退出 Craft 账户（设置 → 账户 → 退出登录）
  2. 完全关闭应用
  3. 重新打开 Craft 并重新登录
您的升级计划现在应该已生效。如果仍未生效，请确认您使用的是购买订阅时所用的同一账户登录。

​
数据与存储问题

最近删除文件夹消失可能有两个原因：
  1. 已删除的文档超过 30 天
  2. 已删除文件夹的内容被手动清空
如果您是误删，请查阅存储与恢复文档，了解可用的恢复选项。
如果重新添加外部位置时反复收到外部位置已添加的提示，但该位置并未显示为空间：
1

退出 Craft 账户

2

重新登录

3

再次尝试添加外部位置

如果提示仍然出现：
  1. 从设备中删除 Craft 应用
  2. 重新安装应用
  3. 再次尝试添加外部位置
iCloud 设备备份与 Craft 自身的同步是两回事。
  • Craft 同步将您的文档复制到我们的服务器。这是您在新设备上登录后恢复内容的方式，也是应当依赖的数据保障路径。
  • iCloud 设备备份备份的是整台设备。它恢复的也是整台设备，而非单个文档，因此您无法从中单独提取一个 Craft 文档。
如需文档级别的恢复，请使用最近删除和文档历史记录，而不是设备备份。参见存储与恢复。存储在 iCloud Drive 中的外部存储空间属于另一种情况。参见下方的外部存储的 iCloud 同步问题。
iCloud Drive 同步的可靠性和性能超出我们的控制范围。如果同步无法正常工作，以下步骤通常有帮助。
我们不建议在多台设备上使用外部空间。这可能导致数据冲突和数据丢失。如果您不确定如何使用空间，请联系支持团队。
故障排除步骤：
  1. 手动触发同步。 打开 Finder（macOS）或文件应用（iOS），导航到您的 iCloud Drive 文件夹。
  2. 编辑文档。 修改内容可触发同步。
  3. 检查网络连接。 使用 Wi-Fi 或快速的蜂窝网络连接，并确保设备有足够电量。
  4. 切换飞行模式。 重新连接可重启 iCloud Drive 同步。
  5. 检查蜂窝同步设置：
    • 在设置 → 蜂窝网络下启用系统服务
    • 在设置 → iCloud → iCloud 云盘下启用使用蜂窝网络
  6. 检查电量。 低电量会降低同步速度以节省电量。
  7. 检查 iCloud 存储限额。 达到存储配额后同步将停止。
  8. 重启设备。 确保 iCloud 服务正常运行。
  9. 确认 iCloud 已启用：
    • iOS： 登录 iCloud 并启用 iCloud 云盘
    • macOS： 登录 iCloud 并在 Apple ID 设置中启用 iCloud 云盘
  10. 关闭优化 Mac 储存空间。 开启此功能后，Mac 会将文件转移到云端，可能导致文件丢失。
  11. 耐心等待。 首次同步最长可能需要一天时间。
  12. 退出并重新登录。 如果 iCloud Drive 卡住，请退出 iCloud 账户并重新登录。
  13. 设置自动时间。 确保所有设备都启用了自动时间设置。
  14. 更新操作系统。 Apple 会在每个 OS 版本中改进 iCloud。
  15. 查看 Apple 的系统状态页面。

​
报告错误

如果您在 Craft 中遇到了错误，我们非常欢迎您的帮助来追踪问题。清晰的报告有助于我们更快地调查和解决问题。

​
报告前的准备

  • 确保您使用的是 Craft 的最新版本
  • 重启应用，或刷新网页版
  • 如果问题仍然存在，请继续以下步骤

​
需要包含的信息

1

确认您的版本

请说明您正在运行的确切版本号。
2

提供您的环境信息

  • 设备型号（如 MacBook Pro M2、iPhone 15、Windows 笔记本电脑）
  • 操作系统及版本（如 macOS Sequoia 15.4、iOS 18.5、Windows 11 23H2）
  • 平台（桌面应用、移动应用或网页版）
3

描述重现步骤

列出导致问题的确切操作步骤。例如：打开文档 → 添加新页面 → 插入图片 → 问题出现。
4

附上屏幕录制

录制内容应简短且聚焦于问题，录制完整屏幕（而非裁剪区域），并使用最高可用分辨率。截图也适用于视觉错误和错误信息。请参阅下方的如何录制屏幕。
5

附上诊断文件（如适用）

对于崩溃、卡顿或持续的同步问题，请附上 Spindump、sysdiagnose 或浏览器控制台日志。请参阅下方的获取诊断数据。

​
如何录制屏幕

  • 在设置 → 控制中心中启用屏幕录制
  • 打开控制中心，点击录制
  • 点击红色状态栏停止录制
  • Apple 官方指南

​
获取诊断数据

对于持续性崩溃、卡顿或同步问题，我们的团队可能会要求您提供诊断文件。具体格式取决于您的平台，但目标始终相同：捕获问题发生时系统正在执行的操作。
Spindump 可捕获所有运行中进程的快照。对于 macOS 上的卡顿、彩虹转圈或运行缓慢的问题，这是您能发送给我们的最有用的文件。
1

重现问题

在 Craft 中触发缓慢或无响应的行为，并保持该状态。
2

打开活动监视器

在应用程序 → 实用工具中找到，或使用 Spotlight（⌘ + 空格）搜索。
3

创建 Spindump

点击工具栏中的三点菜单 （⋯），然后选择 Spindump。
4

保存文件

等待几秒钟让报告生成完毕，然后将文件保存到桌面。
5

发送给支持团队

将 .txt 文件附加到您的支持工单中，并附上问题发生前您所执行操作的简短描述。

​
报告后会发生什么

  • 偶发性问题： 我们会记录并持续关注相关案例
  • 可复现的错误： 我们会在内部上报进行调查和修复
感谢您花时间报告错误。您的反馈有助于我们让 Craft 变得更好。

​
仍需帮助？

如果您在这里找不到解决方案，我们随时为您提供帮助：

联系支持团队

直接从我们的支持团队获取帮助

获取帮助

了解所有获取支持和提交反馈的方式