搜索文件并查看结果
“搜索诊断”可帮助您在选定的文件夹中查找可读文件，并了解结果的得出过程。它会在单独的窗口中打开，因此您可以将其与检查器报告并排显示。拖动其标题栏可移动窗口，拖动其边缘或角点可调整窗口大小。再次打开“搜索诊断”时，现有窗口会自动置于最前。
执行搜索
- 在工具栏中打开“搜索诊断”。
- 选择“选择文件夹…”。所选文件夹及其可读取的子文件夹将定义搜索范围。在您选择文件夹之前，其他设置控件将保持禁用状态。
- 选择一种搜索模式，输入查询内容，然后点击“搜索”或按下回车键。
- 检查返回的路径、日期、内容状态和搜索阶段。在将结果列表视为完整之前，请先阅读覆盖说明。
请先选择一个较小且相关的文件夹。大型文件夹、长文档以及文本识别可能需要一定时间。点击“取消”将停止当前操作；此时已显示的结果可能不完整。点击“完成”或窗口的关闭按钮也会停止当前操作。更改查询条件、模式或文件夹将清除之前的输出结果。
选择合适的模式
- 元数据文本搜索
- 使用文件名或字面文本，例如
README或installation. 它会匹配文件名和索引文本，然后还会检查本地提取的内容。匹配时不区分大小写。它不会解析问题，也不理解同义词。 - 自然语言搜索（设备端）
- 提出一个问题，例如“哪份文档说明了如何安装该软件？”。可用的 Apple Intelligence 模型会解析该请求，并评估您 Mac 设备上可读的元数据和文档文本。其响应是一种解读结果；请检查返回的文件及其覆盖范围。
检查型号 重新检查可用性。该操作不会启用 Apple Intelligence，也不会自行下载模型。如果模型不可用，请使用元数据文本搜索或下方支持的日期查询。 型号可用性帮助.
查找最新或最旧的文件
选择“自然语言搜索（设备端）”，并使用以下支持的英语日期查询之一。该应用会在本地解析这些查询，因此即使模型不可用时，它们也能正常工作。
| 查询示例 | 要求内容 |
|---|---|
| 把最新的 Markdown 文件发给我。 | 一个修改时间最新的 Markdown 文件。 |
| 显示最近创建的3个Markdown文件。 | 最多三个 Markdown 文件，按创建时间排序。 |
| 显示最旧的 PDF 文件。 | PDF 文件按修改时间从最旧到最新排序。 |
| 显示昨天修改过的文件。 | 在昨天当地日期间被修改的文件。 |
| 显示过去 7 天内修改过的 Markdown 文件。 | 过去七天内修改过的 Markdown 文件。 |
除非您明确指出“创建日期”，否则“最新”和“新”均采用文件系统的修改时间。这些是文件在磁盘上的日期，而非文档中提到的日期。“今天”和“昨天”则采用您 Mac 的本地日历。对于无法获取日期的文件，无法可靠地按此顺序排列；报告会标出这些缺失。
诸如“最新文件”之类的单数请求仅返回一个结果。不带数字的复数请求会按日期顺序返回所有匹配的文件。添加数字表示请求返回相应数量的结果；这并非通用搜索限制。
哪些内容可以阅读？
- 纯文本、Markdown、源代码以及受支持的文本格式，例如 CSV、JSON、XML 和 HTML。
- PDF 中的文本，以及对 PDF 页面上无法提取文本部分的文本识别。
- 通过原生文档阅读器打开 RTF、RTFD、DOC、DOCX 和 ODT 文件。
- 通过 OCR（光学字符识别）识别受支持图像中的文本。OCR 仅识别可见文本；这并非对图像中物体或场景的一般性识别。
可读性取决于文件本身以及 macOS 的读者。不支持的格式、被锁定的 PDF、读取错误或模型故障都可能导致内容缺失。OCR 可能会误读文本。即使无法提取文件正文，仍可能找到与文件名或元数据匹配的结果；这并不证明已对完整的正文进行了搜索。
阅读并抄写结果
搜索覆盖范围报告了已检查的文件数量以及无法读取的内容。来源标签用于区分文件系统检索与Spotlight/文件系统联合检索。提取状态（例如“文本在本地流式传输”）描述了在请求提取时正文文本的读取方式。自然语言搜索响应对选定的证据进行了总结；日期查询响应描述了实际的日期排序情况。
结果列表默认显示 100 行。如需查看后续行，请点击“显示更多结果”。结果总数没有固定的上限。复制操作将包含所有已保留的结果、阶段以及任何错误或未完成状态，而不仅仅是当前可见的页面内容。点击“完整值…”可查看详细的阶段信息。
“无匹配项”表示在本次操作检查的数据中未找到匹配项。这并不意味着该文件不存在、未被索引，或对其他所有应用程序不可用。
技术细节：检索与模型的局限性
字面搜索结合作用域 NSMetadataQuery 文件系统遍历的结果。Spotlight 数据收集有 30 秒的时限；若超时则报告失败，文件系统搜索将继续进行。不存在固定的全局深度、查询字符、候选项、结果或总时长限制。
对于一般的自然语言查询，指定类型可以缩小搜索范围。否则，所有可读的候选项均符合条件。字面量 Spotlight 匹配结果将优先显示，但不会排除其他文件。元数据和提取的内容将按上下文大小的块进行评估，并给出简洁的判断结果。显示的路径来自范围限定检索，而非虚构的模型标识符。模型可用性、支持的语言、上下文容量和安全规则仍可能限制操作；若处理不完整，系统将予以报告。
这些结果并未披露苹果的原始相关性评分、嵌入向量、私有实体存储库，也未透露语义索引是否已准备就绪。 苹果的设备端模型参考.
搜索隐私
检查器不会通过网络发送文件或查询，也不会配置任何云模型。搜索仅在选定的范围内进行读取。它不会将文件内容添加到索引中，不会强制重新索引，不会执行文档脚本，也不会运行导入程序代码。搜索文件夹的访问权限仅在当前会话中有效，且不会作为书签保存。
复制的输出内容可能包含路径、元数据以及文档内容的摘要。在将其分享给他人或应用程序之前，请先进行审核。