第30章 Cloudreve 第30章：搜索功能详解

搜索类型 Cloudreve 提供三种文件搜索方式：内置搜索、全文搜索 / AI 混合搜索和快速搜索。它们在搜索范围、搜索对象和配置要求上各不相同，适用于不同的使用场景。

对比

| 功能 | 内置搜索 | 全文 / AI 混合搜索 | 快速搜索 | | --- | --- | --- | --- | | 搜索对象 | 文件名、文件属性 | 文件内容 | 文件名 | | 搜索范围 | 我的文件、子目录、分享 | 仅"我的文件" | 当前会话已加载的文件 | | 权限过滤 | ✅ | - | - | | 配置 | 无需额外配置 | 需要外部索引与内容提取服务 | 无需额外配置 | | 依赖服务器 | ✅ | ✅ | ❌ |

内置搜索 内置搜索是 Cloudreve 的默认搜索方式，无需额外配置。

搜索对象：支持按文件名搜索，或按文件属性（如类型、大小等）筛选。 搜索范围：可搜索当前用户的"我的文件"、任意子目录，以及其他用户分享的目录。 权限控制：搜索结果遵循文件权限设置，用户只能搜到自己有权访问的文件。 结果展示：搜索结果直接显示在文件列表中。

全文搜索 / AI 混合搜索 全文搜索和 AI 混合搜索可以搜索文件的实际内容，而不只是文件名。

搜索对象：搜索文件内容（如文档中的文本）。 搜索范围：仅限当前用户的"我的文件"目录。 前提条件：需配置第三方索引与内容提取服务方可启用。

TIP 全文搜索适合根据内容定位文件的场景，例如在大量 PDF 或文档中快速找到包含特定关键词的文件。

快速搜索 快速搜索利用当前浏览器会话中缓存的文件信息，在客户端本地即时搜索，不向服务器发送请求。

搜索对象：仅支持按文件名搜索。 搜索范围：仅限当前浏览器会话中已加载的文件（例如最近浏览过的目录中的文件）。 使用场景：快速定位最近浏览过的文件，或在当前目录中快速查找文件。

WARNING 快速搜索的结果取决于当前会话缓存的文件数据。如果目标文件在当前会话中尚未加载，就不会出现在搜索结果里。