Docs平台设置Windows 安装指南
返回文档
平台设置

Windows 安装指南

在 Windows 上安装和配置 YeePilot，使用 DPAPI 凭据存储

最后更新: 2026年2月28日

概述

YeePilot 在 Windows 10 和 Windows 11 上运行，提供 x86_64 和 ARM64 的原生二进制文件。本指南涵盖安装、PATH 配置、凭据存储以及如何通过 WSL2 获取完整的沙箱功能。

系统要求

要求详情
Windows 版本Windows 10 (1903+) 或 Windows 11
架构amd64 (x86_64) 或 arm64
终端Windows Terminal（推荐）、PowerShell 或命令提示符

安装

下载二进制文件

Windows 目前尚无自动安装脚本。请从发布页面 (opens in new tab)手动下载二进制文件：

  • yeepilot-windows-amd64.tar.gz 适用于标准 x86_64 系统
  • yeepilot-windows-arm64.tar.gz 适用于 ARM64 设备（如 Surface Pro X、Snapdragon 笔记本电脑）

解压并安装

  1. 解压下载的归档文件。您可以在 PowerShell 中使用内置的 Windows tar 命令：
powershell
tar xzf yeepilot-windows-amd64.tar.gz
  1. 将二进制文件移动到永久位置。常见选择是 C:\Program Files\YeePilot\：
powershell
New-Item -ItemType Directory -Force -Path "C:\Program Files\YeePilot"
Move-Item yeepilot.exe "C:\Program Files\YeePilot\yeepilot.exe"
  1. 将目录添加到系统 PATH，这样您就可以从任何地方运行 yeepilot。

添加到 PATH

通过系统设置（持久化）

  1. 按 Win + S 搜索"环境变量"。
  2. 点击编辑系统环境变量。
  3. 点击环境变量。
  4. 在用户变量（或为所有用户选择系统变量）下，选择 Path 并点击编辑。
  5. 点击新建并添加 C:\Program Files\YeePilot。
  6. 在所有对话框上点击确定。
  7. 打开新的终端窗口使更改生效。

通过 PowerShell（当前用户，持久化）

powershell
$currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$currentPath;C:\Program Files\YeePilot", "User")

运行此命令后打开新的终端窗口。

验证安装

powershell
yeepilot version

初始设置

运行交互式设置以配置 AI 提供商：

powershell
yeepilot setup

这会在 %USERPROFILE%\.yeepilot\config.yaml（通常是 C:\Users\YourName\.yeepilot\config.yaml）创建配置文件。

凭据存储

YeePilot 使用 **Windows 数据保护 API（DPAPI）**安全地存储 API 密钥和认证令牌。DPAPI 使用您的 Windows 用户账户加密凭据，因此只有在您登录时才能访问。

  • 无需安装额外软件。
  • 凭据存储在 YeePilot 配置目录中的加密文件中。
  • 加密绑定到您的 Windows 用户账户。同一台机器上的其他用户无法解密。

终端推荐

YeePilot 的 TUI 需要支持良好 Unicode 和颜色的现代终端。

终端推荐
Windows Terminal强烈推荐。出色的颜色、Unicode 和调整大小支持。可从 Microsoft Store 获取。
PowerShell 7+在 Windows Terminal 中运行时效果良好。
命令提示符基本支持。某些 TUI 元素可能无法正确渲染。
传统 PowerShell (5.x)可用但可能有颜色渲染问题。建议升级到 PowerShell 7+。

安装 Windows Terminal

如果您尚未安装 Windows Terminal：

powershell
winget install Microsoft.WindowsTerminal

或从 Microsoft Store (opens in new tab) 下载。

沙箱限制

原生 Windows 不支持 Linux 内核命名空间。YeePilot 在 Windows 上使用进程级别资源限制，提供基本保护：

  • CPU 时间限制 -- 如果命令超过配置的 CPU 时间，将被终止。
  • 内存限制 -- 进程内存受到限制。
  • 文件大小限制 -- 单个文件创建受到限制。
yaml
# %USERPROFILE%\.yeepilot\config.yaml
sandbox:
  enabled: true
  use_namespaces: false  # Windows 上不可用
  max_cpu_seconds: 300
  max_memory_mb: 512

要获得完整的命名空间沙箱隔离，请使用 WSL2（见下文）。

通过 WSL2 获取完整沙箱功能

**Windows Subsystem for Linux 2（WSL2）**在 Windows 上提供真实的 Linux 内核，使 YeePilot 能够使用完整的命名空间沙箱，包括用户、PID、挂载和网络隔离。

安装 WSL2

如果您尚未安装 WSL2：

powershell
wsl --install

这默认安装带有 Ubuntu 的 WSL2。提示时重新启动计算机。

在 WSL2 中安装 YeePilot

打开 WSL2 终端并使用 Linux 安装脚本安装 YeePilot：

bash
curl -fsSL https://yee.to/install.sh | bash

在 WSL2 中，YeePilot 可以使用完整的 Linux 功能集：

  • 完整的命名空间沙箱隔离
  • GNOME Keyring 凭据存储（如已配置）
  • 带哈希链的防篡改审计日志

从 WSL2 访问 Windows 文件

在 WSL2 中，您的 Windows 驱动器挂载在 /mnt/ 下：

bash
# 访问 Windows 主目录
ls /mnt/c/Users/YourName/
 
# 对 Windows 托管的文件运行 YeePilot
yeepilot run

何时使用 WSL2 与原生 Windows

使用场景推荐
管理 Linux 服务器WSL2（完整沙箱、原生 SSH）
Windows 特定管理原生 Windows
最大安全性WSL2（命名空间隔离）
快速任务原生 Windows（无 WSL 启动时间）

将 YeePilot 作为服务运行

如果您希望 YeePilot 的自动更新检查在后台运行，可以使用 Windows 任务计划程序。但对于大多数用户，启动时的自动更新检查就足够了。

更新

检查并安装更新：

powershell
yeepilot update

或仅检查而不安装：

powershell
yeepilot update --check

要手动更新，从发布页面下载新的二进制文件并替换现有的 yeepilot.exe 文件。

卸载

移除 YeePilot 及其所有数据：

powershell
yeepilot uninstall --all

或仅移除二进制文件：

powershell
yeepilot uninstall --binary-only

手动移除：

  1. 删除二进制文件：C:\Program Files\YeePilot\yeepilot.exe
  2. 删除配置目录：%USERPROFILE%\.yeepilot\
  3. 从 PATH 中移除 C:\Program Files\YeePilot。

如果您也在 WSL2 中安装了，请从 WSL2 终端内单独卸载：

bash
yeepilot uninstall --all
上一篇

macOS 安装指南

Platform Setup

下一篇

最佳实践

Guides