跳转到主要内容
本指南介绍在使用 Craft 时可能遇到的常见问题以及对应的解决方法。有关平台特定的问题，请展开下方相应部分查看详细信息。
部分故障排查内容已在各功能文档中覆盖：

​
同步问题

解决此问题最简单的方法是完全退出并重启应用：在 iOS 上：
  • 强制退出应用
  • 等待约 30 秒
  • 重新打开应用
在 Mac 上：
  1. 打开 Activity Monitor（在 Spotlight 中搜索，或在 Applications > Utilities 中找到）
  2. 在列表中找到 Craft
  3. 选中它，然后点击窗口顶部的停止按钮
  4. 重新打开 Craft
重启后，前往 设置 > 诊断 检查同步可用性（Sync Availability）。
检查是否使用相同账户：如果在某台设备上看不到你的文档，请确认你在所有设备上使用的是相同的账户和登录方式（Email 或 Sign in with Apple）。检查你的邮箱地址：
  • Mac：在文档列表左上角靠近头像处会显示你的邮箱地址
  • iPad：在文档列表左上角轻触头像以打开空间列表（Spaces List），查看你的邮箱地址
  • iPhone：在文档列表右下角轻触头像以打开空间列表（Spaces List），查看你的邮箱地址
如果你看到的邮箱地址以 @privaterelay.appleid.com 结尾，说明你是通过 Sign in with Apple 登录的，这是由系统生成的隐匿邮箱地址。
打开 设置 > 诊断，然后点击 Sync Now 按钮。点击后，应用会尝试重启同步过程。
在某些情况下，使用 VPN、广告拦截器（例如 AdGuard）或网络监控应用（例如 LittleSnitch）会阻止设备间的同步。建议：
  1. 暂时禁用这些应用
  2. 重启 Craft
  3. 检查同步连接是否恢复
浏览器扩展如 “Hush” 和 “Plume Guard” 也可能阻止访问 Craft 的服务器。
公司网络设置、防火墙或隐私类程序可能会阻止对 Craft 的访问。如果你在工作环境中使用 Craft，请联系 IT 部门检查网络设置。他们可能需要将以下 URL 列入白名单：
  • api.craft.do
  • docs.craft.do
  • res.craft.do
另请参阅：无法在 Web/Windows 访问 Craft 了解相关网络问题的更多信息。

​
登录问题

当你在 Mac 上选择 Continue with Apple 时，系统会提示输入密码，这是 Apple 的安全机制。重要：你需要输入的是 你在这台 Mac 上的账户密码，而不是你的 Apple ID 密码。如果你输入 Apple ID 密码，提示会重新出现，但不会报错。
某些浏览器扩展、广告拦截器或私有网络可能会阻止你访问 Craft 的网站或应用。常见错误包括“Server Not Found”或页面无法加载。已知可能导致问题的应用：解决方法：
  1. 暂时禁用这些扩展或应用
  2. 在其配置中将 Craft 的域名标记为受信任/安全
  3. 尝试使用其他网络
如果在不同网络和蜂窝数据下问题仍然存在，请联系支持团队。

​
性能问题

如果你遇到性能问题，请尝试以下步骤：快速修复：
  1. 通过 Activity Monitor 重启应用（参见上文同步问题）
  2. 关闭不必要的标签页和窗口
  3. 检查是否使用了窗口管理类应用（如 Magnet），并确保其为最新版本
向支持团队提供的信息：如果问题持续，请在联系支持前收集以下信息：
  • 你是否在使用基于外部存储的 空间？
  • 是否正在使用任何窗口管理工具？
  • 是否存在第三方文本编辑相关工具？
  • 在 System Settings > Privacy & Security > Accessibility 下安装的应用截图
  • 重启应用是否有帮助？
  • 多个标签页或窗口是否会导致问题？
创建 Spindump（用于持续性问题）：
  1. 打开 Activity Monitor
  2. 点击 ”…” 菜单
  3. 选择 Spindump
  4. 保存该文件并发送给支持团队
如果在 Windows 上遇到性能问题，请检查：
  1. 你的 Windows 版本是什么？
  2. 是否连接到公司网络或 VPN？
  3. 重启应用后性能是否恢复正常？
  4. 重启电脑后性能是否恢复正常？
