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

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

  * Video Brick 現在支援 inline subtitles 與 SRT/WebVTT subtitle files、subtitle styling、events-only subtitle mode，以及 cue enter/exit events。

  ### Generators

  * Generator HTTP 現在會送出 response 與 error events，包含 response body、status、headers 與 SSE details。
  * Generators：File append 在多檔案模式會尊重 targetDirectory，Question skip 會用 skipped answer 重新評估 downstream conditions，Tick 會拒絕 invalid/sub-millisecond intervals，Vector Store 可處理 zero-limit searches 而不失敗，programmatic confirm cancellation 也會移除 dialog。

  ### Generator LLM

  * MLX：從 text 解析出的 Llama tool calls 現在會回傳 flat tool-call array。

  ### Data Calculation

  * Data Calculation 與 Property Bank sandbox 修正：lexical variables 可 shadow context names，重疊的 async runs 會正確還原 host globals，stale/unknown commands 會安全 fallback，command removal 也可容忍沒有 in/out ports 的 nodes。

  ### Runtime & config sync

  * 同名 app revisions 會正確 refresh，viewport 變更後 entitlement-filtered configs 仍保持 filtered，in-memory subspace delete-all 不再清掉其他 subspaces 的資料，launcher init 也可處理 missing device lookup responses。

  ### DevTools

  * WebView query-selector expression errors 現在會以 errors 回報，不再讓 script calls 卡住，DevTools 現在可在 Runtime.callFunctionOn round-trip BigInt arguments。

  ### Audio & TTS

  * Bert-VITS2 Mandarin tones、Chinese large-number reading、OuteTTS English integer/large-number reading，以及 long numeric IDs 不再讓 synthesis 崩潰。

  ### Activity Log

  * Activity Log 會限制 oversized Property Bank update values，並記錄 dropped oversized events，不再反覆失敗。

  ### Desktop

  * Linux windows 現在可再次從 top strip 拖曳，也能避開 interactive controls。
  * Linux installer 現在安裝 `bricks-launcher` command name，並在需要時把 install directory 加入 shell PATH。
  * 上述 Video Brick subtitle support、Generator HTTP response events、WebView query-selector、DevTools、Data Calculation、Property Bank、config-refresh、storage、Activity Log、TTS 與 runtime 修正也適用於 Desktop Foundation。

  ### 改進項目

  * 其他穩定性改善。

  ### 向下相容性

  此版本與 v2.20、v2.21、v2.22、v2.23 與 v2.24 的 Launcher 保持相容。
</Update>

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

  * Generator HTTP Server 現在可由 scripts 控制，包含 status、start / stop、自訂 responses、temp-file cleanup 與 stream ending。
  * TCP Server LF/CRLF framing 不再漏掉字元或把額外 frames 留在 buffer，Serial Port 會重新處理 buffer 中完整的 EDC frames，MQTT 會拒絕 undefined publish payloads 而不是送出 `"undefined"`，Iterator 對 empty 或 out-of-range object data 不再崩潰。
  * WebCrawler 在 HTTP selector 找不到 match 時會保留前一次 response，WebRTC renegotiation 不再略過首次 negotiation。

  ### Generator LLM

  * Phi-4 與 Mistral tool calls 會正確解析 single-bracket closings，LLM sessions 會讀取正確的 token field，auto-session files 也會更可靠地清理。

  ### Canvas & events

  * Brick Sketch events 現在包含目前 sketch state，讓 drawing workflows 更容易 automate 與 replay。
  * Dynamic Animation 會從 test data 解析 VARIABLE# values。

  ### Data Bank & configs

  * routed receiver hit / not-hit events 現在使用 receiver 自己的規則，linked-module 與 sparse-config operations 對 optional maps 更容錯，Data Bank fetches 可處理 empty / missing results，SQLite 在 backing property 於 init 期間變更時會切換 databases。

  ### Audio & TTS

  * multi-channel audio downmix 已恢復，OuteTTS v3 不再修改 speaker prompts，tiny numeric values 在文字轉換時會正確 render。

  ### DevTools

  * DevTools frontend / log streams 在開啟失敗時更可靠，selector matching 現在也接受 `:nth-child(An+B)` formulas 中的空白。

  ### Activity Log

  * Activity Log buffers 在 ENOSPC drop-retry 後會恢復。

  ### Desktop

  * Device info 現在會回報正確的 home volume 與 OS version。
  * Native workers 會等 initialization 完成後才接收 commands，減少 slow model / audio workers 的 startup races。
  * 從 freshly bound device 建立 app 時，即使 screen details 尚未抵達也不再失敗。
  * DevTools selector 與 stream-opening 修正，以及上述 Generator、Data Bank、Property Bank、Dynamic Animation 與 runtime 修正，也適用於 Desktop Foundation。

  ### 改進項目

  * 其他穩定性改善。

  ### 向下相容性

  此版本與 v2.20、v2.21、v2.22、v2.23 與 v2.24 的應用程式保持相容。
