仓库级配置

在仓库中放置 .xgopilot.yml 文件，为该仓库定制 XGopilot 的行为。此文件是可选的 —— 不放也能正常工作，XGopilot 会使用合理的默认值。

文件位置

配置文件可以放在以下任一位置（按优先级从高到低）：

your-repo/
├── .xgopilot.yml              ← 最高优先级
├── .github/
│   └── xgopilot.yml           ← GitHub 风格
└── .codeagent/
    └── xgopilot.yml           ← 专用目录

XGopilot 按顺序检查这些路径，使用第一个找到的文件。

可配置选项

仓库级配置主要用于模型设置。敏感信息（API Key、Base URL 等）通过全局配置和环境变量管理，不在仓库配置中设置。

设置默认 AI 模型

# .xgopilot.yml
default_ai_provider: claude

支持的值：claude、deepseek、gemini、minimax、kimi、zhipu、codex

自定义 Provider 模型

可以为每个 Provider 覆盖具体的模型名称：

# .xgopilot.yml
default_ai_provider: claude

claude:
  model: "claude-sonnet-4"

# deepseek:
#   model: "deepseek/deepseek-v3.2-251201"

# gemini:
#   model: "gemini-3.0-pro-preview"

注意：仓库配置中只能设置模型名称。API Key、Base URL 等敏感配置仍然从全局配置和环境变量读取。

配置生效方式

.xgopilot.yml 的变更立即生效，无需重启或重新部署。XGopilot 每次处理请求时都会从默认分支读取该文件。

配置优先级：命令行参数 > 仓库配置 > 全局配置