# v0.28.22 Release Notes

> v0.28.21 → v0.28.22

## Summary

Reshapes calculation requests around batched work and clarifies runtime configuration boundaries. The terminal interface gains faster model discovery while file-query operations share a more consistent foundation.

<details>
<summary>翻譯</summary>

將計算請求調整為批次工作模式，並釐清執行期設定的責任邊界。終端介面新增更快速的模型查詢能力，檔案查詢操作也改以更一致的基礎實作。

</details>

## ⚠️ Breaking Changes

### Calculation requests use `expressions`

**Before:**
```json
{"expression":"1 + 1"}
```

**After:**
```json
{"expressions":["1 + 1"]}
```

**Migration:** Replace every single `expression` string with an `expressions` array. Read result values from the returned object by expression string.

<details>
<summary>翻譯</summary>

計算請求改用 `expressions` 陣列。請將所有單一 `expression` 字串替換為 `expressions` 陣列，並以算式字串作為鍵自回傳物件讀取結果。

</details>

### Read-only command configuration renamed

**Before:** Use the `white_command.json` configuration name and its corresponding runtime setting.

**After:** Use `read_only_command.json` and the renamed read-only command configuration.

**Migration:** Rename custom configuration files and update every reference to the new read-only command configuration name before starting the runtime.

<details>
<summary>翻譯</summary>

唯讀命令設定已重新命名。請重新命名自訂設定檔，並在啟動執行期前將所有引用更新為新的唯讀命令設定名稱。

</details>

## Changes

### BREAKING
- Replace single calculation input with batch expressions API (@pardnchiu) [58b3dda]
- Rename white command config to read-only command configuration (@pardnchiu) [fd6d2ac]

<details>
<summary>翻譯</summary>

- 將單一計算輸入改為批次 expressions API。
- 將白名單命令設定重新命名為唯讀命令設定。

</details>

### FEAT
- Add a TUI shortcut to list configured models (@pardnchiu) [17c0ce5]

<details>
<summary>翻譯</summary>

- 新增列出已設定模型的 TUI 快捷指令。

</details>

### UPDATE
- Add documentation and adjust TUI rendering and file-open permissions (@pardnchiu) [a8b43dc]

<details>
<summary>翻譯</summary>

- 新增文件，並調整 TUI 渲染與檔案開啟權限。

</details>

### REFACTOR
- Extract file-query helpers and clarify tool batching guidance (@pardnchiu) [6457866]

<details>
<summary>翻譯</summary>

- 抽取檔案查詢輔助函式，並釐清工具批次處理指引。

</details>

## Scope

- `internal/tools/calculate/` — BREAKING
- `configs/jsons/`, `internal/filesystem/`, `internal/agents/exec/` — BREAKING
- `internal/runtime/tui/` — FEAT, UPDATE
- `internal/tools/file/` — REFACTOR
- `doc/`, `internal/tools/openFile.go` — UPDATE

***

Generated by [SKILL](https://github.com/pardnchiu/skill-version-generate)