环境变量

GraphRAG 会加载项目根目录下的 .env，并把 settings.yaml 中的 ${ENV_VAR} 替换为对应环境变量。

# .env
GRAPHRAG_API_KEY=your_api_key

completion_models:
  default_completion_model:
    api_key: ${GRAPHRAG_API_KEY}

管理原则

• .env 不提交到 Git；仓库只保存不含真实值的 .env.example。
• 开发、预览和生产使用各自的密钥来源，不共用同一份文件。
• 日志和错误页面不得输出密钥或完整请求头。
• 替换 Provider 后，同时核对 model_provider、model、认证方式和服务地址。

环境变量存在不代表凭据有效。索引前用 --dry-run 检查配置，真实调用仍需观察模型权限、限额和网络错误。