若问题仍然存在，请录制一段全屏视频，展示错误或异常行为，并与支持团队分享。
在 Craft Mac 应用中使用 Grammarly Desktop 的步骤：
1
从 grammarly.com/desktop 下载 Grammarly Desktop
2
安装后，启动 Grammarly 应用
3
按指南在 System Settings > Privacy & Security > Accessibility 中启用 Grammarly
4
重新启动 Craft 应用
现在，当你选择一个 块 时，Grammarly 小部件应可用以进行审查。

​
macOS 特定问题

如果在 App Store 中只看到“Open”按钮，而没有更新：
1
强制退出 App Store
2
重新启动 App Store
3
搜索 “Craft Docs”
4
点击标题进入应用详情页
5
检查是否可以看到更新按钮
当系统检测到之前安装遗留的文件时，会显示此消息。通常发生在你从多个来源安装过 Craft（例如同时来自 App Store 和 Setapp）。解决方法：
1
从 Applications 文件夹中删除 Craft
2
在 Finder 中依次选择 Go > Go to Folder，逐一粘贴以下路径并删除其内容：
~/Library/Group Containers/group.com.lukilabs.lukiapp.share/
~/Library/Containers/com.lukilabs.lukiapp
3
如果仍无法解决，请检查 Group Containers 和 Containers 文件夹，删除任何包含“craft”、“lukilabs”或“lukiapp”的文件
4
从你偏好的来源重新安装 Craft

​
iOS/iPadOS 特定问题

目前，通过分享表单（Share Sheet）可以分享到 Craft 的仅限文本和链接。如果尝试分享照片或文件，可能会得到不可用的链接。解决方法：方案 1：复制粘贴
  1. 在分享表单中选择 复制
  2. 打开 Craft
  3. 粘贴到目标 文档 中
方案 2：下载并添加
  1. 将文件下载到设备
  2. 在 Craft 中轻触左下角的 + 按钮
  3. 选择 Files 选项
  4. 从设备中选择该文件

​
Windows/Web 特定问题

在公司设备或网络上访问 Craft 时，公司代理解决方案可能会阻止访问。请让 IT 部门将以下 URL 列入白名单：
  • api.craft.do
  • docs.craft.do
  • res.craft.do
该消息表示应用暂时失去与互联网或我们服务器的连接。应用会自动尝试重新连接。建议操作：
  • 检查网络连接：确保你的网络可用且稳定
  • 暂停编辑：为避免潜在的数据丢失，请在离线期间暂停编辑
  • 重新加载页面：如果你的连接稳定且没有未保存的更改，尝试重新加载页面
一旦连接成功恢复，消息会自动消失。
在使用 Craft 的 Web 版本时，某些粘贴链接（例如 LinkedIn）可能无法正确显示缩略图，并出现 “Failed to fetch data”。说明：用于获取链接数据的第三方服务似乎被阻止了，这是我们无法直接控制的外部问题。好消息：
  • 链接在点击时仍然可用
  • 该问题仅影响 Web 版本
  • 主要影响个人 LinkedIn 个人资料链接
  • 公司 LinkedIn 链接可正常显示
  • 在 Mac、iOS 和 iPad 的应用中，所有 LinkedIn 缩略图均正常显示
Windows 版 Craft 会在你退出并重新打开应用时自动更新。当有新版本可用时，你会在 Windows 通知面板（右下角）看到通知。你也可以手动更新：
  1. 卸载 Windows 版 Craft
  2. 从 craft.do/download 或 Windows App Store 下载最新版本

​
数据与存储问题

最近删除文件夹可能消失的原因有两种：
  1. 之前删除的文档已超过 30 天
  2. 最近删除文件夹的内容被手动清空
如果你误删了内容，请在 Storage and Recovery 文档中查看可用的恢复选项。
问题：在尝试重新添加外部位置时，系统一直提示 “External location already added”，但该位置并未显示为一个 空间。解决方法：
1
从 Craft 应用中登出
2
重新登录
3
再次尝试添加该外部位置
如果仍然出现相同提示：
  1. 从设备中删除 Craft 应用
  2. 重新安装应用
  3. 再次尝试添加外部位置