</Update>

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

  * 許多 commands 現在會在 edge cases 回傳正確結果——包含 COLLECTION\_INCLUDES（以 value 比對 objects / arrays）、COLLECTION\_REDUCE、Union、Max / Min / Mean / Sum / GCD、OBJECT\_MAP\_KEYS / OBJECT\_MAP\_VALUES、XOR、STRING\_REPLACE（尊重 regex toggle，不符時原樣傳回）、integer conversion、IS\_DATETIME、Root command 與 color scale gamma。
  * async functions 與 methods 會保留 `this` 與 `arguments`，使用 `await` 的 async arrow functions 現在可執行，Concat 不再為未連線的輸入插入空項目，且當共用的 data node 在不同 maps 間 wire 不同 ports 時會保留 connections。

  ### Generators

  * Iterator Last / Previous / 負數 start 的修正，Tick generator 會保留 mapped 為 `0` / 空字串 / `false` 的 value，MQTT message events 會將 body 以 GENERATOR\_MQTT\_PAYLOAD / payload 形式提供。

  ### State groups

  * switch overrides 現在會執行正確的 event automation、套用至 rendered canvas，並在 force canvas change 後仍保留；被停用（commented）的 state group 不再阻擋後續的 state groups。

  ### Canvas & events

  * Change Canvas 在 canvas title 含 regex characters 時也能運作，單一項目的 Canvas Set 會 loop 回自身，`resetPopup` 的預設「all」會關閉每個開啟的 popup，targeting sibling item brick 的 events 不再被丟棄，one-time channel subscriptions 不再拆掉其他 subscriptions，Dynamic Animation 只評估 brick-target parameter。

  ### Data Bank & assets

  * 被移除的 Data Bank property 不再從 cache 重新出現，read-only routed values 不再被覆寫，Items paging 會尊重 page bounds，file uploads 會送出正確的 extension，Rive files 與 nested Items default images 會更可靠地 preload。

  ### Media

  * 在沒有 source 時 Video actions 會是安全的 no-op，Media Flow 的 Reset cache action 也會清除 cached box metadata，audio auto-cut 不再把 buffer padding 算成 audio，on-device vision inference 對僅有 image 的輸入也能運作。

  ### 修正

  * 匯入 brick snapshot 會還原 position 與 size，垂直 Text bricks 在 box 過小或 letter spacing 極端時不再 freeze，on-device tool calling 不再破壞 character classes，恢復 simulator Logs panel，native recordings 會寫入正確的 WAV header，packets 順序錯亂抵達時 config sync 更可靠。

  ### Desktop

  * 修正 embedded web view 中的 race，避免送往頁面的 messages 在頁面載入完成前遺失，尤其是快速載入的頁面。
  * Desktop file writes 不再破壞以 ascii-encoded byte arrays 傳入的 binary data。
  * 上述 Data Calculation、generator、canvas、event、automation 與 runtime 修正也適用於 Desktop Foundation。

  ### 改進項目

  * 其他穩定性改善。

  ### 向下相容性

  此版本與 v2.20、v2.21、v2.22、v2.23 與 v2.24 的應用程式保持相容。
