# 安裝 Desktop
URL: /zh-TW/docs/install/desktop

下載適用於 macOS、Windows 或 Linux 的 Spirit Agent。



Desktop 是圖形化主機：聊天、工作區檔案、Git、設定、市集和自動化。它與 [CLI](./cli.mdx) 共用本機 daemon。

## 下載 [#下載]

使用[下載頁面](/en-US/download)。它會根據您的作業系統和架構，從 `download.spirit.fast` 挑選合適的建置版本。

| 平台      | 檔案            | 架構               |
| ------- | ------------- | ---------------- |
| macOS   | `.dmg`        | x64, arm64       |
| Windows | `.exe` (NSIS) | x64, arm64, ia32 |
| Linux   | `.AppImage`   | x64, arm64       |

您也可以從 [latest](https://github.com/SpiritAgents/SpiritAgent/releases/latest) 取得 GitHub Release。Linux 版本除了 AppImage 之外，可能還包含 `.deb`。

Desktop 沒有官方的 Homebrew、winget 或 apt 套件。

## 安裝後 [#安裝後]

1. 開啟 Spirit Agent。
2. [開啟工作區](../quickstart.mdx#2-open-a-workspace)。
3. 在 **設定 → 模型** 中連接提供者。金鑰會儲存到系統鑰匙圈。

在 macOS 上，如果 Gatekeeper 阻止首次啟動，請在 Finder 中以 Control-click → 開啟 來開啟應用程式。

在 Linux 上，執行前請先將 AppImage 標記為可執行（`chmod +x SpiritAgent-linux-*.AppImage`）。

## 更新 [#更新]

下載頁面和 CDN 的 `latest` 路徑始終指向目前的 Desktop 建置版本。GitHub Releases 會保留有版本的資產，方便您需要釘選版本時使用。