本地优先搜索优化
问题
本地优先搜索引擎完全在浏览器中运行，无需服务器往返即可提供即时结果。然而，这意味着它们受到浏览器内存和处理能力的限制。如果搜索索引没有得到妥善优化，它可能会消耗过多的 RAM，导致浏览器标签页卡顿甚至崩溃，尤其是在移动设备上。
为什么重要
无缝的搜索体验对于提高开发者效率至关重要。如果搜索工具引起性能问题或消耗过多内存，用户就会避免使用它。针对本地优先搜索优化您的内容，可确保您的文档在所有设备和网络条件下都能保持快速、响应灵敏且可靠。
方法
docmd 的 搜索插件 在构建时使用提取流水线来创建高度优化的索引。通过剪枝不必要的数据并专注于高价值的语义字段，它确保了生成的索引既全面又轻量。
实施
1. 构建时提取
在构建过程中，docmd 会处理您的 Markdown 文件，仅提取最相关的文本进行索引。它会自动剥离：
- HTML 标签和结构化样板。
- 不增加语义价值的 Markdown 语法字符。
- 仅用于格式化、会导致索引膨胀的元素。
这确保了索引器仅接收干净、有意义的文本，从而显著减小了最终索引的大小。
2. 利用 Frontmatter 进行战略索引
您可以使用 Frontmatter 明确控制页面的索引方式。例如，如果页面包含大量重复数据（如原始 JSON 日志），而这些数据对搜索没有帮助，您可以选择仅索引标题和元数据。
---
title: "API 日志参考"
search:
indexBody: false # 仅索引标题和行标题
---
3. 客户端内存管理
docmd 在浏览器中精细管理搜索索引的生命周期。它采用按需加载策略，这意味着仅在用户首次与之交互时才初始化搜索引擎。这保持了初始页面加载的足迹较小，并确保系统资源仅在需要时才被使用。
权衡
从搜索索引中激进地剪枝内容（例如排除大型代码块）有时会导致错过一些冷门的搜索结果。您必须在轻量、快速的索引与全面的搜索覆盖范围之间取得平衡。我们建议优先考虑标题和概念性描述，因为这些是开发者最常用的搜索目标。