AB
AiBoss
project

DigUp - 用自然语言搜索本机文件的本地语义检索工具

DigUp 是一款开源桌面搜索工具,据项目自述,它借助 Google DeepMind 的 EmbeddingGemma 2 模型,让用户用自然语言描述来查找本机的图片、PDF、文档、音视频乃至代码,索引与检索全部在本地完成。

DigUp 是一款面向桌面端的本地文件搜索工具,解决的问题是:当你不记得文件名、只记得内容时,如何把文件找出来。据项目自述,它把 Google DeepMind 的 EmbeddingGemma 2 多模态嵌入模型接到本机文件上,用户选定要搜索的文件夹后,用一句自然语言描述想找的东西,DigUp 就能在图片、PDF、文档、录音、视频之间给出匹配结果。它适合文件量大、类型混杂、又在意隐私的个人用户:据项目说明,索引内容不会离开本机,程序只在首次下载模型和每天检查一次更新时联网。项目提供 Mac、Windows(beta)与 Linux(beta)三个平台的构建。

维护者与状态

DigUp 由 ARahim3 维护,仓库创建于 2026-10-08,最后一次提交在 2026-10-22。最新正式版本为 v0.6.2,发布于 2026-10-21。截至 2026-10-26,仓库获得 5783 个星标。从时间线看,这是一个起步不久但迭代较快的项目,Windows 与 Linux 版本在项目自述中仍标注为 beta。

主要能力

以下能力均来自项目自述,未经本站独立验证:

  • 跨文件类型的语义检索:据项目说明,可以按画面内容找照片和截图,按页面内容找 PDF(含扫描件),按文字找文档,按说话内容定位播客或录音中的某一分钟,按画面定位视频中某个对象出现的时刻。
  • 跨语言搜索:项目自述称模型支持 100 多种语言,用英文搜索可以命中孟加拉语、阿拉伯语等语言的笔记,反之亦然。
  • 精确字符串匹配:README 中称,发票号、错误码、人名等会按原样匹配文件名与文档正文,因此一次搜索同时覆盖「语义」和「字面」两种需求;在 Mac 上还包括截图中的文字。
  • 可选的代码搜索:默认关闭,需在设置或初始化时对指定文件夹开启。以 code: 开头描述代码行为或直接输入符号名,结果可在 Zed、VS Code、Cursor、Sublime Text、JetBrains 系列等编辑器中打开到对应行。
  • 结果跳转:据项目说明,PDF 可打开到对应页,音视频可打开到对应时刻,文件可在访达、资源管理器或文件管理器中定位。
  • 索引范围可控:只读取用户选定的文件夹;项目自述称不会读取密钥、证书、密码文件、.ssh 等隐藏目录、应用与缓存,也会跳过看起来像数据集的文件夹,并且不会下载仅存在于云端的文件。

使用入口

项目仓库地址:ARahim3/DigUp,安装包与各平台构建从该仓库的 Releases 获取。

据项目说明,各平台的安装方式如下:

  • Mac:下载 DMG 拖入「应用程序」,或使用 Homebrew 安装,需要 Apple Silicon 机型与 macOS 14 及以上版本。
  • Windows:下载 x64 安装程序运行,仅当前用户安装、无需管理员权限;项目自述提到安装包尚未签名,系统可能提示无法识别,需选择「更多信息」后继续。要求 64 位 Windows 10 或 11。
  • Linux:Ubuntu、Debian、Mint 等可安装 .deb 包(包名为 dig-up),其他发行版可使用 AppImage;面向 64 位 Intel 与 AMD 处理器,支持 Ubuntu 22.04、Debian 12、Mint 21 及更新版本。
brew install --cask arahim3/tap/digup
sudo apt install ./DigUp_x.y.z_amd64.deb

安装后首次启动时,模型会下载一次(865 MB),期间可选择要索引的文件夹,程序会显示首次扫描预计耗时。之后在任意应用中按 ⇧⌘Space(Mac)或 Ctrl+Shift+Space(Windows / Linux)呼出搜索面板,快捷键可修改。

许可与限制

DigUp 本身采用 MIT 许可证。需要注意,项目自述中提到的 EmbeddingGemma 2 模型是另一个独立项目,其许可证以该模型自身的发布条款为准,不能与 DigUp 的 MIT 许可混为一谈。

已知限制与适用边界(据项目说明):

  • 首次索引耗时与硬件相关。Mac 上几百个文件需要几分钟,大型下载文件夹可能耗时一小时;Windows 与 Linux 会在显卡更快时使用显卡,否则退回处理器,纯处理器环境下单张图片约需数秒,大型照片库可能耗时数小时。
  • 单个 PDF 最多处理 5000 页,长文档先处理前 30 页,其余在队列空闲后补齐。
  • 音频按 30 秒重叠窗口处理,视频每隔数秒取帧,因此定位精度受此粒度限制。
  • 以数字为主的文本(如数据导出)只做精确文本匹配,不参与语义检索。
  • 在 Wayland 下的 GNOME 与 KDE 不允许应用自行设置全局快捷键,需在系统键盘设置中调整;GNOME 上托盘图标依赖 AppIndicator 扩展。
  • Windows 与 Linux 版本在项目自述中标注为 beta,稳定性与功能完整度可能不及 Mac 版本。

以上能力与行为描述均来自项目自述,实际表现请以仓库文档与自身环境为准。