agent-aide/aide-marketplace/aide-plugin/commands/install-win.md

Aide Windows 环境安装

你正在执行 Aide Windows 环境安装流程。这是一个独立运行的命令，用于在 Windows 系统上安装 aide 所需的全部环境依赖。

概述

本命令将检测并安装以下工具：

• uv - Python 包管理器（用于管理 Python 和依赖）
• Python - aide 运行时环境（通过 uv 安装）
• Java JRE - PlantUML 运行依赖（用于生成流程图）

---

开始

1. 系统检测

首先确认当前系统是 Windows：

# 检测操作系统
$env:OS

如果不是 Windows 系统，请提示用户使用 /aide:install-linux 命令。

2. 环境检测

检测当前环境中各工具的可用性：

2.1 检测 uv

uv --version

2.2 检测 Python

# 先尝试 uv 管理的 Python
uv python list 2>$null

# 如果 uv 不可用，检测系统 Python
python --version 2>$null
python3 --version 2>$null

2.3 检测 Java

java -version 2>&1

2.4 汇总检测结果

根据检测结果，列出：

• 已安装的工具及版本
• 缺失的工具

如果所有工具都已安装，跳转到「aide PATH 配置」章节。

---

3. 安装模式选择

向用户询问安装模式：

模式 A：自动安装

• 生成安装报告，用户确认后自动执行安装
• 适合希望快速完成的用户

模式 B：手动指南

• 生成详细的操作指南和自动化脚本
• 用户可以自行选择执行
• 适合需要完全控制安装过程的用户

使用 AskUserQuestion 工具询问用户选择。

---

4. 模式 A：自动安装

4.1 生成安装报告

在执行任何安装操作前，必须先生成安装报告，内容包括：

将要执行的操作：

• 列出每个需要安装的工具
• 说明安装命令

安装位置：

• uv: %USERPROFILE%\.local\bin\ 或 %USERPROFILE%\.cargo\bin\
• Python: 由 uv 管理，位于 %USERPROFILE%\.local\share\uv\python\
• Java: 取决于安装方式（winget/scoop/手动）

可能的副作用：

• 会修改用户 PATH 环境变量
• 可能需要重启终端生效

潜在风险：

• 如果已有其他 Python 安装，可能产生版本冲突
• 需要网络连接下载安装包

4.2 请求用户确认

使用 AskUserQuestion 工具，展示报告并请求用户确认。

如果用户不确认，取消安装并退出。

4.3 执行安装

安装 uv（如需要）

# 使用官方安装脚本
irm https://astral.sh/uv/install.ps1 | iex

安装后验证：

# 刷新环境变量
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","User") + ";" + [System.Environment]::GetEnvironmentVariable("Path","Machine")

# 验证安装
uv --version

安装 Python（如需要）

# 使用 uv 安装 Python 3.11
uv python install 3.11

# 验证安装
uv python list

安装 Java JRE（如需要）

检测可用的包管理器：

# 检测 winget
winget --version 2>$null

# 检测 scoop
scoop --version 2>$null

# 检测 chocolatey
choco --version 2>$null

根据可用的包管理器选择安装方式：

使用 winget（推荐）：

winget install EclipseAdoptium.Temurin.17.JRE

使用 scoop：

scoop bucket add java
scoop install temurin17-jre

使用 chocolatey：

choco install temurin17jre -y

无包管理器： 提供 Adoptium Temurin JRE 下载链接：

• https://adoptium.net/temurin/releases/?os=windows&arch=x64&package=jre

指导用户下载并手动安装 MSI 包。

安装后验证：

java -version

4.4 汇报安装结果

列出每个工具的安装状态和版本。

---

5. 模式 B：手动指南

5.1 生成 Markdown 操作指南

创建文件 aide-install-guide.md，内容包括：

# Aide 环境安装指南 (Windows)

## 1. 安装 uv

uv 是 Astral 开发的高性能 Python 包管理器。

### 方法一：PowerShell 脚本（推荐）

