在 Windows 上安装和使用 AI Shell 的分步指南

在 Windows 上安装和使用 AI Shell 的分步指南

掌握Windows上AI Shell的安装和使用

AI Shell 通过将先进的人工智能功能直接集成到命令行界面 (CLI) 中来增强用户的能力。此工具提供了一个对话环境,用于与各种 AI 模型进行交互,通过简单的命令语法、错误解决甚至代码生成来提高工作效率。本综合指南将指导您在 Windows 系统上逐步安装和有效使用 AI Shell。

安装 AI Shell 的先决条件

在开始安装之前,请确保您已:

  • Windows 10 或 Windows 11 操作系统。
  • 您的系统上安装了 PowerShell 版本 7.4.6 或更高版本。
  • 安装软件和修改环境变量的管理权限。

满足这些先决条件可确保安装过程更加顺利,并最大限度地减少潜在问题。

将 PowerShell 更新到最新版本

要成功安装 AI Shell,您需要将 PowerShell 更新至 7.4.6 或更高版本。请按照以下步骤进行无缝更新:

  1. 按下Win + X并选择Windows PowerShell(管理员)
  2. 通过执行以下命令允许脚本临时运行:
  3. Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

  4. 运行以下命令下载并安装最新的 PowerShell:
  5. Invoke-RestMethod -Uri "https://aka.ms/install-powershell.ps1"-OutFile "install-powershell.ps1"
    .\install-powershell.ps1

  6. 将 PowerShell 添加到系统 PATH:
  • Win + R,输入SystemPropertiesAdvanced,然后按 Enter。
  • 单击环境变量
  • 系统变量部分中,找到路径并选择编辑
  • 单击新建并添加路径:
    C:\Users\\AppData\Local\Microsoft\powershell

请记住用您的实际 Windows 用户名替换<YourUsername>