</Update>

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

  * **Storage inspection** — DevTools Storage inspection 現在涵蓋 System storage、Data Bank stores、Generator cache 與 Generative Media cache，CLI clients 可取得可讀 values。

  ### 修正

  * **Property Bank** — PROPERTY\_BANK\_EXPRESSION errors 現在會說明不支援的 statement patterns，例如 `if`／`for`／`while` blocks 或 destructuring，不再只顯示模糊的 runtime failure。
  * 在 Mac 上執行的 iOS apps 現在會回報 Mac device names，不再回報 iPad names。

  ### Desktop

  * Embedded web views 在重新 render 後不再重複觸發 events。

  ### 改進項目

  * 其他穩定性改善。

  ### 向下相容性

  此版本與 v2.20、v2.21、v2.22、v2.23 與 v2.24 的應用程式保持相容。
</Update>

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

  * **Generator Apple STT** — contextual strings 可讓辨識偏向產品術語與專案專用詞，且 Apple STT 現在可作為 Realtime Transcription transcriber。
  * **Generator Sound Recorder** — Web 與 Desktop 麥克風擷取現在可自訂 echo cancellation、noise suppression 與 auto gain control。

  ### DevTools

  * 預設更精簡，隱藏不適合檢查 bricks 的面板與工具列控制項。
  * 連線在 disconnect 與過期 socket 關閉時更穩定。
  * 模擬點擊會尊重 disabled pressable Brick，並忽略過期的點擊競態。

  ### Desktop

  * **Generator Apple STT** — Desktop Foundation 現在支援 macOS 26+ 的 Apple speech recognition。

  ### 修正

  * **Property Bank** — 過期的更新 locks 逾時後會自動釋放，避免先前更新失敗後阻塞後續更新。

  ### 改進項目

  * 其他效能與穩定性改善。

  ### 向下相容性

  此版本與 v2.20、v2.21、v2.22、v2.23 與 v2.24 的應用程式保持相容。
</Update>

<Update label="2026 年 6 月 3 日" description="v2.24.6" tags={["發佈"]}>
  ### Generator

  * **Generator LLM (GGML)** — 升級 `llama.cpp` runtime 至 b9309。
  * **Generator Assistant** — Guardrails 改用 Jinja templates，支援 conversation history、結構化 tool args 與自訂 `redactReplacement`；before-LLM／after-LLM hooks 也會正確略過 tool-result continuation 與純 tool-call 回應。
  * **Generator LLM／Speech Inference／Reranker／VAD／TTS** — 共享本機 model contexts 現在會獨立追蹤每個 Generator 實例，釋放其中一個 Generator 不再破壞另一個使用同一 model 的 Generator。

  ### Web Preview / DevTools

  * DevTools CDP 連線更穩定：Server 啟動會重試暫時性的 port 探測失敗，重新連線後會忽略舊 client 事件，CLI 錯誤也會說明是否被另一個 DevTools session 取代。
  * Web Preview DevTools 開啟 Runtime console 時會顯示連線提示與 `usage()` 範例。
  * 透過 DevTools／preview 自動操作模擬鍵盤輸入時，即使底層平台同步回報 key event 也不再拋出例外。

  ### Desktop

  * **Web debug panel** — tab selector 現在會以 context menu 開啟，不再強制使用 TV 風格 tab strip。
  * **Web SerialPort** — close 會等待 reader loop 結束後再關閉，避免 locked-stream 錯誤。

  ### 修正

  * **Sound Recorder** — 重疊錄音 fragment 在結束前一段時不再清掉目前正在寫入的檔案。
  * **Voice transcription** — listeners 會在 transcription 開始時正確註冊。
  * **Property Bank** — command 初始化遇到缺失的 data-node entry 時會使用預設值，不再讓 runtime 崩潰。
  * **Subspace 渲染** — 會略過失效的 Brick 參照，避免 Canvas item 指到已刪除 Brick 時崩潰。

  ### 改進項目

  * 其他效能與穩定性改善。

  ### 向下相容性

  此版本與 v2.20、v2.21、v2.22、v2.23 與 v2.24 的應用程式保持相容。
