> ## 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-ctor 的產品更新與公告

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

  * 生成的 projects 現在預設會收合 canvases、Bricks 與 Data，同時保留 explicit expanded-state settings。
  * 生成的 Items Brick projects 會保留 frame type 與 detail/list press behaviors 等 item fields。

  ### MCP server

  * Simulator MCP output 現在會在 successful compiles 後指向 Preview DevTools / `bricks devtools` inspection loop。詳見 [MCP server](/zh-Hant/ctor-pkg/mcp-server)。
</Update>

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

  * 生成的 projects 會正確 serialize array data values。
  * Data Calculation sandbox output 不再於每次 compile 後累積額外的 `{ }` blocks。
  * 其他 generated-project 穩定性修正。

  ### Pull app

  * **`bricks ctor pull-app`** — 會建立缺少的 parent directories，並尊重選擇的 starting branch。
</Update>

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

  * 生成的 projects 會保留 target case id 為 dynamic 的 conditional jumps，不再在 compile 時默默丟棄。
  * Generator code generation 在 entity aliases 衝突時不再產生重複的 variable declarations。
  * 生成的 projects 不再在某個 alias 與另一個的 fallback file name 衝突時遺失 Data Calculation。

  ### Automation tests

  * Legacy automation tests 現在會 migrate 成 per-test files，不再被丟棄並以空的 placeholders 取代。

  ### MCP

  * 格式錯誤的 MCP config 在 project setup 期間不再清除你其他已設定的 MCP servers。
</Update>

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

  * 生成 projects 會為 Codex 預先 approve bricks-ctor MCP tools，讓 Codex CLI sessions 不會卡在 approval prompts。

  ### Claude Code

  * Claude Code projects 會 seed local auto-mode trusted BRICKS infrastructure，但不會自動啟用 auto mode。

  ### 編譯驗證

  * 生成 project compile checks 會更早抓出 Data Calculation cycles 與壞掉的 PROPERTY\_BANK\_EXPRESSION strings。
</Update>

<Update label="2026 年 5 月 27 日" description="v2.24.5" tags={["發佈", "Preview"]}>
  ### 編譯驗證

  * **`bricks app check-config --validate-automation`** — 在編譯期就揭露失效的 automation\_map／test\_map 參照（缺漏的 Subspace、Brick、Canvas、Bank、動態 sender／handler，以及格式錯誤的 `PROPERTY_BANK_*` `input_to_receiver` 前綴）。專案代理的 compile 流程預設啟用。

  ### Automation

  * **Method steps 的 `subspaceId` 可省略** — `brick_press`、`execute_action`、`wait_until_*`、`delay` 等 method steps 可省略 `subspaceId`，執行時自動解析為 Root Subspace。[Config Editor](/zh-Hant/controller/config-editor) 將空值選項標示為「Root (default)」。

  ### 型別系統

  * **Animation Event 處理欄位** 改為支援 getter 形式（`() => Animation`），讓 Animation 之間的延遲或前向引用能通過型別檢查，與其他實體參照一致。
  * **Data 型別欄位接受 `boolean` 作為 `bool` 的別名**，便於 TypeScript 使用者撰寫；編譯輸出不變。

  ### MCP

  * MCP 工具輸出不再混入來自 `tsc`／`bun`／`bricks` 子程序的 ANSI 顏色碼；終端機呼叫端仍保留顏色。
</Update>

<Update label="2026 年 5 月 20 日" description="v2.24.4" tags={["發佈", "Preview"]}>
  ### 自動編譯與 Pull

  * **背景自動編譯** — 專案 Session 啟用時於背景自動編譯（Hash gate 控制是否實際執行），內嵌錯誤橫幅，以及偵測伺服器較新／本地較前狀態的 **Pull**／**Update Config** Pill 流程。
  * **非強制 Pull** — Pull 對話框新增非強制 Pull：在伺服器 last commit 上分支、套用新檔案後再將 `main` 合併回來。Force Pull 保留原本的覆寫行為。

  ### Deploy 與重新命名

  * **Deploy／Update Config** 會將 `application.json` 中的名稱一併送出，本地改名同時也會在伺服器更名。搭配 [`bricks app/module release --name`](/zh-Hant/cli/changelog) 使用。

  ### 產生檔案

  * Automation Test 與 Data Calculation 的生成檔名改以 alias 推導的 kebab-case slug，避免重新排序後檔名飄移；Pull 時會清掉孤兒 `.ts` 檔案。

  ### Skills

  * 新增 **bricks-design**／**bricks-ux** [skills](/zh-Hant/ctor-pkg/skills)，包含視覺設計與互動設計的完整規範供專案代理使用。
</Update>

<Update label="2026 年 5 月 13 日" description="v2.24.3" tags={["發佈", "Preview"]}>
  ### 改進項目

  * 產生的專案新增 `bun update-app` 腳本，可在不變更 release 版本的情況下推送設定變更，搭配 [BRICKS CLI](/zh-Hant/cli/changelog) 中 `bricks app update --last-commit-id`／`--validate` 的衝突防護機制使用。
  * 更新代理使用的 Buttress 整合說明參考。
</Update>

<Update label="2026 年 4 月 29 日" description="v2.24.1" tags={["發佈", "Preview"]}>
  ### 改進項目

  * 自動產生的 Commit（deploy、pull force-commit、遷移／更新）改以 CTOR（Desktop）作者署名。
  * Generator 在格式化產生專案時，會略過點開頭目錄與 markdown 檔案。
</Update>

<Update label="2026 年 4 月 22 日" description="v2.24.0" tags={["發佈", "重大變更"]}>
  ### 重大變更

  * **從 `bricks-project` 重新命名** — `@fugood/bricks-project` 現為 `@fugood/bricks-ctor`；`bricks-project-generator` 現為 `bricks-ctor-generator`。
  * **新的專案結構** — 新產生的專案使用 `from 'bricks-ctor'` 匯入與 `./ctor/` 目錄。
  * **自動遷移** — 舊版 `project/` 目錄與 MCP 設定鍵會在首次執行時自動遷移。最新的設定方式請參考[入門指南](/zh-Hant/ctor-pkg/getting-started)。
</Update>