> ## 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.

# 專案設定

> 建立並管理 BRICKS 專案

專案是您機器上包含 `application.json` 檔案的目錄。[BRICKS](https://bricks.tools) CTOR 在單一視窗中執行，並在側邊欄中顯示所有已開啟的專案。

## 開啟專案

1. 點擊側邊欄中的**開啟專案**按鈕
2. 選取包含 BRICKS 專案的目錄（或父目錄——應用程式最多掃描 3 層深度）
3. 探索到的專案會以節點形式顯示在側邊欄中

<Info>
  如果選取的目錄不包含任何 `application.json` 檔案，應用程式會顯示錯誤訊息。請關閉訊息並嘗試其他目錄。
</Info>

## 建立新專案

建立專案有兩種方式：

* **請主聊天代理協助（推薦）。** 在[開始聊天](/zh-Hant/ctor/guide/main-chat)中描述您想建置的內容，代理會替您執行 `bricks app ctor-init`。完成後，聊天底部會出現 **Created projects** 卡片——點選 **Start session** 即可開啟專案範圍的聊天，且新建的專案已經選取好。主聊天中的情境會透過 `CONTEXT.md` 交接，讓專案代理從您離開的地方接續。
* **使用「新增專案」對話框（手動）。** 點選側邊欄的**新增專案**，透過表單建立專案，不經過代理。

本節後續說明手動流程。

### 新增專案對話框

**新增專案**對話框有兩個分頁：**從現有應用程式**和**建立新應用程式**。

如果您有多個已驗證的[設定檔](/zh-Hant/ctor/guide/authentication#multi-profile-support)，對話框頂部會顯示**設定檔**下拉選單，讓您可以在任何工作區下瀏覽和建立應用程式。

### 從現有應用程式

使用**從現有應用程式**分頁，從已存在於 [BRICKS Controller](/zh-Hant/controller) 上的應用程式建立本機專案。

<Steps>
  <Step title="開啟新增專案對話框">
    點擊側邊欄中的**新增專案**。
  </Step>

  <Step title="選取應用程式">
    對話框會列出所選設定檔工作區中的應用程式。使用搜尋欄位按名稱或描述篩選。
  </Step>

  <Step title="選擇目錄">
    選取應用程式，點擊**建立專案**，並在您的機器上選擇一個目錄。應用程式會在該目錄中初始化專案。
  </Step>
</Steps>

### 建立新應用程式

使用**建立新應用程式**分頁，一步在伺服器上建立新應用程式並初始化本機專案。

<Steps>
  <Step title="開啟新增專案對話框">
    點擊側邊欄中的**新增專案**，然後選取**建立新應用程式**分頁。
  </Step>

  <Step title="輸入應用程式詳細資訊">
    * **應用程式名稱**（必填）——新應用程式的名稱
    * **描述**（選填）——應用程式功能的簡短說明
  </Step>

  <Step title="建立應用程式和專案">
    點擊**建立應用程式與專案**，然後選擇一個目錄。這會在 BRICKS 伺服器上建立應用程式並初始化本機專案。新工作階段會自動開啟。
  </Step>
</Steps>

## 管理專案

每個已開啟的專案在側邊欄中都會顯示為可展開的節點。點擊專案即可展開並檢視其工作階段。工作階段以專案為範圍——選取專案只會顯示該專案的聊天工作階段。

### 移除專案

從側邊欄移除專案：

1. 將滑鼠暫留在專案上，點擊 **X** 按鈕
2. 點擊顯示的確認按鈕（或等待 3 秒讓其重置）

移除專案只會將其從側邊欄中移除。磁碟上的專案檔案不會被刪除。

### 最近的專案

先前開啟的專案會顯示在最近專案清單中，以便快速存取。重新啟動應用程式時，也會還原所有已開啟的專案。

## 專案內容檔案

在您的專案根目錄放置 `CLAUDE.md` 或 `AGENTS.md` 檔案，可為 AI 代理提供自訂指示。這些檔案會自動包含在該專案每個工作階段的代理系統提示中。

這有助於：

* 定義特定於專案的程式碼慣例
* 描述您的專案架構
* 新增代理應遵循的自訂規則

應用程式也會從專案根目錄讀取 `application.json`，以便在代理的上下文中包含應用程式中繼資料。

## 後續步驟

<CardGroup cols={2}>
  <Card title="開始使用 AI 代理" icon="robot" href="/zh-Hant/ctor/guide/agent-usage">
    與 AI 代理聊天以建置您的應用程式。
  </Card>

  <Card title="bricks-ctor SDK" icon="cube" href="/zh-Hant/ctor-pkg">
    了解驅動 bricks-ctor 應用程式的 TypeScript SDK。
  </Card>
</CardGroup>