# 安装

> 下载 Windows 版 NeuroSquad 安装程序，选好安装位置，其余一切交给首次运行的设置向导。

Source: https://docs.neurosquad.ai/zh/getting-started/installation

NeuroSquad 提供适用于 **Windows 10 和 11（64 位）** 的现成安装程序。下载的是一个小巧的在线安装程序（160 KB）：
它会获取最新版本（约 100 MB），校验 SHA-256 校验和，然后启动安装。无需自行构建，
也不用碰终端。Mac 用户请参阅[在 macOS 上安装](https://docs.neurosquad.ai/zh/getting-started/macos)；Linux 版本稍后推出。

[前往下载页面](https://neurosquad.ai/zh/download/)

**1. 下载 NeuroSquad-Installer.exe**

打开我们网站上的[下载页面](https://neurosquad.ai/zh/download/)，点击 **下载 Windows 版**。
运行后，它会下载最新版本的 NeuroSquad，校验后打开安装界面。

**2. 运行它——并通过 SmartScreen**

安装程序目前还没有代码签名，所以 Windows 可能会弹出蓝色的 **Windows protected your PC**
（“Windows 已保护你的电脑”）窗口。点击 **More info**（“更多信息”），确认应用是
`NeuroSquad-Installer.exe`，然后点击 **Run anyway**（“仍要运行”）。

**3. 选择安装位置**

**安装位置**已经预先填好：`%LOCALAPPDATA%\Programs\NeuroSquad`。可以保留，也可以用
**浏览…** 选择其他文件夹——下方一行会显示 NeuroSquad 需要多少空间（369 MB）以及磁盘剩余空间。
想在桌面放一个 NeuroSquad 图标，就让 **桌面快捷方式** 保持开启。

安装到默认文件夹时，NeuroSquad 只为你当前的 Windows 账户安装，窗口底部会显示
**无需管理员权限**。如果选择 Program Files 这类文件夹，底部会改为 **此文件夹需要管理员权限 ·
Windows 会请求授权**——点击“安装”后，Windows 会弹窗请求授权。

**4. 点击“安装”**

窗口会显示当前步骤、已解压的文件数量和进度条。**显示日志** 会打开安装日志：每个文件的大小和校验和，
并附有时间戳。解压文件期间可以随时点击 **取消**，已复制的文件会被删除。

**5. 启动 NeuroSquad**

看到 **NeuroSquad 已安装** 后，点击 **启动 NeuroSquad**。之后可以从开始菜单启动它（如果保留了快捷方式，
桌面上也有）。

> 对于任何尚未使用证书签名的新应用，SmartScreen 都会显示这个警告。请只从我们的[下载页面](https://neurosquad.ai/zh/download/)下载安装程序。

## 从终端安装

同一个安装程序，无界面运行：只为你的 Windows 账户安装，无需管理员权限。每种方式在运行前都会用
SHA-256 校验和核对下载的文件；无论用哪种方式安装，之后 NeuroSquad 都会自动更新。

**winget**——Windows 程序包管理器，Windows 10 和 11 自带：

```powershell
winget install NeuroSquad.NeuroSquad
```

**Scoop**——先添加 NeuroSquad 的软件仓库，再安装到 Scoop 的应用文件夹：

```powershell
scoop bucket add neurosquad https://github.com/glmn-ai/scoop-neurosquad
scoop install neurosquad
```

**PowerShell**——下载最新版本，安装到 `%LOCALAPPDATA%\Programs\NeuroSquad` 并启动 NeuroSquad
（Windows PowerShell 5.1 或 PowerShell 7）：

```powershell
irm https://neurosquad.ai/install.ps1 | iex
```

## 登录

首次启动时，NeuroSquad 会请你登录 NeuroSquad 账号——账号是免费的。浏览器会打开 app.neurosquad.ai：用发送到邮箱的验证码或 Google
登录，点击 **Connect**，应用就会接上。在此之前，应用只显示登录界面。详细步骤，以及登录期间应用发送哪些内容，见[账号与登录](https://docs.neurosquad.ai/zh/getting-started/account)。

## 设置向导

登录后，NeuroSquad 会检查你的电脑上已经有什么，并提议安装缺少的部分。在你点击按钮之前什么都不会改变，
而且每一步都可以跳过——唯一的例外是 Node.js（见下文）。

**1. 智能体 CLI**

你的卡片将要运行的 AI 智能体。如果你已经装好了，向导会告诉你。如果还没有，选择
Claude Code、Codex CLI、OpenCode 或 Kilo Code，然后点击 **Install it for me**——向导会用 npm 安装，
并准确显示运行的是哪条命令。还没有 npm？智能体 CLI 离不开它，所以向导会自动安装 Node.js LTS：
来自 nodejs.org 的官方压缩包，并校验其公布的 SHA-256，仅为你的账户安装，无需管理员权限。
在 Windows 上，如果缺少 Node.js，安装程序在安装时就已完成这一步；已有的 Node.js 永远不会被改动。

**2. 终端与 Git**

Git for Windows 自带 Git Bash，终端卡片和隔离工作树都要用到它。向导会用 `winget`
安装它——并且总是先征求你的同意。

**3. 语音输入**

语音输入所用的语音模型不包含在安装程序中，需要单独下载。选择一个模型并点击 **Download**，
或者直接跳过这一步：语音输入是可选功能，其他功能都不依赖它。之后也可以在 **Settings → Dictation**
中下载；在此之前，状态栏会显示 **Dictation: download the model**。参见[语音模型](https://docs.neurosquad.ai/zh/dictation/models)。

**4. 就绪**

点击 **Start working**。你随时可以在 **Settings → Setup** 中重新打开这些步骤。

> 你仍需按常规方式登录每个智能体——在它的卡片里运行一次，按照它自己的登录提示操作即可。NeuroSquad 从不索要你的密钥。

## 更新

NeuroSquad 会自动更新。如需手动更新，再次运行[下载页面](https://neurosquad.ai/zh/download/)上的
`NeuroSquad-Installer.exe` 即可——它总是获取最新版本。安装程序会自动识别已安装的版本：安装位置指向现有的安装文件夹，按钮变为 **更新**，并有一条提示说明工作区、
智能体和设置都会保留——它们存放在 `%APPDATA%\NeuroSquad`，而不在应用自己的文件夹里。

如果 NeuroSquad 仍在运行，安装程序会显示 **NeuroSquad 仍在运行**，并按名称和 PID 列出占用其文件的每个进程——
应用本身以及它的卡片终端。你可以自己关闭 NeuroSquad 后点击 **重新检查**，或者点击 **结束并继续**
（NeuroSquad 卡片中打开的终端将会停止）。

新版本会先解压到旧版本旁边，完整解压后才替换旧版本。如果更新失败或被取消，原来的版本不会受到任何影响。

## 卸载

打开 **Windows 设置 → 应用**，找到 **NeuroSquad** 并选择 **卸载**（或运行安装文件夹中的
`Uninstall NeuroSquad.exe`）。卸载只会删除安装程序装上的文件、快捷方式和应用列表中的条目。
你自己放进安装文件夹的文件会保留。

你的数据也会保留——除非打开 **同时删除我的 NeuroSquad 数据**（默认关闭）。这会删除
`%APPDATA%\NeuroSquad`：工作区列表、智能体、设置、听写模型以及智能体的隔离工作树——其中未提交的工作将会丢失。
你的项目文件夹永远不会被改动。参见[你的数据存放在哪里](https://docs.neurosquad.ai/zh/help/data)。

## 无人值守安装

供 IT 管理员和脚本使用，安装程序可以不显示窗口运行。最新版本的完整安装程序位于
`https://neurosquad.ai/downloads/NeuroSquad-Setup.exe`；在线安装程序会把同样的参数传给它。

```text
NeuroSquad-Setup.exe --silent [--dir <文件夹>] [--no-desktop] [--launch] [--close-app]
```

- `--dir`——安装位置（默认为 `%LOCALAPPDATA%\Programs\NeuroSquad`，或现有安装所在的文件夹）
- `--no-desktop`——不创建桌面快捷方式
- `--launch`——安装完成后启动 NeuroSquad
- `--close-app`——结束正在运行的 NeuroSquad 进程，而不是直接失败

退出代码：`0` 已安装，`1` 失败，`2` 文件被占用（NeuroSquad 正在运行且未传入 `--close-app`）。
无人值守卸载：

```text
"Uninstall NeuroSquad.exe" --silent [--delete-data]
```

## 如果出了问题

失败页面会用通俗的话说明发生了什么，并显示详细信息和日志，还提供 **重试** 按钮。如果安装在替换文件之前就失败了，
原来的版本仍可正常使用。

安装程序会把每次运行的完整日志保存在 `%TEMP%\NeuroSquad-Setup-<日期>.log`，并在安装文件夹中另存一份
`install.log`。日志面板中有 **复制日志** 和 **打开日志文件** 按钮——报告问题时请附上日志。

## 下一步

  - **[你的第一个工作区](https://docs.neurosquad.ai/zh/getting-started/first-workspace)**: 把 NeuroSquad 指向一个项目文件夹——或者先逛逛演示工作区。