</Update>

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

  * **Brick RichText** — 新增可選的 `renderMarkdown` 屬性，啟用後將 Markdown 內容透過既有的 render-html pipeline 渲染（首次使用時延遲載入解析器）。

  ### Generator

  * **Generator LLM (GGML)** — 升級 `llama.cpp` 至 b9254，並新增 MTP（multi-token prediction）推測解碼參數。
  * **Generator VAD (Traditional)** — 將 `processFloat32` 公開為公用方法，避免錄音器灌入區塊時即時偵測拋出例外。
  * **Generator LLM／Speech Inference** — 於 `releaseContext` 時清除過期的 [BRICKS Buttress](/zh-Hant/buttress) context，下一次請求會重新初始化，不再以「Context not initialized」失敗。

  ### Desktop

  * **Linux AppImage** — 在僅提供 `libfuse2t64` 的系統上自動安裝 `libfuse2`，若安裝失敗則改以軟失敗繼續執行。

  ### Web Preview

  * **沙箱化的 CDP `Runtime.evaluate`** — Console 指令改在已置空全域物件的 UnsafeEval scope 中執行，與 Launcher DevTools 伺服器一致，DevTools 探測不再能取得 host iframe 的 `document`／`window`。
  * **Preview-invoke 自動操作** — 處理 Config 就緒競爭，避免代理工具觸發的 preview 渲染顯示半初始化畫面。

  ### DevTools

  * Console 例外輸出不再於堆疊上方重複錯誤類別名稱。

  ### tvOS

  * 恢復 Applications 列表。

  ### 修正

  * 在 `setupAnimations` 中略過缺失的 `animationId` 參照（補強 v2.24.4 reducer 端的防護），避免帶有已刪除或重新命名 Animation 的 Config 在啟動時造成 React 子樹崩潰。

  ### 改進項目

  * 其他效能與穩定性改善。

  ### 向下相容性

  此版本與 v2.20、v2.21、v2.22、v2.23 與 v2.24 的應用程式保持相容。
</Update>

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

  * **可點選 Brick** — standby 過渡的包裝層不再攔截未設定 press 事件的 Brick 之點選，與 v2.24.3 的下層接收行為一致。

  ### Generator

  * **Generator Assistant** — 新增可設定的 guardrails，於 `before-llm`／`after-llm`／`before-tool`／`after-tool` 四個檢核點以 pattern 或 LLM 規則執行 `block`／`redact`／`log-only`，並內建預設的安全策略。
  * **Generator STT (GGML)** — 更新 `whisper.cpp` 執行階段。
  * **AI Filter** — 雲端模型陣容更新（Claude Sonnet 4.6 + Haiku 4.5、Gemini 3.1 Pro + 3 Flash preview、GPT-5.5 + 5.4 Mini/Nano）。

  ### Desktop

  * Desktop Launcher 的 DevTools frontend 預取不再失敗。
  * **Generator LLM (MLX)** — 於 Desktop／Web Preview 的 generator 表中註冊為 [BRICKS Buttress](/zh-Hant/buttress) 限定可用（原生 MLX 僅 iOS／tvOS 支援）。
  * Web Preview 截圖：避免文字在元件邊界被裁切。

  ### 修正

  * 跳過不合法的 `hit_regex`（例如僅 PCRE 支援的內嵌旗標）而不再導致 Data Bank 初始化崩潰。
  * 事件 Reducer 略過缺失的 animationId 參照，不再因失效的引用導致應用程式預覽啟動崩潰。

  ### 改進項目

  * 預載啟動更快：平行化逐檔的存在檢查。
  * 其他效能與穩定性改善。

  ### 向下相容性

  此版本與 v2.20、v2.21、v2.22、v2.23 與 v2.24 的應用程式保持相容。
</Update>

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

  * **Brick Image** — 新增帶色彩矩陣的濾鏡渲染。提供於 iOS、Android 與 Desktop。
  * **Brick Rect** — 未設定 press 事件的 Brick 不再攔截點選，會由下方 Brick 接收，而非被無作用的 Touchable 攔截。

  ### Desktop

  * 視窗拖曳改為原生實作，取代既有的拖曳覆蓋層；上方拖曳區可疊在 UI 之上而不影響底下按鈕點選。
  * macOS 應用程式選單新增 **Open System Menu** 項目。

  ### Generator

  * Generator LLM (GGML)：升級 llama.cpp runtime 至 b9084。

  ### 改進項目

  * 其他效能與穩定性改善。

  ### 向下相容性

  此版本與 v2.20、v2.21、v2.22、v2.23 與 v2.24 的應用程式保持相容。
