安装与更新

选择安装方式

环境	安装入口	数据位置
macOS	下载页的 DMG	本机 Nexus 数据目录
Windows	下载页的安装程序	本机 Nexus 数据目录
Linux 或团队服务器	Docker Compose 部署	挂载的服务端数据目录

安装包、支持的架构和版本说明以官方 Releases为准。下载时选择与操作系统和处理器架构匹配的版本。

安装桌面版

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

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

首次启动

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

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

更新版本

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

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

卸载与数据

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

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