配置参考

配置文件在哪里

主配置文件位于：

~/.yeepilot/config.yml

较早的安装可能仍保留 ~/.yeepilot/config.yaml，但当前应以 config.yml 为准。

如何修改

最实用的三种方式：

• 使用 yeepilot setup
• 打开 Neural HUD 中的 Settings
• 手动编辑 config.yml

优先级

实际优先级顺序：

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

ai 部分

这里控制 AI 的主要行为：

• provider
• model
• base_url
• thinking
• token_mode
• vibe_coding

示例：

ai:
  provider: openrouter
  model: openai/gpt-oss-120b:free
  thinking: auto
  token_mode: balanced
  vibe_coding: false

ai 的高级子部分

部分环境还会使用：

• ai.recovery
• ai.agentic
• ai.failover
• ai.knowledge
• ai.context7
• ai.codeintel
• ai.verification
• ai.scheduler

对终端用户来说，只修改自己真正理解的项会更安全。

security 部分

用于控制审批、安全姿态和审计相关行为。

常见项：

• mode
• require_confirmation
• audit

sandbox 部分

用于限制本地 runtime 能做什么。

常见键：

• enabled
• use_namespaces
• network_access
• max_cpu_seconds
• max_memory_mb
• max_filesize_mb
• max_processes
• denied_paths

示例：

sandbox:
  enabled: true
  network_access: false
  max_cpu_seconds: 120
  max_memory_mb: 1024

tui 部分

控制终端界面，例如：

• theme
• language
• live stream
• sidecar
• 视觉行为

像 tui.hud.* 这样的内部项，通常更适合在 HUD 中修改，而不是手工编辑。

Keybinds

终端用户通常应该在 HUD 的 Keybinds 标签页中管理快捷键。tui.keybinds.actions 虽然存在，但不建议把手动修改内部 action ID 当作常规做法。

files 部分

用于控制附件、上下文和本地文件行为。如果您经常处理大仓库，这一部分值得检查。

vault 部分

这里涉及锁定、autolock 和 Vault 偏好。由于会影响秘密访问和恢复，请谨慎修改。

personality 部分

用于调整面向用户的语气或操作风格。只有在组织有明确要求时才建议修改。

platform 部分

与运行环境有关。大多数用户不需要频繁调整。

update 部分

用于控制更新检查与应用方式。

常见键：

• auto_check
• check_interval_hours
• channel
• channel_token

示例：

update:
  auto_check: true
  check_interval_hours: 24
  channel: public

不应再作为主要控制项的设置

旧资料里可能会出现 ai.agent_mode。它现在只是兼容项，不应再作为主要控制方式。现代使用方式应围绕：

• /plan
• /autonomy
• /think
• ai.vibe_coding

实用建议

• 优先从 HUD 或 yeepilot setup 修改
• 手动编辑时只改自己理解的设置
• 敏感变更先在小任务里验证，再用于正式工作流