DigUp：本地语义文件搜索

项目简介

DigUp 是一款本地优先的桌面文件搜索工具，基于 Google DeepMind 的多模态嵌入模型 EmbeddingGemma 2。它把文本、图片、音频和视频放进同一个向量空间，因此你可以用自己的话描述要找的东西，它会按文件内容而不是文件名把文件找出来。支持 macOS、Windows 和 Linux，所有索引与搜索都在本机完成。

主要功能

• 按内容搜索："zebra in a video" 直接跳到斑马出现的那一秒，"where they talk about sleep" 跳到播客的那一分钟，"the clause about pets in the lease" 打开 PDF 的对应页面，"a dog on the beach" 找到那张照片，"payment declined error" 找到截图。
• 多语言：用英文搜索也能找到用孟加拉语、阿拉伯语等 100 多种语言写的笔记，反过来也一样。
• 精确字符串：发票号、错误码、人名等按原样匹配文件名和文档正文（Mac 上还包括截图中的文字），与语义结果一起给出。
• 代码搜索：在 Settings → Code 中为指定文件夹开启后，用 code: 开头描述代码做什么，或直接输入函数名，结果会在编辑器里打开到对应行（Zed、VS Code、Cursor、Sublime Text、JetBrains IDE，Mac 上的 Xcode，Windows 上的 Notepad++ 等）。
• 快速唤起：任意应用中按 ⇧⌘Space（Mac）或 Ctrl+Shift+Space（Windows / Linux）打开搜索面板，方向键选择，回车打开，空格大图预览。
• 读取范围：图片与截图（JPEG、PNG、HEIC、WebP 等）、PDF（逐页，含扫描件）、文档（txt、md、typ、rtf、docx、odt、html，Mac 上还有 doc）、表格与演示（xlsx、ods、pptx、odp）、任意长度的音频和视频。
• 隐私：文件不会被上传，DigUp 只在首次下载模型和每天检查一次更新时联网，无账号、无遥测。

安装与使用

Mac：从 Releases 下载 DMG 后拖入 Applications，或使用 Homebrew。需要 Apple Silicon 且 macOS 14 及以上。

brew install --cask arahim3/tap/digup

Windows：从 beta 版本 下载 DigUp_x.y.z_x64-setup.exe 运行，仅为当前用户安装，无需管理员权限。需要 64 位 Windows 10 或 11。

Linux：下载 .deb 安装，或下载 AppImage 赋予执行权限后运行。适用于 64 位 Intel / AMD 处理器，Ubuntu 22.04、Debian 12、Mint 21 及更新版本。

sudo apt install ./DigUp_x.y.z_amd64.deb

安装后打开 DigUp，在模型下载期间（865 MB，仅一次）选择要搜索的文件夹，之后随时按快捷键开始搜索。

注意事项

• DigUp 只在 本项目 Releases 和 digup.arahim.dev 发布，其他站点提供的安装包与项目无关。
• Windows 安装包尚未签名，系统提示无法识别时选择「更多信息」→「仍要运行」。
• Debian 的 .deb 包名为 dig-up，因为系统中已有无关的 digup 包。
• 首次索引只做一次：Mac 上几百个文件需要几分钟，较大的下载文件夹可能耗时一小时；Windows / Linux 会优先使用显卡，纯处理器下每张图片需要数秒。之后新文件落盘几秒内即可搜索。
• 在 GNOME / KDE 的 Wayland 下，DigUp 会在安装时把 Ctrl+Shift+Space 写入桌面快捷键设置，需在该处修改；GNOME 的托盘图标需要 AppIndicator 扩展。
• DigUp 只读取文件，从不修改、移动或上传它们；它会跳过密钥、证书、密码文件、隐藏文件夹、应用与缓存，也不下载仅存在于云端的文件。

本作品整理自 GitHub 开源项目 ARahim3/DigUp，原作者 @ARahim3，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。