---
title: "搜索与 Spotlight"
description: "通过 Spotlight 和 OmniSearch 快速跳转到笔记，以及在文档流中按文本筛选。"
---

# 搜索与 Spotlight

Notarium 有两种截然不同的搜索界面，从一开始就把它们分清楚很有帮助。**Spotlight** 和 **OmniSearch** 用于快速跳转：输入标题的一部分，就能径直跳到想要的笔记。而**文档流的文本筛选**（`?q=`）是对整个语料的搜索：它收窄笔记列表，并可与按文件夹、标签、日期的筛选组合使用。一句话概括：一个是"跳到某条笔记"，另一个是"筛选当前选集"。

## Spotlight——跳到笔记

Spotlight 是一块居中的、以键盘驱动的面板，浮在页面之上。有三种方式打开它，三者都通向同一块面板：

- **Cmd/Ctrl+P**——快速切换器（Spotlight）；
- 左侧栏中的**搜索**图标；
- **`/`** 快捷键。

> [!tip] 键盘布局不会碍事
> 面板监听的是物理按键，而非字符。在西里尔字母布局下，`Cmd/Ctrl+P`（此处该物理键打出西里尔字母 *ze*）和 `/` 的表现与拉丁布局下完全一致。

面板的行为：

- **空查询 →"最近"。** 先列出你最近**打开过**的笔记（该列表按各空间分别保存），随后由最近**修改过**的笔记补入。快速切换器的首要任务，就是把你带回刚刚所在之处。
- **输入 → 笔记。** 每次击键都通过混合搜索来精炼结果（在启用向量搜索处为词法 + 语义；基于链接的图谱加权是一条额外通道，默认关闭；没有向量搜索时，查询回退到全文搜索——不会报错）。命中项会在标题和摘要片段中高亮。
- **每一行结果**都带有日期和上级文件夹的路径，好让你区分同名的笔记。
- **键盘：** `↑`/`↓` 选择、`Enter` 打开、**Cmd/Ctrl+Enter** 在新标签页中打开、`Esc` 关闭。

![Spotlight：命中处高亮，每一行结果都带有日期和上级文件夹](/media/app-search-light.webp)

Spotlight 在**当前空间**范围内工作：它搜索当前空间中的笔记。

## OmniSearch——顶栏中的搜索框

**OmniSearch** 就是同一个搜索框，在宽屏上被移到顶栏正中。它与 Spotlight 共享建议数据：你输入时，下方会下拉出同样的快速跳转结果。顶部的"在文档流中搜索"一行（或直接按 `Enter`）会把查询交给**文档流**，作为 `?q=` 文本筛选。

这个搜索框是为大显示器提供的便利：在窄屏上它会被完全隐藏。这并不意味着失去访问入口——搜索始终触手可及，一个动作即可：侧栏图标、`Cmd/Ctrl+P` 或 `/`。

## 文档流的文本筛选

在[文档流](/docs/guides/feed/)中，`q` 查询是与文件夹、标签并列的第三条筛选轴：一套统一的查询语言，`文件夹 ∧ 标签 ∧ 文本`。这里要紧的是**词项是否出现**，而非语义上的相近：该筛选使用词法搜索通道（全文），因此没有共同词汇的"语义近邻"不会进入选集。查询保存在 URL 中（`?q=`），而文档流窗口、精确的 `total` 计数器和按日期的直方图，所描述的正是那份被收窄的选集。

想了解混合搜索本身在底层如何运作，参见[搜索](/docs/concepts/search/)。打开它的键盘快捷键，见[键盘快捷键](/docs/guides/hotkeys/)页面。