Appearance
🔍 搜索功能使用指南
本教程的搜索功能专注于标题搜索，帮助你快速找到需要的章节
📖 搜索说明
搜索范围
本站搜索功能仅搜索文档标题，不搜索正文内容。这样设计的原因：
- ✅ 更精准：直接定位到章节标题
- ✅ 更快速：搜索速度更快
- ✅ 更清晰：结果更容易理解
支持的内容
搜索覆盖以下内容的标题：
- 📚 15章正文：第1-15章的所有标题
- 📖 8个附录：附录A-H的标题
- 💡 示例文档：examples目录下的文档标题
- 📄 其他页面：README、学习路径等
🎯 搜索技巧
1. 使用关键词
推荐做法：
text
✅ 飞书
✅ 配置
✅ Skills
✅ 问题
✅ API不推荐：
text
❌ 如何配置飞书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：使用更具体的关键词，或组合多个关键词。
示例：
text
❌ 配置 → 结果太多
✅ 飞书 配置 → 结果更精准Q3：搜索结果太少或没有结果？
A：尝试以下方法：
使用更短的关键词
❌ 飞书Bot配置 → 可能没结果 ✅ 飞书 → 有结果检查拼写
❌ Skils → 拼写错误 ✅ Skills → 正确使用同义词
问题 = 故障 = 错误 配置 = 设置
Q4：搜索速度慢？
A：首次加载时需要下载搜索索引（约几KB），之后搜索会很快。如果持续慢，请：
- 刷新页面
- 清除浏览器缓存
- 检查网络连接
📚 相关资源
最后更新：2026年2月14日