YeePilot 入门指南
几分钟内启动并运行 YeePilot。设置 AI 提供商、发送第一条提示，并了解命令安全机制。
启动 YeePilot
安装完成后，运行以下命令启动 YeePilot：
yeepilot同样功能的短别名：
yee首次运行时，YeePilot 会自动启动设置向导。无需提前进行任何其他配置。
设置向导
设置向导会在大约一分钟内引导您完成基本配置。您可以随时使用 yeepilot setup 重新运行设置向导。
第一步：选择 AI 提供商
YeePilot 支持多个 AI 提供商。选择适合您需求的一个：
| 提供商 | 模型 | 费用 | 需要 API 密钥 |
|---|---|---|---|
| OpenRouter | 多种模型，包含免费选项 | 有免费方案 | 是（免费创建） |
| OpenAI | GPT-4o, GPT-4, GPT-3.5 | 付费 | 是 |
| Anthropic | Claude Sonnet, Claude Haiku | 付费 | 是 |
如果您想免费试用 YeePilot，请选择 OpenRouter -- 它提供的免费模型足以胜任大多数服务器管理任务。
第二步：输入 API 密钥
在提示时粘贴您的 API 密钥。YeePilot 会将其安全地存储在操作系统的密钥环中（macOS 钥匙串、Linux Secret Service 或 Windows 凭据管理器）。在没有密钥环的系统上，密钥存储在加密的本地文件中。
第三步：选择模型
从所选提供商的可用模型中进行选择。向导会根据能力和费用推荐模型。您可以稍后在配置中更改。
第四步：选择语言
YeePilot 的界面支持：
- English（默认）
- German（Deutsch）
这控制系统消息、提示和 TUI 界面的语言。AI 本身可以根据您的输入用任何语言回复。
第五步：安全模式
选择您偏好的安全级别。这控制 YeePilot 在执行前验证命令的严格程度。推荐大多数用户使用默认设置。
第一条提示
设置完成后，您将进入交互式终端。用自然语言描述您想要完成的任务：
> Show me disk usage on all mounted filesystems, sorted by usage percentageYeePilot 将您的请求转化为具体的命令方案：
Plan:
1. df -h --output=source,pcent,target | sort -k2 -rn
Risk: SAFE
Execute? [Y/n]按 Enter 或 Y 批准并执行方案。输出会直接显示在终端中。
更多示例
以下是一些常见的初始提示示例：
> Find the 10 largest files in /var/log> Check which ports are listening and what processes own them> Show memory usage breakdown by process> Create a new user called deploy with SSH key authentication理解命令方案
在您的系统上运行任何命令之前，YeePilot 都会展示一个方案供您审查。每个方案显示：
- 将要执行的确切命令
- 每个命令的风险指标
- 请求您批准的提示
您始终拥有最终决定权。未经您的明确确认，任何命令都不会执行。
风险指标
每个提议的命令被分为四个风险等级：
SAFE（安全 - 绿色）
仅读取的命令，检查系统状态而不做任何更改。
示例：ls, cat, df, ps, uptime, whoami
MODERATE（中等 - 黄色）
以可控方式修改文件或系统状态的命令。这些是常见的管理任务，但值得快速检查一下。
示例：mkdir, cp, mv, chmod, systemctl restart
DANGEROUS（危险 - 红色）
具有重大破坏潜力的命令。YeePilot 会突出显示这些命令并要求明确确认。
示例：rm -rf, dd, mkfs, iptables -F
BLOCKED（阻止 - 停止）
对于自动执行来说过于危险的命令。无论是否批准，YeePilot 都会拒绝运行这些命令。这包括可能导致不可逆的系统级损害的命令。
示例：rm -rf /, :(){ :|:& };:, chmod -R 777 /
下一步
现在 YeePilot 已经运行起来了，请探索以下主题：