故障排除

为什么搜索不到，或者索引里没有这个文件/文件夹？

Gety 的索引过程包括快速索引和文本提取两个阶段。

「搜不到」通常有三种情况：

• 文件没有进入索引。
• 文件已进入索引，但内容还没提取完成。
• 文件其实能搜到，只是排序靠后，或被筛选条件隐藏了。

先诊断这个文件，再根据结果处理。

先诊断这个文件

文件诊断工具会对单个文件给出明确结论，不用逐项猜测。

1. 打开设置 → 关于 → 文件诊断工具。
2. 把文件拖进方框，或点击选择文件。
3. Gety 会逐层检查：文件是否落在已添加的索引目录中、命中的连接器是否在运行、路径每一层是否已索引、是否被过滤规则排除。

结果显示诊断通过或诊断未通过，按结论继续：

• 诊断通过：说明文件已经在 Gety 的索引中。你可以搜索完整文件名，快速确认这个文件能够被搜到。如果能找到文件，但搜不到文件里的内容，见能找到文件名，但找不到内容。
• 诊断未通过：文件还没有进入索引，见文件没有进入索引。

文件没有进入索引

诊断未通过时，工具会直接说明原因并给出建议，例如把上级文件夹添加为索引目录、启动对应的连接器，或调整过滤设置。按建议处理后重试即可。

Gety 会通过排除规则跳过系统文件和无需索引的目录，减少不必要的处理和搜索干扰。同时，Gety 也内置了许多白名单规则，让需要保留的文件仍能被索引。如果你平时会用到的文件或文件夹被排除了，欢迎在诊断工具中点击发送报告，告诉我们你希望搜索哪些内容，帮助我们完善规则。

连接器中的内容没有出现，则查看连接器没有结果。

能找到文件名，但找不到内容

能搜到文件名，说明文件已经在索引里。接下来检查：文本是否提取完成，以及 Gety 提取到的文字里有没有你要找的内容。

1. 前往设置 → 本地文件 → 索引范围。

2. 找到对应文件夹路径，点击右侧的菜单按钮，选择查看索引。

   

3. 在弹出的索引状态查看器中找到并选中该文件，查看索引状态和内容面板：

   状态或提示	含义
   等待提取	还没轮到这个文件，等待完成
   基础提取完成，OCR 进行中	文字部分已可搜索，图片和扫描件仍在识别
   提取完成 / 提取完成（含 OCR）	提取已结束，可以继续往下排查
   未解析	提取失败，展开原因查看具体错误
   暂无提取内容（内容面板）	Gety 还没有从这个文件里读到文字。如果提取已结束，可以点击刷新内容重试；刷新后仍为空，请通过 hi@gety.ai 反馈文件格式和错误提示

4. 如果还在提取，先等待完成。如果提取失败，直接点击刷新内容重试。如果你修改了原文件，但提取内容仍是旧版，也可以刷新这一个文件。

   

刷新并等待提取完成后，如果仍然搜不到文件里的内容，打开内容面板。这里显示的是 Gety 从文件里读到的文字。对照原文件，看看你搜索的那句话或关键词是否出现在面板里：

• 能看到要找的文字：说明可以通过这部分文字搜到文件。它可能排在结果后面，可以用筛选栏按文件类型、来源或时间缩小范围，方便定位。
• Gety 读到的内容不完整或有误：图片、扫描件或排版复杂的文件可能出现漏字、错字。欢迎通过 hi@gety.ai 告诉我们哪部分内容没有正确读取。如果方便，请附上原文件，帮助我们复现问题、改进提取效果。如果文件涉及隐私，可以改为提供隐去隐私信息的截图，但仅凭截图可能无法完整判断问题原因。

如何查找日志文件？

1. 前往设置 → 通用 → 高级设置，找到日志文件。
2. 点击打开文件夹，查看其中的 .log 文件。

日志文件夹地址：

• Windows：%LOCALAPPDATA%\ai.gety\logs。按 Win + R，粘贴地址并按回车。
• macOS：~/Library/Logs/ai.gety。在访达中按 Command + Shift + G，粘贴地址并按回车。

提示 GetyService 不可用怎么办？

这是 Windows 的本地文件索引服务未能正常提供服务。先检查它是否已启动。

1. 右键点击 Windows 任务栏，打开任务管理器。
2. 打开服务，搜索 gety，找到 gety-service。
3. 如果状态为已停止，右键选择开始。
4. 服务启动后，重新打开 Gety，检查错误是否消失、文件索引是否恢复。

如果列表中没有该服务，或启动时出现错误，请记录具体提示，并按查找日志文件收集日志后反馈。不要把“搜索结果为零”直接当成同一种故障。

模型下载很慢或失败怎么办？

先在索引状态或错误通知中查看失败原因，再重试对应的下载。

• 网络错误或所有下载源失败：确认电脑能连接互联网。如果当前网络需要代理，在设置 → 通用 → 代理中配置并测试连接，再重试。
• 文件校验失败：重新下载，不要跳过校验或继续使用校验失败的文件。
• 磁盘空间不足、写入或解压失败：检查 Gety 数据目录所在磁盘的剩余空间，以及当前用户是否有该目录的写入权限，再重试。

如果仍然失败，记录模型名称和具体错误，按查找日志文件收集日志后反馈。

文件能搜到，为什么打不开或无法预览？

先尝试在文件管理器中打开原文件，判断是文件本身无法访问，还是只在 Gety 中无法预览。

• 原文件也打不开：检查文件是否已被移动或删除、所在磁盘或共享文件夹是否可访问，以及当前用户是否有读取权限。
• 原文件能打开，只有 Gety 不能预览：先用原来的应用查看文件。记录文件格式和 Gety 的错误提示，反馈具体问题，不必为了预览失败重建整个索引。

提示通知权限已关闭，如何恢复分享前确认？

先在操作系统的通知设置中允许 Gety 发送通知，再回到设置 → AI 集成 → 数据共享控制，选择始终询问。

重新从 AI 应用发起一次请求，确认 Gety 能弹出分享确认窗口后，再继续使用敏感资料。如果仍未出现确认窗口，先停止从该 AI 应用发起文件访问，不要假定请求已经被拦截。

错误码

“io: 拒绝访问。(os error 5)”

如果你在 Windows 上安装 CLI 时看到“安装 CLI 命令失败：io: 拒绝访问。(os error 5)”，通常是系统权限导致的。

请按以下步骤排查：

1. 检查杀毒软件或安全软件是否有拦截提示

   如果有拦截提示，请允许 Gety 执行相关操作后，再重新安装 CLI。

2. 确认当前 Windows 登录用户是否与安装 Gety 时的用户一致

   如果你当前登录的 Windows 用户和安装 Gety 时使用的用户不是同一个，可能会导致 CLI 安装目录没有写入权限。

3. 使用管理员权限运行 Gety

   关闭 Gety 后，右键点击 Gety 图标，选择“以管理员身份运行”，然后再次前往 AI 集成页面安装 CLI。