跳轉到主要內容

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 需要幾項指令列工具才能執行專案、安裝相依套件，以及與工作區溝通：
工具最低版本狀態用途
BRICKS CLI2.24.0必要與 BRICKS 工作區互動的 Agent 工作流程
Bun1.3.0必要用於安裝相依套件與執行指令碼的 JavaScript 執行環境
Git—建議專案歷史的版本控制
您也需要一個 BRICKS 工作區帳號才能登入。

​
安裝需求畫面

第一次啟動 CTOR 時，或是 BRICKS CLI 或 Bun 缺少或版本過舊時，CTOR 會在登入畫面之前顯示安裝需求畫面。每項工具都有一張卡片，列出偵測到的版本、所需的最低版本，以及對應的操作按鈕：
  • 安裝 — 在背景執行官方的 curl 安裝指令碼，並將輸出串流至可展開的記錄區。BRICKS CLI 安裝於 ~/.bricks-cli/bin，Bun 安裝於 ~/.bun/bin。安裝程式結束後 CTOR 會自動重新檢查。
  • 更新 — 當工具已安裝但版本低於最低需求時顯示。會重新執行安裝指令碼以取得最新版本。
  • 跳過 — 僅 Git 可使用，因為 Git 為選填。點選跳過即可關閉 Git 卡片而不安裝。
  • 檢視文件 — 在尚未支援自動安裝的 Windows 上顯示，會開啟上游的安裝程式頁面。
手動安裝後請點選重新檢查重新偵測，待所有必要工具都符合需求後再按繼續。
偵測會優先探查 ~/.bricks-cli/bin、~/.bun/bin 與 npm 全域目錄，再回退到 which，因此即使 shell 的 PATH 尚未重新載入，剛安裝的執行檔也能立即被識別。

​
手動安裝

如果您偏好從終端機進行設定，相同的安裝程式都提供一行指令的版本： 
# 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 下載 Git。

​
下載

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

下載 macOS 版本（ARM64）

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

​
Beta 頻道

可在穩定版之外另行安裝 Beta 頻道。Beta 應用程式名為 CTOR Beta，Linux 執行檔為 bricks-ctor-beta，因此兩個頻道可同時並存。
下載最新的 macOS Beta 版本（Apple Silicon）：

下載 CTOR Beta for macOS（ARM64）

CTOR-Beta-arm64.dmg
開啟 DMG 並將 CTOR Beta 拖曳至「應用程式」資料夾。

​
自動更新

CTOR 會自動檢查更新。當有新版本可用時：
  1. 開啟設定（齒輪圖示）
  2. 捲動至更新區段
  3. 點擊下載並安裝以就地更新
應用程式會在設定面板中顯示目前版本及最新可用版本。

​
後續步驟

登入您的工作區

驗證您的 BRICKS 工作區以開始建置。