Skip to main content
發佈
v2.25.11

新指令

  • 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,並會回報模擬器程序失敗。
發佈
v2.25.10

修正

  • 取消瀏覽器登入會立即停止登入流程,包含最後步驟。
  • bricks app release 與 bricks module release 可接受包含 URL 的行內發佈設定,不再誤判為檔案路徑。請參閱指令。
  • bricks group resolve 會搜尋所有裝置群組,--limit 會限制符合的結果數量。
發佈
v2.25.9

修正

  • bricks ctor 的專案設定不再因命令輸出過多而卡住。請參閱指令。
  • Data Bank 指令會回報格式異常的回應,不再無聲失敗。
  • 裝置與群組監控會拒絕無效的輪詢間隔。
發佈
v2.25.7

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 則可清除裝置上的既有紀錄。
發佈
v2.25.6

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 以錯誤的傳輸格式送出,所有寫入都被拒絕。
發佈
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 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 也會顯示各裝置的授權狀態。詳見本機除錯。
發佈
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 group — dispatch、refresh、devices 與 monitor 不再總是失敗;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 remove、bricks device remove 與 bricks module remove — 可從工作區移除對應的資源,並支援 dry-run 預覽與 JSON 輸出。詳見指令。
發佈
v2.24.5

DevTools

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

分享 App

  • bricks app share-info/share-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 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 指令。