From 35e72b13edbc38e3a985508edbffd2c6d0b480da Mon Sep 17 00:00:00 2001
From: lzt404 <2596933790@qq.com>
Date: Tue, 6 Oct 2026 13:28:05 +0800
Subject: [PATCH] Add the v0.3.24 release note

---
 docs/release-notes/v0.3.24/en.md    | 57 +++++++++++++++++++++++++++++
 docs/release-notes/v0.3.24/ja.md    | 57 +++++++++++++++++++++++++++++
 docs/release-notes/v0.3.24/zh-CN.md | 20 ++++++++++
 docs/release-notes/v0.3.24/zh-TW.md | 57 +++++++++++++++++++++++++++++
 4 files changed, 191 insertions(+)
 create mode 100644 docs/release-notes/v0.3.24/en.md
 create mode 100644 docs/release-notes/v0.3.24/ja.md
 create mode 100644 docs/release-notes/v0.3.24/zh-CN.md
 create mode 100644 docs/release-notes/v0.3.24/zh-TW.md

diff --git a/docs/release-notes/v0.3.24/en.md b/docs/release-notes/v0.3.24/en.md
new file mode 100644
index 0000000..d08a1c3
--- /dev/null
+++ b/docs/release-notes/v0.3.24/en.md
@@ -0,0 +1,57 @@
+## v0.3.24 Release Notes
+
+- This release continues the improvements to usage records and kernel configuration management. Suggestions and issue reports are welcome in the community chat or on GitHub.
+
+## Added
+
+- Added a Usage Records “Display Settings” panel. Users can choose visible columns and enable fixed record row heights. When enabled, the row height can be adjusted with a draggable slider; when disabled, rows fit their content automatically.
+- Usage Records pagination, visible columns, and column widths are now saved in the application data directory and restored after app updates.
+
+## Improved
+
+- Standardized the management-key wording as “Management Key” and “web management console” across the Chinese, English, and Japanese interfaces.
+- When the management key cannot be read or recovered as usable plaintext, the application uses `123456` as the recovery value and synchronizes it between GUI requests and the kernel configuration.
+- Clarified the Usage Records toolbar with “Show columns” and “Reset Widths” actions.
+
+## Fixed
+
+- Fixed startup failures after the v8 core rewrote the management key as a bcrypt/argon2 hash and the GUI tried to write its plaintext value back into the configuration.
+- Fixed valid v8 configurations producing a duplicate top-level `management` mapping during startup, preventing the kernel from starting ([Issue #351](https://github.com/router-for-me/EasyCLIProxyAPI/issues/351)).
+- Fixed Usage Records display settings being reset to defaults after an application update.
+## v0.3.22 Release Notes
+
+- The project is currently improving its UI. Suggestions and feedback are welcome in the community chat or on GitHub.
+
+## Added
+
+- Added quota reset support for Claude accounts.
+
+## Fixed
+
+- Fixed layout issues on the quota lookup page.
+
+## v0.3.21 Release Notes
+## Added
+
+- Added plugin management and a plugin store with support for installation, updates, version selection, enabling and disabling, uninstallation, configuration editing, and OAuth authorization provided by plugins.
+- Added Muse (Meta) OAuth device authorization, along with support for detecting and launching DeepSeek Harness Desktop on Windows.
+- Added support for custom system prompts for Codex models. Saved prompts are synchronized to the model catalog, and model defaults can be restored.
+- Added batch model health checks. Request records now show the actual response model and flag cases where it differs from the requested model.
+- Added per-request cost estimates and CSV export to request records. Reasoning effort is shown by default to make usage review and troubleshooting easier.
+
+## Improved
+
+- Updated the bundled CLIProxyAPI core to **8.0.13** and adapted the management API and configuration editor for v8.
+- Redesigned the dashboard, usage analytics, and main management pages with a consistent light theme, navigation, and table styling; improved dark-mode contrast and narrow-window layouts.
+- Reworked credential management into a compact list showing plans, status, request statistics, and quotas, with pagination, enable/disable controls, expandable details, and improved cooldown countdowns and reset operations.
+- Added more structured settings for requests, OAuth, plugins, concurrency, and providers; improved search, validation, conflict warnings, restoring defaults, and restart notices.
+- Added support in API access for native v8 provider groups and per-credential editing, deletion, and reordering. Model aliases are displayed in a separate tab.
+- Added search, pagination, and saved display preferences to the client list; expanded installation-path detection and prioritized installed clients.
+- Added “Install Bundled Core” to version management, allowing direct installation from the local core package included with the application.
+
+## Fixed
+
+- Fixed migration from v7 to v8 and migration of mixed-format configurations; improved preservation of keys, providers, model aliases, and custom fields, and prevented external refreshes from overwriting unsaved configuration drafts.
+- Fixed cooldown states being mixed up for same-named credentials from different accounts, and fixed OAuth model-exclusion updates affecting other providers.
+- Fixed cost aggregation when requests with different context lengths are combined, and improved the display of the coverage of cost estimates.
+- Fixed model-alias source validation and inconsistent Codex model ID usage; installed plugins and runtime data are now preserved when rebuilding portable distributions.
diff --git a/docs/release-notes/v0.3.24/ja.md b/docs/release-notes/v0.3.24/ja.md
new file mode 100644
index 0000000..27d531c
--- /dev/null
+++ b/docs/release-notes/v0.3.24/ja.md
@@ -0,0 +1,57 @@
+## v0.3.24 リリースノート
+
+- 使用量記録とコア設定管理を引き続き改善しました。ご提案や問題の報告は、グループチャットまたは GitHub でお知らせください。
+
+## 新機能
+
+- 使用量記録に「表示設定」を追加しました。表示する列を選択でき、レコードの行高を固定する設定も利用できます。有効にするとスライダーをドラッグして行高を調整でき、無効時は内容に合わせて自動調整します。
+- 使用量記録のページサイズ、表示列、列幅などの設定をアプリのデータフォルダーに保存し、アプリ更新後も復元するようにしました。
+
+## 改善
+
+- 中国語、英語、日本語の画面で、管理キーと Web 管理画面の表記を統一しました。
+- 管理キーを読み取れない、または利用可能な平文キーとして復元できない場合は、復旧値として `123456` を使用し、GUI のリクエストとコア設定で同じキーを使うようにしました。
+- 使用量記録の下部ツールバーに「表示する列」と「列幅をリセット」を追加し、操作内容を分かりやすくしました。
+
+## 修正
+
+- v8 コアが管理キーを bcrypt/argon2 ハッシュとして書き戻した後、GUI が平文キーを再度書き込むことで起動に失敗する問題を修正しました。
+- 正常な v8 設定でも起動時にトップレベルの `management` が重複し、コアを起動できなくなる問題を修正しました（[Issue #351](https://github.com/router-for-me/EasyCLIProxyAPI/issues/351)）。
+- アプリ更新後に使用量記録の表示設定が既定値へ戻る問題を修正しました。
+## v0.3.22 リリースノート
+
+- 現在、本プロジェクトでは UI の改善を進めています。ご提案やご意見がありましたら、グループチャットまたは GitHub でぜひお寄せください。
+
+## 新機能
+
+- Claude アカウントのクォータをリセットする機能を追加しました。
+
+## 修正
+
+- クォータ確認ページの UI レイアウトが崩れる問題を修正しました。
+
+## v0.3.21 リリースノート
+## 新機能
+
+- プラグイン管理とプラグインストアを追加しました。インストール、更新、バージョン選択、有効化・無効化、アンインストール、設定編集、およびプラグインが提供する OAuth 認証に対応します。
+- Muse（Meta）の OAuth デバイス認証を追加しました。Windows での DeepSeek Harness Desktop の検出と起動にも対応しました。
+- Codex モデルのシステムプロンプトをカスタマイズできるようになりました。保存時にモデルカタログへ同期され、モデルの既定値に戻すこともできます。
+- モデルの一括ヘルスチェックを追加しました。リクエスト履歴には実際の応答モデルを表示し、要求したモデルと異なる場合に通知します。
+- リクエスト記録にリクエスト単位の推定費用と CSV エクスポートを追加しました。推論レベルを既定で表示し、使用量の確認や問題の調査をしやすくしました。
+
+## 改善
+
+- 同梱の CLIProxyAPI コアを **8.0.13** に更新し、管理 API と設定エディターを v8 に対応させました。
+- ダッシュボード、使用量分析、主要な管理ページを刷新しました。ライトテーマ、ナビゲーション、表のスタイルを統一し、ダークモードのコントラストと狭いウィンドウでのレイアウトを改善しました。
+- 認証情報の管理をコンパクトな一覧に変更しました。プラン、状態、リクエスト統計、クォータをまとめて表示し、ページ切り替え、有効化・無効化、詳細の展開に対応するとともに、クールダウンの残り時間表示とリセット操作を改善しました。
+- リクエスト、OAuth、プラグイン、同時実行、プロバイダーの設定項目を拡充しました。検索、入力検証、競合の警告、既定値への復元、再起動の案内も改善しました。
+- API 接続で v8 ネイティブのプロバイダーグループと、認証情報ごとの編集・削除・並べ替えに対応しました。モデルエイリアスは専用タブに移動しました。
+- クライアント一覧に検索、ページ切り替え、表示設定の保存を追加しました。インストール先の検出範囲を広げ、インストール済みクライアントを優先して表示します。
+- バージョン管理に「同梱コアのインストール」を追加し、アプリに同梱されたローカルのコアパッケージから直接インストールできるようにしました。
+
+## 修正
+
+- v7 から v8 への移行および新旧の形式が混在する設定の移行を修正し、キー、プロバイダー、モデルエイリアス、カスタム項目などの保持を改善しました。外部からの更新で未保存の設定が上書きされる問題も修正しました。
+- 異なるアカウントの同名の認証情報でクールダウン状態が混同される問題と、OAuth のモデル除外設定の更新が他のプロバイダーに影響する問題を修正しました。
+- コンテキスト長が異なるリクエストをまとめて集計する際の費用計算を修正し、費用推定の対象範囲の表示を改善しました。
+- モデルエイリアスの参照元の検証と Codex モデル ID の不統一を修正しました。また、ポータブル版の再構築時にインストール済みプラグインと実行データを保持するようにしました。
diff --git a/docs/release-notes/v0.3.24/zh-CN.md b/docs/release-notes/v0.3.24/zh-CN.md
new file mode 100644
index 0000000..17b0652
--- /dev/null
+++ b/docs/release-notes/v0.3.24/zh-CN.md
@@ -0,0 +1,20 @@
+## v0.3.24 发布说明
+
+- 本版本继续完善使用记录和内核配置管理。如果您遇到问题或有改进建议，欢迎在群聊或 GitHub 提出。
+
+## 新增
+
+- 使用记录新增“显示设置”：可以选择要显示的列，并可开启“固定记录行高”。开启后可拖动滑块调整行高，关闭时记录会根据内容自动适应。
+- 使用记录的分页、显示列和列宽等偏好会保存到软件数据目录，应用更新后会自动恢复。
+
+## 优化
+
+- 管理密钥相关文案统一为“管理密钥”和“网页管理后台”，中、英、日语言保持同步。
+- 管理密钥设置在读取失败或无法恢复可用明文密钥时使用 `123456` 作为恢复值，并同步软件请求和内核配置，避免两边使用不同的密钥。
+- 使用记录底部工具栏改进为更清晰的“显示列”和“重置列宽”操作。
+
+## 修复
+
+- 修复内核 v8 已将管理密钥写成 bcrypt/argon2 哈希后，GUI 启动时再次写入明文导致配置渲染异常的问题。
+- 修复部分合法 v8 配置在启动时生成重复顶层 `management` 节点、导致内核无法启动的问题（[Issue #351](https://github.com/router-for-me/EasyCLIProxyAPI/issues/351)）。
+- 修复使用记录设置在应用更新后恢复为默认值的问题。
\ No newline at end of file
diff --git a/docs/release-notes/v0.3.24/zh-TW.md b/docs/release-notes/v0.3.24/zh-TW.md
new file mode 100644
index 0000000..0f61ef7
--- /dev/null
+++ b/docs/release-notes/v0.3.24/zh-TW.md
@@ -0,0 +1,57 @@
+## v0.3.24 發布說明
+
+- 本版本持續完善使用記錄與核心設定管理。歡迎在群組聊天或 GitHub 提出建議與問題回報。
+
+## 新增
+
+- 使用記錄新增「顯示設定」：可選擇要顯示的欄位，並可啟用「固定記錄行高」。啟用後可拖曳滑桿調整行高，關閉時記錄會依內容自動適應。
+- 使用記錄的分頁、顯示欄位與欄寬等偏好會儲存在應用程式資料目錄，更新應用程式後會自動恢復。
+
+## 改善
+
+- 統一中文、英文與日文介面的「管理密鑰」及「網頁管理後台」用語。
+- 當管理密鑰讀取失敗或無法恢復為可用的明文密鑰時，使用 `123456` 作為恢復值，並同步 GUI 請求與核心設定中的密鑰。
+- 使用記錄底部工具列改為更清楚的「顯示欄位」與「重設欄寬」操作。
+
+## 修正
+
+- 修正 v8 核心將管理密鑰寫成 bcrypt/argon2 雜湊後，GUI 再次寫入明文導致啟動失敗的問題。
+- 修正部分有效的 v8 設定在啟動時產生重複頂層 `management` 節點、導致核心無法啟動的問題（[Issue #351](https://github.com/router-for-me/EasyCLIProxyAPI/issues/351)）。
+- 修正應用程式更新後使用記錄顯示設定恢復為預設值的問題。
+## v0.3.22 發布說明
+
+- 本專案近期正在改善 UI，歡迎在群組聊天或 GitHub 提出建議與意見。
+
+## 新增
+
+- 新增 Claude 帳號的額度重設功能。
+
+## 修正
+
+- 修正額度查詢頁面的 UI 排版混亂問題。
+
+## v0.3.21 發布說明
+## 新增
+
+- 新增外掛管理與外掛商店，支援安裝、更新、選擇版本、啟用與停用、解除安裝及編輯設定，並整合外掛提供的 OAuth 授權。
+- 新增 Muse（Meta）OAuth 裝置授權；支援在 Windows 上偵測並啟動 DeepSeek Harness Desktop。
+- 支援自訂 Codex 模型的系統提示詞，儲存後同步至模型目錄，並可還原模型預設值。
+- 新增批次模型健康檢查；請求記錄顯示實際回應模型，並提示請求模型與回應模型不一致的情況。
+- 請求記錄新增單次請求費用估算與 CSV 匯出，預設顯示推理等級，方便核對用量與排查問題。
+
+## 改善
+
+- 內建 CLIProxyAPI 核心升級至 **8.0.13**，管理介面與設定編輯適配 v8。
+- 重新設計首頁、用量分析及主要管理頁面，統一淺色主題、導覽與表格樣式，改善深色模式對比度及窄視窗版面。
+- 憑證管理改為精簡列表，集中顯示方案、狀態、請求統計與配額，支援分頁、啟用與停用及展開詳細資料，並完善冷卻倒數與重設操作。
+- 進階設定新增更多結構化設定項目，涵蓋請求、OAuth、外掛、並行處理與服務供應商設定；完善搜尋、驗證、衝突提示、還原預設值及重新啟動提示。
+- API 接入支援 v8 原生服務供應商群組，以及逐筆憑證編輯、刪除與排序，模型別名改於獨立分頁顯示。
+- 用戶端列表支援搜尋、分頁及儲存顯示偏好，擴充安裝路徑偵測並優先顯示已安裝的用戶端。
+- 版本管理提供「安裝內建核心」，可直接使用應用程式隨附的本機核心套件。
+
+## 修正
+
+- 修正 v7 升級至 v8 及混合格式設定的遷移問題，改善金鑰、服務供應商、模型別名、自訂欄位等設定的保留，並避免外部重新整理覆蓋尚未儲存的設定草稿。
+- 修正不同帳號的同名憑證冷卻狀態混淆，以及更新 OAuth 模型排除設定時影響其他服務供應商的問題。
+- 修正混合統計不同上下文長度請求時的費用彙總，改善費用估算涵蓋範圍的顯示。
+- 修正模型別名來源驗證與 Codex 模型 ID 使用不一致的問題，並在重建可攜版時保留已安裝的外掛及執行資料。