更新日誌

​

Worktrees

• Isolated git worktrees — Chats 現在可在 isolated git worktrees 中執行，支援 selectable worktree target、create/merge/remove flows、per-worktree simulator 與 Config Editor state，以及 sidebar worktree indicators。

​

Tool calls

• Tool calls 顯示更清楚的進度：agents 會在 tool calls 前後敘述狀態，bash tool titles 也會使用第一行 intent comment。

​

Models

• 新增 model options — Claude Fable 5、透過 GitHub Copilot 與 opencode 使用的 Claude Sonnet 5、GitHub Copilot Kimi K2.7 Code、opencode Kimi K2.7 Code、opencode GLM 5.2，以及 opencode MiniMax M3。詳見支援的模型。

​

Sign-in and connections

• OTP login — 更可靠地處理 object-form validation replies、missing-token replies 與 request timeouts。
• Transient connection-retry errors 在 automatic retries 仍在進行時會保持安靜，只在 retries exhausted 時顯示。

​

App lifecycle

• CTOR Desktop 會每小時檢查 app updates，Settings 會可靠地開到指定 tab，Main Chat 也不再顯示 project-only actions。

​

Linux

• Installers 會在需要時把 bin directory 加入 PATH，從 CTOR 安裝 BRICKS CLI 也會正確保留 CLI path。

​

Fixes

• Foreground bash timeouts 會被限制，sub-agent output truncate 時也不會破壞 UTF-8 text。
• 其他 CTOR Desktop 穩定性改善。

​

Models

• Custom endpoints — OpenAI-compatible endpoints 現在可啟用 Responses API mode、per-model reasoning、xhigh、context window 與 vision。
• Fallback Vision Model — text-only models 現在可使用設定的 vision model，描述 attachments、read_file、simulator screenshots 與 tool results 中的 images，讓 model 仍可使用它們。可在設定中設定。

​

Main chat

• main chat 可回答它所驅動 sessions 提出的 ask_questions，當答案已很明確時 background sessions 可直接繼續。

​

Appearance

• Streaming 動畫 — streaming messages 現在會在抵達時 animate，Appearance 設定也新增 Reduce motion option 可關閉。

​

Window and layout

• floating sidebar 在靠近 window 左緣時會保持開啟並有更平順的 edge handling，Local Devices actions 在 compact widths 下也會更好地收合。

​

Sessions

• 刪除或切換 sessions 不再破壞 navigation history、truncate 錯誤的 session 或以 stale state merge projects，quick questions 也會維持在正確的 session scope。

​

Fixes

• Codex commentary 會以 text render，transient WebSocket retry 現在會正確觸發，read_file output 在送給 model 前會被限制長度，right-area tabs 在 layout changes 期間也有 guard。
• 其他 CTOR Desktop 穩定性改善。

​

Preview

• Draw mode — 新增 host 端的 annotation overlay，提供 pen、rectangle、arrow、可編輯 text 與 eraser 工具，以及 undo / redo、color 與 width。
• Record Events as Automations — 在 preview 中錄製現在會於 chat 預先填入一則請求，要求 agent 撰寫該 automation，並附上真實的 step timings 與 entity names。

​

Messages

• 匯出 — Messages Detail panel 可透過原生儲存對話方塊，將傳給 model 的 messages 匯出為 Markdown 或 JSON。

​

Goals

• 可就地編輯執行中 goal 的 objective、執行 on-demand 的 goal Check，並看見 session 期間有哪些 custom lifecycle hooks 被觸發——包含任何被阻擋或失敗的。

​

Agent

• General-purpose sub-agent — 提供具備完整 tools 的 sub-agent，skills 也可透過 bundled instructions file 驅動一個 spawned agent。

​

Models

• 新增 model 選項：opencode-go glm-5.2，以及給 openai-codex GPT-5.4 / 5.5 的 Normal / Fast 速度選擇器。

​

Sessions

• macOS dock icon 會列出你最近使用的 5 個 sessions，session search 在 query 為空時會顯示最近的 sessions。

​

Sandbox

• 在 Sandboxed mode 中，read-only 的 bricks devtools command chains 現在會自動核准，不再每次都提示。

​

Window and layout

• right-side panel 與 sidebar 在被拖到比其 compact width 更窄時會自動關閉，right-area panel 現在會以動畫開啟與關閉。

​

Other

• 其他功能、修正與效能、穩定性改善。

​

Plan

• Plan mode — 使用 /plan 在 read-only session 中撰寫 implementation plans、review 或 approve，並在執行時追蹤 checklist progress。

​

工作階段

• 多 Session 管理 — Main Chat 可建立、傳訊、停止、archive 與 inspect 其他 sessions，並把 completion reports queue 回目前 chat。
• Fork — 可從目前 transcript fork session。

​

代理

• Custom hooks — 透過 global 與 project hooks.json 的 custom agent hooks，可在 prompts、tool calls、session stops、compaction、goals 與 sub-agents 上執行 commands。
• MCP 管理 — Main Chat 可透過 main workspace 的 .mcp.json 管理 MCP servers。
• Persistent goals — goals 可自動持續執行直到完成。