</Update>

<Update label="2026 年 5 月 4 日" description="v2.24.2" tags={["發佈"]}>
  ### 重點功能

  * **Brick Sketch（Preview）** — 全新繪圖畫布，支援 Apple Pencil 壓感、復原／重做／橡皮擦／顏色／粗細工具列、可設定初始狀態並支援匯出圖片。詳見[核心參考](/zh-Hant/foundation/reference)。提供於 iOS、Android 與 Desktop（Apple Pencil 壓感僅限 iOS）。
  * **自架 DevTools 前端** — DevTools UI 改以 HTTP 提供，方便 LAN 內檢查；因 Chrome 已加固的 `devtools://` CSP 不再允許非 loopback 的 WebSocket 連線。詳見[本機除錯](/zh-Hant/foundation/local-debugging)。
  * **Realtime Transcription／Speech Inference 偵測語言** — Generator Realtime Transcription 與 Speech Inference 將偵測到的語言以新的 Outlets 與事件 payload 提供。

  ### 改進項目

  * 其他效能與穩定性改善。

  ### 向下相容性

  此版本與 v2.20、v2.21、v2.22、v2.23 與 v2.24 的應用程式保持相容。
</Update>

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

  * Generator LLM (OpenAI)：支援 OpenResponses API。
  * Brick GenerativeMedia：新增 OpenAI 圖片模型選擇。
  * 其他效能與穩定性改善。

  ### 向下相容性

  此版本與 v2.20、v2.21、v2.22、v2.23 與 v2.24 的應用程式保持相容。
</Update>

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

  * **DevTools CDP 整合** — 透過 Chrome DevTools Protocol（CDP）從 Chrome DevTools、Puppeteer 或 Playwright 檢查 BRICKS 應用程式。Network 面板涵蓋 iOS、Android、Desktop 與 Web Preview 的 HTTP、SSE、WebSocket、MQTT 與檔案下載活動；DOM 面板呈現 Brick 元件樹並提供 CSS 選擇器（`:pressable`、`:editable`、`:hidden`）；Input 支援按壓與文字輸入；Storage 可唯讀檢視系統儲存、[Data Bank](/zh-Hant/controller/data-bank) 與 generator 快取。詳見[本機除錯](/zh-Hant/foundation/local-debugging)。
  * **Generator LLM (MLX) — 原生支援** — 在 Apple Silicon 上原生執行裝置端 LLM/VLM 推理（iOS 17+ / tvOS），支援串流補全、模型載入/釋放與 tokenize/detokenize。此功能先前僅支援 BRICKS Buttress。
  * **Rect 模糊效果** — Rect 新增模糊屬性（`blurEnabled`、`blurVariant`、`blurType`、`blurAmount`），iOS 支援 progressive blur 與 Liquid Glass 變體，並相容 iOS、tvOS、Android、Web（Web 以 View fallback）。
  * **晉升為正式版** — **Brick GenerativeMedia**、**Brick Rive**、**Generator Realtime Transcription**、**Generator VAD Inference** 與 **Generator Vector Store** 現已進入正式版，詳見[核心參考](/zh-Hant/foundation/reference)。

  ### 重大變更

  * **Android 最低 SDK 提升至 26** — Android 8.0（API 26）現為最低支援版本。
  * **Generator STT (GGML)：移除 `transcribeRealtime`** — 請改用 Generator Realtime Transcription（現已正式）。

  ### 改進項目

  * Generator LLM (GGML)：升級 llama.cpp runtime 至 b8827
  * [Activity Log](/zh-Hant/foundation/activity-log)：支援定期擷取並上傳螢幕截圖
  * Brick Items：重新計算時保留 post-transform standby
  * Star 印表機：更新原生整合並改善穩定性
  * 為 RNBlobUtil 串流錯誤加上呼叫端脈絡標註，改善錯誤診斷（Desktop）
  * 修正 sync 在結果觸發前失敗時 Preload 停滯於 Preparing 的問題
  * 其他效能與穩定性改善

  ### 向下相容性

  此版本與 v2.20、v2.21、v2.22 與 v2.23 的應用程式保持相容。
</Update>
