第一次啟動 BRICKS CTOR 時，您會落腳於主聊天——這是一個專案無關的代理，能協助您建立新的 BRICKS 應用程式、列出本機裝置、瀏覽 Activity Log，或回想過往專案工作階段中的內容，全程都不需要先開啟專案。 建立或開啟專案後，您就可以切換到專案範圍的聊天進行程式碼層級的工作。在那之前，主聊天就是您的起點。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.
何時使用主聊天
當工作不繫於單一專案時，請使用主聊天：- 從零開始建立新應用程式，且尚未準備目錄
- 詢問網路上有哪些裝置，或它們最近記錄了什麼
- 跨過往對話搜尋幾週前所做的決策
- 執行臨時的
bricksCLI 檢查（bricks doctor、bricks device list等）
位置
側邊欄分為兩個可摺疊的區段：- Projects——您已註冊的 BRICKS 專案。點選 + 從磁碟註冊專案。
- Chat——主聊天的工作階段。點選 + 開始新的主聊天。
開始主聊天
- 開啟 CTOR。若沒有作用中的工作階段，會出現空白的 Main Chat 畫面與置中的輸入列。
- 輸入您的請求——例如*「幫我建立一個 hello-world 的 BRICKS 應用程式」*——並按 Ctrl+Enter。
- CTOR 會在第一次送出時建立主工作階段，聊天即開始。
主工作區
主代理在~/bricks-ctor 中執行，這是您可以用一般檔案管理員瀏覽的最上層目錄。代理寫入的內容——例如以 bricks app ctor-init 建立的專案——除非您另行指示，否則都會落在這裡。
此目錄是代理的工作根目錄，沙箱、檔案提及（@）以及技能範圍都以它為基準。代理註冊專案後（見下方），主代理在沙箱模式下也能讀取該專案目錄。
工作區層級工具
除了標準的檔案與 shell 工具外，主代理還有四個專案工作階段中沒有的工具：| 工具 | 用途 |
|---|---|
open_created_project | 註冊專案目錄（必須包含 application.json），使其顯示在側邊欄。可選擇寫入 CONTEXT.md 交接備忘。 |
list_projects | 列出目前在側邊欄中已註冊的專案。 |
list_project_sessions | 列出已儲存的聊天工作階段，可選擇依專案篩選。 |
read_project_session | 依 id 讀取已儲存的工作階段，並回傳精簡的對話記錄。 |
bricks CLI 處理 BRICKS 特定操作，例如 bricks app ctor-init（建立專案）、bricks device list 與 bricks device monitor（檢視裝置），以及 bricks activity-log（稽核紀錄）。完整指令集請參閱 BRICKS CLI 參考。
從 URL 複製分享的應用程式
將分享 URL 貼入主聊天，代理會將來源應用程式複製到您的工作區。系統可辨識兩種 URL 格式：https://control.bricks.tools/#/create-share-app?application_id=<id>——從 BRICKS Controller 版本頁複製的「從分享建立」連結。https://share.bricks.tools/app/<id>——公開分享頁面連結。
bricks app share-info 列出公開版本，詢問您要複製哪一個（並可選擇輸入名稱與說明），然後以 bricks app share-new 建立新的應用程式。新應用程式會建立於您目前作用中設定檔對應的工作區——若想建立到其他工作區，請先切換設定檔。
新應用程式建立完成後，代理會詢問是否要為它在本機建立專案——透過重新執行 share-new --init -y，或在主工作區中呼叫 bricks app ctor-init <new-app-id>，並接著註冊專案使其出現在側邊欄。
Created projects 橫幅
每當主代理透過open_created_project 在磁碟上註冊專案時，聊天底部會出現一張 Created projects 卡片。每張卡片會顯示專案名稱、應用程式 id 與 stage。點選 Start session 即可開啟該專案並啟動專案範圍的聊天——CTOR 會在一個步驟中開啟專案、在側邊欄中選取，並建立全新的工作階段。
交接情境
若主聊天負責建立此專案，代理可以將對話摘要寫成專案根目錄下的CONTEXT.md，並在專案的 AGENTS.md（或 CLAUDE.md）中加上 @CONTEXT.md 參照。第一個專案工作階段就會自動載入該情境，您不必重新解釋主聊天中的決策。
此標記具備幂等性——重複執行不會建立重複的連結。
技能、子代理與 MCP
主聊天相較於專案工作階段，介面較為精簡：- 技能與子代理仍可使用，但只會載入內建與全域層級——專案層級的技能與代理會刻意隱藏，因為主聊天不繫屬於任何單一專案。
- MCP 伺服器不會在主聊天中提供。
- 由於 Preview 是專案專屬功能，Preview 按鈕會被隱藏。
切換工作區設定檔
沙箱模式選擇器旁的標籤會顯示您目前作用中的設定檔。與專案聊天不同——專案聊天中此標籤為唯讀——當您有多個已驗證的設定檔時，主聊天會將其轉為下拉選單。點選即可挑選主代理要作用的工作區。 切換設定檔會更新 CTOR 傳遞給內建bricks CLI 與工具環境的 BRICKS_PROFILE 環境變數，因此下一輪對話的系統提示與指令輸出都會反映所選工作區。
後續步驟
專案設定
開啟或建立專案，深入專案範圍的工作。
使用 AI 代理
了解同時驅動專案與主聊天工作階段的聊天介面。