iCloud Drive 的可靠性和性能不在我们的可控范围内。如果同步出现问题，以下建议可能有帮助：
我们不建议在不同设备间使用外部 空间，因为这可能导致数据冲突或数据丢失。如果你不确定如何使用 空间，请联系支持。
故障排查步骤：
  1. 手动触发同步：在 Mac 上打开 Finder，或在 iOS 上打开 Files 应用并导航到你的 iCloud Drive 文件夹
  2. 编辑一个文档：更改文档内容以触发同步
  3. 检查网络访问：确保你连接的是 Wi‑Fi 或有较快的蜂窝网络，并确保设备有足够电量
  4. 切换飞行模式：重新连接网络有时会触发 iCloud Drive 同步
  5. 检查蜂窝同步设置：
    • 在 iOS 中，开启 Settings > Cellular Data 下的 “System Services”
    • 在 Settings > iCloud > iCloud Drive 中开启 “Use Cellular Data”
  6. 检查电量：电量较低时，设备会降低后台同步速度以节省能量
  7. 检查 iCloud 存储配额：如果达到存储上限，Craft 将无法同步
  8. 重启设备：确保 iCloud 服务在后台正常运行
  9. 确认 iCloud 已启用：
    • iOS：使用 Apple ID 登录 iCloud，并启用 iCloud Drive
    • Mac：登录 iCloud，并在 Apple ID 设置中确保已启用 iCloud Drive
  10. 关闭 “优化 Mac 存储”：该选项位于 Apple ID 设置中，开启时 Mac 会将内容移至云端，可能导致本地文件缺失
  11. 耐心等待：iCloud Drive 首次同步或大量数据同步可能需要较长时间，甚至一天才能完全开始
  12. 登出并重新登录 iCloud：当 iCloud Drive 卡住或非常慢时，可尝试登出后再登录
  13. 启用自动设置时间：确保所有设备都启用了自动设置时间
  14. 更新操作系统：Apple 会在每个系统版本中持续改进 iCloud 服务
  15. 检查 Apple 的系统状态：访问 Apple 的系统状态页面 查看 iCloud 服务是否正常

​
报告 Bug

如果你在 Craft 中遇到 Bug，我们非常欢迎你协助我们定位问题。清晰的报告能让团队更快地调查与修复。

​
报告前请先确认

  • 确保你使用的是 Craft 的 最新版本
  • 重启应用或刷新 Web 版本
  • 问题仍然存在时，再继续提交报告

​
提交 Bug 报告时请提供的信息

  1. 确认版本：请说明你是否使用最新版本
  2. 环境信息：
    • 设备型号（例如：MacBook Pro、iPhone 14、Windows 笔记本）
    • 操作系统及版本（例如：macOS Sonoma 14.2、iOS 17.3、Windows 11）
    • 平台（桌面应用、移动应用或 Web 版本）
  3. 描述导致问题的步骤：
    • 请逐步列出导致问题的具体操作
    • 例子：“打开一个文档 > 新增一页 > 插入图片 > 出现问题”
  4. 包含屏幕录制：
    • 保持短小且聚焦于问题本身
    • 操作间隔适当以便观察
    • 录制整个屏幕（不要裁剪）
    • 使用尽可能高的分辨率
    • 对于视觉类 Bug，截图也很有帮助

​
如何录制屏幕

iPhone：
  • 在 Settings > Control Center 中启用屏幕录制
  • 打开控制中心并轻触录制
  • 通过轻触红色状态栏停止录制
  • Apple 官方指南
Mac：
  • 按 Command + Shift + 5
  • 选择 “Record Entire Screen” 或 “Record Selected Portion”
  • Apple 官方指南
Windows：

​
提交后会怎样

  • 偶发性问题：我们会记录并持续观察是否有相关案例
  • 可复现的 Bug：我们会在内部升级并展开调查与修复流程
感谢你花时间报告 Bug，你的反馈能帮助我们让 Craft 对每个人都更好用。

​
仍需要帮助？

如果你在这里找不到解决办法，我们随时乐意提供帮助：

联系客服

获取帮助