# 安装与更新

选择桌面版或服务端，校验安装包并安全升级。

## 选择安装方式

| 环境 | 安装入口 | 数据位置 |
| --- | --- | --- |
| macOS | [下载页](/download)的 DMG | 本机 Nexus 数据目录 |
| Windows | [下载页](/download)的安装程序 | 本机 Nexus 数据目录 |
| Linux 或团队服务器 | [Docker Compose 部署](/docs/deployment) | 挂载的服务端数据目录 |

安装包、支持的架构和版本说明以[官方 Releases](https://github.com/nexus-research-lab/nexus/releases)为准。下载时选择与操作系统和处理器架构匹配的版本。

## 安装桌面版

1. 下载与你系统匹配的安装包和对应 `.sha256` 文件。
2. 核对校验值。macOS 可运行 `shasum -a 256 文件名.dmg`；Windows PowerShell 可运行 `Get-FileHash 文件名.exe -Algorithm SHA256`。
3. macOS 打开 DMG 后安装应用；Windows 运行安装程序并完成向导。
4. 打开 Nexus，进入[模型服务配置](/docs/providers)，完成一次连接测试。

系统拦截安装时，先确认下载源、校验结果和发布说明中的签名要求。根据系统提示处理具体问题，并保留系统安全保护。

## 首次启动

官方桌面包默认携带 NXS 引擎。Nexus 会启动本地服务并打开工作台，因此首次启动需要等待服务就绪。桌面本地模式不使用服务端登录密码。

若界面持续空白，先完整退出并重新打开应用。保留发生时间、系统版本、安装包版本和错误信息，再按[故障排查](/docs/troubleshooting)检查本地服务与桌面宿主。

## 更新版本

更新前结束正在写入文件的任务，按[备份指南](/docs/backup)保留完整数据。安装新版本时使用官方包，并查看跨版本说明。更新后先检查 Agent、历史会话和文件，再运行一次小任务验证模型与工具。

数据迁移可能随新版本发生。旧程序未必能读取新版本已迁移的数据；需要回退时，应一起恢复升级前的程序版本和数据备份。

## 卸载与数据

应用程序与工作数据分别保存。卸载后是否保留工作数据，应检查数据目录和卸载选项。需要迁移到另一台机器时，先完整备份状态根；仅复制应用程序不会带走历史会话和 Agent 文件。

桌面版当前使用的数据目录可在 **设置 → 数据目录** 查看。详细位置和迁移方式见[备份、恢复与迁移](/docs/backup)。