docs: add v3.12.0 CHANGELOG and release notes (zh/en/ja)

CHANGELOG.md

@@ -9,6 +9,127 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [3.12.0] - 2026-03-09
+
+### Feature Release
+
+This release restores the **Model Health Check (Stream Check)** UI, adds **OpenAI Responses API** format conversion, introduces the **Bedrock Optimizer** for thinking + cache injection, expands provider presets (Ucloud, Micu, X-Code API, Novita, Bailian For Coding), overhauls **OpenClaw config panels** with a JSON5 round-trip write engine, enhances **WebDAV sync** with dual-layer versioning, and delivers a comprehensive **i18n audit** fixing 69 missing keys alongside 20+ bug fixes.
+
+**Stats**: 56 commits | 221 files changed | +20,582 insertions | -8,026 deletions
+
+### Added
+
+#### Stream Check (Model Health Check)
+
+- **Restore Stream Check UI**: Brought back the model health check (Stream Check) panel for testing provider endpoint availability with live streaming validation
+- **First-Run Confirmation**: Added a confirmation dialog on first use of Stream Check to inform users about the feature's purpose and network requests
+- **OpenAI Chat Format Support**: Stream Check now supports `openai_chat` api_format, enabling health checks for providers using OpenAI-compatible endpoints
+
+#### OpenAI Responses API
+
+- **Responses API Format Conversion**: New `api_format = "openai_responses"` option enabling Anthropic Messages ↔ OpenAI Responses API bidirectional conversion for providers that implement the Responses API
+- **Responses API Deduplication**: Deduplicated and improved the Responses API conversion logic, consolidating shared transformation code
+
+#### Bedrock Optimizer
+
+- **Bedrock Request Optimizer**: PRE-SEND optimizer that injects thinking parameters and cache control blocks into AWS Bedrock requests, enabling extended thinking and prompt caching on Bedrock endpoints (#1301)
+
+#### OpenClaw Enhancements
+
+- **JSON5 Round-Trip Write Engine**: Overhauled OpenClaw config panels with a JSON5 round-trip write engine that preserves comments, formatting, and ordering when saving configuration changes
+- **Config Panel Improvements**: Redesigned EnvPanel as a full JSON editor, added `tools.profile` selection to ToolsPanel, introduced OpenClawHealthBanner for config validation warnings, and added legacy timeout migration support in Agents Defaults
+- **Agent Model Dropdown**: Replaced text inputs with dropdown selects for OpenClaw agent model configuration, offering a curated list of available models
+- **User-Agent Toggle**: Added a User-Agent header toggle for OpenClaw, defaulting to off to avoid potential compatibility issues with certain providers
+
+#### Provider Presets
+
+- **Ucloud**: Added Ucloud partner provider preset for Claude, Codex, and OpenClaw with endpointCandidates, unified apiKeyUrl, refreshed model defaults, and OpenClaw `templateValues` / `suggestedDefaults`
+- **Micu**: Added Micu partner provider preset for Claude, Codex, OpenClaw, and OpenCode with OpenClaw `templateValues` / `suggestedDefaults`
+- **X-Code API**: Added X-Code API partner provider preset for Claude, Codex, and OpenCode with endpointCandidates
+- **Novita**: Added Novita provider presets and icon across all supported apps (#1192)
+- **Bailian For Coding**: Added Bailian For Coding preset configuration (#1263)
+- **SiliconFlow Partner Badge**: Added partner badge designation for SiliconFlow provider presets
+- **Model Role Badges**: Added model role badges (e.g., Opus, Sonnet) to provider presets and reordered presets to prioritize Opus models
+
+#### WebDAV Sync
+
+- **Dual-Layer Versioning**: Added protocol v2 + db-v6 dual-layer versioning to WebDAV sync, enabling backward-compatible sync format evolution and automatic migration detection
+- **Auto-Sync Confirmation**: Added a confirmation dialog when toggling WebDAV auto-sync on/off to prevent accidental changes
+
+#### Usage & Data
+
+- **Daily Rollups & Auto-Vacuum**: Added usage daily rollups for aggregated statistics, incremental auto-vacuum for storage management, and sync-aware backup that coordinates with WebDAV sync cycles
+- **UsageFooter Extra Fields**: Added extra field display in UsageFooter component for normal mode, showing additional usage metadata (#1137)
+
+#### Session Management
+
+- **Session Deletion**: Added session deletion with per-provider cleanup and path safety validation, allowing users to remove individual conversation sessions
+
+#### UI & Config
+
+- **Auth Field Selector**: Restored Claude provider auth field selector supporting both AUTH_TOKEN and API_KEY authentication modes
+- **Failover Toggle**: Moved failover toggle to display independently on the main page with a confirmation dialog for enabling/disabling
+- **Common Config Auto-Extract**: Auto-extract Common Config Snippets from live configuration files on first run, seeding initial common config without manual setup
+- **New Provider Page Improvements**: Improved the new provider page with API endpoint and model name fields (#1155)
+
+### Changed
+
+#### Architecture
+
+- **Common Config Runtime Overlay**: Common Config is now applied as a runtime overlay during provider switching instead of being materialized (merged) into each provider's stored config. This preserves the original provider config in the database and applies common settings dynamically at write time
+- **First-Run Auto-Extract**: On first run, Common Config Snippets are automatically extracted from the current live configuration files, eliminating the need for manual initial setup
+
+### Fixed
+
+#### Proxy & Streaming
+
+- **OpenAI Streaming Conversion**: Fixed OpenAI ChatCompletion → Anthropic Messages streaming conversion that could produce malformed events under certain response structures
+- **Codex /responses/compact Route**: Added support for Codex `/responses/compact` route in proxy forwarding (#1194)
+- **Codex Common Config TOML Merge**: Fixed Codex Common Config to use structural TOML merge/subset instead of raw string comparison, correctly handling key ordering and formatting differences
+- **Proxy Forwarder Failure Logs**: Improved proxy forwarder failure logging with more descriptive error messages
+
+#### Provider & Preset
+
+- **X-Code Rename**: Renamed "X-Code" provider to "X-Code API" for consistency with the official branding
+- **SSSAiCode Missing /v1**: Added missing `/v1` path to SSSAiCode default endpoint for Codex and OpenCode
+- **AICoding URL Fix**: Removed `www` prefix from aicoding.sh provider URLs to match the correct domain
+- **New Provider Page Input Handling**: Fixed the new provider page so API endpoint / model fields handle line-break deletion correctly and added the missing `codexConfig.modelNameHint` i18n key for zh/en/ja
+
+#### Platform
+
+- **Cache Hit Token Statistics**: Fixed missing token statistics for cache hits in streaming responses (#1244)
+- **Minimize-to-Tray Auto Exit**: Fixed issue where the application would automatically exit after being minimized to the system tray for a period of time (#1245)
+
+#### i18n & Localization
+
+- **Comprehensive i18n Audit**: Added 69 missing i18n keys and fixed hardcoded Chinese strings across the application, improving localization coverage for all three languages (zh/en/ja)
+- **Model Test Panel i18n**: Corrected i18n key paths for model test panel title and description
+- **JSON5 Slash Escaping**: Normalized JSON5 slash escaping and added i18n support for OpenClaw panel labels
+
+#### UI
+
+- **Skills Count Display**: Fixed skills count not displaying correctly when adding new skills (#1295)
+- **Endpoint Speed Test**: Removed HTTP status code display from endpoint speed test results to reduce visual noise
+- **Outline Button Text Tone**: Aligned outline button text color tone with usage refresh control for visual consistency (#1222)
+
+### Performance
+
+- **OpenClaw Config Write Skip**: Skip backup and atomic write when OpenClaw configuration content is unchanged, avoiding unnecessary I/O operations
+
+### Documentation
+
+- **User Manual i18n**: Restructured user manual for internationalization and added complete EN/JA translations alongside the existing ZH documentation
+- **User Manual OpenClaw**: Added OpenClaw coverage and completed settings documentation for the user manual
+- **UCloud CompShare Sponsor**: Added UCloud CompShare as a sponsor partner
+- **Docs Directory Reorganization**: Reorganized docs directory structure, added user manual links to all three README files, removed cross-language links from user manual sections, and synced README features across EN/ZH/JA
+
+### Maintenance
+
+- **Periodic Maintenance Timer**: Consolidated periodic maintenance timers into a unified scheduler, combining vacuum and rollup operations into a single timer
+- **OpenClaw Save Toast**: Removed backup path display from OpenClaw save toasts for cleaner notification messages
+
+---
+
 ## [3.11.1] - 2026-02-28
 
 ### Hotfix Release

docs/release-notes/v3.12.0-en.md

@@ -0,0 +1,238 @@
+# CC Switch v3.12.0
+
+> Stream Check Returns, OpenAI Responses API Arrives, and OpenClaw / WebDAV Get a Major Upgrade
+
+**[中文版 →](v3.12.0-zh.md) | [日本語版 →](v3.12.0-ja.md)**
+
+---
+
+## Overview
+
+CC Switch v3.12.0 is a feature release focused on provider compatibility, OpenClaw editing, Common Config usability, and sync/data reliability. It restores the **Model Health Check (Stream Check)** UI with improved stability, adds **OpenAI Responses API** format conversion, expands provider presets for **Ucloud**, **Micu**, **X-Code API**, **Novita**, and **Bailian For Coding**, and upgrades **WebDAV sync** with dual-layer versioning.
+
+**Release Date**: 2026-03-09
+
+**Update Scale**: 56 commits | 221 files changed | +20,582 / -8,026 lines
+
+---
+
+## Highlights
+
+- **Stream Check returns**: Restored the model health check UI, added first-run confirmation, and fixed `openai_chat` provider support
+- **OpenAI Responses API**: Added `api_format = "openai_responses"` with bidirectional conversion and shared conversion cleanup — simply select the Responses API format when adding a provider and enable proxy takeover, and you can use GPT-series models in Claude Code!
+- **OpenClaw overhaul**: Introduced JSON5 round-trip config editing, a config health banner, better agent model selection, and a User-Agent toggle
+- **Preset expansion**: Added Ucloud, Micu, X-Code API, Novita, and Bailian For Coding updates, plus SiliconFlow partner badge and model-role badges
+- **Sync and maintenance improvements**: Added WebDAV protocol v2 + db-v6 versioning, daily rollups, incremental auto-vacuum, and sync-aware backup
+- **Common Config usability improvements**: After updating a Common Config Snippet, it is now automatically applied when switching providers — no more manual checkbox needed
+
+---
+
+## Main Features
+
+### Model Health Check (Stream Check)
+
+Restored the Stream Check panel for live provider validation, improving the reliability of provider management.
+
+- Restored Stream Check UI panel with single and batch provider availability testing
+- Added first-run confirmation dialog to prevent unsupported providers from showing misleading errors
+- Fixed detection compatibility for `openai_chat` API format providers
+
+### OpenAI Responses API
+
+Added native support for providers using the OpenAI Responses API with a new `openai_responses` API format.
+
+- New `api_format = "openai_responses"` provider format option
+- Bidirectional Anthropic Messages <-> OpenAI Responses API format conversion
+- Consolidated shared conversion logic to reduce code duplication
+
+### Bedrock Request Optimizer
+
+Added a PRE-SEND phase request optimizer for AWS Bedrock providers to improve compatibility and performance.
+
+- PRE-SEND thinking + cache injection optimizer (#1301, thanks @keithyt06)
+
+### OpenClaw Config Enhancements
+
+Comprehensive upgrade to the OpenClaw configuration editing experience with richer management capabilities.
+
+- JSON5 round-trip write-back: preserves comments and formatting when editing configs
+- EnvPanel JSON editing mode and `tools.profile` selection support
+- New config validation warnings and config health status checks
+- Improved agent model dropdown with recommended model fill from provider presets
+- User-Agent toggle: optionally append OpenClaw identifier to requests (defaults to off)
+- Legacy timeout configuration auto-migration
+
+### Provider Presets
+
+New and expanded provider presets covering more providers and use cases.
+
+- **Ucloud**: Added `endpointCandidates` and OpenClaw defaults, refreshed `templateValues` / `suggestedDefaults`
+- **Micu**: Added preset defaults and OpenClaw recommended models
+- **X-Code API**: Added Claude presets and `endpointCandidates`
+- **Novita**: New provider preset (#1192, thanks @Alex-wuhu)
+- **Bailian For Coding**: New provider preset (#1263, thanks @suki135246)
+- **SiliconFlow**: Added partner badge
+- **Model Role Badges**: Provider presets now support model-role badge display
+
+### WebDAV Sync Enhancements
+
+WebDAV sync introduces dual-layer versioning for improved sync reliability and data safety.
+
+- New WebDAV protocol v2 + db-v6 dual-layer versioning
+- Confirmation dialog when toggling WebDAV auto-sync on/off to prevent accidental changes
+- Sync-aware backup: uses a sync-specific backup variant that skips local-only table data
+
+### Usage & Data
+
+Enhanced usage statistics and data maintenance capabilities for finer-grained data management, significantly reducing database growth rate.
+
+- Daily rollups: aggregate usage data by day to reduce storage overhead
+- Auto-vacuum: incremental database cleanup to maintain database health
+- UsageFooter extra statistics fields (#1137, thanks @bugparty)
+
+### Other New Features
+
+- **Session Deletion**: Per-provider session cleanup with path safety validation
+- **Claude Auth Field Selector**: Restored authentication field selector
+- **Failover Toggle on Main Page**: Moved the failover toggle to display independently on the main page with a first-use confirmation dialog
+- **Common Config Auto-Extract**: On first run, automatically extracts common config snippets from live config files
+- **New Provider Page Improvements**: Improved new provider page experience (#1155, thanks @wugeer)
+
+---
+
+## Architecture Improvements
+
+### Common Config Runtime Overlay
+
+Common Config Snippets are now applied as a runtime overlay instead of being materialized into stored provider configs.
+
+**Before**: Common Config content was merged directly into each provider's `settings_config` on save or switch. This caused shared configuration to be duplicated across every provider entry, requiring manual sync when changes were needed.
+
+**After**: Common Config is only injected as a runtime overlay when switching providers and writing to the live file — provider entries themselves no longer contain shared configuration. This means modifying Common Config takes effect immediately without updating each provider individually.
+
+### Common Config Auto-Extract
+
+On first run, if no Common Config Snippet exists in the database, one is automatically extracted from the current live config. This ensures users upgrading from older versions do not lose their existing shared configuration settings.
+
+### Periodic Maintenance Timer Consolidation
+
+Consolidated daily rollups and auto-vacuum into a unified periodic maintenance timer, eliminating resource contention and complexity from multiple independent timers.
+
+---
+
+## Bug Fixes
+
+### Proxy & Streaming
+
+- Fixed OpenAI ChatCompletion -> Anthropic Messages streaming conversion
+- Added Codex `/responses/compact` route support (#1194, thanks @Tsukumi233)
+- Improved TOML config merge logic to prevent key-value loss
+- Improved proxy forwarder failure logs with additional diagnostic information
+
+### Provider & Preset Fixes
+
+- Renamed X-Code to X-Code API for consistent branding
+- Fixed SSSAiCode `/v1` path issue
+- Removed incorrect `www` prefix from AICoding URLs
+- Fixed new provider page line-break deletion issue (#1155, thanks @wugeer)
+
+### Platform Fixes
+
+- Fixed cache hit token statistics not being reported (#1244, thanks @a1398394385)
+- Fixed minimize-to-tray causing auto exit after some time (#1245, thanks @YewFence)
+
+### i18n Fixes
+
+- Added 69 missing translation keys and removed remaining hardcoded Chinese strings
+- Fixed model test panel i18n issues
+- Normalized JSON5 slash escaping to prevent i18n string parsing errors
+
+### UI Fixes
+
+- Fixed Skills count display (#1295, thanks @fzzv)
+- Removed HTTP status code display from endpoint speed test to reduce visual noise
+- Fixed outline button styling (#1222, thanks @Sube-py)
+
+---
+
+## Performance
+
+- Skip unnecessary OpenClaw config writes when config is unchanged, reducing disk I/O
+
+---
+
+## Documentation
+
+- Restructured the user manual for i18n and added complete EN/JA coverage
+- Added OpenClaw usage documentation and completed settings documentation
+- Added UCloud sponsor information
+- Reorganized the docs directory and synced README feature sections across EN/ZH/JA
+
+---
+
+## Notes & Considerations
+
+- **Common Config now uses runtime overlay**: Common Config Snippets are no longer materialized into each provider's stored config. They are dynamically applied at switch time. Modifying Common Config takes effect immediately without updating each provider.
+- **Stream Check requires first-use confirmation**: A confirmation dialog appears when using the model health check for the first time. Testing proceeds only after confirmation.
+- **OpenClaw User-Agent toggle defaults to off**: The User-Agent identifier must be manually enabled in the OpenClaw configuration.
+
+---
+
+## Special Thanks
+
+Thanks to all contributors for their contributions to this release!
+
+@keithyt06 @bugparty @Alex-wuhu @suki135246 @Tsukumi233 @wugeer @fzzv @Sube-py @a1398394385 @YewFence
+
+---
+
+## Download & Installation
+
+Visit [Releases](https://github.com/farion1231/cc-switch/releases/latest) to download the appropriate version.
+
+### System Requirements
+
+| System  | Minimum Version                 | Architecture                        |
+| ------- | ------------------------------- | ----------------------------------- |
+| Windows | Windows 10 or later             | x64                                 |
+| macOS   | macOS 10.15 (Catalina) or later | Intel (x64) / Apple Silicon (arm64) |
+| Linux   | See table below                 | x64                                 |
+
+### Windows
+
+| File                                     | Description                                          |
+| ---------------------------------------- | ---------------------------------------------------- |
+| `CC-Switch-v3.12.0-Windows.msi`          | **Recommended** - MSI installer with auto-update     |
+| `CC-Switch-v3.12.0-Windows-Portable.zip` | Portable version, extract and run, no registry write |
+
+### macOS
+
+| File                             | Description                                                          |
+| -------------------------------- | -------------------------------------------------------------------- |
+| `CC-Switch-v3.12.0-macOS.zip`    | **Recommended** - Extract and drag to Applications, Universal Binary |
+| `CC-Switch-v3.12.0-macOS.tar.gz` | For Homebrew installation and auto-update                            |
+
+> **Note**: Since the author doesn't have an Apple Developer account, you may see an "unidentified developer" warning on first launch. Please close it, then go to "System Settings" -> "Privacy & Security" -> click "Open Anyway", and it will open normally afterwards.
+
+### Homebrew (macOS)
+
+```bash
+brew tap farion1231/ccswitch
+brew install --cask cc-switch
+```
+
+Update:
+
+```bash
+brew upgrade --cask cc-switch
+```
+
+### Linux
+
+| Distribution                            | Recommended Format | Installation Method                                                    |
+| --------------------------------------- | ------------------ | ---------------------------------------------------------------------- |
+| Ubuntu / Debian / Linux Mint / Pop!\_OS | `.deb`             | `sudo dpkg -i CC-Switch-*.deb` or `sudo apt install ./CC-Switch-*.deb` |
+| Fedora / RHEL / CentOS / Rocky Linux    | `.rpm`             | `sudo rpm -i CC-Switch-*.rpm` or `sudo dnf install ./CC-Switch-*.rpm`  |
+| openSUSE                                | `.rpm`             | `sudo zypper install ./CC-Switch-*.rpm`                                |
+| Arch Linux / Manjaro                    | `.AppImage`        | Add execute permission and run directly, or use AUR                    |
+| Other distributions / Unsure            | `.AppImage`        | `chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage`              |

docs/release-notes/v3.12.0-ja.md

@@ -0,0 +1,238 @@
+# CC Switch v3.12.0
+
+> Stream Check が復活し、OpenAI Responses API に対応、OpenClaw と WebDAV も大幅強化
+
+**[中文版 →](v3.12.0-zh.md) | [English →](v3.12.0-en.md)**
+
+---
+
+## 概要
+
+CC Switch v3.12.0 は、プロバイダー互換性、OpenClaw の設定編集、共通設定の使い勝手、同期とデータ保守性を強化する機能リリースです。安定性を強化した **Model Health Check (Stream Check)** UI を復元し、**OpenAI Responses API** 形式変換を追加、**Ucloud**、**Micu**、**X-Code API**、**Novita**、**Bailian For Coding** などのプリセットを拡張し、**WebDAV 同期** に二層バージョニングを導入しました。
+
+**リリース日**: 2026-03-09
+
+**更新規模**: 56 commits | 221 files changed | +20,582 / -8,026 lines
+
+---
+
+## ハイライト
+
+- **Stream Check 復活**: モデルヘルスチェック UI を復元し、初回確認ダイアログを追加、`openai_chat` プロバイダー対応も修正
+- **OpenAI Responses API**: `api_format = "openai_responses"` を追加し、双方向変換と共有変換ロジックの整理を実施 — プロバイダー追加時に Responses API フォーマットを選択してプロキシテイクオーバーを有効にするだけで、Claude Code で GPT シリーズモデルが使えます！
+- **OpenClaw パネル強化**: JSON5 round-trip 編集、設定ヘルスバナー、改良された Agent Model 選択、User-Agent トグルを導入
+- **プリセット拡張**: Ucloud、Micu、X-Code API、Novita、Bailian For Coding を追加・更新し、SiliconFlow partner badge とモデルロールバッジも追加
+- **同期と保守の改善**: WebDAV protocol v2 + db-v6、daily rollups、incremental auto-vacuum、sync-aware backup を追加
+- **共通設定の使い勝手向上**: 共通設定スニペットを更新すると、プロバイダー切り替え時に自動的に反映されるようになりました。手動でチェックを入れ直す必要はありません
+
+---
+
+## 主な機能
+
+### モデルヘルスチェック (Stream Check)
+
+Stream Check パネルを復元し、プロバイダーの可用性をリアルタイムで検証できるようにしました。
+
+- Stream Check UI パネルを復元し、単一またはバッチでのプロバイダー可用性検出をサポート
+- 初回使用確認ダイアログを追加、ヘルスチェック非対応プロバイダーの誤検出によるユーザー混乱を防止
+- `openai_chat` API フォーマットプロバイダーの検出互換性を修正
+
+### OpenAI Responses API
+
+新しい `openai_responses` API フォーマットを追加し、OpenAI Responses API を使用するプロバイダーのネイティブサポートを提供します。
+
+- `api_format = "openai_responses"` プロバイダーフォーマットオプションを追加
+- Anthropic Messages <-> OpenAI Responses API の双方向フォーマット変換をサポート
+- 共有変換ロジックを整理し、重複コードを削減
+
+### Bedrock リクエストオプティマイザー
+
+AWS Bedrock プロバイダー向けに PRE-SEND フェーズのリクエスト最適化を追加し、互換性とパフォーマンスを向上させました。
+
+- PRE-SEND thinking + cache injection オプティマイザー（#1301、@keithyt06 に感謝）
+
+### OpenClaw 設定強化
+
+OpenClaw の設定編集体験を全面的にアップグレードし、より豊富な設定管理をサポートします。
+
+- JSON5 round-trip 書き戻し: 編集時にコメントとフォーマットを保持
+- EnvPanel の JSON 編集モードと `tools.profile` 選択をサポート
+- 設定検証バナーと設定ヘルスステータスチェックを追加
+- Agent モデルのドロップダウン改善、プロバイダープリセットから推奨モデルを自動入力
+- User-Agent トグル: リクエストに OpenClaw 識別子を付加する機能（デフォルトオフ）
+- Legacy timeout 設定の自動マイグレーション
+
+### プロバイダープリセット
+
+新規および既存のプロバイダープリセットを拡張し、より多くのプロバイダーとユースケースをカバーします。
+
+- **Ucloud**: `endpointCandidates` および OpenClaw デフォルト値を追加、`templateValues` / `suggestedDefaults` を更新
+- **Micu**: プリセットデフォルト値および OpenClaw 推奨モデルを追加
+- **X-Code API**: Claude プリセットおよび `endpointCandidates` を追加
+- **Novita**: プロバイダープリセットを追加（#1192、@Alex-wuhu に感謝）
+- **Bailian For Coding**: プロバイダープリセットを追加（#1263、@suki135246 に感謝）
+- **SiliconFlow**: partner badge 識別を追加
+- **モデルロールバッジ**: プロバイダープリセットでモデルロール badge 表示をサポート
+
+### WebDAV 同期強化
+
+WebDAV 同期に二層バージョン管理を導入し、同期の信頼性とデータ安全性を向上させました。
+
+- WebDAV protocol v2 + db-v6 二層バージョン管理を追加
+- WebDAV auto-sync の切り替え時に確認ダイアログを表示し、誤操作を防止
+- sync-aware backup: 同期時にローカル専用テーブルを除外した sync バリアントバックアップを使用
+
+### 使用量とデータ
+
+使用量統計とデータ保守機能を強化し、より精密なデータ管理を実現、データベースの増加速度を大幅に抑制します。
+
+- Daily rollups: 日次で使用量データを集計し、ストレージ使用量を削減
+- Auto-vacuum: インクリメンタルなデータベースクリーンアップ、データベースの健全性を維持
+- UsageFooter に追加統計フィールドを追加（#1137、@bugparty に感謝）
+
+### その他の新機能
+
+- **セッション削除**: プロバイダー単位のクリーンアップとパス安全性検証付きのセッション削除
+- **Claude auth field selector 復元**: 認証フィールドセレクターを復元
+- **Failover トグルをメインページへ移動**: failover toggle を設定パネルからメインページに独立表示し、初回確認ダイアログを追加
+- **共通設定の自動抽出**: 初回起動時に live config から共通設定スニペットを自動抽出
+- **新規プロバイダーページの改善**: 新規プロバイダーページの体験を最適化（#1155、@wugeer に感謝）
+
+---
+
+## アーキテクチャ改善
+
+### Common Config ランタイムオーバーレイ
+
+共通設定スニペット（Common Config Snippet）をランタイムオーバーレイ方式に変更し、保存済みプロバイダー設定への物理マージを廃止しました。
+
+**変更前**: Common Config の内容は保存時または切り替え時に各プロバイダーの `settings_config` に直接マージされていました。これにより共通設定が各プロバイダーエントリーにコピーされ、変更時には一つずつ同期する必要がありました。
+
+**変更後**: Common Config はプロバイダー切り替え時に live ファイルへ書き込む際のみ runtime overlay として注入され、プロバイダーエントリー自体には共通設定を含みません。つまり Common Config の変更は即座に反映され、各プロバイダーを個別に更新する必要はありません。
+
+### Common Config 初回自動抽出
+
+初回起動時にデータベースに Common Config Snippet がまだ存在しない場合、現在の live config から自動抽出します。これにより旧バージョンからアップグレードしたユーザーの既存の共通設定が失われないことを保証します。
+
+### 定期メンテナンスタイマー統合
+
+daily rollups と auto-vacuum を統一の定期メンテナンスタイマーに統合し、複数の独立タイマーによるリソース競合と複雑さを回避しました。
+
+---
+
+## バグ修正
+
+### プロキシとストリーミング
+
+- OpenAI ChatCompletion -> Anthropic Messages のストリーミング変換問題を修正
+- Codex `/responses/compact` ルーティングをサポート（#1194、@Tsukumi233 に感謝）
+- TOML 設定マージロジックを改善し、キー値の欠落を回避
+- proxy forwarder の失敗ログを改善し、診断情報を追加
+
+### プロバイダーとプリセットの修正
+
+- X-Code を X-Code API にリネームし、ブランド名称を統一
+- SSSAiCode の `/v1` パス問題を修正
+- AICoding URL の誤った `www` プレフィックスを削除
+- 新規プロバイダーページの改行削除問題を修正（#1155、@wugeer に感謝）
+
+### プラットフォーム修正
+
+- cache hit token の統計欠落を修正（#1244、@a1398394385 に感謝）
+- 最小化後しばらくすると自動終了する問題を修正（#1245、@YewFence に感謝）
+
+### i18n 修正
+
+- 69 個の欠落翻訳キーを補完し、残りのハードコード中国語を除去
+- model test panel の i18n 問題を修正
+- JSON5 slash escaping を正規化し、国際化文字列の解析異常を回避
+
+### UI 修正
+
+- Skills カウント表示の問題を修正（#1295、@fzzv に感謝）
+- endpoint speed test から HTTP ステータスコード表示を削除し、視覚的ノイズを軽減
+- outline button のスタイル問題を修正（#1222、@Sube-py に感謝）
+
+---
+
+## パフォーマンス
+
+- OpenClaw 設定が未変更の場合に不要な書き込みをスキップし、ディスク I/O を削減
+
+---
+
+## ドキュメント
+
+- ユーザーマニュアルを i18n 対応で再構成し、EN/JA の内容を拡充
+- OpenClaw の説明を追加し、設定ドキュメントを補完
+- UCloud スポンサー情報を追加
+- docs ディレクトリを再編成し、EN/ZH/JA の README 機能説明を同期
+
+---
+
+## 注意事項
+
+- **Common Config はランタイムオーバーレイに変更**: 共通設定スニペットは各プロバイダー設定への物理マージではなく、切り替え時に動的にオーバーレイされます。Common Config の変更は即座に反映され、各プロバイダーを個別に更新する必要はありません。
+- **Stream Check は初回使用時に確認が必要**: 初回使用時にモデルヘルスチェックの確認ダイアログが表示され、確認後に使用可能になります。
+- **OpenClaw の User-Agent トグルはデフォルトオフ**: OpenClaw 設定で User-Agent 識別子の付加機能を手動で有効にする必要があります。
+
+---
+
+## 謝辞
+
+以下のコントリビューターの皆様、このリリースへの貢献に感謝します！
+
+@keithyt06 @bugparty @Alex-wuhu @suki135246 @Tsukumi233 @wugeer @fzzv @Sube-py @a1398394385 @YewFence
+
+---
+
+## ダウンロードとインストール
+
+[Releases](https://github.com/farion1231/cc-switch/releases/latest) から適切なバージョンをダウンロードしてください。
+
+### システム要件
+
+| システム | 最小バージョン                   | アーキテクチャ                      |
+| -------- | -------------------------------- | ----------------------------------- |
+| Windows  | Windows 10 以降                  | x64                                 |
+| macOS    | macOS 10.15 (Catalina) 以降      | Intel (x64) / Apple Silicon (arm64) |
+| Linux    | 下表参照                         | x64                                 |
+
+### Windows
+
+| ファイル                                 | 説明                                                 |
+| ---------------------------------------- | ---------------------------------------------------- |
+| `CC-Switch-v3.12.0-Windows.msi`          | **推奨** - MSI インストーラー、自動更新対応          |
+| `CC-Switch-v3.12.0-Windows-Portable.zip` | ポータブル版、解凍して実行、レジストリ書き込みなし   |
+
+### macOS
+
+| ファイル                         | 説明                                                              |
+| -------------------------------- | ----------------------------------------------------------------- |
+| `CC-Switch-v3.12.0-macOS.zip`    | **推奨** - 解凍して Applications にドラッグ、Universal Binary     |
+| `CC-Switch-v3.12.0-macOS.tar.gz` | Homebrew インストールと自動更新用                                 |
+
+> **注意**: 作者が Apple Developer アカウントを持っていないため、初回起動時に「開発元を確認できません」という警告が表示される場合があります。一度閉じてから、「システム設定」→「プライバシーとセキュリティ」→「このまま開く」をクリックすると、その後は正常に開けます。
+
+### Homebrew (macOS)
+
+```bash
+brew tap farion1231/ccswitch
+brew install --cask cc-switch
+```
+
+更新：
+
+```bash
+brew upgrade --cask cc-switch
+```
+
+### Linux
+
+| ディストリビューション                  | 推奨形式    | インストール方法                                                       |
+| --------------------------------------- | ----------- | ---------------------------------------------------------------------- |
+| Ubuntu / Debian / Linux Mint / Pop!\_OS | `.deb`      | `sudo dpkg -i CC-Switch-*.deb` または `sudo apt install ./CC-Switch-*.deb` |
+| Fedora / RHEL / CentOS / Rocky Linux    | `.rpm`      | `sudo rpm -i CC-Switch-*.rpm` または `sudo dnf install ./CC-Switch-*.rpm`  |
+| openSUSE                                | `.rpm`      | `sudo zypper install ./CC-Switch-*.rpm`                                |
+| Arch Linux / Manjaro                    | `.AppImage` | 実行権限を追加して直接実行、または AUR を使用                          |
+| その他のディストリビューション / 不明   | `.AppImage` | `chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage`              |

docs/release-notes/v3.12.0-zh.md

@@ -0,0 +1,238 @@
+# CC Switch v3.12.0
+
+> Stream Check 回归，OpenAI Responses API 上线，OpenClaw 与 WebDAV 迎来一次大升级
+
+**[English →](v3.12.0-en.md) | [日本語版 →](v3.12.0-ja.md)**
+
+---
+
+## 概览
+
+CC Switch v3.12.0 是一个功能版本，重点提升供应商兼容性、OpenClaw 配置编辑体验、通用配置功能使用体验，以及同步与数据维护能力。本次恢复了增强稳定性后的 **模型健康检查（Stream Check）** UI，新增 **OpenAI Responses API** 格式转换，扩展了 **Ucloud**、**Micu**、**X-Code API**、**Novita**、**Bailian For Coding** 等供应商预设，并为 **WebDAV 同步** 引入双层版本控制。
+
+**发布日期**：2026-03-09
+
+**更新规模**：56 commits | 221 files changed | +20,582 / -8,026 lines
+
+---
+
+## 重点内容
+
+- **Stream Check 回归**：恢复模型健康检查 UI，新增首次使用确认，并修复 `openai_chat` 供应商检测
+- **OpenAI Responses API**：新增 `api_format = "openai_responses"`，支持双向格式转换并整理共享转换逻辑，只需要在添加供应商的时候选择 Response 接口格式并开启代理接管，您就可以在 Claude Code 中使用 gpt 系列模型了！
+- **OpenClaw 面板升级**：引入 JSON5 round-trip 配置编辑、配置健康提示、改进后的 Agent Model 选择和 User-Agent 开关
+- **预设扩展**：补充 Ucloud、Micu、X-Code API、Novita、Bailian For Coding 预设，并新增 SiliconFlow partner badge 与模型角色标识
+- **同步与维护增强**：新增 WebDAV protocol v2 + db-v6 双层版本、daily rollups、增量 auto-vacuum 和 sync-aware backup
+- **通用配置功能使用体验优化**：现在通用配置片段更新之后，会在切换供应商时自动同步到新的供应商，不需要再手动勾选。
+
+---
+
+## 主要功能
+
+### 模型健康检查 Stream Check
+
+恢复 Stream Check 面板，用于实时验证供应商可用性，增强供应商管理的可靠性。
+
+- 恢复 Stream Check UI 面板，支持单个或批量检测供应商可用性
+- 新增首次使用确认对话框，避免不支持健康检查的供应商报错误导用户
+- 修复 `openai_chat` API 格式供应商的检测兼容性
+
+### OpenAI Responses API
+
+新增 `openai_responses` API 格式，为使用 OpenAI Responses API 的供应商提供原生支持。
+
+- 新增 `api_format = "openai_responses"` 供应商格式选项
+- 支持 Anthropic Messages <-> OpenAI Responses API 双向格式转换
+- 整理共享转换逻辑，减少重复代码
+
+### Bedrock 请求优化器
+
+为 AWS Bedrock 供应商新增 PRE-SEND 阶段请求优化器，提升兼容性和性能。
+
+- PRE-SEND thinking + cache injection 优化器（#1301，感谢 @keithyt06）
+
+### OpenClaw 配置增强
+
+OpenClaw 配置编辑体验全面升级，支持更丰富的配置管理。
+
+- JSON5 round-trip 写回：编辑配置时保留注释和格式
+- EnvPanel 支持 JSON 编辑模式和 `tools.profile` 选择
+- 新增配置校验提示和配置健康状态检查
+- Agent 模型下拉框改进，支持从供应商预设填充推荐模型
+- User-Agent 开关：可选在请求中附加 User-Agent 标识（默认关闭）
+- Legacy timeout 配置自动迁移
+
+### 供应商预设 Preset
+
+新增和扩展多组供应商预设，覆盖更多供应商和使用场景。
+
+- **Ucloud**：新增 `endpointCandidates` 以及 OpenClaw 默认值，刷新 `templateValues` / `suggestedDefaults`
+- **Micu**：新增预设默认值及 OpenClaw 推荐模型
+- **X-Code API**：新增 Claude 预设及 `endpointCandidates`
+- **Novita**：新增供应商预设（#1192，感谢 @Alex-wuhu）
+- **Bailian For Coding**：新增供应商预设（#1263，感谢 @suki135246）
+- **SiliconFlow**：新增 partner badge 标识
+- **模型角色标识**：供应商预设支持模型角色 badge 显示
+
+### WebDAV 同步增强
+
+WebDAV 同步引入双层版本控制，提升同步可靠性和数据安全性。
+
+- 新增 WebDAV protocol v2 + db-v6 双层版本控制
+- 切换 WebDAV auto-sync 时弹出确认对话框，防止误操作
+- sync-aware backup：WebDAV 同步时使用 sync 变体备份，跳过仅本地使用的表数据
+
+### 用量与数据
+
+用量统计和数据维护能力增强，数据管理更精细，极大降低数据库增长速度。
+
+- Daily rollups：按天汇总用量数据，减少存储占用
+- Auto-vacuum：增量式数据库清理，保持数据库健康
+- UsageFooter 新增额外统计字段（#1137，感谢 @bugparty）
+
+### 其他新功能
+
+- **会话删除**：按供应商清理会话记录，带路径安全校验
+- **Claude auth field selector 恢复**：恢复认证字段选择器
+- **Failover 开关独立显示**：将 failover toggle 从设置面板移到主页独立展示，并新增首次确认对话框
+- **通用配置自动抽取**：首次运行时自动从 live config 中抽取通用配置片段
+- **新供应商页面改进**：优化新建供应商页面体验（#1155，感谢 @wugeer）
+
+---
+
+## 架构改进
+
+### Common Config 运行时叠加
+
+通用配置片段（Common Config Snippet）改为运行时叠加方式应用，不再物化写入每个供应商配置。
+
+**变更前**：Common Config 内容在保存或切换时直接合并写入每个供应商的 `settings_config`。这导致公共配置被复制到每个供应商条目中，修改时需要逐一同步。
+
+**变更后**：Common Config 仅在切换供应商写入 live 文件时以 runtime overlay 方式注入，供应商条目本身不包含公共配置。这意味着修改 Common Config 后立即生效，无需逐一更新每个供应商。
+
+### 通用配置首次自动抽取
+
+首次运行时，如果数据库中尚无 Common Config Snippet，会自动从当前 live config 中抽取通用配置。这确保了从旧版本升级的用户不会丢失已有的通用配置设置。
+
+### 定期维护定时器整合
+
+将 daily rollups 和 auto-vacuum 整合到统一的定期维护定时器中，避免多个独立定时器带来的资源竞争和复杂度。
+
+---
+
+## Bug 修复
+
+### 代理与流式转换
+
+- 修复 OpenAI ChatCompletion -> Anthropic Messages 流式转换问题
+- 新增 Codex `/responses/compact` 路由支持（#1194，感谢 @Tsukumi233）
+- 改进 TOML 配置合并逻辑，避免键值丢失
+- 改进 proxy forwarder 失败日志，增加更多诊断信息
+
+### 供应商预设修复
+
+- X-Code 更名为 X-Code API，统一品牌命名
+- 修复 SSSAiCode `/v1` 路径问题
+- 移除 AICoding URL 错误的 `www` 前缀
+- 优化新建供应商页面换行删除问题（#1155，感谢 @wugeer）
+
+### 平台修复
+
+- 修复 cache hit token 统计缺失（#1244，感谢 @a1398394385）
+- 修复最小化到托盘后一段时间自动退出的问题（#1245，感谢 @YewFence）
+
+### i18n 修复
+
+- 补齐 69 个缺失翻译 key，清理剩余硬编码中文
+- 修复 model test panel 的 i18n 问题
+- 规范 JSON5 slash escaping，避免国际化字符串解析异常
+
+### UI 修复
+
+- 修复 Skills 计数显示问题（#1295，感谢 @fzzv）
+- 移除 endpoint speed test 的 HTTP 状态码显示，减少视觉噪音
+- 修复 outline button 样式问题（#1222，感谢 @Sube-py）
+
+---
+
+## 性能优化
+
+- OpenClaw 配置未变化时跳过无意义写入，减少磁盘 I/O
+
+---
+
+## 文档
+
+- 重构用户手册以支持国际化，补齐 EN/JA 完整内容
+- 新增 OpenClaw 使用说明，补完设置章节
+- 新增 UCloud 赞助商信息
+- 重组 docs 目录结构，同步 EN/ZH/JA README 的功能说明
+
+---
+
+## 说明与注意事项
+
+- **Common Config 改为运行时叠加**：通用配置片段不再物化写入每个供应商配置，而是在切换时动态叠加。修改 Common Config 后立即生效，无需逐一更新供应商。
+- **Stream Check 首次使用需确认**：首次使用模型健康检查时会弹出确认对话框，确认后方可使用。
+- **OpenClaw User-Agent 开关默认关闭**：需要在 OpenClaw 配置中手动开启 User-Agent 标识附加功能。
+
+---
+
+## 特别感谢
+
+感谢以下贡献者为本版本做出的贡献！
+
+@keithyt06 @bugparty @Alex-wuhu @suki135246 @Tsukumi233 @wugeer @fzzv @Sube-py @a1398394385 @YewFence
+
+---
+
+## 下载与安装
+
+访问 [Releases](https://github.com/farion1231/cc-switch/releases/latest) 下载对应版本。
+
+### 系统要求
+
+| 系统    | 最低版本                      | 架构                                |
+| ------- | ----------------------------- | ----------------------------------- |
+| Windows | Windows 10 及以上             | x64                                 |
+| macOS   | macOS 10.15 (Catalina) 及以上 | Intel (x64) / Apple Silicon (arm64) |
+| Linux   | 见下表                        | x64                                 |
+
+### Windows
+
+| 文件                                     | 说明                                |
+| ---------------------------------------- | ----------------------------------- |
+| `CC-Switch-v3.12.0-Windows.msi`          | **推荐** - MSI 安装包，支持自动更新 |
+| `CC-Switch-v3.12.0-Windows-Portable.zip` | 便携版，解压即用，不写入注册表      |
+
+### macOS
+
+| 文件                             | 说明                                                      |
+| -------------------------------- | --------------------------------------------------------- |
+| `CC-Switch-v3.12.0-macOS.zip`    | **推荐** - 解压后拖入 Applications 即可，Universal Binary |
+| `CC-Switch-v3.12.0-macOS.tar.gz` | 用于 Homebrew 安装和自动更新                              |
+
+> **注意**：由于作者没有苹果开发者账号，首次打开可能出现"未知开发者"警告，请先关闭，然后前往"系统设置" → "隐私与安全性" → 点击"仍要打开"，之后便可以正常打开
+
+### Homebrew（macOS）
+
+```bash
+brew tap farion1231/ccswitch
+brew install --cask cc-switch
+```
+
+更新：
+
+```bash
+brew upgrade --cask cc-switch
+```
+
+### Linux
+
+| 发行版                                  | 推荐格式    | 安装方式                                                               |
+| --------------------------------------- | ----------- | ---------------------------------------------------------------------- |
+| Ubuntu / Debian / Linux Mint / Pop!\_OS | `.deb`      | `sudo dpkg -i CC-Switch-*.deb` 或 `sudo apt install ./CC-Switch-*.deb` |
+| Fedora / RHEL / CentOS / Rocky Linux    | `.rpm`      | `sudo rpm -i CC-Switch-*.rpm` 或 `sudo dnf install ./CC-Switch-*.rpm`  |
+| openSUSE                                | `.rpm`      | `sudo zypper install ./CC-Switch-*.rpm`                                |
+| Arch Linux / Manjaro                    | `.AppImage` | 添加执行权限后直接运行，或使用 AUR                                     |
+| 其他发行版 / 不确定                     | `.AppImage` | `chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage`              |