跳转到主要内容
本指南涵盖使用 Craft 时可能遇到的常见问题及解决方法。展开以下各节，找到与您问题匹配的主题。
部分故障排除内容位于对应的功能文档中：

​
同步问题

大多数同步问题可通过诊断面板进行诊断和修复。打开设置 → 诊断，查看当前同步状态、手动触发同步，或直接向我们的团队报告同步错误。
Craft 中的诊断设置面板，显示同步状态、故障排除链接、同步历史记录和重置同步选项
最快的解决方法是完全关闭并重新启动 Craft。
  1. 打开活动监视器（通过 Spotlight 搜索，或前往应用程序 → 实用工具）
  2. 在列表中找到 Craft
  3. 选中后点击顶部的停止（⊗）按钮
  4. 重新打开 Craft
重启后，打开设置 → 诊断，查看面板顶部的同步状态。
首先，确认您在每台设备上使用相同的账户和登录方式登录。即使邮箱地址看起来相同，使用邮箱和通过 Apple 登录创建的是不同的账户。查看您的邮箱地址：
您的邮箱地址显示在文档列表左上角头像旁边。
如果您的邮箱以 @privaterelay.appleid.com 结尾，说明您使用了通过 Apple 登录进行注册。这是 Apple 生成的中继地址，并非您的真实邮箱。请确保在每台设备上使用相同的 Apple ID。
打开设置 → 诊断，点击立即同步。应用将尝试重启同步进程。如果立即同步未能解决问题：
  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。

​
登录问题

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

​
性能问题

快速解决方案：
  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 中，前往前往 → 前往文件夹，逐一粘贴以下路径并删除其中的内容：
~/Library/Group Containers/group.com.lukilabs.lukiapp.share/
~/Library/Containers/com.lukilabs.lukiapp
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 在退出并重新打开应用时会自动更新。有新版本可用时，Windows 通知面板（右下角）会出现通知。手动更新：
  1. 卸载 Windows 版 Craft
  2. 从 craft.do/download 或 Microsoft Store 下载最新版本

​
订阅问题

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

​
数据与存储问题

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

退出 Craft 账户

2

重新登录

3

再次尝试添加外部位置

如果提示仍然出现：
  1. 从设备中删除 Craft 应用
  2. 重新安装应用
  3. 再次尝试添加外部位置
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 变得更好。

​
仍需帮助？

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

联系支持团队

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

获取帮助

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