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

# 安裝

> 下載並安裝 CTOR

## 安裝需求

CTOR 需要幾項指令列工具才能執行專案、安裝相依套件，以及與工作區溝通：

| 工具                         | 最低版本   | 狀態 | 用途                              |
| -------------------------- | ------ | -- | ------------------------------- |
| [BRICKS CLI](/zh-Hant/cli) | 2.24.0 | 必要 | 與 BRICKS 工作區互動的 Agent 工作流程      |
| [Bun](https://bun.sh)      | 1.3.0  | 必要 | 用於安裝相依套件與執行指令碼的 JavaScript 執行環境 |
| [Git](https://git-scm.com) | —      | 建議 | 專案歷史的版本控制                       |

您也需要一個 [BRICKS](https://bricks.tools) 工作區帳號才能登入。

### 安裝需求畫面

第一次啟動 CTOR 時，或是 BRICKS CLI 或 Bun 缺少或版本過舊時，CTOR 會在登入畫面之前顯示**安裝需求**畫面。每項工具都有一張卡片，列出偵測到的版本、所需的最低版本，以及對應的操作按鈕：

* **安裝** — 在背景執行官方的 curl 安裝指令碼，並將輸出串流至可展開的記錄區。BRICKS CLI 安裝於 `~/.bricks-cli/bin`，Bun 安裝於 `~/.bun/bin`。安裝程式結束後 CTOR 會自動重新檢查。
* **更新** — 當工具已安裝但版本低於最低需求時顯示。會重新執行安裝指令碼以取得最新版本。
* **跳過** — 僅 Git 可使用，因為 Git 為選填。點選**跳過**即可關閉 Git 卡片而不安裝。
* **檢視文件** — 在尚未支援自動安裝的 Windows 上顯示，會開啟上游的安裝程式頁面。

手動安裝後請點選**重新檢查**重新偵測，待所有必要工具都符合需求後再按**繼續**。

<Info>
  偵測會優先探查 `~/.bricks-cli/bin`、`~/.bun/bin` 與 npm 全域目錄，再回退到 `which`，因此即使 shell 的 PATH 尚未重新載入，剛安裝的執行檔也能立即被識別。
</Info>

### 手動安裝

如果您偏好從終端機進行設定，相同的安裝程式都提供一行指令的版本：

```bash theme={null}
# BRICKS CLI → ~/.bricks-cli/bin/bricks
curl -fsSL https://cdn.bricks.tools/bricks-cli/release/install.sh | sh

# Bun → ~/.bun/bin/bun
curl -fsSL https://bun.sh/install | bash
```

macOS 請執行 `xcode-select --install`，透過 Command Line Tools 安裝 Git。Linux 請使用系統套件管理員（例如 `apt install git`）。Windows 請至 [git-scm.com](https://git-scm.com/downloads) 下載 Git。

## 下載

<Tabs>
  <Tab title="macOS">
    **Homebrew：**

    ```bash theme={null}
    brew install --cask mybigday/bricks/bricks-ctor
    ```

    **手動下載：**

    下載最新的 macOS 版本（Apple Silicon）：

    <Card title="下載 macOS 版本（ARM64）" icon="apple" href="https://cdn.bricks.tools/bricks-project-desktop/release/CTOR-arm64.dmg">
      CTOR-arm64.dmg
    </Card>

    開啟 DMG 並將應用程式拖曳到「應用程式」資料夾。此應用程式已通過 Apple 公證。首次啟動時，macOS 可能會顯示安全性提示，請點擊**開啟**繼續。
  </Tab>

  <Tab title="Linux">
    **快速安裝：**

    ```bash theme={null}
    curl -fsSL https://cdn.bricks.tools/bricks-project-desktop/release/install.sh | sh
    ```

    此指令碼會自動偵測您的架構，將 AppImage 下載至 `~/.local/bin/bricks-ctor`，在缺少 `libfuse2` 執行階段相依套件時透過系統套件管理員安裝，並可選擇性地建立桌面捷徑。

    如需解除安裝：

    ```bash theme={null}
    curl -fsSL https://cdn.bricks.tools/bricks-project-desktop/release/uninstall.sh | sh
    ```

    **手動下載：**

    <CardGroup cols={2}>
      <Card title="Linux (x86_64)" icon="linux" href="https://cdn.bricks.tools/bricks-project-desktop/release/CTOR-x86_64.AppImage">
        CTOR-x86\_64.AppImage
      </Card>

      <Card title="Linux (ARM64)" icon="linux" href="https://cdn.bricks.tools/bricks-project-desktop/release/CTOR-arm64.AppImage">
        CTOR-arm64.AppImage
      </Card>
    </CardGroup>

    ```bash theme={null}
    chmod +x CTOR-x86_64.AppImage
    ./CTOR-x86_64.AppImage
    ```

    <Note>
      AppImage 執行時需要 `libfuse2`（FUSE 2）。許多較新的發行版預設並未隨附，快速安裝指令碼會自動安裝；若採手動下載，請自行安裝：

      | 發行版                      | 指令                             |
      | ------------------------ | ------------------------------ |
      | Debian / Ubuntu（≤ 22.04） | `sudo apt install libfuse2`    |
      | Ubuntu 24.04+            | `sudo apt install libfuse2t64` |
      | Fedora / RHEL            | `sudo dnf install fuse-libs`   |
      | Arch                     | `sudo pacman -S fuse2`         |
      | openSUSE                 | `sudo zypper install libfuse2` |
      | Alpine                   | `sudo apk add fuse`            |
    </Note>
  </Tab>
</Tabs>

## Beta 頻道

可在穩定版之外另行安裝 Beta 頻道。Beta 應用程式名為 **CTOR Beta**，Linux 執行檔為 `bricks-ctor-beta`，因此兩個頻道可同時並存。

<Tabs>
  <Tab title="macOS">
    **Homebrew：**

    ```bash theme={null}
    brew install --cask mybigday/bricks/bricks-ctor-beta
    ```

    **手動下載：**

    <Card title="下載 CTOR Beta for macOS（ARM64）" icon="apple" href="https://cdn.bricks.tools/bricks-project-desktop/beta/CTOR-Beta-arm64.dmg">
      CTOR-Beta-arm64.dmg
    </Card>

    開啟 DMG 並將 **CTOR Beta** 拖曳至「應用程式」資料夾。
  </Tab>

  <Tab title="Linux">
    ```bash theme={null}
    curl -fsSL https://cdn.bricks.tools/bricks-project-desktop/beta/install.sh | sh -s -- --beta
    ```

    指令碼會將 AppImage 安裝至 `~/.local/bin/bricks-ctor-beta`。以下列指令執行：

    ```bash theme={null}
    bricks-ctor-beta
    ```

    如需解除安裝：

    ```bash theme={null}
    curl -fsSL https://cdn.bricks.tools/bricks-project-desktop/beta/uninstall.sh | sh -s -- --beta
    ```
  </Tab>
</Tabs>

## 自動更新

CTOR 會自動檢查更新。當有新版本可用時：

1. 開啟**設定**（齒輪圖示）
2. 捲動至**更新**區段
3. 點擊**下載並安裝**以就地更新

應用程式會在設定面板中顯示目前版本及最新可用版本。

## 後續步驟

<Card title="登入您的工作區" icon="right-to-bracket" href="/zh-Hant/ctor/guide/authentication">
  驗證您的 BRICKS 工作區以開始建置。
</Card>