DeckEdit OCR 错误信息的含义
如果你在把 PDF 或图片转换成 PowerPoint 时看到错误，本页会解释发生了什么，以及接下来该尝试哪些具体步骤。
大多数 DeckEdit 错误都意味着以下三种情况之一：浏览器的显卡驱动达到了上限、文件对你的设备来说太大，或者你的设备不支持 DeckEdit 所需的加速。解决方法通常是重新加载页面、使用更小的文件，或切换到桌面浏览器。
先尝试这些步骤
- 重新加载页面。这会重启 OCR 引擎并清除临时内存。
- 先用较小的文件测试。先用 1-2 页确认引擎能在你的设备上启动。
- 如果你正在使用手机、平板或较旧的笔记本电脑，请改用桌面电脑上的 Chrome 或 Edge。
- 打开 /diagnostics，查看 DeckEdit 检测到的关于你的浏览器和 GPU 的准确信息。
按错误信息查找
OCR 运行时你的 GPU 断开连接
你的显卡驱动停止了 WebGPU 计算会话。当幻灯片较复杂或系统内存较低时，这在 Windows 上搭配某些 Intel、AMD 或较旧 NVIDIA 驱动时很常见。
解决方法： 重新加载页面。如果反复发生，请关闭其他标签页或应用、使用较小的 PDF，或更新显卡驱动。DeckEdit 无法绕过驱动崩溃。
此设备无法启动 WebGPU
你的浏览器或操作系统没有返回可用的 WebGPU 适配器。这会发生在 iOS Safari、旧版浏览器、虚拟机、部分图形设置被锁定的企业设备，以及 Firefox 上。
解决方法： 在配备较新 GPU 的桌面电脑上，用 Chrome 或 Edge 打开 DeckEdit。手机和平板没有变通方案，因为 Safari 和大多数移动浏览器不提供 WebGPU。
你的 iPhone 或 iPad 内存不足
iOS Safari 有严格的单标签内存限制，并且不支持 WebGPU。DeckEdit 会回退到 WebAssembly OCR，这在较大文件上可能会崩溃。
解决方法： 使用 1-2 页的 PDF，或者把较大文件移到桌面浏览器处理。关闭其他标签页可能有帮助，但根本解决办法是使用支持 WebGPU 的设备。
此设备无法运行 GPU 加速 OCR
DeckEdit 检测到你的浏览器没有 WebGPU 适配器，也没有可用的多线程 CPU 路径。桌面上的单线程 CPU OCR 每页需要数分钟，因此已被禁用。
解决方法： 在桌面电脑的 Chrome 或 Edge 中打开 DeckEdit。配备较新 GPU 的 Windows、macOS 和大多数 Linux 桌面都符合条件。
OCR 无法完成此文件的读取
引擎在处理完所有文本区域之前停止了。最常见的原因是文件太大、页面文本或图片过于密集，或浏览器不受支持。
解决方法： 尝试 10 页以下的文件，重新加载页面，并使用桌面电脑的 Chrome 或 Edge。如果某页总是失败，该页面对你当前设备可能过于复杂。
/diagnostics 显示什么
诊断页面会列出 DeckEdit 为你的设备选择的计算层级、浏览器返回的 WebGPU 适配器、你的操作系统和浏览器，以及可用存储空间。
这些信息本身不是修复方案，但能告诉你该设备是否被期望正常工作，或者限制来自硬件还是浏览器策略。
何时切换设备
如果你已经尝试了重新加载和使用较小文件，但错误仍然持续，问题很可能在你的设备或浏览器，而不是文件。
- 手机和平板：请使用桌面电脑。移动浏览器缺乏 WebGPU，内存限制也很严格。
- 配备旧集成显卡的笔记本电脑：尝试 Chrome 或 Edge，关闭其他应用，并使用较小的文件。
- 企业或受管设备：请向 IT 部门确认 WebGPU 是否被策略阻止。
DeckEdit 对这些限制保持诚实，因为这里没有服务器来掩盖失败。工具在你的设备上运行，所以设备必须能够完成这项工作。