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.
自動編譯
- 自動編譯 — 偵測到輸入實際變動時於背景執行(
write_file/edit_file工具 hook,加上 subspaces、automation-tests、application.json、compile.ts、app.ts、root.ts的監看),錯誤以橫幅呈現並提供 Ask 按鈕將失敗訊息交給代理。
同步
- 同步狀態 Pill 顯示於 Actions 選單旁,反映伺服器是否較新或本地是否較前;Actions 選單新增 Check for Updates,可手動觸發同步檢查並顯示結果。
- Update Config 對話框 — 推送前若伺服器較新則拒絕、等待內嵌的自動編譯完成、編譯錯誤會直接呈現而不會默默推送舊版本。
- 非強制 Pull — 對話框拆成 Pull 與 Force Pull;非強制 Pull 會在伺服器 last commit 上分支、再以 3-way merge 落回
main,衝突以自動編譯錯誤呈現而非中斷 Pull。
Skills
- Skills 安裝器 — 可從公開 GitHub repo(例如
vercel-labs/skills)或本地資料夾安裝第三方 skills;支援遞迴偵測、多選、衝突警告,可選擇 Global 或目前 Project 範圍。
工作階段
- 工作階段封存 — 側邊欄的右鍵 Delete 改為 Archive(軟刪除);新增 Settings → Archive 分頁,依專案分組顯示已封存的工作階段,並提供 Recover 與兩段式 Delete forever。
- 從側邊欄專案 more-menu 重新命名專案(會寫回
application.json;Enter 確認、Esc 取消)。
對話
- Ask Question — 代理可暫停執行並以 chip 形式在聊天中詢問 1–4 題單/複選問題,每題支援 Custom 自由文字選項。
/compactslash 指令 — 可在達到 context 上限前手動壓縮對話;當壓縮無法找到有意義的切點時隱藏該項;支援字尾提示(例如/compact tell me about X)。- Custom Instruction 改為明確的 Save 按鈕(不再以失去焦點自動儲存),且儲存的內容以新的優先順序規則包覆:使用者輸入視為個人規則,但與先前系統提示衝突時以系統提示為準。
- Main Chat 代理能辨識分享 App 的 URL(
control.bricks.tools/#/create-share-app、share.bricks.tools/app/)並交給 BRICKS CLI 的 share-app workflow 處理。 - 使用者尚未點選聊天框就開始打字時,自動聚焦聊天輸入欄並插入首個字(會略過修飾鍵組合、IME 編寫中、彈窗開啟、其他輸入欄聚焦的情境)。
其他
- 其他效能與穩定性改善。
預覽
- Draw Mode — 以畫筆覆蓋層在內嵌預覽上手繪註解,並將預覽截圖與筆跡合成的圖片附到聊天輸入欄。
對話
- 工作區個人檔案選擇器 — 聊天輸入欄新增工作區個人檔案選擇器:專案聊天顯示專案綁定的工作區;Main Chat 則可切換目前的驗證 profile(切換時跳出二次確認,因為會重建代理的系統提示)。
- 長對話採用分頁,舊訊息收合為「Show N hidden replies」按鈕(完整渲染上限為 50 則)。
write_file/edit_file/read_file工具呼叫的檔案內容改以語法高亮的程式碼或統一 diff 顯示,超過上限可展開為完整內容;串流時內容會逐字更新。- 代理執行中,與經過時間並列顯示品牌動畫。
- 串流渲染以 rAF 合併更新,歷史訊息短路渲染;新增的 markdown 區塊以淡入/滑入動畫呈現。
- 僅在所選模型支援視覺輸入時才允許附加圖片;聊天圖片預覽(80px)與訊息中圖片高度(400px)皆套用上限。
- 程式化設定提示時(Inspect、彈出預覽視窗、歷史導覽等),聊天輸入欄會自動調整高度。
代理
- 代理結束或請求權限授權時,若應用程式未取得焦點,發出系統通知與音效(Settings → Agent 可切換)。
- 代理新增
set_session_title工具,可將目前任務摘要為適合側邊欄寬度的標題。 - 使用者於聊天輸入
/<skill-name>時,代理會載入對應的 skill。 - 允許代理以絕對路徑
read_file讀取專案目錄內檔案。 - 遭遇
context_length_exceeded錯誤時自動執行壓縮並重試;context 指標立即反映壓縮後狀態。
Local Devices
- 掃描並整合已發現的 buttress-server,可透過「Ask Agent to integrate」串接(支援多選;與 devtools 列表互斥)。
設定
- Settings → Appearance 新增主題色設定。
側邊欄與視窗
- 淺色主題支援視窗背景模糊。
- 視窗較窄時,頂端列的 Diff/Open in editor/Actions/Open Controller 按鈕收合為圖示,避免換行。
- 加大側邊欄分割區標題列;移除一般工作階段的預設聊天泡泡圖示。
- 記住 Controller 視窗的位置與大小。
模型
- 修正
kimi-k2.5/kimi-k2.6透過 opencode/opencode-go 時reasoning_content被遺失的問題。
其他
- 二進位安裝模式下,背景自動更新 BRICKS CLI(npm/bun 管理的安裝不會被修改)。
- 新增 React Error Boundary,於渲染錯誤時呈現可重新載入的 fallback 畫面並回報至 Bugsnag。
- 其他穩定性改善。
修正
- 排除多輪執行與佇列輸入自動送出時出現的「Agent is already processing」競爭條件。
對話
- Main Chat — 不依附專案的代理,適用於一般 BRICKS 工作流程。空白狀態提供供應商設定指南、Local Devices 面板與「開啟 BRICKS Controller」入口。側邊欄分為 Projects 與 Chat 兩區。
- Pinned Sessions — 已標記星號的工作階段集中於專屬側邊欄分割區。
- 在聊天中以 BRICKS 主題渲染 mermaid 圖表。
供應商
- Settings → Providers 新增 API key 測試驗證,支援 Anthropic、OpenAI/
baseUrl、Google AI Studio、Google Vertex、OpenAI Codex 與自訂供應商。
模型
- opencode 供應商新增模型:
kimi-k2.6與deepseek-v4-flash/deepseek-v4-pro;opencode-go預設模型改為kimi-k2.6。詳見模型。
沙箱
- 偵測危險 bash 指令並強制顯示權限提示。詳見沙箱。
側邊欄與視窗
- 側邊欄最小寬度更窄並最佳化緊湊版面;底部按鈕移至 Projects 區段標題旁。
- macOS:全螢幕時收回紅綠燈保留的標題列空間。
- 加寬控制器拖曳區域,且不阻擋下方按鈕的點選。
預覽
- 將主題變更同步至預覽窗格。
- 在本機裝置上一律顯示 DevTools 按鈕;尚未完成探測的裝置改為輸入 passcode。Local Devices 改為內嵌於聊天區段顯示。
- 停用內層預覽標題列。
- DevTools/CDP 螢幕共享預設為關閉。
設定
- Settings 改用聊天輸入欄的 chip 樣式 Model/Thinking 選擇器。
- 點選 ACP 指示器可直接跳至對應設定。
其他
- macOS 新增「Open Folder in CTOR」Finder Service。
- Help 選單新增更新日誌連結。
- 將 Open Project 掃描範圍限制在直接子目錄。
- 解決 deploy/pull/update 期間 watcher fan-out 與
git index.lock競爭問題。 - 其他穩定性改善。
修正
- 移除專案時清除已失效的聊天。
- 將登入 OTP 輸入限制為伺服器格式(5 個字母 + 4 個數字)。
- 輸入法組字過程中不再切換輸入歷史。
- 不再將預設允許的沙箱網域寫入設定檔,確保未來預設值更新可同步至既有使用者。
- 串流時的 API 錯誤通知去重,並於切換工作階段時清除已過期訊息。
- 將 Auth0 重新導向保留在 Controller 視窗內,確保登入流程於應用程式內完成。
模型
- 預設模型更新:OpenAI 預設改為
openai/gpt-5.5,Codex 預設改為openai-codex/gpt-5.5。詳見模型。 gpt-5.3-codex-spark限定 ChatGPT Pro 方案使用。
供應商
- 新增 Google Agent Platform(Vertex AI) 供應商。
- 供應商新增/編輯表單加入取消與刪除按鈕。
- 以 token 登入時,個人檔案名稱改由 ID token 解析。
視窗
- Window 選單新增 Pin Window 切換。
- Controller 視窗改為無邊框透明,並支援深色視窗背景模糊。
側邊欄
- 寬度可調整。
- 新加入的專案顯示於最上方。
- 側邊欄收合時頂端新增建立工作階段按鈕。
對話
- 聊天與輸入欄位支援原生右鍵選單。
- 橫幅對齊聊天內容寬度。
- 提示預覽區塊可收合。
- 每個代理可設定自訂指令。
圖片
沙箱
- 網路白名單允許 Activity Log 網域。
- 重複使用代理時重新整理執行環境。
其他
- 擴充 Agent Client Protocol 伺服器,支援更多代理用戶端。
- 新增 BRICKS CLI、Bun 與 Git 的啟動需求畫面。
- 微調主題的浮層背景與主要文字配色。
- 從聊天輸入欄位隱藏已停用或未安裝的 skill。
修正
- 修正輸入法組字過程中按 Enter 會送出聊天訊息的問題。
- 重新傳送已編輯的訊息時,模型 fallback 採用正確值。
- 套用更新時,一併納入所有產生檔案與安裝後步驟變更的路徑。
- 修正 CTOR 改名後遺漏的遷移。
CTOR 首個 Preview 版本發佈,是建構 BRICKS 應用程式的全新桌面 IDE。
重點功能
- AI 代理對話式工作流程 — 透過內建 AI 代理 對話建構 BRICKS 應用程式,可在整合的差異檢視中檢視檔案編輯與工具呼叫。
- 整合的 Controller 檢視 — 直接在桌面應用程式中預覽與管理工作區,無需切換至網頁版。
- Web Preview CDP 橋接 — 外部 CDP 用戶端(Chrome DevTools、Playwright、
bricks devtools)可透過本機 WebSocket 伺服器連線至 CTOR preview,目前僅於 CTOR 中提供。