專案設定

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.

專案是您機器上包含 application.json 檔案的目錄。BRICKS CTOR 在單一視窗中執行，並在側邊欄中顯示所有已開啟的專案。

​

開啟專案

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

​

建立新專案

建立專案有兩種方式：

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

本節後續說明手動流程。

​

新增專案對話框

新增專案對話框有兩個分頁：從現有應用程式和建立新應用程式。 如果您有多個已驗證的設定檔，對話框頂部會顯示設定檔下拉選單，讓您可以在任何工作區下瀏覽和建立應用程式。

​

從現有應用程式

使用從現有應用程式分頁，從已存在於 BRICKS Controller 上的應用程式建立本機專案。

​

建立新應用程式

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

​

管理專案

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

​

移除專案

從側邊欄移除專案：

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

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

​

最近的專案

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

​

專案內容檔案

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

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

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

​

後續步驟