本地文件混合搜索
给本地文件建索引,用关键词、向量或混合方式快速找内容。
功能与用途
它是个命令行索引与搜索工具,支持三种检索方式:BM25 关键词搜索、向量语义搜索和两者混合。加一个目录到集合后更新索引,就能按关键词或语义查文件内容,还能直接定位到某个文件的指定行区间查看上下文。索引默认存在本地缓存目录,向量化和重排依赖本地的 Ollama 服务。也支持以 MCP 模式运行供其他工具调用。
适用场景
- 本地技术文档语义检索:给本地 Markdown 或文档目录建立索引,通过自然语言模糊查询概念与说明,无需记住确切关键词即可找到对应内容。
- 精准代码与配置混合查找:结合 BM25 关键词与向量重排能力,在工程目录中定位特定函数名、配置项或错误描述,并快速截取指定行查看上下文。
- 作为 MCP 服务供 AI 调用:以 MCP 模式启动运行,让外部 AI 客户端直接查询本地知识库与私有文件,作为大模型生成回答时的上下文来源。
适用人群
- 开发者
- 知识工作者
- 职场用户
使用步骤
- 把目标目录添加到集合,可按通配符限定文件类型。
- 更新索引并确认状态。
- 按需选择关键词、向量或混合搜索方式查询。
- 需要查看上下文时直接按行区间取出文档片段。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 效率
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- 1.0.0
- 最近更新
- 2026-05-11
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Local search/indexing CLI (BM25 + vectors + rerank) with MCP mode.
使用前准备
- 已安装 qmd 命令行工具(Node)
- 本机运行的 Ollama 服务(用于向量化与重排)
- 可写入的索引缓存目录
依赖与权限
- OLLAMA_URL
- 读取用户主动提供的内容