> ## 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/zh-Hant/cloud/settings/general.md)
* [帳戶選單與浮層](https://docs.aihubmix.com/zh-Hant/cloud/interface/command-and-menus.md)


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