# 文档搜索与排除

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

### 文件搜索

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

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

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

<figure><img src="/files/ArdmTyo6TBXNwKuPXni1" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="/files/0U8YwuOhEv3BMlR9mBD3" alt=""><figcaption></figcaption></figure>

### 文件夹内搜索

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

<figure><img src="/files/qyQDRsQSfSrTUj7UbY0Y" 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="/files/8ZgyEGmTHz7m9dHFTZmK" alt=""><figcaption></figcaption></figure>

#### 全文搜索排除

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

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

<figure><img src="/files/blW9leFqg7VXSnHwmaX2" alt=""><figcaption></figcaption></figure>

### 搜索问题解决

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

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

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-cn.hapigo.com/baisc/searchdocs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.