如果在运行 DigUp 时遇到文件未建立索引、搜索无匹配项或系统弹窗提示，你可以对照官方说明的各项规则逐一排查。
索引进度慢或部分内容未被收录
DigUp 仅会读取你在设置中指定勾选的文件夹。首次索引时，软件会对选中的图片、文档、音视频进行分析。如果发现特定文件未出现在搜索结果中，可以检查以下限制规则：
- 文件类型与系统支持：在 Windows 和 Linux 测试版中，目前不会读取截图内的文字，旧版 Word 的
.doc文件、RAW 格式照片以及 SVG 矢量图也仅在 Mac 上支持读取。 - 长文档处理规则：长 PDF 文件单份最多读取 5,000 页。DigUp 会优先读取前 30 页，其余内容排在其他文件之后继续处理。
- 自动跳过的目录：DigUp 不会读取隐藏文件夹（例如
.ssh）、密钥文件、证书、密码文件、应用程序及缓存，也会跳过结构类似数据集的文件夹。在代码仓库内（含有.git或package.json的目录），若未开启代码搜索，默认仅读取其中的截图。 - 索引异常与版本修复：在 Mac 0.6.1 版本中，修复了文件夹名称包含重音符号、韩文或日文时可能中断索引的问题，并解决了目录内容频繁变更导致扫描重置的故障。你可以查看索引慢与文件跳过排查说明了解详情。
云端占位文件未被读取
DigUp 仅读取存储在本地磁盘上的文件，不会主动从云端下载未同步的内容。如果你的文件存放在 iCloud 云盘（Mac）或 OneDrive（Windows）中且处于仅在线存储状态，软件会直接跳过它们。若需纳入索引，需确保相关文件已经完整下载到本机。详情可参考云盘占位文件排查。
跨语言与文字匹配差异
EmbeddingGemma 2 模型支持超过 100 种语言，在语义层面支持跨语言检索。但在精准词匹配（例如特定编号、代码或名字）方面存在特定机制：
- 汉语、日语、泰语等不使用空格分词的语言，不会被拆分成单独词组进行精确匹配。
- 截图文字识别功能目前仅支持 Mac，且依赖系统识别，覆盖约 25 种语言。
- 更多细节可参阅跨语言搜索说明。
系统安装与权限弹窗提示
不同操作系统在安装与调用外部应用时可能弹出安全或授权对话框：
- Windows 安装提示：在 64 位 Windows 10 或 11 上运行
DigUp_0.7.0-beta.1_x64-setup.exe安装包时，由于安装程序尚未签名，系统可能会提示无法识别该应用。此时可以选择“更多信息”，再点击“仍要运行”。具体步骤见 Windows 未签名安装提示说明。 - Mac 播放控制提示：在 Mac 上回车打开视频结果时，视频会在 QuickTime Player 中定位到对应时间点播放。macOS 系统会弹出一次询问，确认是否允许 DigUp 控制 QuickTime Player。详细流程见 QuickTime 权限弹窗说明。