---
title: 更新 HeartBeatAgents
summary: 在桌面应用和自托管实例上，更新是如何被检查、下载和应用的，以及失败时会发生什么。
date: 2026-09-10
---

# 更新 HeartBeatAgents

在桌面应用和自托管实例上，更新是如何被检查、下载和应用的，以及失败时会发生什么。

## 桌面应用

桌面应用会自动检查更新；你也可以从**设置 → 系统 → 检查更新**自行触发一次检查。发现新版本后，它会在后台下载，同时你可以继续工作。准备就绪后，你会看到一个横幅；点击**立即重启**以应用它，或者继续工作、在方便的时候再重启——更新已经下载并验证完毕，随时待命。

如果下载的更新无法通过验证，它不会被安装。你当前的安装不会有任何变化。

## 自托管实例

自托管实例会显示相同的**设置 → 系统**更新卡片，但带有一个明确的**立即更新**操作，而不是后台下载。确认后会重启所有服务；实例会短暂不可用，通常只有几分钟，期间进行更新。如果中途出现任何失败，它会自动回滚到你之前运行的版本，服务在那个之前的版本上重新恢复健康，而不是停留在一个损坏的中间状态。

## 候选版本

你可以从同一个设置卡片将实例加入候选版本计划，以提前获取预发布版本进行早期测试。候选版本可能包含影响你的安装或数据的错误；仅在你专门用于测试即将到来的更改的实例上开启此功能，而不是任何你所依赖运行的实例。

## 相关内容

- [安装](/zh/docs/getting-started/installation)：首先下载并验证一个版本
- [自托管](/zh/docs/guides/self-hosting)：更新时机完全由你自己掌控的部署方式
