指南

更新与故障排查

保持 YeePilot 为最新状态，并解决 provider、model、sandbox、Vault、配置和支持相关问题。

最后更新: 2026年6月21日

更新 YeePilot

手动更新：

bash

yeepilot update --check      # 检查可用更新
yeepilot update              # 安装可用版本
yeepilot update --force      # 需要时强制重新安装
yeepilot update --rollback   # 回滚到上一版本

查看总体状态：

bash

yeepilot status

YeePilot 会在替换已安装的二进制文件前验证公开更新。如果验证失败，更新不会应用，YeePilot 会尝试保留或恢复到之前的版本。

启动时，如果当前通道有新版本可用，YeePilot 可能会显示提示。实际安装仍需您明确运行 yeepilot update。

更新通道

常见通道：

public
canary

可通过以下方式设置：

~/.yeepilot/config.yml
YEEPILOT_UPDATE_CHANNEL
YEEPILOT_UPDATE_CHANNEL_TOKEN

更新设置

update 部分通常包括：

auto_check
check_interval_hours
channel
channel_token

诊断命令

bash

yeepilot diagnostics pending
yeepilot diagnostics report-last
yeepilot diagnostics report-last --context "vault unlock issue"

Support report

需要向支持团队提交上下文时：

bash

yeepilot support report --message "describe the problem"

也可以附加 --title、--context、--severity 和 --include-debug-log。

常见问题

平台登录或退出

需要重新进行平台认证时：

bash

yeepilot setup --auth
yeepilot logout

yeepilot logout 以及交互式客户端中的 /logout 只会退出 YeePilot 平台。提供商密钥和 vault 条目需要单独管理。

provider 或 model 无法使用

请检查：

当前 provider
已配置 model
认证信息
provider 侧是否可用

sandbox 限制过强

检查 config.yml 中的 sandbox，尤其是：

enabled
network_access
max_cpu_seconds
max_memory_mb
denied_paths

Vault 无法解锁

检查：

主解锁方法
HUD 中的锁定状态
如果丢失常用方式，则检查 recovery key

配置似乎损坏

先备份当前配置，再重新运行：

bash

yeepilot setup

如果想从头开始，可先把 ~/.yeepilot/config.yml 临时移走，再重新运行向导。

出现问题后的推荐顺序

yeepilot status
查看 HUD 中的 Settings 和 Audit
yeepilot diagnostics pending
yeepilot diagnostics report-last
yeepilot support report --message "..."

最佳实践

Guides