DigUp 索引哪些文件夹:选择文件夹与跳过规则

核心结论 DigUp 只读取你选择的文件夹或子文件夹,并在设置过程中根据你的电脑实测显示每个文件夹首次索引所需的时间。

最近更新于 · Mac 版 DigUp 0.6.1,Windows 和 Linux 测试版 0.7.0-beta.1

DigUp 只读取你主动选择的文件夹。在初始设置期间,你可以选择整个文件夹或仅勾选其中的部分子文件夹,DigUp 会根据你的电脑速度测算并显示每个文件夹完成首次索引需要多长时间。

如何选择与管理文件夹

首次打开 DigUp 并下载 865 MB 模型的同时,你就可以挑选要搜索的文件夹。之后你随时可以在“Settings”(设置)中跳过更多文件夹或文件类型;在 Mac 0.6.1 版本中,文件夹相关选项位于“Settings → Folders”。关于可读取的文件格式,请参阅支持的文件类型。

选定文件夹内的处理规则

即使某个文件夹已被选中,DigUp 也会按以下规则过滤其中的内容:

选定文件夹内的内容 DigUp 的处理方式
代码项目(包含 .git、package.json 等的文件夹) 仅读取其中的截图;代码本身需通过代码搜索单独开启并索引
密钥、证书、密码文件、如 .ssh 的隐藏文件夹、应用程序和缓存 从不读取
看起来像数据集的文件夹 自动跳过
仅保存在云端的文件(Mac 上的 iCloud 云盘、Windows 上的 OneDrive) 从不自动下载
你在“Settings”中指定跳过的文件夹或文件类型 按设置跳过

云盘与按需同步文件夹

DigUp 不会下载仅存在于云端的文件(如 Mac 上的 iCloud 云盘或 Windows 上的 OneDrive 未下载到本地的文件)。

在用户反馈 Issue #61(截至 2026年10月16日 仍处于开启状态,尚无维护者确认的修复)中,一位 Mac 0.6.1 用户观察到,由 Synology Drive 按需同步的文件夹几乎没有被索引,因为其中的文件大多是未下载到本地的云端占位文件,而 DigUp 会跳过这类文件且不在界面中提示原因。该报告者提到,开启了“优化 Mac 储存空间”的 iCloud 云盘以及 OneDrive、Dropbox 和 Google Drive 也会遇到同样情况。目前 DigUp 没有自动拉取云端占位文件的设置。如需索引这些文件,请参考iCloud 云盘与 OneDrive 文件未被索引的排查方法将文件保留在本地。

照片图库

在用户反馈 Issue #43(截至 2026年10月16日 仍处于开启状态,尚无维护者回复)中,有 Mac 用户报告 ~/Pictures 下一个 40 GB 的照片图库显示为“nothing to index here yet”或“zero of zero indexed”,具体原因尚不明确。如果你遇到类似情况,可查看索引为 0 个文件或搜不到结果的排查。

大型文件夹与首次索引耗时

首次索引只进行一次,设置界面会提前显示预估耗时:

  • 在 Mac 上,几百个文件需要几分钟,而大型下载文件夹可能需要一小时。
  • 在 Windows 和 Linux 上,当显卡(GPU)更快且结果一致时,DigUp 会在显卡(GPU)上运行模型,否则使用处理器。仅靠处理器时,一张图片需要几秒钟(在 2017 年款酷睿 i5 笔记本上约为 5 秒),因此大型照片库首次索引可能需要数小时。
  • 对于超长 PDF 和长文档,DigUp 会先立即读取前 30 页,其余部分(单个文件最多 5,000 页)会在其他文件处理完后再继续读取。
  • 在 Mac 0.6.1(v0.6.1 发布说明)中,你可以在“Settings → Folders”里设置仅在指定时间段内索引(默认为 1:00 至 7:00),期间搜索功能全天可用。有关索引期间的资源占用,请参阅高 CPU、电量与内存占用说明。

Mac 0.6.1 版本的文件夹相关修复

根据 v0.6.1 发布说明,Mac 版修复了以下与选择文件夹相关的问题:

  • 名称中带有重音符号、韩文或日文的已选文件夹(例如 Google Drive 的“내 드라이브”)不再导致所有文件夹停止索引(Issue #14)。
  • 当添加了较多文件夹时,“Settings”界面可以正常滚动,不再超出屏幕底部(Issue #17)。
  • 代码文件夹会立即显示文件数量,不再显示为“0 of 0”,且“Settings”会说明它们将在其他文件夹之后被读取(Issue #21)。

来源 GitHub 上的 DigUp READMEDigUp 0.6.1 发布说明DigUp 0.7.0-beta.1 发布说明GitHub issue #61GitHub issue #43GitHub issue #14GitHub issue #17GitHub issue #21 已于 2026年10月15日 对照 DigUp 的 GitHub Releases 页面核对版本与文件。

常见问题

我应该在 DigUp 中选择哪些文件夹?

选择包含你需要查找的图片、PDF、文档、录音或视频的文件夹即可。DigUp 在设置时会显示每个文件夹首次索引的预估耗时,你可以据此决定添加整个文件夹还是仅勾选部分子文件夹。

DigUp 会扫描我的整个硬盘吗?

不会。DigUp 只读取你主动选择的文件夹,并且会自动跳过密钥、证书、密码文件、如 .ssh 的隐藏文件夹、应用程序、缓存以及看起来像数据集的目录。

可以只索引某个文件夹里的一部分子文件夹吗?

可以。在选择文件夹时,你可以选择整个文件夹,也可以只勾选其中的部分子文件夹;之后还可以在“Settings”中跳过更多文件夹或特定文件类型。

Dropbox 或 Google Drive 的文件夹会被索引吗?

DigUp 不会下载仅保存在云端的文件。根据截至 2026年10月16日 仍开启的用户反馈 Issue #61,按需同步且未下载到本地的云端占位文件会被跳过,只有已下载到本地磁盘的文件才会被读取。

选择一个很大的文件夹会花很长时间吗?

只有首次索引耗时较长:在 Mac 上大型下载文件夹可能需要一小时,在仅用处理器的 Windows 或 Linux 电脑上大型照片库可能需要数小时。首次索引完成后,新文件落地几秒钟后即可被搜到。