vitepress-plugin-fullsearch

VitePress 全文搜索插件，提供开箱即用的智能搜索体验。

✨ 特性

• 🚀 零配置使用 - 无需传递任何参数，默认配置即最优
• 🔍 智能分词 - 支持中英文混合搜索，自动逐字符分词
• 🎯 精准排序 - 多层排序优化，确保最相关的结果排在前面
• 💡 友好预览 - 上下文预览，快速定位关键信息
• 🎨 原生体验 - 完美集成 VitePress 默认主题

📦 安装

npm install vitepress-plugin-fullsearch

🚀 使用

最简单的方式（推荐）

// docs/.vitepress/config.mjs
import { defineConfig } from 'vitepress';
import { FullSearchPlugin } from 'vitepress-plugin-fullsearch';

export default defineConfig({
  vite: {
    plugins: [
      FullSearchPlugin(), // 无需任何参数！
    ],
  },
});

高级自定义（可选）

FullSearchPlugin({
  tokenize: 'full', // 全字匹配模式（默认）
  previewLength: 100, // 预览长度（默认 100）
  placeholder: '搜索文档...', // 占位符文本（默认）
  maxSuggestions: 10, // 最多显示结果数（默认）
});

🎯 核心功能

智能多策略搜索

• 原始查询 - 精确匹配整个搜索词
• 拆分查询 - 中英文分离，逐个匹配
• 无空格查询 - 移除空格后的版本

中英文混合搜索

• 自动识别中文和英文关键词
• 中文逐字符分词，支持单字、双字、三字搜索
• 英文保留完整单词，同时支持部分匹配
• 空格容错，有无空格都能搜到

🔧 开发说明

默认配置

1. tokenize: 'full' - 全字匹配模式，中文搜索更准确
2. previewLength: 100 - 显示足够的上下文信息
3. placeholder: '搜索文档...' - 友好的引导文本
4. maxSuggestions: 10 - 平衡性能和用户体验

📄 License

MIT