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 语法，以确保代理能正确解析您的向量存储后端与索引需求。