grepai-config-reference

此技能作為透過 .grepai/config.yaml 檔案管理 GrepAI 配置的主要技術參考。專為軟體工程師、DevOps 專業人員及 AI 代理開發者設計，旨在為各種專案規模（從本地個人專案到複雜的團隊架構）微調語義程式碼搜尋環境。此技能涵蓋完整結構，使用戶能在 Ollama 等本地嵌入模型提供者與 OpenAI 等雲端方案間切換，或調整 GOB、PostgreSQL 與 Qdrant 等儲存後端。利用此參考，用戶可優化索引效能，精確管理檔案監控，並運用搜尋增強策略，將核心邏輯等程式碼區域優先級提升，同時過濾測試目錄或依賴資料夾等干擾。

• .grepai/config.yaml 檔案的完整結構剖析。

• 嵌入模型提供者的配置說明，包含 Ollama、OpenAI 與 LM Studio。

• PostgreSQL（支援 pgvector）與 Qdrant 等儲存後端的詳細設定。

• 程式碼區塊切分、Token 大小及重疊度的調整參數，以平衡上下文與效能。

• 搜尋結果評分與排序的配置（包含懲罰與獎勵機制）。

• 使用 tree-sitter AST 解析的進階呼叫圖分析追蹤配置。

• 忽略模式管理，用於排除 node_modules、編譯產物或自動生成程式碼等無關檔案。

• 支援敏感 API 金鑰注入的環境變數處理。

• 推薦用於配置注重隱私的本地優先 AI 代理環境。

• 提供適用於小型專案、大型程式碼庫、團隊環境及高隱私需求場景的配置模板。

• 對於排解索引同步問題、搜尋關聯性故障及嵌入向量維度不匹配至關重要。

• 配置結構支援自訂路徑排除與正規表達式，用於鎖定特定搜尋範圍。

• 請務必檢查 .grepai/config.yaml 語法，以確保代理能正確解析您的向量儲存後端與索引需求。