设置环境变量
  • 单击“确定”保存更改。
  • 使用以下命令打开新的 PowerShell 版本:
  • pwsh

  • 通过运行以下命令来验证您的安装:
  • $PSVersionTable

    PowerShell 版本验证
  • (可选)如有必要,恢复默认执行策略:
  • Set-ExecutionPolicy -Scope Process -ExecutionPolicy Restricted

    按照以下步骤可确保 PowerShell 至少更新至 7.4.6 版本并可全局访问,为成功安装 AI Shell 奠定基础。

    使用安装脚本安装 AI Shell

    安装 AI Shell 的最快方法是通过自动安装脚本,该脚本会为您配置一切。操作方法如下:

    1. 按下键Win,输入“终端”,右键单击“终端”,然后选择“以管理员身份运行”,以管理员身份打开终端。
    2. 如果终端默认没有使用 PowerShell 打开,请从选项卡栏的下拉菜单中选择“Windows PowerShell”。
    3. 通过输入以下命令启动更新的 PowerShell 实例:
    4. pwsh

    5. 使用以下命令执行安装脚本:
    6. Invoke-Expression "& { $(Invoke-RestMethod 'https://aka.ms/install-aishell.ps1') }"

      此命令将下载aish.exe并将$env:LOCALAPPDATA\Programs\AIShell其添加到系统的 PATH,从而允许从任何命令提示符进行访问。

    7. 安装后,通过在 PowerShell 中输入命令来启动 AI Shell Start-AIShell。这将在 Windows 终端中打开一个拆分窗格,其中 AI Shell 可供使用。启动后,系统会提示您选择 AI 代理。

    手动安装 AI Shell

    对于那些喜欢手动安装的人来说,你可以手动安装 AI Shell。以下是分步方法:

    1. 从与您的系统架构相匹配的官方来源下载 AI Shell 的最新 ZIP 文件(例如AIShell-1.0.0-preview.1-win-x64.zip)。
    2. 将 ZIP 文件解压到系统上的指定文件夹,例如C:\AIShell
    3. 将该文件夹添加到系统的 PATH 变量中,使您能够aish.exe全局运行。
    4. 为此,在 Windows 搜索中搜索“环境变量”,选择“编辑系统环境变量”,然后打开“环境变量”。在系统变量区域中,找到并编辑路径,并添加到解压文件夹的完整路径(例如C:\AIShell)。

    5. 以管理员身份打开 PowerShell,然后运行以下命令安装 AI Shell PowerShell 模块:
    6. Install-PSResource -Name AIShell

    此命令从 PowerShell 库中检索并安装所需的模块,从而允许无缝集成到您的 CLI 环境中。

    配置和使用AI Shell

    安装 AI Shell 后,下一步是为您选择的 AI 代理进行配置。默认情况下,AI Shell 提供两个代理:Azure OpenAI 代理和 Azure 中的 Copilot。Azure OpenAI 代理需要通过提供您的端点、API 密钥以及可能的系统提示来进行额外配置,以根据您的特定需求定制 AI 模型。Azure 代理中的 Copilot 专注于与 Azure 相关的任务,因此您必须登录 Azure 才能使用它。

    从配置面板中选择一个代理来开始设置过程。

    AI Shell 配置

    通过在 AI Shell 窗格中运行命令来配置您选择的代理/agent config。将打开一个 JSON 格式的配置文件,允许您输入基本设置,例如 API 访问凭据:

    {
    "GPTs": [
    // Example configuration for Azure OpenAI
    {
    "Name": "ps-az-gpt4",
    "Description": "A GPT instance for PowerShell.",
    "Endpoint": "<insert your Azure OpenAI endpoint>",
    "Deployment": "<insert your deployment name>",
    "ModelName": "<insert the model name>",
    "Key": "<insert your key>",
    "SystemPrompt": "You are a helpful assistant for PowerShell scripting."
    }
    ],
    "Active": null
    }

    将占位符替换为您的实际 API 密钥并保存配置文件。然后,通过/refresh在 AI Shell 窗格中键入内容来刷新以应用更改。

    与 AI Shell 交互很简单:在窗格中输入您的查询。要将命令定向到特定代理,请@<agentName>在查询前面使用语法,例如@openai-gpt "How do I list files in a directory?"

    使用 AI Shell 命令增强您的工作流程

    AI Shell 包含多种内置命令和键盘快捷键,可以提高您的工作效率:

    • 使用/code post命令或Ctrl + D, Ctrl + D快捷方式将生成的代码插入当前 PowerShell 会话。
    • 利用/code copyCtrl + D, Ctrl + C将生成的代码片段复制到剪贴板以供日后使用。
    • Alt + RightArrow使用和在 AI Shell 和 PowerShell 窗格之间导航Alt + LeftArrow
    • 使用Resolve-Errorcmdlet 将错误消息发送至 AI Shell 以获取帮助。
    • 对于复杂的查询,利用Invoke-AIShell命令与选定的代理进行交互。
    • 键入/help以显示所有可用的命令。

    /code post命令简化了将代码从 AI Shell 发布到会话的过程,同时/code copy有助于保存代码片段以供将来参考。使用该Resolve-Error命令,您可以直接通过 AI Shell 获得实时问题故障排除支持。

    结论

    AI Shell 使用命令行界面增强了与 AI 模型的交互,非常适合开发人员和 IT 专业人员。无论您选择自动安装脚本还是选择手动安装以获得更多控制,AI Shell 都可以简化 AI 交互体验。它利用直观的界面、强大的命令和无缝集成来显著提高日常任务的生产力。

    更多见解

    1. AI Shell 的系统要求是什么?

    AI Shell 需要 Windows 10 或 Windows 11 以及 PowerShell 版本 7.4.6 或更高版本。确保您具有安装和配置的管理权限。

    2. 没有网络连接的话可以使用AI Shell吗?

    AI Shell 需要互联网连接才能与在线托管的 AI 模型进行交互,尤其是在使用 Azure OpenAI 代理或访问公共 API 时。

    3. 如何解决 AI Shell 的安装问题?

    如果遇到问题,请确保您的 PowerShell 已更新,仔细检查 PATH 变量配置,并Resolve-Error在运行时使用该命令寻求帮助。

    来源和图片

    发表回复

    您的邮箱地址不会被公开。 必填项已用 * 标注