Skip to main content
發佈
v2.25.1

DevTools

  • bricks devtools console list — 讀取執行中 app 的 console 輸出,涵蓋 log 項目與例外狀況,並可指定收集時間與 JSON 輸出。詳見指令
  • 沒有標題的 MESSAGE system Action 現在也會傳送到 console,不再只出現在 Simulator 內的 Logs 面板。
  • bricks devtools 操作 Simulator 時,計時器會維持正常速度運作,Generator Tick 等以計時器驅動的 generator 不再看似凍結。詳見 CTOR

Buttress

Doctor

  • bricks app doctor — 設定驗證現在會檢查項目 Brick 的 event maps,標示格式錯誤的項目,以及舊版 Short Edit 寫入所留下的無效 key。詳見 bricks-ctor
發佈重大變更
v2.25.0

重大變更

  • 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 workspacesbricks auth use-workspace 選擇工作區。
  • 工作區 API 接受 OAuth 登入,權限與網頁版 BRICKS Controller 逐一對應。CI 與自動化仍完整支援工作區 token。

ctor 專案

  • bricks ctorinitpostinstallpullpushdeploycompilesimulatormcp 現在都改由 CLI 提供。詳見指令

Doctor

  • bricks app doctorbricks module doctor — 一個指令即可完成設定檔驗證,並執行能抓出真實錯誤的語意檢查規則:資料更新競爭、缺少結果參數、版面框超出可視範圍、可點選 Brick 被蓋住、資料節點未使用等。

DevTools

  • bricks devtools issue-token 會依設定檔快取工作區 token。CDP 指令會自動帶入,scanopen 也會顯示各裝置的授權狀態。詳見本機除錯
發佈
v2.24.11

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 --ts value,讓列出的 screenshots 可下載,不再因 timestamp rounding 失敗。
發佈
v2.24.10

修正

  • bricks device — 當 memory 或 disk usage 不可用時,現在會顯示 N/A 而不是 NaN%。詳見指令
發佈
v2.24.9

修正

  • bricks app share-new — 不再以「Unknown argument」error 失敗,可從 shared version 建立 application。詳見指令
  • bricks groupdispatchrefreshdevicesmonitor 不再總是失敗;dispatch 現在會回報 dispatched 與 device 數量。詳見指令
  • bricks app get — 現在會正確將 locked application 顯示為 locked。
  • event value 含有三個連續 hyphens(「---」)時不再丟棄 streamed event data。
發佈
v2.24.8

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。詳見指令
發佈
v2.24.7

資源管理

  • bricks app removebricks device removebricks module remove — 可從工作區移除對應的資源,並支援 dry-run 預覽與 JSON 輸出。詳見指令
發佈
v2.24.5

DevTools

  • bricks devtools — 可直接以 -a host:port 同時指定主機與埠號,--address 預設改為 127.0.0.1,並改善非標準像素比裝置上的點擊反應。詳見指令

分享 App

  • bricks app share-infoshare-new — 於 v2.24.5+ 工作區可正常運作;bricks-cli 依賴的工作區範圍 GraphQL 欄位先前未在 workspace API 上公開。
發佈
v2.24.4

分享 App

  • bricks app share-info <id> — 列出來源 App 已選的 release。詳見指令
  • bricks app share-new — 從共享 release 版本建立 App(可用 --app-id + --version--version-id)。

App 與 Module

  • bricks app/module release — 接受 --name 在同一個請求中重新命名。
發佈
v2.24.3

自我更新

  • 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 專案內初始化新專案。
發佈
v2.24.2

desktop-acp-bridge

  • desktop-acp-bridge 新增 --ws 模式,可將 CTOR Desktop 的 ACP socket 透過 WebSocket 對 LAN 用戶端公開,並支援 Bearer-token 驗證。詳見指令
發佈
v2.24.1

獨立發行版

  • 新增獨立 CLI 發行版,提供 macOS、Linux、Windows 安裝程式(不需 Node.js)。安裝前置需求請參考驗證指令
  • 偵測到 bun 時優先使用 bun runtime,否則自動回退至 node
  • Unix 安裝目錄改為 ~/.bricks-cli/bin
  • PATH 中缺少安裝目錄時,自動將其加入對應的 shell rc。
發佈
v2.24.0

重點 — AI 代理工作流程

  • 機器可讀的健康檢查 — 新增 bricks doctorbricks auth status --json,提供可程式化執行的環境診斷,詳見指令
  • resolve 指令 — 新增 resolve 子指令,用於透過名稱或別名解析 devices、apps、modules、groups 的正式 ID。
  • --dry-run 預覽 — 執行前先預覽寫入類指令的影響:device controldevice binddevice refreshdevice clear-cacheapp bindapp releasemodule releasegroup dispatchgroup refresh
  • Activity Log 與裝置指標 — 可透過 CLI 與內建 MCP server 查詢 Activity Log 資料與裝置指標。
  • 非 TTY 環境下的安全啟動 — 當 stdout 非 TTY 時顯示 help 而非 Ink UI,確保 CI 與管線呼叫行為穩定。

DevTools

  • bricks devtools — 新增多項子指令,可從終端機檢查執行中的 BRICKS 應用程式:screenshotbrick treebrick queryinput tapinput typenetwork listnetwork getstorageruntime eval,詳見 DevTools 指令