升级与备份
替换程序时保留原来的数据目录。可用下载见获取 Astral；下面的流程适用于包含更新器和迁移工具的构建。旧的不带更新器版本需要先手动安装一次，之后才能在 App 内更新。
更新 Desktop
跳转到“更新 Desktop”打开 设置 → 关于与诊断。受支持的 Desktop 安装会在启动后及运行期间定期检查新版本，并在后台下载。也可以点击检查更新；下载完成后，点击重启并更新。
| 安装方式 | 更新方法 |
|---|---|
| 官方签名的 macOS App | 在 App 内下载，再重启并更新 |
| 当前用户的 Windows EXE 安装版 | 在 App 内下载，再重启并更新 |
| Linux AppImage | 在 App 内下载，再重启并更新 |
| Linux DEB、Windows ZIP、未签名 Mac 或开发构建 | 手动下载安装新版 |
后台下载不会停止任务。安装时会先停止本地 Server，中断正在运行的任务和电脑命令；普通退出不会安装已下载的更新。本机电脑服务随 Desktop 更新，远程电脑需要单独执行更新操作。
如果 Mac 发行说明标注 Apple 公证仍在等待，表示 Developer ID 签名已验证，但首次打开仍可能被 Gatekeeper 拦截。尝试打开可信的官方下载后，可按照 Apple 的说明，在 系统设置 → 隐私与安全性 → 仍要打开 中允许本次打开。这与 Astral 的 App 内更新功能是两回事。
更新无界面 Server
跳转到“更新无界面 Server”如果 Linux Server 由官方当前用户安装脚本管理，再执行一次安装命令，也可以指定已发布的版本 Tag。保留原有安装根目录和网络配置；脚本会验证下载、停止用户服务，再让新程序使用原数据启动。
自行管理的 Server 则先停止进程，替换程序，再用原来的 --data 目录和启动参数重新启动。独立 Server 的本机电脑服务随 Server 更新，不要因为更换可执行文件而意外使用空数据目录。
跳过版本与数据转换
跳转到“跳过版本与数据转换”只需要下载最新版应用。最新版包含所有受支持的历史数据迁移，并按顺序执行缺失步骤，不需要下载或安装中间版本的应用。
需要转换数据时，启动流程会先取得独占运行权并备份完整 Server 目录，在迁移和准备数据库期间保留恢复信息，随后在接受网页、API 或聊天工作之前确认升级。迁移或准备阶段失败会恢复该次备份，确认前中断则在下次启动时先恢复。确认后可能已经接受新工作，后续故障不会自动恢复旧数据。Linux 安装脚本若在本次激活检查中失败，会另行恢复本次升级的快照；Desktop 不会在每次启动失败时自动回退 App。自动快照位于 Server 数据目录同级的 upgrade-backups/。
首次公开发行支持的数据基线为 Host 3 / Core 11。使用该格式的公开版本共用 schema-3-core-11/ 目录，从 0.1.0 升级会保留已有设置、历史和电脑身份。更早的私有 Core 10 等数据不导入；旧的 schema-3/ 等目录完整保留，不会转换或删除。显式指定更早的私有开发格式或未知的新格式时，启动会被拒绝。安装旧程序不等于数据降级：恢复旧数据需要匹配的备份和程序版本。请继续维护独立备份，包括电脑上的工作文件，不要只依赖升级快照。
更新远程电脑或容器
跳转到“更新远程电脑或容器”打开 设置 → 电脑 → 电脑详情 → Daemon 维护。对于已在线、支持管理更新的电脑，点击更新 Daemon，并确认正在运行的任务会停止。Astral 会下载并校验官方版本、替换程序，再检查同一台电脑重新连接。如果 Daemon 比 Server 更新，Astral 会提醒更新 Desktop 或 Server，但不阻止继续检查 Daemon 更新。即使两端当前版本相同，该操作仍会检查最新发行版；目标版本相同或更旧时不重复安装。
也可以复制页面显示的更新命令；旧 Daemon 尚不支持管理更新，或该操作不可用时，使用这种方式：
- 裸机：在目标电脑执行 Shell 或 PowerShell 命令，更新当前用户的后台服务。
- 容器：在 Docker 宿主机执行命令。它会替换 Daemon 并重启同一个容器，保留身份、已安装工具、可写层与数据。
新容器的管理更新由容器内监督进程接管，替换程序并重启 Daemon，不重新创建环境。更新 Daemon 不改变基础镜像；更新失败会尝试恢复原程序。恢复任务前，先确认页面结果和电脑连接状态。
预构建 Ubuntu 环境独立于应用发版。新建容器拉取当前 Astral 版本指定的镜像摘要，再单独放入 Daemon。应用更新不会在用户电脑上重建镜像，也不会重建已有容器；原镜像、可写层、已安装工具、数据卷和配对挂载保留。程序需要更新时，使用独立的 Daemon 更新操作。环境准备和持久化说明见使用容器。
备份哪些内容
跳转到“备份哪些内容”| 对象 | 需要保留的内容 |
|---|---|
| Server | 完整数据目录，包括数据库、master.key、computer-identity/ 和配置 |
| 本机及远程电脑 | 电脑服务数据、Bot 工作目录和实际项目文件 |
| 容器 | 数据卷，以及需要保留的容器可写层或重建方法 |
只复制数据库不够：加密密钥用于读取已保存的凭据，电脑连接身份用于保留现有电脑对 Server 的信任。Server 迁移备份不会从连接的电脑复制工作文件，也不能撤销已经发生的外部操作。
最直接的一致备份方法是停止 Desktop 或 Server，再复制完整 Server 数据目录。运行中备份需要采用一致的 SQLite 备份方式，不能随手复制一个正在写入的数据库文件。
找到数据目录
跳转到“找到数据目录”优先查看启动日志、电脑详情与实际启动参数。独立运行时默认使用以下 Astral 根目录：
- macOS：
~/Library/Application Support/astral - Windows：
%APPDATA%\astral - Linux：
$XDG_CONFIG_HOME/astral，通常为~/.config/astral
Server 数据通常在根目录的 server/，本机电脑数据在 computers/。Desktop 使用操作系统应用数据目录中的 astral/schema-3-core-11/：macOS 和 Windows 对应上面的 Astral 位置，Linux 通常为 ~/.config/astral/schema-3-core-11/。Linux VPS 安装脚本则使用安装根目录下的 data/。自定义路径和环境变量优先。
恢复后检查
跳转到“恢复后检查”恢复前先停止 Desktop 或 Server。使用与备份数据匹配的程序启动，确认历史、已保存的模型连接、电脑在线状态和聊天账号，再恢复任务。不要让两个 Server 进程同时写同一个数据目录。