# 文档搜索与排除

HapiGo 是一款应用/文件搜索启动工具，快捷键打开主窗口后就可以开始搜索应用和文件了。

### 文件搜索

HapiGo 文件搜索可以分为 2 种方式：1. 混合搜索；2. 单独搜索。

混合搜索是应用和文件一起搜索。因为大部分人电脑中的应用较少，所以多输入一些关键词就可以直接过滤掉应用，而开始搜索文件了。

而单独搜索则可以设置：「文档优先」和「应用优先」。设置了应用优先，那么打开主面板后需要按下 <mark style="background-color:blue;">空格</mark> 来切换至文档搜索。&#x20;

<figure><img src="https://1003988539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl32LfsaljX9FHbl3ksjH%2Fuploads%2FXu5yPPwvZRzwUctzGJgm%2F%E6%88%AA%E5%B1%8F2023-06-13%2019.14.27.png?alt=media&#x26;token=4b930d6f-7b1c-49e6-8524-682d17f4d71d" alt=""><figcaption></figcaption></figure>

### 全文搜索 & 搜索文件夹

除了普通的文档搜索外，HapiGo 还提供全文搜索及仅搜索文件夹。在文档搜索模式下（混合搜索不区分），输入 <mark style="background-color:blue;">单引号</mark> 可以进入全文搜索模式，输入 <mark style="background-color:blue;">逗号</mark> 可以进入仅搜索文件夹模式。

如果你不记得这些符号快捷方式，可以点击主搜索框右侧的过滤图标，从弹出菜单中进入对应的搜索模式。

<figure><img src="https://1003988539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl32LfsaljX9FHbl3ksjH%2Fuploads%2FUXmGeBqHxSVsAy1TIxby%2F%E6%88%AA%E5%B1%8F2023-06-13%2019.16.13.png?alt=media&#x26;token=e6706a92-7f0d-4308-81cb-97946b5d6793" alt=""><figcaption></figcaption></figure>

### 文件夹内搜索

当搜索到某个文件夹时，可以按 <mark style="background-color:blue;">Tab</mark> 键进入文件夹内搜索模式。此时，输入关键词可搜索本文件夹内所有层级的文件或文件夹。按 <mark style="background-color:blue;">Shift+Tab</mark> 可以返回上级文件夹。

<figure><img src="https://1003988539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl32LfsaljX9FHbl3ksjH%2Fuploads%2F9LeCm6A6sBtuCZJg6sSw%2F%E6%88%AA%E5%B1%8F2023-06-13%2021.02.25.png?alt=media&#x26;token=d4b425cc-7440-42e3-8039-c2e3a857ebd9" alt=""><figcaption></figcaption></figure>

### 添加网盘&外置磁盘搜索

HapiGo 常规文件搜索已使用完全自研的索引及搜索技术，可以设置搜索范围。同时也支持已在 Finder 中挂载的外置磁盘（NTFS、FAT32）和网络硬盘（NAS、WebDAV、SMB 等）。所以如果你经常使用外置磁盘和网盘，可以在设置中添加挂载的外置磁盘和网盘。

打开主窗口后按 <mark style="background-color:blue;">CMD+,</mark> 在打开的设置面板中切换到「搜索」-「文档搜索」。点击右上角 <mark style="background-color:blue;">+</mark>，将需要搜索的路径添加。

{% hint style="info" %}
**索引性能：**&#x6B63;常来说，索引的速度很快。在文件不多的电脑上，几乎没有影响。但是，如果文件数超过 50 万，可能会导致 CPU 持续高占用、能耗升高、电脑发热。所以，建议文件数较多的用户，排除一些不必要的文件路径。减少索引文件数，减少索引时长。

**外置磁盘索引：**&#x8FDE;接稳定的外置磁盘只比本地磁盘索引性能慢一点，且同样支持实时增量索引。

**网盘索引：**&#x7F51;盘受限于网络传输原因，索引速度相对较慢。

**查询文件数量**：打开主窗口后按 <mark style="background-color:blue;">CMD+,</mark> 在打开的设置面板中切换到「搜索」-「文档搜索」 - 点击「文件索引检查」-「检查」-「开始」。系统会进行索引检查，可以看到文件搜索路径、数量和索引用时。这个结果可以用来评估是否要减少文件路径。
{% endhint %}

### 文档搜索排除

#### 常规搜索排除

常规搜索的排除，可以在 HapiGo 中设置。打开主窗口后按 <mark style="background-color:blue;">CMD+,</mark> 在打开的设置面板中切换到「搜索」-「文档搜索排除」。

这里，可以有 3 种索引排除方式：

1. 按路径排除：添加需要排除的路径
2. 按后缀排除：这里后缀可以是文件后缀，也可以是文件夹后缀（文件夹后面添加 <mark style="background-color:green;">.后缀</mark>）。比如：排除后缀「noindex」，那么在文件夹后面添加 <mark style="background-color:green;">.noindex</mark>，此文件夹就不会被搜索到。
3. 按文件夹名称排除：设置文件夹名称，那么无论此名称的文件夹在什么路径或有多少个，都会被排除。

<figure><img src="https://1003988539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl32LfsaljX9FHbl3ksjH%2Fuploads%2F1zUBCZ5a5tCXiOpGb6mi%2F%E6%88%AA%E5%B1%8F2023-06-14%2005.12.03.png?alt=media&#x26;token=f7ef1cc5-c623-4a56-a979-539f29ff4863" alt=""><figcaption></figcaption></figure>

#### 全文搜索排除

HapiGo 的全文搜索目前使用的是 Spotlight 提供的结果，所以如果要排除全文搜索的结果，可以进入系统 Spotlight 进行设置。

在 HapiGo 中搜索「Siri 与聚焦」并打开，在设置面板中滚动到最底部「聚焦隐私...」，添加需要隐藏的路径。

<figure><img src="https://1003988539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl32LfsaljX9FHbl3ksjH%2Fuploads%2FCjyhzaLIqFoEwKyzi9Rf%2F%E6%88%AA%E5%B1%8F2023-06-14%2004.58.20.png?alt=media&#x26;token=84766ae5-a360-4709-b8aa-d0eb548e7c92" alt=""><figcaption></figcaption></figure>

### 搜索问题解决

如果你发现某个文件搜索不到，请尝试如下操作：

1. 检查该文件路径是否在搜索范围内
2. 如果不在，请添加至搜索
3. 如果在，请重启 HapiGo

如果以上操作无法解决你的问题，请通过你方便的方式向我们反馈。

* 邮箱：<feedback@hapigo.com>
* 论坛：<https://forum.hapigo.com>
* QQ 群：577036563