如何在 Windows 中安装和使用 AI Shell

　　AI Shell 是一种工具，旨在将人工智能的强大功能直接引入您的命令行界面。它允许您通过对话界面与各种 AI 模型进行交互，从而在命令语法、错误解决甚至代码生成方面提供帮助。本文将指导您完成 AI Shell 在 Windows 上的安装和基本使用。

　　AI Shell 提供了两种主要的安装方式：使用方便的安装脚本，或通过手动安装。对于大多数用户来说，安装脚本是最简单的路由，因此是推荐的方法。

　　将 PowerShell 更新到最新版本

　　您需要 PowerShell 版本 7.4.6 或更高版本才能安装 AI Shell。以下是在 Windows 10 或 Windows 11 PC 上安装和更新 PowerShell 的说明。

　　第 1 步：按 Win + X 并选择 Windows PowerShell(管理员).

　　第 2 步：通过执行以下命令暂时允许脚本运行：

　　Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

　　步骤 3：运行以下命令：

　　Invoke-RestMethod -Uri "https://aka.ms/install-powershell.ps1" -OutFile "install-powershell.ps1"

　　.\install-powershell.ps1

　　步骤 4：将 PowerShell 添加到系统 PATH：

　　1. 按 Win + R，键入 SystemPropertiesAdvanced，然后按 Enter。

　　2. 单击 Environment Variables (环境变量).

　　3. 在“System variables(系统变量)”部分，选择 Path(路径)，然后单击 Edit(编辑).

　　4. 单击 New 并添加以下路径：

　　C:\Users\\AppData\Local\Microsoft\powershell

　　将 替换为您的 Windows 用户名。

　　5. 单击 OK 保存更改并关闭所有对话框。

　　第 5 步：安装后，使用以下方法打开新的 PowerShell 版本：

　　pwsh

　　第 6 步：使用以下命令验证已安装的版本：

　　$PSVersionTable

　　步骤 7(可选)：根据需要恢复默认执行策略：

　　Set-ExecutionPolicy -Scope Process -ExecutionPolicy Restricted

　　此过程可确保 PowerShell 更新到 v7.4.6 或更高版本，并且可以全局访问。

　　使用安装脚本安装 AI Shell

　　安装脚本简化了安装 AI Shell 可执行文件和 PowerShell 模块的过程。该方法会自动配置必要的路径并安装 AI Shell 模块。

　　步骤1：以管理员身份打开终端。您可以通过按 Win 键，键入“终端”，右键单击“终端”并选择“以管理员身份运行”来执行此操作。

　　步骤2：如果终端默认不使用 PowerShell 打开，请单击选项卡栏中的下拉菜单图标，然后选择“Windows PowerShell”。

　　步骤3：运行以下命令以使用我们在上面安装的 PowerShell v7.4.6(或更高版本)。

　　pwsh

　　步骤4：执行安装脚本。将以下命令复制并粘贴到 PowerShell 窗口中，然后按 Enter 键:

　　Invoke-Expression "& { $(Invoke-RestMethod 'https://aka.ms/install-aishell.ps1') }"

　　此脚本将aish.exe下载并安装到 $env:LOCALAPPDATA\Programs\AIShell，将其添加到 PATH 环境变量中，然后将 AIShell 模块安装到模块路径中。此过程将允许您从命令行或直接从 PowerShell 运行 AI Shell。

　　步骤5：安装完成后，您可以在 PowerShell 窗口中使用命令 Start-AIShell 启动 AI Shell。此命令将在 Windows 终端中打开一个拆分窗格，AI Shell 在右侧窗格中运行。系统将提示您选择 AI 代理，在您运行 Start-AIShell 命令后，将通过提示符完成初始选择。

　　________________________________________

　　手动安装 AI Shell

　　如果您无法使用安装脚本或更喜欢手动控制，则可以按照以下步骤安装 AI Shell。此方法包括下载必要的文件、提取它们，并将它们的位置添加到系统的 PATH 变量中。

　　步骤1：下载适用于 Windows 的最新版本的 AI Shell。访问官方源，下载与您的系统架构相匹配的相应 ZIP 文件，例如 AIShell-1.0.0-preview.1-win-x64.zip.

　　步骤2：将下载的 ZIP 文件解压到系统上的合适位置，例如 C:\AIShell。此文件夹将包含 aish.exe 可执行文件。

　　步骤3：将提取的文件夹添加到系统的 PATH 环境变量中。这允许您从任何命令提示符运行 aish.exe。

　　为此，请在 Windows 搜索栏中搜索“环境变量”，单击“编辑系统环境变量”，然后选择“环境变量”。在“系统变量”下，选择“路径”，单击“编辑”，单击“新建”，然后添加提取文件夹的完整路径(例如，C:\AIShell)，然后保存。

　　步骤4：安装 AIShell PowerShell 模块。以管理员身份打开终端，并在终端的 Windows PowerShell 选项卡中运行以下命令：

　　Install-PSResource -Name AIShell

　　此命令从 PowerShell 库下载并安装 AI Shell 模块，从而提供与 PowerShell 环境的无缝集成。

　　________________________________________

　　配置和使用 AI Shell

　　安装 AI Shell 后，您需要配置要使用的 AI 代理。默认情况下，AI Shell 提供两个代理：Azure OpenAI 代理和 Azure 中的 Copilot。Azure OpenAI 代理需要额外的配置，包括提供终结点、API 密钥，可能还需要系统提示符，从而使 AI 模型为特定用例奠定基础。Azure 代理中的 Copilot 专为 Azure 特定任务而设计，需要您登录到 Azure。

　　从右侧面板中选择一个代理进行配置。

　　要配置代理，请在 AI Shell 窗格中运行命令 /agent config。

　　将打开一个 JSON 配置文件，您可以在其中添加设置，包括 API 密钥或其他访问凭证。

　　例如，如果您正在配置 openai-gpt 模型，请将下面代码块中的内容粘贴到您的配置文件中，将 替换为您的 API 密钥并保存配置文件：

　　{

　　// Declare GPT instances.

　　"GPTs": [

　　/* --- uncomment the examples below and update as appropriate ---