跳过主要内容
广告OpenFree logo推广你的产品触达更多潜在用户,助力产品增长与收益提升。投放广告
Favicon of QMD

QMD

Free 等级项目

QMD 是一个本地优先的迷你 CLI 搜索工具,用于检索文档、知识库、会议记录等文本。它结合 BM25 全文搜索、向量语义搜索和 LLM 重排序,并通过 node-llama-cpp 与 GGUF 模型全程在设备端运行。

访问 tobi/qmd

项目简介

QMD 是一个设备端搜索工具,用于检索 markdown 笔记、会议记录、文档和知识库中的内容。它支持关键词和自然语言搜索,结合 BM25 全文搜索、向量语义搜索和 LLM 重排序,并通过 node-llama-cpp 与 GGUF 模型全程在本地运行。

核心功能

  • 混合搜索结合 BM25 全文搜索、向量语义搜索和 LLM 重排序。
  • 通过 node-llama-cpp 与 GGUF 模型在设备端本地运行。
  • 可索引 markdown 笔记、会议记录、文档和知识库的集合。
  • 通过 search、vsearch 和 query 命令支持关键词与自然语言查询。
  • 提供 MCP 服务器,包含 query、get、multi_get 和 status 工具,用于智能体集成。
  • 提供 Node.js 和 Bun SDK,可将搜索嵌入应用。

适用场景

  • 从命令行搜索个人笔记、会议记录、文档和知识库。
  • 通过 JSON 和文件输出将结构化搜索结果提供给 AI 智能体和 LLM 工作流。
  • 使用 SDK 为 Node.js 或 Bun 应用添加本地文档检索。
  • 让 Claude Desktop 或 Claude Code 等 MCP 客户端查询本地已索引内容。

快速开始

  • 使用 npm install -g @tobilu/qmd 或 bun install -g @tobilu/qmd 全局安装,也可用 npx @tobilu/qmd 或 bunx @tobilu/qmd 直接运行。
  • 使用 qmd collection add 为笔记、文档和会议记录创建集合,再用 qmd context add 添加上下文。
  • 用 qmd embed 生成嵌入,并用 qmd search 进行关键词搜索、qmd vsearch 进行语义搜索,或用 qmd query 进行带重排序的混合搜索。
  • 配置 MCP 客户端运行 qmd mcp,或用 qmd mcp --http 启动 HTTP 传输。

部署与要求

  • Node.js 版本 22 或更高。
  • Bun 版本 1.0.0 或更高。
  • 在 macOS 上,需要 Homebrew SQLite 以支持扩展。
  • 本地 GGUF 模型在首次使用时从 HuggingFace 自动下载并缓存;默认模型包括 embeddinggemma-300M-Q8_0、qwen3-reranker-0.6b-q8_0 和 qmd-query-expansion-1.7B-q4_k_m。
  • 切换嵌入模型时需用 qmd embed -f 重新索引,因为向量在不同模型之间不兼容。

采用前须知

  • 许可证:MIT。在使用、修改或分发项目前,请确认其具体条款。

评论

登录 后发表评论。

更多类似 QMD 的项目

Favicon of 矩媒 MatrixMedia

矩媒 MatrixMedia

Free 等级项目星标数: 1.3K

多平台视频矩阵发布与批量分发工具

MCP 服务与工具连接器

矩媒 MatrixMedia 是开源的多平台视频矩阵发布与批量分发工具,基于 Electron 与 CLI。一次准备内容,可批量分发到抖音、快手、小红书、视频号、哔哩哔哩等账号矩阵,并提供 CLI、HTTP API 与 MCP,方便脚本和 AI 编排。

Favicon of Pinky

Pinky

Free 等级项目星标数: 1.6K

让 AI 智能体使用你的手机,你全程掌控

MCP 服务与工具连接器

Pinky 是一款跨平台桌面应用,让 Claude Code、Codex、Cursor 等支持 MCP 的智能体或脚本操作真实的 iPhone 与 Android 手机;你可以在电脑上观看过程、批准风险步骤,并回看每次运行的记录。

Favicon of GBrain

GBrain

Free 等级项目星标数: 31.9K

为 AI 代理提供可控的共享记忆层

MCP 服务与工具连接器

GBrain 是面向现有 AI 代理的自托管记忆层,存储带来源的显式事实,支持更正与撤回,并提供关键词、语义、图谱检索及可选的带引用综合。