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 上读取 | 支持画面与截图内文字 | 仅按画面内容匹配,暂不读取截图内文字 |
| 逐页读取(含扫描件);长文件先读取前 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 打开的大预览界面均可直接从对应页码或时间点开始。