```powershell
irm https://astral.sh/uv/install.ps1 | iex

方法二：手动下载

1. 访问 https://github.com/astral-sh/uv/releases
2. 下载 uv-x86_64-pc-windows-msvc.zip
3. 解压到 %USERPROFILE%\.local\bin\
4. 将该目录添加到 PATH

验证安装

uv --version

2. 安装 Python

使用 uv 安装受管理的 Python：

uv python install 3.11

验证安装

uv python list

3. 安装 Java JRE

Java 用于运行 PlantUML 生成流程图。

方法一：使用 winget（推荐）

winget install EclipseAdoptium.Temurin.17.JRE

方法二：使用 scoop

scoop bucket add java
scoop install temurin17-jre

方法三：手动下载

1. 访问 https://adoptium.net/temurin/releases/?os=windows&arch=x64&package=jre
2. 下载 MSI 安装包
3. 运行安装程序

验证安装

java -version

4. 配置 aide PATH

将 aide-program 添加到系统 PATH：

# 获取 aide-program 路径（根据实际位置调整）
$aidePath = "C:\path\to\aide-program\bin"

# 添加到用户 PATH
$currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
if ($currentPath -notlike "*$aidePath*") {
    [Environment]::SetEnvironmentVariable("Path", "$currentPath;$aidePath", "User")
}

5. 验证安装

# 重启终端后运行
aide env ensure --runtime

常见问题

Q: uv 安装后命令找不到？

A: 重启终端或手动刷新环境变量。

Q: Python 版本冲突？

A: uv 管理的 Python 独立于系统 Python，不会冲突。

Q: Java 安装后仍然找不到？

A: 检查 JAVA_HOME 和 PATH 是否正确配置。

#### 5.2 生成 PowerShell 安装脚本

创建文件 `aide-install.ps1`：

```powershell
#Requires -Version 5.1
<#
.SYNOPSIS
    Aide 环境自动安装脚本 (Windows)

.DESCRIPTION
    此脚本用于安装 aide 工具所需的环境依赖：
    - uv (Python 包管理器)
    - Python (通过 uv 安装)
    - Java JRE (用于 PlantUML)

.PARAMETER AideProgramPath
    aide-program 目录的路径

.PARAMETER SkipUv
    跳过 uv 安装

.PARAMETER SkipPython
    跳过 Python 安装

.PARAMETER SkipJava
    跳过 Java 安装

.EXAMPLE
    .\aide-install.ps1 -AideProgramPath "C:\projects\aide-program"

.NOTES
    作者: aide
    版本: 1.0
#>

param(
    [string]$AideProgramPath,
    [switch]$SkipUv,
    [switch]$SkipPython,
    [switch]$SkipJava
)

# 颜色输出函数
function Write-Success { Write-Host "✓ $args" -ForegroundColor Green }
function Write-Warning { Write-Host "⚠ $args" -ForegroundColor Yellow }
function Write-Error { Write-Host "✗ $args" -ForegroundColor Red }
function Write-Info { Write-Host "→ $args" -ForegroundColor Cyan }

# 检测工具是否可用
function Test-Command {
    param([string]$Command)
    $null -ne (Get-Command $Command -ErrorAction SilentlyContinue)
}

# 刷新环境变量
function Update-Path {
    $env:Path = [System.Environment]::GetEnvironmentVariable("Path","User") + ";" + [System.Environment]::GetEnvironmentVariable("Path","Machine")
}

Write-Host "========================================" -ForegroundColor Cyan
Write-Host "    Aide 环境安装脚本 (Windows)        " -ForegroundColor Cyan
Write-Host "========================================" -ForegroundColor Cyan
Write-Host ""

# 1. 安装 uv
if (-not $SkipUv) {
    Write-Info "检测 uv..."
    if (Test-Command "uv") {
        $uvVersion = uv --version 2>&1
        Write-Success "uv 已安装: $uvVersion"
    } else {
        Write-Info "安装 uv..."
        try {
            Invoke-RestMethod https://astral.sh/uv/install.ps1 | Invoke-Expression
            Update-Path
            if (Test-Command "uv") {
                Write-Success "uv 安装成功"
            } else {
                Write-Error "uv 安装后仍无法找到，请重启终端后重试"
            }
        } catch {
            Write-Error "uv 安装失败: $_"
        }
    }
}