​

Models

• 新增 models：opencode-go kimi-k2.7-code、minimax-m3、qwen3.7-plus。

​

視窗與版面

• Preview／Simulator／right-area panes 在 refresh、session switch 與空的 Main Chat 狀態間會保持 attached。

​

對話

• 設定 image provider 後會提示 /imagegen。

​

其他

• Sandboxed project init、media upload／download 與 clipboard copy 更可靠。
• 其他功能、修正與效能、穩定性改善。

​

檔案

• File Viewer tabs — 在 right area 瀏覽本機 project files 與 config URL 資產、預覽常見的檔案與媒體格式、用 rg 搜尋、開啟本機 Markdown 連結，並在瀏覽時替換目前的 file tab。

​

對話

• 語音輸入 — 在 macOS 26+ 上以口述方式輸入對話訊息。包含麥克風權限處理、英文／繁體中文／日文辨識、BRICKS 相關的上下文術語、清楚的停止狀態，以及更高品質的錄音預設值。

​

代理

• 沙盒化的 read_file 權限 — 代理在讀取 project 以外的檔案前可先請求權限，提供 Allow once 與 Allow & save 選項，並寫入 sandbox.json。詳見 sandbox。
• CTOR Desktop 現在會在執行破壞性的 bricks app remove／device remove／module remove 指令前先提示確認。詳見指令。

​

工作階段

• Dock badge — agent session 在失焦時完成會增加 app dock badge，並在檢視、封存或刪除 session 後清除。

​

視窗與版面

• 浮動側邊欄可從可見的邊緣調整寬度，並記住寬度設定。
• right area 的 + 按鈕會開啟可用檢視的下拉選單，不再經過空白的 picker。

​

Preview 與 DevTools

• DevTools tabs 新增頁面內的關閉按鈕，並改用更精簡的前端，移除較少使用的面板與工具列按鈕。

​

部署

• 生成的 configs 在 compile 時會保留 Data Bank 的 remote-update 型別。

​

其他

• 其他效能與穩定性改善。

​

工作階段

• SQLite session 儲存 — session 儲存改用 SQLite 與全文搜尋。Cmd/Ctrl+K 可搜尋 session title／messages、用搜尋文字開始新 chat、限定 project 搜尋，並避開干擾結果的 tool results。

​

視窗與版面

• 多個 main windows — 可從 File → New Window／Actions 開啟同一個 chat；agent events、approvals 與 questions 會在多個視窗同步。
• Right area tabs — right area 重新設計為 Controller、Diff、Preview、Simulator 與 DevTools tabs。tabs 可拖曳排序、關閉、用 Cmd+1..9 切換，尺寸可保留並依 project 保存狀態。
• 視窗與 right-panel 最小寬度縮小、Preview toolbar 在窄寬度下改為 icon-only、Delete Local Project 使用 danger 樣式，preview 截圖也會保留 box-shadow。

​

Preview 與 DevTools

• Device 與 Simulator DevTools 預設 dock 到 right-area tabs，並可 pop out；embedded DevTools 預設關閉 screencast。

​

Controller

• Controller tab 可在原處 refresh、外部連結會交給系統瀏覽器開啟，且未指定 workspace 時會進入 workspace picker。

​

側邊欄

• 浮動側邊欄成為新使用者預設，含首次啟動提示；支援 Cmd+[／Cmd+] 的 session back/forward，並在 webview、context menu 或拖曳時維持正確行為。

​

對話

• 任意檔案附件 — 支援 vision 的 models 會將圖片 inline attach，其它檔案會插入 @{path} mentions；chat 圖片可開啟 lightbox 並儲存。
• Context usage popover 會拆出 System Instruction、Agent md、Skills、Custom Instruction、Tools、Messages 與剩餘容量，並顯示 auto-compact threshold。

​

代理

• Agent run 遇到暫時性 connection／5xx／timeout 錯誤會自動重試，但不會重試 auth 或 quota 錯誤。
• small models 的 tool calls 可透過 fallback schemas 正規化；ask_questions 也能處理單題扁平輸出。

​

部署

• Push Config 取代 CTOR Desktop 與生成專案中的 Update Config；local-ahead indicator 可在下一個 commit 前暫時關閉。
• 生成專案現在會在 application-only payload 中包含 app entry，並在 bricks output 中正確 import 生成的 animations／properties。

​

模型

• 新增 models：Claude Opus 4.8、opencode-go Mimo 2.5／2.5 Pro 與 qwen3.7-max（text-only）。請參閱 models。

​

其他

• macOS Local Network privacy — CTOR builds 現在有唯一 Mach-O UUID 與正確權限提示，修正受影響系統上的 Local Devices／DevTools discovery。
• 移除 project 時會釋放快取的 TypeScript LanguageService。
• 其他效能與穩定性改善。

​

側邊欄

• 浮動側邊欄覆蓋層 — Arc 風格的側邊欄在收合時，滑鼠移至視窗左緣會自動以卡片形式滑出；收合狀態可跨啟動保留。

​

對話

