> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用全文检索启动器

> Linkly AI 提供了一个强大的全文检索启动器，帮助你快速找到所需的文档。

## 启动器介绍

Linkly AI 启动器是一个全局检索窗口，类似于 macOS Spotlight 或 Raycast。你可以在任何时候通过快捷键唤起它，输入关键词或自然语言来搜索你的本地文档。

Linkly AI 的检索能力，采用基于关键词和语义的混合检索算法，不仅能精确匹配关键词，还能理解你的搜索意图，找到语义相关的文档。

<CardGroup cols={2}>
  <Card title="关键词搜索" icon="magnifying-glass" iconType="duotone">
    输入精确关键词，快速匹配文档标题和内容
  </Card>

  <Card title="语义搜索" icon="brain" iconType="duotone">
    用自然语言描述你想找的内容，AI 理解语义并返回相关文档
  </Card>
</CardGroup>

## 如何使用

<Steps>
  <Step title="唤起启动器">
    按下全局快捷键 `⌘ + Shift + L`（macOS）或 `Ctrl + Shift + L`（Windows/Linux），启动器立刻弹出。

    <Tip>
      你可以在「设置 → 通用 → 搜索快捷键」中自定义唤起快捷键。
    </Tip>
  </Step>

  <Step title="输入搜索内容">
    在搜索框中输入关键词或自然语言描述。输入后系统会自动搜索，无需按回车。

    **搜索示例：**

    * 精确搜索：`API 设计文档`
    * 自然语言：`关于团队协作流程的笔记`
    * 多关键词：`React 性能优化 最佳实践`
  </Step>

  <Step title="浏览搜索结果">
    搜索结果实时显示，每条结果包含：

    * **文档图标** — 根据文件类型（PDF、DOCX、MD 等）显示对应图标
    * **标题** — 文档文件名
    * **内容摘要** — 匹配的正文片段，搜索词高亮显示
    * **文件路径** — 文档所在路径
    * **匹配度** — 以百分比显示相关度

    使用 `↑` `↓` 方向键在结果之间导航。
  </Step>

  <Step title="预览文档">
    选中目标结果后按 `Enter`，进入文档预览视图。预览视图提供：

    * **全文内容** — 完整的文档文本，搜索词在全文中高亮显示
    * **自动定位** — 自动滚动到第一个匹配位置
    * **元数据抽屉** — 按 `⌘ + I` 展开元数据面板，查看文件大小、字数、创建时间、关键词等详细信息
  </Step>

  <Step title="打开文件">
    在搜索结果或预览视图中按 `Shift + Enter`，使用系统默认程序打开文件。你也可以按 `⌘ + Shift + C` 复制文件路径。
  </Step>
</Steps>

### 搜索历史

当搜索框为空时，启动器会显示你最近的搜索记录（最多 20 条）。点击任意历史记录可以快速重新搜索。

点击历史记录旁的清除按钮可以一次清空全部历史。

## 快捷键

### 全局快捷键

| 快捷键                                                       | 功能       |
| --------------------------------------------------------- | -------- |
| `⌘ + Shift + L`（macOS）/ `Ctrl + Shift + L`（Windows/Linux） | 唤起/关闭启动器 |

### 搜索视图

| 快捷键             | 功能          |
| --------------- | ----------- |
| `↑` / `↓`       | 在搜索结果间导航    |
| `Enter`         | 预览选中的文档     |
| `Shift + Enter` | 用系统默认程序打开文件 |
| `⌘ + Shift + C` | 复制文件路径      |
| `⌘ + ,`         | 打开设置        |
| `Esc`           | 关闭启动器       |

### 预览视图

| 快捷键                 | 功能          |
| ------------------- | ----------- |
| `Shift + Enter`     | 用系统默认程序打开文件 |
| `⌘ + Shift + C`     | 复制文件路径      |
| `⌘ + I`             | 展开/收起元数据面板  |
| `⌘ + ,`             | 打开设置        |
| `Esc` / `Backspace` | 返回搜索结果      |

<Note>以上表格中的 `⌘` 键在 Windows 和 Linux 系统上对应 `Ctrl` 键。</Note>