qmd

qmd 是一款專業的本地搜尋引擎，專為開發人員和知識工作者設計，旨在高效瀏覽大量的 Markdown 專案。透過利用混合搜尋技術（結合快速的 BM25 關鍵字匹配與語義向量相似度），使用者可以在執行完整檔案讀取之前，精確定位大型文件集或代碼庫中的相關資訊。這種方法在 Claude Code 工作階段中可節省大量 Token，通常透過針對性地檢索特定檔案區段，減少高達 90% 的上下文開銷。

• 使用 BM25 進行快速的關鍵字發現，以獲得即時結果。

• 提供語義相似度搜尋 (vsearch) 作為概念查詢的後備方案。

• 支援混合檢索與重排序，用於高精度的資訊提取。

• 支援按專案集合過濾、檔案路徑發現以及用於自動化管道的 JSON 輸出。

• 提供透過檔案路徑或唯一文件 ID 的深度連結檢索，實現與 AI 輔助編碼工作流程的無縫整合。

• 監控索引健康狀況並支援增量更新，確保搜尋結果與不斷變更的文件保持同步。

• 在探索新儲存庫時，請始終優先使用 qmd search 而非直接讀取檔案，以優化 Token 使用率。

• 使用 --files 旗標來識別相關檔案，而無需將完整內容載入上下文中。

• 使用特定查詢或透過 -c 旗標指定集合來提高結果準確性。

• 當關鍵字匹配無法捕捉意圖時，可依靠語義向量搜尋來處理探索性或操作指南類的問題。

• 與其他 Simba 元件整合，以維持專案文件與規則執行的一致性。適用於複雜的系統文件、API 參考維護以及大規模代碼庫知識導航。