> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# 更新日誌

> BRICKS CLI 的產品更新與公告

<Update label="2026 年 7 月 8 日" description="v2.24.11" tags={["發佈"]}>
  ### DevTools

  * **`bricks devtools`** — 新增 Preview / Simulator workflows 的 runtime interaction commands，包含 text input 與 popup reset helpers。詳見[指令](/zh-Hant/cli/commands)。

  ### 修正

  * **`bricks media upload`** — 當 `--concurrency` 是 0、負數或 invalid 時，現在仍會上傳 files，改以 serial execution fallback，不再回報 false success。
  * **`bricks al screenshots`** — 現在會顯示精確的 epoch-ms `--ts` value，讓列出的 screenshots 可下載，不再因 timestamp rounding 失敗。
</Update>

<Update label="2026 年 7 月 1 日" description="v2.24.10" tags={["發佈"]}>
  ### 修正

  * **`bricks device`** — 當 memory 或 disk usage 不可用時，現在會顯示 N/A 而不是 NaN%。詳見[指令](/zh-Hant/cli/commands)。
</Update>

<Update label="2026 年 6 月 24 日" description="v2.24.9" tags={["發佈"]}>
  ### 修正

  * **`bricks app share-new`** — 不再以「Unknown argument」error 失敗，可從 shared version 建立 application。詳見[指令](/zh-Hant/cli/commands)。
  * **`bricks group`** — `dispatch`、`refresh`、`devices` 與 `monitor` 不再總是失敗；`dispatch` 現在會回報 dispatched 與 device 數量。詳見[指令](/zh-Hant/cli/commands)。
  * **`bricks app get`** — 現在會正確將 locked application 顯示為 locked。
  * event value 含有三個連續 hyphens（「---」）時不再丟棄 streamed event data。
</Update>

<Update label="2026 年 6 月 17 日" description="v2.24.8" tags={["發佈"]}>
  ### Data Bank

  * **`bricks data`** — 可管理 Data Bank status、space keys 與 properties，並支援 JSON output 與寫入 Action 的確認處理。詳見[指令](/zh-Hant/cli/commands)。

  ### DevTools

  * **`bricks devtools storage`** — 可檢查 System storage、Data Bank stores、Generator cache 與 Generative Media cache，支援 filters、paging 與完整 value output。詳見[指令](/zh-Hant/cli/commands)。

  ### App 驗證

  * **`bricks app check-config`** — 現在預設驗證 Data Calculation references 與 PROPERTY\_BANK\_EXPRESSION strings，需要時可用 `--no-validate-expressions`。詳見[指令](/zh-Hant/cli/commands)。
</Update>

<Update label="2026 年 6 月 10 日" description="v2.24.7" tags={["發佈"]}>
  ### 資源管理

  * **`bricks app remove`**、**`bricks device remove`** 與 **`bricks module remove`** — 可從工作區移除對應的資源，並支援 dry-run 預覽與 JSON 輸出。詳見[指令](/zh-Hant/cli/commands)。
</Update>

<Update label="2026 年 5 月 27 日" description="v2.24.5" tags={["發佈"]}>
  ### DevTools

  * **`bricks devtools`** — 可直接以 `-a host:port` 同時指定主機與埠號，`--address` 預設改為 `127.0.0.1`，並改善非標準像素比裝置上的點擊反應。詳見[指令](/zh-Hant/cli/commands)。

  ### 分享 App

  * **`bricks app share-info`**／**`share-new`** — 於 v2.24.5+ 工作區可正常運作；bricks-cli 依賴的工作區範圍 GraphQL 欄位先前未在 workspace API 上公開。
</Update>

<Update label="2026 年 5 月 20 日" description="v2.24.4" tags={["發佈"]}>
  ### 分享 App

  * **`bricks app share-info <id>`** — 列出來源 App 已選的 release。詳見[指令](/zh-Hant/cli/commands)。
  * **`bricks app share-new`** — 從共享 release 版本建立 App（可用 `--app-id` + `--version` 或 `--version-id`）。

  ### App 與 Module

  * **`bricks app/module release`** — 接受 `--name` 在同一個請求中重新命名。
</Update>

<Update label="2026 年 5 月 13 日" description="v2.24.3" tags={["發佈"]}>
  ### 自我更新

  * **`bricks update-cli`** — 新增指令，可就地自我更新（npm／bun／獨立執行檔皆支援）；`--check-update` 僅回報是否有新版本，不會實際安裝。詳見[指令](/zh-Hant/cli/commands)。

  ### Buttress

  * **`bricks buttress scan`** — 掃描 LAN 上的 buttress-server，並顯示驗證狀態、綁定的工作區與各 generator 的硬體規格。詳見[指令](/zh-Hant/cli/commands)。

  ### App 與 Module 更新

  * **`bricks app/module update`** — 支援 `--last-commit-id` 與 `--validate` 旗標以拒絕衝突推送。產生的專案新增 `bun update-app` 腳本，可在不變更 release 版本的情況下推送設定，並依照專案 git 狀態自動推導衝突防護資訊。

  ### DevTools

  * 預設輸出 HTTP CDP 前端 URL；`devtools://` 標示為 legacy。詳見[本機除錯](/zh-Hant/foundation/local-debugging)。
  * 支援將 devtools 旗標放在子指令之前。

  ### 其他

  * 支援以 `-v` 作為 `--version` 別名。
  * `bricks app/module new --init`（與 `ctor-init`）使用者明確指定 `--output` 時，將其視為目標目錄。
  * 拒絕在現有 CTOR 專案內初始化新專案。
</Update>

<Update label="2026 年 5 月 4 日" description="v2.24.2" tags={["發佈"]}>
  ### desktop-acp-bridge

  * `desktop-acp-bridge` 新增 `--ws` 模式，可將 [CTOR](/zh-Hant/ctor) Desktop 的 ACP socket 透過 WebSocket 對 LAN 用戶端公開，並支援 Bearer-token 驗證。詳見[指令](/zh-Hant/cli/commands)。
</Update>

<Update label="2026 年 4 月 29 日" description="v2.24.1" tags={["發佈"]}>
  ### 獨立發行版

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

<Update label="2026 年 4 月 22 日" description="v2.24.0" tags={["發佈"]}>
  ### 重點 — AI 代理工作流程

  * **機器可讀的健康檢查** — 新增 `bricks doctor` 與 `bricks auth status --json`，提供可程式化執行的環境診斷，詳見[指令](/zh-Hant/cli/commands)。
  * **`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](/zh-Hant/foundation/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 指令](/zh-Hant/cli/commands)。
</Update>