新指令
bricks app control-page <app-id>— 為 Runtime Editor、Canvas Control 與 Device Control 頁面核發 token 並輸出其 URL。核發 token 需要 OAuth 登入;--no-token只輸出登入用 URL。bricks devtools diagnostics pull— 使用裝置畫面上顯示的診斷碼、裝置通行碼或工作區 token 讀取裝置的診斷紀錄,裝置未綁定、閒置或離線時也可使用。
變更
bricks app release與bricks ctor deploy會要求伺服器驗證設定,使用--no-validate可略過。請參閱指令。bricks devtools brick tree會顯示每個元素的 node ID,bricks devtools runtime eval會回傳最後一個運算式的值。
修正
bricks app get會回報已綁定裝置的 Automation 排程,不再總是顯示 No schedule。bricks ctor simulator支援--help,並會回報模擬器程序失敗。
DevTools
bricks devtools input key會透過 runtime 的按鍵模擬(與自動化 keydown/keyup 步驟相同的路徑)按下具名按鍵,例如ArrowRight、Enter、Escape、Tab,Generator Keyboard 與 Scene3D 按鍵指令碼因此能收到。指令也會回報 runtime 接受、拒絕,或是舊版 runtime 無法確認送達。先前即使非文字按鍵被丟棄,指令仍顯示成功。請參閱指令。bricks devtools console list會為每筆項目標記[retained <age>]或[new],過期的錯誤不再與目前執行剛產生的錯誤難以分辨。--live-only會略過既有紀錄,新增的bricks devtools console clear則可清除裝置上的既有紀錄。
Activity Log
bricks al screenshot --stream --from <window>— 以單一 MJPEG 串流下載整段 Activity Log 截圖區間,不再每張一個請求:26 張從 27 秒縮短為 1.4 秒。檔名以擷取時間戳命名,-j會輸出清單,單張下載路徑現在也會輸出。請參閱指令。bricks activity-log的--limit改在伺服器端套用,從 3.6 萬筆事件的區間取 100 筆,從 9.5 秒縮短為 2 秒。新增的--offset可搭配分頁,未搭配--limit時會被拒絕,因為伺服器會無聲忽略它。
Buttress
bricks buttress bank-key— 核發、輪替或以--revoke撤銷 BRICKS Buttress 伺服器 local functions 使用的 Data Bank 金鑰。bricks buttress status會顯示綁定的 Data Bank。請參閱 BRICKS Buttress。
修正
bricks data set可再次寫入 Data Bank。先前值與 meta 以錯誤的傳輸格式送出,所有寫入都被拒絕。
DevTools
bricks devtools console list— 讀取執行中 app 的 console 輸出,涵蓋 log 項目與例外狀況,並可指定收集時間與 JSON 輸出。詳見指令。- 沒有標題的 MESSAGE system Action 現在也會傳送到 console,不再只出現在 Simulator 內的 Logs 面板。
- 當
bricks devtools操作 Simulator 時,計時器會維持正常速度運作,Generator Tick 等以計時器驅動的 generator 不再看似凍結。詳見 CTOR。
Buttress
bricks buttress mcp-config— 寫入 agent 連線至 BRICKS Buttress 伺服器所需的.mcp.json設定。詳見 BRICKS Buttress。
Doctor
bricks app doctor— 設定驗證現在會檢查項目 Brick 的 event maps,標示格式錯誤的項目,以及舊版 Short Edit 寫入所留下的無效 key。詳見 bricks-ctor。
重大變更
bricks auth login改為 OAuth — 現在會啟動瀏覽器登入流程。通行碼登入移至bricks auth login-workspace。詳見驗證。- ctor 專案工具鏈移入 CLI —
@fugood/bricks-ctor不再內含專案工具,改由bricks ctor指令群取代。既有專案會在bricks ctor postinstall時自動遷移,一併更新 package scripts、相依套件與.mcp.json。詳見 bricks-ctor。
驗證
- 使用 BRICKS 帳號登入 —
bricks auth login會以 PKCE 開啟瀏覽器登入;SSH 與無頭環境可用--no-browser裝置代碼流程。接著以bricks auth workspaces與bricks auth use-workspace選擇工作區。 - 工作區 API 接受 OAuth 登入,權限與網頁版 BRICKS Controller 逐一對應。CI 與自動化仍完整支援工作區 token。
ctor 專案
bricks ctor—init、postinstall、pull、push、deploy、compile、simulator與mcp現在都改由 CLI 提供。詳見指令。
Doctor
bricks app doctor與bricks module doctor— 一個指令即可完成設定檔驗證,並執行能抓出真實錯誤的語意檢查規則:資料更新競爭、缺少結果參數、版面框超出可視範圍、可點選 Brick 被蓋住、資料節點未使用等。
DevTools
bricks devtools issue-token會依設定檔快取工作區 token。CDP 指令會自動帶入,scan與open也會顯示各裝置的授權狀態。詳見本機除錯。
DevTools
bricks devtools— 新增 Preview / Simulator workflows 的 runtime interaction commands,包含 text input 與 popup reset helpers。詳見指令。
修正
bricks media upload— 當--concurrency是 0、負數或 invalid 時,現在仍會上傳 files,改以 serial execution fallback,不再回報 false success。bricks al screenshots— 現在會顯示精確的 epoch-ms--tsvalue,讓列出的 screenshots 可下載,不再因 timestamp rounding 失敗。
修正
bricks app share-new— 不再以「Unknown argument」error 失敗,可從 shared version 建立 application。詳見指令。bricks group—dispatch、refresh、devices與monitor不再總是失敗;dispatch現在會回報 dispatched 與 device 數量。詳見指令。bricks app get— 現在會正確將 locked application 顯示為 locked。- event value 含有三個連續 hyphens(「---」)時不再丟棄 streamed event data。
Data Bank
bricks data— 可管理 Data Bank status、space keys 與 properties,並支援 JSON output 與寫入 Action 的確認處理。詳見指令。
DevTools
bricks devtools storage— 可檢查 System storage、Data Bank stores、Generator cache 與 Generative Media cache,支援 filters、paging 與完整 value output。詳見指令。
App 驗證
bricks app check-config— 現在預設驗證 Data Calculation references 與 PROPERTY_BANK_EXPRESSION strings,需要時可用--no-validate-expressions。詳見指令。
自我更新
bricks update-cli— 新增指令,可就地自我更新(npm/bun/獨立執行檔皆支援);--check-update僅回報是否有新版本,不會實際安裝。詳見指令。
Buttress
bricks buttress scan— 掃描 LAN 上的 buttress-server,並顯示驗證狀態、綁定的工作區與各 generator 的硬體規格。詳見指令。
App 與 Module 更新
bricks app/module update— 支援--last-commit-id與--validate旗標以拒絕衝突推送。產生的專案新增bun update-app腳本,可在不變更 release 版本的情況下推送設定,並依照專案 git 狀態自動推導衝突防護資訊。
DevTools
- 預設輸出 HTTP CDP 前端 URL;
devtools://標示為 legacy。詳見本機除錯。 - 支援將 devtools 旗標放在子指令之前。
其他
- 支援以
-v作為--version別名。 bricks app/module new --init(與ctor-init)使用者明確指定--output時,將其視為目標目錄。- 拒絕在現有 CTOR 專案內初始化新專案。
重點 — AI 代理工作流程
- 機器可讀的健康檢查 — 新增
bricks doctor與bricks auth status --json,提供可程式化執行的環境診斷,詳見指令。 resolve指令 — 新增resolve子指令,用於透過名稱或別名解析 devices、apps、modules、groups 的正式 ID。--dry-run預覽 — 執行前先預覽寫入類指令的影響:device control、device bind、device refresh、device clear-cache、app bind、app release、module release、group dispatch、group refresh。- Activity Log 與裝置指標 — 可透過 CLI 與內建 MCP server 查詢 Activity Log 資料與裝置指標。
- 非 TTY 環境下的安全啟動 — 當 stdout 非 TTY 時顯示 help 而非 Ink UI,確保 CI 與管線呼叫行為穩定。
DevTools
bricks devtools— 新增多項子指令,可從終端機檢查執行中的 BRICKS 應用程式:screenshot、brick tree、brick query、input tap、input type、network list、network get、storage與runtime eval,詳見 DevTools 指令。