DigUp 索引慢或文件被跳过怎么排查

DigUp 会在首次对所选文件夹建立索引,并在遇到纯云端文件、密钥或非指定代码文件时依设计自动跳过。

当前版本:Mac 为 0.6.1,Windows 和 Linux 为 0.7.0-beta.1(测试版);已根据 2026年10月15日 的 DigUp GitHub Releases 页面进行核对。

DigUp 在初次扫描文件夹时需要读取内容并运行 EmbeddingGemma 2 模型。首次索引所需的时间取决于文件数量与硬件配置,并且 DigUp 会按照设计跳过特定类型的文件与目录。

首次索引的速度参考

在 Mac 上,读取几百个文件通常需要几分钟,而一个大型“下载”文件夹可能需要约 1 小时。在 Windows 和 Linux 上,如果仅依赖处理器(CPU)运行模型,处理一张图片约需数秒(例如在 2017 款笔记本的 Core i5 处理器上约需 5 秒),因此扫描大型照片库可能会持续数小时。如果环境检测显示显卡(GPU)更快且结果一致,DigUp 会调用 GPU 运行。在首次索引完成后,新添加的文件通常在存入几秒后即可供搜索。

哪些文件会被自动跳过

DigUp 会依设计跳过以下内容:

  • 仅保存在云端的文件:DigUp 不会主动从云端下载未缓存在本地的文件,例如 Mac 上的 iCloud 云盘或 Windows 上的 OneDrive。具体排查可参考 iCloud 与 OneDrive 文件未被索引。
  • 敏感与系统文件:密钥、证书、密码文件、隐藏文件夹(如 .ssh)、应用程序以及系统缓存均不会被读取。
  • 数据集目录:外观特征类似数据集的文件夹会被跳过。
  • 代码文件:未在设置中开启代码搜索的目录,DigUp 不会读取其中的代码。在包含 .git 或 package.json 的项目目录中,普通搜索默认只读取截图。若需搜索函数或代码逻辑,请在“Settings → Code”中添加对应目录,详情见 DigUp 代码搜索设置与使用指南。
  • 格式限制:在 Windows 和 Linux 当前测试版本(0.7.0-beta.1)中,旧版 Word 的 .doc 文件、RAW 照片、SVG 矢量图以及截图内部的文字暂不读取,这些内容目前仅在 Mac 上支持。

索引机制与异常处理

超过 30 页的长 PDF 或长文档会优先读取前 30 页,其余内容在后台完成,单个文件最高支持 5,000 页。纯数字导出的文本仅匹配确切文字。在 Mac 0.6.1 版本中,若单个文件读取发生内存异常,DigUp 会自动中止并跳过该文件继续执行;当文件夹内容持续变动时,扫描也不会再陷入从头重新开始的循环。

操作步骤

  1. 检查所选文件夹与状态

    在 Mac 菜单栏或 Windows/Linux 系统托盘点击 DigUp 图标,查看当前索引进度,或确认是否处于暂停状态。

  2. 确认硬件与处理模式

    在 Windows 或 Linux 上,检查日志文件确认是否使用了显卡(GPU)运行,若仅使用处理器(CPU),处理大量图片需更长时间。

  3. 检查定时索引设置

    在 Mac 的“Settings → Folders”中检查是否开启了限制索引时间段(默认为 1:00 至 7:00),开启后 DigUp 仅在设定时间内执行索引。

  4. 确认文件是否已下载到本地

    检查 iCloud 云盘或 OneDrive 中的文件是否已被操作系统下载到本地磁盘,仅存于云端占位符的文件会被直接跳过。

  5. 检查代码与文件类型设置

    若要搜索代码内容,需在“Settings → Code”中添加对应仓库;在“Settings”中同时确认该文件后缀未被列入排除列表。

常见问题

为什么长 PDF 只能搜到前面的内容?

对于长 PDF 文件,DigUp 会优先读取前 30 页并使其立即可搜,剩余页面会在其余文件处理完毕后于后台继续读取,单个文件最多读取 5,000 页。

为什么截图里的文字搜不到?

截图内文字识别目前仅支持 Mac 版本,由 macOS 的文本识别技术处理。Windows 和 Linux 测试版目前仅能通过画面呈现的内容检索截图,暂不读取图内文字。

为什么索引一直在后台运行?

首次扫描大型文件库需要一定时间。你可以在菜单栏或系统托盘中暂停索引,或在 Mac 的“Settings → Folders”中指定允许索引的具体时间段。