• 工具區塊 — 工具呼叫與對應結果合併為單一可收合的區塊；write_file／edit_file 預設收合，標頭即時顯示 +新增／−刪除 的差異統計。
• 每輪 model header 顯示累計時間；多訊息的回合再加上靠右對齊的 footer，讓 model 與時間在 header 捲離畫面後仍可見。

​

預覽

• 原生預覽窗格工具 取代舊有的 host iframe 流程。多個專案預覽可同時運作、無頭擷取保持隱藏、可見預覽不會因無頭 invoke 而中斷、截圖會裁切至應用程式畫面。請參閱 preview。

​

代理工具

• TypeScript Language Server 工具 — 可選啟用。啟用後，代理會在每次對 .ts／.tsx／.cts／.mts 執行 write_file／edit_file 後提示型別錯誤，並可跳至符號定義或尋找引用之處。於 Settings → Advanced → Language Server Tools 切換開啟。
• edit_file 改為容忍空白的多階段比對（完全相符 → trim → 註解／Unicode → 前綴／子字串 → indent-aware 模糊比對 → 字元層級 fallback，並在各階段加上嚴格的歧義防護），並新增 replace_all 以支援批次替換。寫入時以位元組層級保留 CRLF／BOM／混合換行。
• read_file 新增 offset／limit 分頁、cat -n 行號、自動移除 BOM、單行壓縮檔案的中段保留 fallback，以及分類錯誤類別（ENOENT／EACCES／EISDIR）。
• bash、grep、glob 共用同一輸出截斷機制：bash 保留 256 KB 開頭 + 256 KB 結尾，不再因輸出超量被中止；grep 新增 output_mode 參數（content／files／count），content 上限為 100 行；glob 上限為 100 個路徑，並過濾 .DS_Store 與完整 node_modules 路徑。

​

工作區

• Main Chat 工作目錄可自訂（預設 ~/bricks-ctor），含事前驗證；於工作階段中變更目錄會即時換掉代理的工具與沙箱範圍。

​

設定

• 字級設定 — UI 與程式碼字級（10–24 px），位於 Settings → Appearance → Fonts。
• 品牌圖示 — Settings 供應商列表與聊天工具列「Open in」選單，現顯示供應商（Anthropic、OpenAI、Google、Vertex AI、GitHub Copilot、OpenAI Codex、opencode…）與外部編輯器（VSCode、Cursor、Zed、Sublime、Codex、Antigravity、iTerm、Ghostty、Terminal…）的品牌圖示。

​

模型與供應商

• Gemini 3.5 Flash 已新增至 Google AI Studio、Vertex AI 與 GitHub Copilot 供應商；Google 的預設模型改為 Gemini 3.5 Flash。請參閱 models。
• 每個模型的 Context 視窗覆寫 — openai-compat 端點可逐模型覆寫 Context 視窗大小（最小 32 K，預設 128 K）。
• Anthropic OAuth 登入 — 改以 Claude Pro 或 Max 訂閱進行額度（credit-based）登入，無需 API key；登入後 Provider 列會顯示 OAuth 標記。

​

其他

• 其他功能、修正、效能與穩定性改善。

​

自動編譯

• 自動編譯 — 偵測到輸入實際變動時於背景執行（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 自由文字選項。
• /compact slash 指令 — 可在達到 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 視窗改為無邊框透明，並支援深色視窗背景模糊。

​

側邊欄

• 寬度可調整。
• 新加入的專案顯示於最上方。
• 側邊欄收合時頂端新增建立工作階段按鈕。

​

對話

• 聊天與輸入欄位支援原生右鍵選單。
• 橫幅對齊聊天內容寬度。
• 提示預覽區塊可收合。
• 每個代理可設定自訂指令。

​

圖片

• 差異檢視窗格顯示圖片預覽。
• 新增 imagegen skill 控制項。
• Markdown 圖片以專案路徑為基準解析。

​

沙箱

• 網路白名單允許 Activity Log 網域。
• 重複使用代理時重新整理執行環境。

​

其他

• 擴充 Agent Client Protocol 伺服器，支援更多代理用戶端。
• 新增 BRICKS CLI、Bun 與 Git 的啟動需求畫面。
• 微調主題的浮層背景與主要文字配色。
• 從聊天輸入欄位隱藏已停用或未安裝的 skill。

​

修正

• 修正輸入法組字過程中按 Enter 會送出聊天訊息的問題。
• 重新傳送已編輯的訊息時，模型 fallback 採用正確值。
• 套用更新時，一併納入所有產生檔案與安裝後步驟變更的路徑。
• 修正 CTOR 改名後遺漏的遷移。

​

重點功能

• AI 代理對話式工作流程 — 透過內建 AI 代理 對話建構 BRICKS 應用程式，可在整合的差異檢視中檢視檔案編輯與工具呼叫。
• 整合的 Controller 檢視 — 直接在桌面應用程式中預覽與管理工作區，無需切換至網頁版。
• Web Preview CDP 橋接 — 外部 CDP 用戶端（Chrome DevTools、Playwright、bricks devtools）可透過本機 WebSocket 伺服器連線至 CTOR preview，目前僅於 CTOR 中提供。