Docs配置环境变量
返回文档
配置

环境变量

使用环境变量覆盖 provider、model、update channel、vibe coding 等 YeePilot 设置。

最后更新: 2026年5月12日

优先级

环境变量优先于 ~/.yeepilot/config.yml

实用顺序:

  1. 环境变量
  2. config.yml
  3. 内部默认值

常用 AI 变量

  • YEEPILOT_AI_PROVIDER
  • YEEPILOT_AI_MODEL
  • YEEPILOT_AI_BASE_URL
  • YEEPILOT_AI_THINKING
  • YEEPILOT_AI_TOKEN_MODE
  • YEEPILOT_AI_VIBE_CODING

示例:

bash
export YEEPILOT_AI_PROVIDER=openrouter
export YEEPILOT_AI_MODEL=openai/gpt-oss-120b:free
export YEEPILOT_AI_THINKING=auto
export YEEPILOT_AI_VIBE_CODING=false

更新相关变量

  • YEEPILOT_UPDATE_CHANNEL
  • YEEPILOT_UPDATE_CHANNEL_TOKEN

适合在不编辑主配置文件的情况下切换 publiccanary

Vault 与文件相关变量

在某些环境里,您也可能用环境变量临时覆盖 Vault 流程、文件行为或路径设置。这很适合按会话或按主机进行局部调整。

TUI 相关变量

如果部署需要,也可以通过环境变量强制语言、主题或视觉偏好。

单次运行示例

bash
YEEPILOT_AI_PROVIDER=openai \
YEEPILOT_AI_MODEL=gpt-4o \
yeepilot

持久化时要注意

把变量写进 shell 配置会长期生效。一个被遗忘的环境变量,可能会让之后的行为长期看起来不合理。

关于 ai.agent_mode

旧资料里可能提到 ai.agent_mode。请把它视为 legacy 兼容项。现代客户端中的主要控制项是 /plan/autonomy/think,以及必要时的 YEEPILOT_AI_VIBE_CODING