更新日誌

​

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 失敗。

​

修正

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

​

修正

• 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 app remove、bricks device remove 與 bricks module remove — 可從工作區移除對應的資源，並支援 dry-run 預覽與 JSON 輸出。詳見指令。

​

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 上公開。

​

分享 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 在同一個請求中重新命名。

​

自我更新

• 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 專案內初始化新專案。

​

desktop-acp-bridge

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

​

獨立發行版

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

​

重點 — 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 指令。