核心功能
qmd 是一款由 Shopify CEO Tobi Lutke 开发的本地文件索引与搜索 CLI 工具，本 Skill 为其纯文档型使用说明。核心能力包括：
- 多模式搜索：BM25 关键词检索 (
qmd search)、向量语义搜索 (qmd vsearch)、混合检索 (qmd query) - 本地索引管理：支持添加集合、更新索引、查看状态，数据默认存储于
~/.cache/qmd - MCP 集成：提供
qmd mcp命令实现与 Claude 等 AI 助手的协议对接 - Ollama 依赖：嵌入生成与重排序依赖本地 Ollama 服务（默认
localhost:11434）
显著优点
1. 来源权威：维护者为全球知名企业家 Tobi Lutke，项目托管于个人 GitHub，可信度 T1 级
2. 架构清晰：纯文档型 Skill，无可执行代码，无依赖注入风险
3. 隐私优先：完全本地运行，索引与搜索不依赖云端 API，数据不出境
4. 检索精准：BM25 + 向量 + 重排序的三阶段架构，兼顾关键词匹配与语义理解
潜在局限
- 前置依赖重：必须自行安装并运行 Ollama 及嵌入模型，配置门槛较高
- 无云端同步：纯本地设计，无法跨设备共享索引
- 仅限 Markdown：从文档看主要面向
.md文件，其他格式支持程度不明 - 无可视化界面：纯 CLI 工具，对非技术用户不够友好
适用人群
- 需要本地知识库检索的开发者、研究员
- 注重隐私、不愿将文档上传云端的知识工作者
- 已部署 Ollama 的 AI 本地化用户
- 熟悉命令行操作的效率工具爱好者
常规风险
- Ollama 服务可用性：若本地 11434 端口未运行 Ollama，向量功能将失效
- 索引存储空间：大规模文档集可能消耗显著磁盘空间
- 版本兼容性：
qmd工具本身迭代时，文档可能存在滞后