# 🔍 搜索功能使用指南

> 本教程的搜索功能专注于标题搜索，帮助你快速找到需要的章节

---

## 📖 搜索说明

### 搜索范围

本站搜索功能**仅搜索文档标题**，不搜索正文内容。这样设计的原因：

- ✅ **更精准**：直接定位到章节标题
- ✅ **更快速**：搜索速度更快
- ✅ **更清晰**：结果更容易理解

### 支持的内容

搜索覆盖以下内容的标题：

- 📚 **15章正文**：第1-15章的所有标题
- 📖 **8个附录**：附录A-H的标题
- 💡 **示例文档**：examples目录下的文档标题
- 📄 **其他页面**：README、学习路径等

---

## 🎯 搜索技巧

### 1. 使用关键词

**推荐做法**：
✅ 飞书
✅ 配置
✅ Skills
✅ 问题
✅ API


**不推荐**：
❌ 如何配置飞书Bot（太长）
❌ 我想知道怎么安装（口语化）


### 2. 中文搜索

支持中文关键词搜索：

```text
飞书 → 找到所有包含"飞书"的标题
配置 → 找到所有包含"配置"的标题
问题 → 找到所有包含"问题"的标题
```

### 3. 英文搜索

支持英文关键词搜索：

```text
API → 找到所有包含"API"的标题
Skills → 找到所有包含"Skills"的标题
Bot → 找到所有包含"Bot"的标题
```

### 4. 组合搜索

使用空格分隔多个关键词：

```text
飞书 配置 → 找到同时包含"飞书"和"配置"的标题
API 问题 → 找到同时包含"API"和"问题"的标题
```

### 5. 模糊匹配

搜索支持前缀匹配：

```text
配 → 可以匹配"配置"
问 → 可以匹配"问题"
Ski → 可以匹配"Skills"
```

---

## 💡 搜索示例

### 示例1：查找飞书相关内容

**搜索词**：`飞书`

**预期结果**：
- 第9章：多平台集成（飞书/企微/钉钉/QQ一键接入）
- 飞书Bot配置
- 飞书配置检查清单
- 等等...

### 示例2：查找配置相关内容

**搜索词**：`配置`

**预期结果**：
- 第2章：5分钟完成部署
- 第11章：高级配置
- 附录H：配置文件模板
- 等等...

### 示例3：查找问题解决

**搜索词**：`问题`

**预期结果**：
- 附录E：常见问题速查
- 故障排查相关章节
- 等等...

### 示例4：查找Skills相关

**搜索词**：`Skills`

**预期结果**：
- 第8章：Skills扩展
- 附录B：必装Skills清单
- Skills开发示例
- 等等...

---

## 🚀 高级功能

### 实时搜索

输入2个字符后，搜索会自动开始（延迟300ms），无需点击搜索按钮。

### 结果高亮

搜索结果中，匹配的关键词会用黄色背景高亮显示。

### 分类标签

搜索结果会显示内容分类：
- 📚 文档 - docs目录下的文档
- 📖 附录 - appendix目录下的附录
- 💡 示例 - examples目录下的示例

### URL参数搜索

可以通过URL参数直接搜索：

```yaml
https://your-site.com/search?q=飞书
```

---

## ❓ 常见问题

### Q1：为什么搜索不到某些内容？

**A**：搜索只匹配标题，不搜索正文内容。如果标题中没有你搜索的关键词，就不会出现在结果中。

**解决方案**：
- 尝试使用标题中可能出现的关键词
- 查看目录，找到相关章节
- 使用浏览器的页内搜索（Ctrl+F / Cmd+F）

### Q2：搜索结果太多怎么办？

**A**：使用更具体的关键词，或组合多个关键词。

**示例**：
❌ 配置 → 结果太多
✅ 飞书 配置 → 结果更精准


### Q3：搜索结果太少或没有结果？

**A**：尝试以下方法：

1. **使用更短的关键词**
   ```
   ❌ 飞书Bot配置 → 可能没结果
   ✅ 飞书 → 有结果
   ```

2. **检查拼写**
   ```
   ❌ Skils → 拼写错误
   ✅ Skills → 正确
   ```

3. **使用同义词**
   ```
   问题 = 故障 = 错误
   配置 = 设置
   ```

### Q4：搜索速度慢？

**A**：首次加载时需要下载搜索索引（约几KB），之后搜索会很快。如果持续慢，请：

1. 刷新页面
2. 清除浏览器缓存
3. 检查网络连接

---

## 📚 相关资源

- [教程目录](../README.md#教程目录)
- [学习路径](../LEARNING-PATH.md)
- [常见问题](../appendix/E-common-problems.md)

---

**最后更新**：2026年2月14日