DigUp 支持的文件格式与类型

核心结论 DigUp 可读取所选文件夹中的图片、截图、PDF、常见文档、音频和视频,开启代码搜索后还可读取代码;目前不支持表格、演示文稿、Apple iWork 文件和 EPUB。

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

DigUp 会读取你在设置中所选文件夹内的图片、截图、PDF、文档(txt、md、rtf、docx、odt、html,以及 Mac 上的 doc)、音频和视频,并在开启代码搜索后读取项目代码。它目前不会读取电子表格(如 Excel)、演示文稿(如 PowerPoint)、Apple iWork 文件(Pages、Keynote、Numbers)以及 EPUB 电子书。

支持的文件类型与平台对比

下表列出了说明文档与发行说明(v0.6.1 与 v0.7.0-beta.1)中支持的文件类别及各平台支持情况:

类别 说明文档中的格式与限制 Mac Windows 与 Linux 测试版
图片与截图 JPEG、PNG、HEIC、WebP 等,按画面内容匹配;截图内的文字仅在 Mac 上读取 支持画面与截图内文字 仅按画面内容匹配,暂不读取截图内文字
PDF 逐页读取(含扫描件);长文件先读取前 30 页,其余部分在后台完成,单文件上限 5,000 页;Mac 0.6.1 起对扫描页启用文字识别(#32) 支持(含扫描页文字识别) 支持
文档 txt、md、rtf、docx、odt、html;旧版 Word .doc 仅限 Mac;长文档分段读取;主要由数字组成的文本(如数据导出)仅按精确文本匹配 支持(含 .doc) 支持(不含 .doc)
音频 任意时长,按重叠的 30 秒片段处理,匹配结果指向具体时间点 支持 支持
视频 任意时长,每隔几秒提取一帧(每个镜头一帧),并按音频同样方式处理音轨 支持 支持
RAW 照片与 SVG 图片 仅在 Mac 上读取;SVG 图片(图表、徽标)自 Mac v0.6.1 起支持 支持 跳过
代码 需在“Settings → Code”或初始设置中开启代码搜索:读取源文件、不含输出内容的 Notebook 以及仓库自带文档 支持 支持

关于如何挑选索引目录,请参阅应该索引哪些文件夹;若遇到文件未被计入,可查看无搜索结果或显示 0 个文件排查与Windows 和 Linux 测试版已知问题。

DigUp 不读取的文件与内容

维护者 ARahim3 在 2026年10月12日关闭的 Issue #4 中说明,Pages、Keynote、Numbers、Excel、PowerPoint 和 EPUB 目前尚未支持。此外,Issue #75(截至 2026年10月16日仍为开启状态的功能请求)提出了读取 .xlsx、.pptx、.ods 和 .odp 的需求,提交者指出在 0.7.0-beta.1 中 .xlsx、.xls、.pptx、.ods 和 .odp 文件会被跳过。

除上述格式外,DigUp 还有以下过滤规则:

  • 在未开启代码搜索的文件夹外绝不读取代码;在代码项目文件夹(含 .git、package.json 等)内默认只读取截图。
  • 绝不读取密钥、证书、密码文件、像 .ssh 这样的隐藏文件夹、应用程序或缓存。
  • 自动跳过看起来像数据集的文件夹,且绝不下载仅保存在云端而未下载到本地的文件(Mac 上的 iCloud 云盘、Windows 上的 OneDrive)。
  • 你可以在“Settings”中设置跳过更多文件夹或文件类型。

搜索结果的打开方式

当你选中结果并按下回车键(Mac 为 ↩,Windows 和 Linux 为 Enter)时,不同系统的打开方式如下(更多操作见搜索技巧):

  • Mac:视频会在 QuickTime Player(macOS 会询问一次是否允许 DigUp 控制它)或 IINA 中跳转到对应时间点打开;PDF 会在预览(Preview)中打开并在搜索框填入你的搜索词。
  • Windows 与 Linux:若 PDF 阅读器支持接收页码参数(Edge、Chrome、Firefox、Acrobat、SumatraPDF、Evince、Okular),PDF 会直接打开到对应页;录音和视频会在 VLC、mpv 或 MPC-HC 中跳转到对应时间点打开。其他应用会从头打开文件,但在结果上按 Space 打开的大预览界面均可直接从对应页码或时间点开始。

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

常见问题

DigUp 支持搜索 Excel 或 PowerPoint 文件吗?

不支持。维护者在 Issue #4 中确认目前不读取 Excel 和 PowerPoint,且截至 2026年10月16日开启的 Issue #75 报告 .xlsx、.xls、.pptx、.ods 和 .odp 在 0.7.0-beta.1 中均被跳过。

DigUp 可以读取 Mac 上的 Pages、Keynote 或 Numbers 吗?

不可以。维护者在 Issue #4 中说明,Pages、Keynote、Numbers 以及 EPUB 目前尚未支持读取。

DigUp 能搜索扫描版 PDF 里的文字吗?

DigUp 会逐页读取包含扫描件在内的 PDF(单文件最多 5,000 页)。在 Mac 0.6.1 版本中,扫描版 PDF 页面也会通过文字识别进行读取,因此输入扫描件上的发票号或订单号即可搜到。

DigUp 是怎么搜索音频和视频内容的?

对于任意时长的音频,模型会以重叠的 30 秒窗口进行读取,匹配结果会指向具体时间点。对于任意时长的视频,DigUp 每隔几秒提取一帧画面(每个镜头一帧),并按与音频相同的方式处理音轨。

Windows 和 Linux 版本支持的文件格式与 Mac 有什么区别?

Windows 和 Linux 测试版(0.7.0-beta.1)暂不读取截图内的文字,截图仅按画面内容匹配。此外,旧版 Word 的 .doc 文件、RAW 照片和 SVG 图片目前仅在 Mac 上读取,在 Windows 和 Linux 上会被跳过。