> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 客户端更新

> 桌面客户端如何检查、下载和安装新版本：更新入口、各状态与失败处理、重启规则，以及自动检查与自动下载开关。

**客户端更新**只针对桌面客户端。默认情况下，客户端会自动检查新版本并在后台下载，下载完成后提示你重启完成安装；你也可以随时手动检查，或关闭自动下载、自动检查。网页版没有这套更新入口，刷新页面即是最新版本。

## 适用范围

| 形态 | 支持情况 | 说明 |
| - | - | - |
| 桌面客户端 | 支持 | 本页全部内容 |
| 网页版 / 手机网页 | 不适用 | 刷新页面即是最新版本 |

## 入口

以下入口显示同一个更新状态，在任一处操作，其他几处同步变化：

* **账户菜单**：「外观」下方的更新行，默认显示「检查更新」和当前版本号。
* **图标栏更新按钮**：图标栏底部、头像上方，只在有新版本、下载中、下载失败或待重启时出现。
* **设置 › 通用 › 更新**：两个开关和版本状态。
* **命令菜单**：搜索「检查更新」。

## 手动检查更新

1. 在账户菜单点「检查更新」（或在「设置 › 通用 › 更新」里点「检查更新」）。
2. 检查结束后：
   * 已是最新：提示「已是最新版本 · v版本号」。
   * 发现新版本：开启了自动下载时直接在后台下载；否则入口变为「有新版本可用」，等你点击下载。
   * 检查失败：提示「无法检查更新，请检查网络后重试」，入口变为「重试检查更新」。

## 下载与安装

1. 入口显示「有新版本可用」时点击它（设置里是「下载并安装」）开始下载。各入口显示下载进度。
2. 下载完成后提示「v版本号 已下载，重启以完成更新」，各入口变为「重启以完成更新」。不会自动重启。
3. 点「重启以完成更新」，弹出确认框：
   * 这台电脑上没有本机任务在运行：可选「稍后」或「立即重启」。
   * 这台电脑上还有本机任务在运行：可选「稍后」或「任务结束后重启」。
4. 重启后提示「已更新到 版本号」。

云端任务不受重启影响，重启后接着显示。

### 等本机任务结束后重启

选「任务结束后重启」后：

* 设置里显示正在等待哪些任务（如「等待「任务标题」结束后自动重启」），这些任务都结束后客户端自动重启完成更新。
* 等待期间可以点「取消重启」，更新仍保持已下载，之后可以再次点「重启以完成更新」。

## 规则与状态

| 状态 | 你会看到 | 你可以 |
| - | - | - |
| 有新版本可用 | 「有新版本可用」+ 新版本号，图标栏按钮带提醒点 | 点击下载并安装 |
| 必须更新 | 设置里提示「当前 v旧版本 版本过低，需要更新到 v新版本 才能继续使用」 | 尽快下载并安装 |
| 下载中 | 进度百分比，不可点 | 等待 |
| 下载失败 | 「下载失败，点按重试」 | 检查网络后点击重试 |
| 更新安装准备失败 | 「更新安装准备失败」·「可以重试，或下载安装包手动安装」 | 点「重试」重新下载，或点「手动下载」下载安装包后自行安装 |
| 待重启 | 「重启以完成更新」 | 重启或稍后 |
| 等本机任务结束 | 「任务结束后重启」 | 等待自动重启，或「取消重启」 |
| 重启失败 | 「重启失败，请重试或手动退出后重新打开」 | 再次重启，或手动退出后重新打开 |

* **必须更新**：当前版本低于要求的最低版本时出现，界面仍可继续使用，请尽快更新。
* **更新安装准备失败**：macOS 上新版本下载完成后，安装包长时间没准备好或准备出错时出现，不会一直停在 100%。开启自动下载时，客户端会在后台自动重试。

## 自动检查与自动下载

「设置 › 通用 › 更新」有两个开关：

| 开关 | 默认 | 说明 |
| - | - | - |
| 自动检查更新 | 开 | 定期检查新版本 |
| 自动下载更新 | 开 | 发现新版本后在后台下载，下载完成后提示重启 |

| 组合 | 发现新版本后 |
| - | - |
| 两个都开（默认） | 后台直接下载，完成后提示重启 |
| 只开自动检查 | 入口变为「有新版本可用」，由你点击下载 |
| 关闭自动检查 | 「自动下载更新」随之置灰；不会主动发现新版本，需要手动检查并点击下载 |

重新打开自动检查后，自动下载恢复为你原先的选择。下载失败后客户端会在后台自动重试；手动点「检查更新」或「下载失败，点按重试」随时可以重试。

## 注意与限制

* 更新只影响桌面客户端本身，不影响云主机和云端任务。

## 常见问题

### 为什么点「重启以完成更新」只能选「任务结束后重启」？

这台电脑上还有本机任务在运行。为了不打断它们，客户端会等任务结束后再自动重启；也可以点「取消重启」，稍后再重启。云端任务不受影响。

### 下载完成后一直卡在 100% 怎么办？

稍等片刻，安装包仍未就绪时会显示「更新安装准备失败」。点「重试」重新下载，或点「手动下载」下载安装包后自行安装。

### 下载失败怎么办？

检查网络后点「下载失败，点按重试」。

### 网页版怎么更新？

网页版不需要手动更新，刷新页面即是最新版本。

## 相关

* [通用与外观](https://docs.aihubmix.com/cn/cloud/settings/general.md)
* [账户菜单与浮层](https://docs.aihubmix.com/cn/cloud/interface/command-and-menus.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.