# 2. 安装 Python
if (-not $SkipPython) {
    Write-Info "检测 Python..."
    if (Test-Command "uv") {
        $pythonList = uv python list 2>&1
        if ($pythonList -match "3\.\d+") {
            Write-Success "Python 已通过 uv 安装"
        } else {
            Write-Info "通过 uv 安装 Python 3.11..."
            uv python install 3.11
            Write-Success "Python 3.11 安装成功"
        }
    } else {
        Write-Warning "uv 不可用，无法安装 Python"
    }
}

# 3. 安装 Java
if (-not $SkipJava) {
    Write-Info "检测 Java..."
    if (Test-Command "java") {
        $javaVersion = java -version 2>&1 | Select-Object -First 1
        Write-Success "Java 已安装: $javaVersion"
    } else {
        Write-Info "安装 Java JRE..."

        if (Test-Command "winget") {
            Write-Info "使用 winget 安装..."
            winget install EclipseAdoptium.Temurin.17.JRE --silent
            Update-Path
        } elseif (Test-Command "scoop") {
            Write-Info "使用 scoop 安装..."
            scoop bucket add java
            scoop install temurin17-jre
        } elseif (Test-Command "choco") {
            Write-Info "使用 chocolatey 安装..."
            choco install temurin17jre -y
            Update-Path
        } else {
            Write-Warning "未检测到包管理器，请手动安装 Java JRE"
            Write-Info "下载地址: https://adoptium.net/temurin/releases/?os=windows&arch=x64&package=jre"
        }

        if (Test-Command "java") {
            Write-Success "Java 安装成功"
        }
    }
}

# 4. 配置 aide PATH
if ($AideProgramPath) {
    $binPath = Join-Path $AideProgramPath "bin"
    if (Test-Path $binPath) {
        $currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
        if ($currentPath -notlike "*$binPath*") {
            Write-Info "添加 aide 到 PATH..."
            [Environment]::SetEnvironmentVariable("Path", "$currentPath;$binPath", "User")
            Update-Path
            Write-Success "aide 已添加到 PATH"
        } else {
            Write-Success "aide 已在 PATH 中"
        }
    } else {
        Write-Warning "aide-program/bin 目录不存在: $binPath"
    }
}

Write-Host ""
Write-Host "========================================" -ForegroundColor Cyan
Write-Host "    安装完成！请重启终端后使用         " -ForegroundColor Cyan
Write-Host "========================================" -ForegroundColor Cyan

5.3 保存文件

将上述两个文件保存到当前工作目录，并告知用户文件位置。

---

6. aide PATH 配置

检测 aide-program 的位置（通常是本仓库的 aide-program/bin 目录）。

6.1 检测当前 PATH

$env:Path -split ";" | Where-Object { $_ -like "*aide*" }

6.2 如果 aide 不在 PATH 中

生成配置命令：

# 获取 aide-program 完整路径
$aidePath = "完整路径\aide-program\bin"

# 方法一：临时添加（当前会话）
$env:Path += ";$aidePath"

# 方法二：永久添加（用户级别）
$currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$currentPath;$aidePath", "User")

6.3 验证配置

# 重启终端后
aide --help

---

7. 最终验证

运行 aide 环境检测：

aide env ensure --runtime

如果验证通过，显示成功信息。

如果验证失败，显示问题诊断和解决建议。

---

完成

安装完成后，向用户汇报：

环境安装完成：
- uv: [版本]
- Python: [版本]
- Java: [版本]
- aide: [PATH 状态]

下一步：
- 运行 /aide:setup 配置项目环境
- 或直接使用 /aide:run 执行任务

---

注意事项

• 此命令是独立运行的，通常在首次使用 aide 前执行一次
• 所有安装操作都需要用户确认，不会静默修改系统
• 如果安装过程中断，可以重新运行此命令继续
• 建议在安装完成后重启终端以确保环境变量生效