传统的全文搜索依赖于精确的关键词匹配。如果用户搜索“身份验证”，但页面仅使用“OAuth2”或“登录”等词汇，标准关键词搜索引擎将无法查找到它。

docmd 提供了由 @docmd/plugin-search 支持的客户端 混合语义搜索。它在浏览器内运行本地 Hugging Face ONNX 模型管道，将 BM25 关键词频率与向量余弦相似度相结合，无需调用第三方 API 即可实现自然语言理解。

配置

在 docmd.config.json 中启用语义搜索：

{
  "plugins": {
    "search": {
      "semantic": true,
      "showConfidence": true
    }
  }
}

嵌入模型配置档

在 CI/CD 中预构建向量

在构建步骤中预先生成向量索引分块，以加速浏览器端执行：

# 构建语义搜索向量分块
npx docmd-search --build

# 编译静态站点
npx @docmd/core build

这会将静态 Vecto-JSON 分块输出至 .docmd-search/。