chore: bump version to v3.12.1 and add release notes

feat: add authHeader field to OpenClawProviderConfig and reuse type in form state
Add optional `authHeader` boolean to support vendor-specific auth headers (e.g. Longcat). Refactor `resetOpenclawState` to use the shared `OpenClawProviderConfig` type instead of an inline duplicate definition.
2026-07-26 06:24:32 +08:00 · 2026-03-12 00:15:05 +08:00 · 2026-03-11 23:56:41 +08:00 · 2026-03-11 23:51:11 +08:00 · 2026-03-11 23:47:08 +08:00 · 2026-03-11 16:25:38 +08:00
59 changed files with 2915 additions and 1651 deletions
@@ -9,6 +9,64 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

 ---

+## [3.12.1] - 2026-03-12
+
+### Patch Release
+
+Stability-focused patch release fixing the Common Config modal infinite reopen loop, a WebDAV sync foreign key constraint failure, several i18n interpolation issues, and a Windows toolbar compact mode bug. Also adds **StepFun** provider presets, **OpenClaw input type selection** and **authHeader** support, upgrades Gemini to **3.1-pro**, and welcomes four new sponsor partners.
+
+**Stats**: 19 commits | 56 files changed | +1,429 insertions | -396 deletions
+
+### Added
+
+#### Provider Presets
+
+- **StepFun**: Added StepFun (阶跃星辰) provider presets including the step-3.5-flash model across supported applications (#1369, thanks @hengm3467)
+
+#### OpenClaw Enhancements
+
+- **Input Type Selection**: Added input type selection dropdown for model Advanced Options in OpenClaw configuration form (#1368, thanks @liuxxxu)
+- **authHeader Field**: Added optional `authHeader` boolean to OpenClawProviderConfig for vendor-specific auth header support (e.g. Longcat), and refactored form state to reuse the shared type
+
+#### Sponsor Partners
+
+- **Micu API**: Added Micu API as sponsor partner with affiliate links
+- **XCodeAPI**: Added XCodeAPI as sponsor partner
+- **SiliconFlow**: Added SiliconFlow (硅基流动) as sponsor partner with affiliate links
+- **CTok**: Added CTok as sponsor partner
+
+### Changed
+
+- **UCloud → Compshare**: Renamed UCloud provider to Compshare (优云智算) with full i18n support across all three locales (EN/ZH/JA)
+- **Compshare Links**: Updated Compshare sponsor registration links to coding-plan page
+- **Gemini Model Upgrade**: Upgraded default Gemini model from 2.5-pro to 3.1-pro in provider presets
+
+### Fixed
+
+#### Common Config & UI
+
+- **Common Config Modal Loop**: Fixed an infinite reopen loop in the Common Config modal and added draft editing support to prevent data loss during edits
+- **Toolbar Compact Mode (Windows)**: Fixed toolbar compact mode not triggering on Windows due to left-side overflow (#1375, thanks @zuoliangyu)
+- **Session Search Index**: Fixed session search index not syncing with query data, causing stale list display after session deletion
+
+#### Sync & Data
+
+- **WebDAV Provider Health FK**: Fixed foreign key constraint failure when restoring `provider_health` table during WebDAV sync
+
+#### Provider & Preset
+
+- **Longcat authHeader**: Added missing `authHeader: true` to Longcat provider preset (#1377, thanks @wavever)
+- **OpenClaw Tool Permissions**: Aligned OpenClaw tool permission profiles with upstream schema (#1355, thanks @bigsongeth)
+- **X-Code API URL**: Corrected X-Code API URL from `www.x-code.cn` to `x-code.cc`
+
+#### i18n & Localization
+
+- **Stream Check Toast**: Fixed stream check toast i18n interpolation keys not matching translation placeholders
+- **Proxy Startup Toast**: Fixed proxy startup toast not interpolating address and port values (#1399, thanks @Mason-mengze)
+- **OpenCode API Format Label**: Renamed OpenCode API format label from "OpenAI" to "OpenAI Responses" for accuracy
+
+---
+
 ## [3.12.0] - 2026-03-09

 ### Feature Release
@@ -4,7 +4,7 @@

 ### The All-in-One Manager for Claude Code, Codex, Gemini CLI, OpenCode & OpenClaw

-[![Version](https://img.shields.io/badge/version-3.12.0-blue.svg)](https://github.com/farion1231/cc-switch/releases)
+[![Version](https://img.shields.io/badge/version-3.12.1-blue.svg)](https://github.com/farion1231/cc-switch/releases)
 [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/farion1231/cc-switch/releases)
 [![Built with Tauri](https://img.shields.io/badge/built%20with-Tauri%202-orange.svg)](https://tauri.app/)
 [![Downloads](https://img.shields.io/endpoint?url=https://api.pinstudios.net/api/badges/downloads/farion1231/cc-switch/total)](https://github.com/farion1231/cc-switch/releases/latest)
@@ -34,6 +34,11 @@ MiniMax-M2.5 is a SOTA large language model designed for real-world productivity
 <td>Thanks to PackyCode for sponsoring this project! PackyCode is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more. PackyCode provides special discounts for our software users: register using <a href="https://www.packyapi.com/register?aff=cc-switch">this link</a> and enter the "cc-switch" promo code during first recharge to get 10% off.</td>
 </tr>

+<tr>
+<td width="180"><a href="https://cloud.siliconflow.cn/i/drGuwc9k"><img src="assets/partners/logos/silicon_en.jpg" alt="SiliconFlow" width="150"></a></td>
+<td>Thanks to SiliconFlow for sponsoring this project! SiliconFlow is a high-performance AI infrastructure and model API platform, providing fast and reliable access to language, speech, image, and video models in one place. With pay-as-you-go billing, broad multimodal model support, high-speed inference, and enterprise-grade stability, SiliconFlow helps developers and teams build and scale AI applications more efficiently. Register via <a href="https://cloud.siliconflow.cn/i/drGuwc9k">this link</a> and complete real-name verification to receive ¥20 in bonus credit, usable across models on the platform. SiliconFlow is also now compatible with OpenClaw, allowing users to connect a SiliconFlow API key and call major AI models for free.</td>
+</tr>
+
 <tr>
 <td width="180"><a href="https://aigocode.com/invite/CC-SWITCH"><img src="assets/partners/logos/aigocode.png" alt="AIGoCode" width="150"></a></td>
 <td>Thanks to AIGoCode for sponsoring this project! AIGoCode is an all-in-one platform that integrates Claude Code, Codex, and the latest Gemini models, providing you with stable, efficient, and highly cost-effective AI coding services. The platform offers flexible subscription plans, zero risk of account suspension, direct access with no VPN required, and lightning-fast responses. AIGoCode has prepared a special benefit for CC Switch users: if you register via <a href="https://aigocode.com/invite/CC-SWITCH">this link</a>, you'll receive an extra 10% bonus credit on your first top-up!</td>
@@ -56,8 +61,8 @@ Claude Code / Codex / Gemini official channels at 38% / 2% / 9% of original pric
 </tr>

 <tr>
-<td width="180"><a href="https://www.compshare.cn/coding-plan?ytag=GPU_YY_YX_git_cc-switch"><img src="assets/partners/logos/ucloud.png" alt="Ucloud" width="150"></a></td>
-<td>Thanks to UCloud CompShare for sponsoring this project! CompShare is UCloud's AI cloud platform, providing stable and comprehensive domestic and international model APIs with just one key. Featuring cost-effective monthly and pay-as-you-go Coding Plan packages at 60-80% off official prices. Supports Claude Code, Codex, and API access. Enterprise-grade high concurrency, 24/7 technical support, and self-service invoicing. Users who register via <a href="https://www.compshare.cn/?ytag=GPU_YY_YX_git_cc-switch">this link</a> will receive a free 5 CNY platform trial credit!</td>
+<td width="180"><a href="https://www.compshare.cn/coding-plan?ytag=GPU_YY_YX_git_cc-switch"><img src="assets/partners/logos/ucloud.png" alt="Compshare" width="150"></a></td>
+<td>Thanks to Compshare for sponsoring this project! Compshare is UCloud's AI cloud platform, providing stable and comprehensive domestic and international model APIs with just one key. Featuring cost-effective monthly and pay-as-you-go Coding Plan packages at 60-80% off official prices. Supports Claude Code, Codex, and API access. Enterprise-grade high concurrency, 24/7 technical support, and self-service invoicing. Users who register via <a href="https://www.compshare.cn/coding-plan?ytag=GPU_YY_YX_git_cc-switch">this link</a> will receive a free 5 CNY platform trial credit!</td>
 </tr>

 <tr>
@@ -71,7 +76,7 @@ Claude Code / Codex / Gemini official channels at 38% / 2% / 9% of original pric
 </tr>

 <tr>
-<td width="180"><a href="https://crazyrouter.com/register?aff=OZcm&ref=cc-switch"><img src="assets/partners/logos/crazyrouter.jpg" alt="AICoding" width="150"></a></td>
+<td width="180"><a href="https://crazyrouter.com/register?aff=OZcm&ref=cc-switch"><img src="assets/partners/logos/crazyrouter.jpg" alt="Crazyrouter" width="150"></a></td>
 <td>Thanks to Crazyrouter for sponsoring this project! Crazyrouter is a high-performance AI API aggregation platform — one API key for 300+ models including Claude Code, Codex, Gemini CLI, and more. All models at 55% of official pricing with auto-failover, smart routing, and unlimited concurrency. Crazyrouter offers an exclusive deal for CC Switch users: register via <a href="https://crazyrouter.com/register?aff=OZcm&ref=cc-switch">this link</a>  to get <strong>$2 free credit</strong> instantly, plus enter promo code `CCSWITCH` on your first top-up for an extra <strong>30% bonus credit</strong>! </td>
 </tr>

@@ -80,6 +85,21 @@ Claude Code / Codex / Gemini official channels at 38% / 2% / 9% of original pric
 <td>Thanks to SSSAiCode for sponsoring this project! SSSAiCode is a stable and reliable API relay service, dedicated to providing stable, reliable, and affordable Claude and Codex model services, <strong>offering high cost-effective official Claude service at just ¥0.5/$ equivalent</strong>, supporting monthly and pay-as-you-go billing plans with same-day fast invoicing. SSSAiCode offers a special deal for CC Switch users: register via <a href="https://www.sssaicode.com/register?ref=DCP0SM">this link</a> to enjoy $10 extra credit on every top-up!</td>
 </tr>

+<tr>
+<td width="180"><a href="https://www.openclaudecode.cn/register?aff=aOYQ"><img src="assets/partners/logos/mikubanner.svg" alt="Micu" width="150"></a></td>
+<td>Thanks to Micu API for sponsoring this project! Micu API is a global LLM relay service provider dedicated to delivering the best cost-performance ratio with high stability. Backed by a registered enterprise for core assurance, eliminating any risk of service discontinuation, with fast official invoicing support! We champion "zero cost to try": top up from as low as ¥1 with no minimum, and get fee-free refunds anytime! Micu API offers an exclusive deal for CC Switch users: register via <a href="https://www.openclaudecode.cn/register?aff=aOYQ">this link</a> and enter promo code "ccswitch" when topping up to enjoy a <strong>10% discount</strong>!</td>
+</tr>
+
+<tr>
+<td width="180"><a href="https://x-code.cc/register?aff=IbPp"><img src="assets/partners/logos/xcodeapi.png" alt="XCodeAPI" width="150"></a></td>
+<td>Thanks to XCodeAPI for sponsoring this project! XCodeAPI offers a special benefit for CC Switch users: register via <a href="https://x-code.cc/register?aff=IbPp">this link</a> and get an extra 10% credit bonus on your first order! (Contact the site admin to claim)</td>
+</tr>
+
+<tr>
+<td width="180"><a href="https://ctok.ai"><img src="assets/partners/logos/ctok.png" alt="CTok" width="150"></a></td>
+<td>Thanks to CTok.ai for sponsoring this project! CTok.ai is dedicated to building a one-stop AI programming tool service platform. We offer professional Claude Code packages and technical community services, with support for Google Gemini and OpenAI Codex. Through carefully designed plans and a professional tech community, we provide developers with reliable service guarantees and continuous technical support, making AI-assisted programming a true productivity tool. Click <a href="https://ctok.ai">here</a> to register!</td>
+</tr>
+
 </table>

 </details>
@@ -106,7 +126,7 @@ Modern AI-powered coding relies on CLI tools like Claude Code, Codex, Gemini CLI

 ## Features

-[Full Changelog](CHANGELOG.md) | [Release Notes](docs/release-notes/v3.12.0-en.md)
+[Full Changelog](CHANGELOG.md) | [Release Notes](docs/release-notes/v3.12.1-en.md)

 ### Provider Management

@@ -4,7 +4,7 @@

 ### Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw のオールインワン管理ツール

-[![Version](https://img.shields.io/badge/version-3.12.0-blue.svg)](https://github.com/farion1231/cc-switch/releases)
+[![Version](https://img.shields.io/badge/version-3.12.1-blue.svg)](https://github.com/farion1231/cc-switch/releases)
 [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/farion1231/cc-switch/releases)
 [![Built with Tauri](https://img.shields.io/badge/built%20with-Tauri%202-orange.svg)](https://tauri.app/)
 [![Downloads](https://img.shields.io/endpoint?url=https://api.pinstudios.net/api/badges/downloads/farion1231/cc-switch/total)](https://github.com/farion1231/cc-switch/releases/latest)
@@ -34,6 +34,11 @@ MiniMax-M2.5 は、実際の生産性向上のために設計された最先端
 <td>PackyCode のご支援に感謝します！PackyCode は Claude Code、Codex、Gemini などのリレーサービスを提供する信頼性の高い API 中継プラットフォームです。本ソフト利用者向けに特別割引があります：<a href="https://www.packyapi.com/register?aff=cc-switch">このリンク</a>で登録し、チャージ時に「cc-switch」クーポンを入力すると 10% オフになります。</td>
 </tr>

+<tr>
+<td width="180"><a href="https://cloud.siliconflow.cn/i/drGuwc9k"><img src="assets/partners/logos/silicon_en.jpg" alt="SiliconFlow" width="150"></a></td>
+<td>SiliconFlow のご支援に感謝します！SiliconFlow は高性能 AI インフラストラクチャおよびモデル API プラットフォームで、言語・音声・画像・動画モデルへの高速かつ信頼性の高いアクセスをワンストップで提供します。従量課金制、豊富なマルチモーダルモデル対応、高速推論、エンタープライズグレードの安定性を備え、開発者やチームがより効率的に AI アプリケーションを構築・拡張できるようサポートします。<a href="https://cloud.siliconflow.cn/i/drGuwc9k">このリンク</a>から登録し、本人確認を完了すると、プラットフォーム内の全モデルで利用可能な ¥20 のボーナスクレジットが付与されます。SiliconFlow は OpenClaw にも対応しており、SiliconFlow の API キーを接続することで主要な AI モデルを無料で呼び出すことができます。</td>
+</tr>
+
 <tr>
 <td width="180"><a href="https://aigocode.com/invite/CC-SWITCH"><img src="assets/partners/logos/aigocode.png" alt="AIGoCode" width="150"></a></td>
 <td>本プロジェクトは AIGoCode のスポンサー提供でお届けしています。AIGoCode は、Claude Code・Codex・最新の Gemini モデルを統合したオールインワンのAIコーディングプラットフォームで、安定性・高速性・コストパフォーマンスに優れた開発サービスを提供します。柔軟なサブスクリプションプランを備え、レスポンスも非常に高速です。さらに、CC Switch ユーザー向けの特典として、<a href="https://aigocode.com/invite/CC-SWITCH">このリンク</a>から登録すると、初回チャージ時に10％分のボーナスクレジットが付与されます！</td>
@@ -56,8 +61,8 @@ Claude Code / Codex / Gemini 公式チャンネルが最安で元価格の 38% /
 </tr>

 <tr>
-<td width="180"><a href="https://www.compshare.cn/coding-plan?ytag=GPU_YY_YX_git_cc-switch"><img src="assets/partners/logos/ucloud.png" alt="Ucloud" width="150"></a></td>
-<td>UCloud CompShare のご支援に感謝します！CompShare は UCloud 傘下の AI クラウドプラットフォームで、国内外の安定した包括的なモデル API を 1 つのキーだけで利用可能。月額・従量課金のコストパフォーマンスに優れた Coding Plan パッケージを提供し、公式価格の 60〜80% オフで利用できます。Claude Code、Codex および API アクセスに対応。エンタープライズ級の高同時接続、24 時間年中無休のテクニカルサポート、セルフサービス請求書発行に対応。<a href="https://www.compshare.cn/?ytag=GPU_YY_YX_git_cc-switch">こちらのリンク</a>から登録すると、無料で 5 元分のプラットフォーム体験クレジットがもらえます！</td>
+<td width="180"><a href="https://www.compshare.cn/coding-plan?ytag=GPU_YY_YX_git_cc-switch"><img src="assets/partners/logos/ucloud.png" alt="Compshare" width="150"></a></td>
+<td>Compshare のご支援に感謝します！Compshare は UCloud 傘下の AI クラウドプラットフォームで、国内外の安定した包括的なモデル API を 1 つのキーだけで利用可能。月額・従量課金のコストパフォーマンスに優れた Coding Plan パッケージを提供し、公式価格の 60〜80% オフで利用できます。Claude Code、Codex および API アクセスに対応。エンタープライズ級の高同時接続、24 時間年中無休のテクニカルサポート、セルフサービス請求書発行に対応。<a href="https://www.compshare.cn/coding-plan?ytag=GPU_YY_YX_git_cc-switch">こちらのリンク</a>から登録すると、無料で 5 元分のプラットフォーム体験クレジットがもらえます！</td>
 </tr>

 <tr>
@@ -71,7 +76,7 @@ Claude Code / Codex / Gemini 公式チャンネルが最安で元価格の 38% /
 </tr>

 <tr>
-<td width="180"><a href="https://crazyrouter.com/register?aff=OZcm&ref=cc-switch"><img src="assets/partners/logos/crazyrouter.jpg" alt="AICoding" width="150"></a></td>
+<td width="180"><a href="https://crazyrouter.com/register?aff=OZcm&ref=cc-switch"><img src="assets/partners/logos/crazyrouter.jpg" alt="Crazyrouter" width="150"></a></td>
 <td>Crazyrouter のご支援に感謝します！Crazyrouter は高性能 AI API アグリゲーションプラットフォームです。1 つの API キーで Claude Code、Codex、Gemini CLI など 300 以上のモデルにアクセス可能。全モデルが公式価格の 55% で利用でき、自動フェイルオーバー、スマートルーティング、無制限同時接続に対応。CC Switch ユーザー向けの限定特典：<a href="https://crazyrouter.com/register?aff=OZcm&ref=cc-switch">こちらのリンク</a>から登録すると <strong>$2 の無料クレジット</strong> を即時進呈。さらに初回チャージ時にプロモコード `CCSWITCH` を入力すると <strong>30% のボーナスクレジット</strong> が追加されます！</td>
 </tr>

@@ -80,6 +85,21 @@ Claude Code / Codex / Gemini 公式チャンネルが最安で元価格の 38% /
 <td>SSSAiCode のご支援に感謝します！SSSAiCode は安定性と信頼性に優れた API 中継サービスで、安定的で信頼性が高く、手頃な価格の Claude・Codex モデルサービスを提供しています。<strong>高コストパフォーマンスの公式 Claude サービスを 0.5￥/$ 換算で提供</strong>、月額制・Paygo など多様な課金方式に対応し、当日の迅速な請求書発行をサポート。CC Switch ユーザー向けの特別特典：<a href="https://www.sssaicode.com/register?ref=DCP0SM">こちらのリンク</a>から登録すると、毎回のチャージで $10 の追加ボーナスを受けられます！</td>
 </tr>

+<tr>
+<td width="180"><a href="https://www.openclaudecode.cn/register?aff=aOYQ"><img src="assets/partners/logos/mikubanner.svg" alt="Micu" width="150"></a></td>
+<td>Micu API のご支援に感謝します！Micu API は、最高のコストパフォーマンスと高い安定性を追求するグローバル大規模言語モデル中継サービスプロバイダーです。法人企業がバックアップしており、サービス停止のリスクを排除、迅速な正規請求書発行に対応！「試行コストゼロ」をモットーに、最低 1 元からチャージ可能で手数料無料、いつでも返金可能！CC Switch ユーザー向けの限定特典：<a href="https://www.openclaudecode.cn/register?aff=aOYQ">こちらのリンク</a>から登録し、チャージ時にプロモコード「ccswitch」を入力すると <strong>10% 割引</strong> が適用されます！</td>
+</tr>
+
+<tr>
+<td width="180"><a href="https://x-code.cc/register?aff=IbPp"><img src="assets/partners/logos/xcodeapi.png" alt="XCodeAPI" width="150"></a></td>
+<td>XCodeAPI のご支援に感謝します！CC Switch ユーザー向けの特別特典：<a href="https://x-code.cc/register?aff=IbPp">こちらのリンク</a>から登録すると、初回注文で 10% の追加クレジットボーナスがもらえます！（サイト管理者に連絡して受け取りください）</td>
+</tr>
+
+<tr>
+<td width="180"><a href="https://ctok.ai"><img src="assets/partners/logos/ctok.png" alt="CTok" width="150"></a></td>
+<td>CTok.ai のご支援に感謝します！CTok.ai はワンストップ AI プログラミングツールサービスプラットフォームの構築に取り組んでいます。Claude Code のプロフェッショナルプランと技術コミュニティサービスを提供し、Google Gemini や OpenAI Codex にも対応しています。丁寧に設計されたプランと専門的な技術コミュニティを通じて、開発者に安定したサービス保証と継続的な技術サポートを提供し、AI アシストプログラミングを真の生産性ツールにします。<a href="https://ctok.ai">こちら</a>から登録してください！</td>
+</tr>
+
 </table>

 </details>
@@ -106,7 +126,7 @@ Claude Code / Codex / Gemini 公式チャンネルが最安で元価格の 38% /

 ## 特長

-[完全な更新履歴](CHANGELOG.md) | [リリースノート](docs/release-notes/v3.12.0-ja.md)
+[完全な更新履歴](CHANGELOG.md) | [リリースノート](docs/release-notes/v3.12.1-ja.md)

 ### プロバイダ管理

@@ -4,7 +4,7 @@

 ### Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 的全方位管理工具

-[![Version](https://img.shields.io/badge/version-3.12.0-blue.svg)](https://github.com/farion1231/cc-switch/releases)
+[![Version](https://img.shields.io/badge/version-3.12.1-blue.svg)](https://github.com/farion1231/cc-switch/releases)
 [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/farion1231/cc-switch/releases)
 [![Built with Tauri](https://img.shields.io/badge/built%20with-Tauri%202-orange.svg)](https://tauri.app/)
 [![Downloads](https://img.shields.io/endpoint?url=https://api.pinstudios.net/api/badges/downloads/farion1231/cc-switch/total)](https://github.com/farion1231/cc-switch/releases/latest)
@@ -34,6 +34,11 @@ MiniMax M2.5 在编程、工具调用与搜索、办公等核心生产力场景
 <td>感谢 PackyCode 赞助了本项目！PackyCode 是一家稳定、高效的API中转服务商，提供 Claude Code、Codex、Gemini 等多种中转服务。PackyCode 为本软件的用户提供了特别优惠，使用<a href="https://www.packyapi.com/register?aff=cc-switch">此链接</a>注册并在充值时填写"cc-switch"优惠码，首次充值可以享受9折优惠！</td>
 </tr>

+<tr>
+<td width="180"><a href="https://cloud.siliconflow.cn/i/drGuwc9k"><img src="assets/partners/logos/silicon_zh.jpg" alt="SiliconFlow" width="150"></a></td>
+<td>感谢硅基流动赞助了本项目！硅基流动是一个高性能 AI 基础设施与模型 API 平台，一站式提供语言、语音、图像、视频等多模态模型的快速、可靠访问。平台支持按量计费、丰富的多模态模型选择、高速推理和企业级稳定性，帮助开发者和团队更高效地构建和扩展 AI 应用。通过<a href="https://cloud.siliconflow.cn/i/drGuwc9k">此链接</a>注册并完成实名认证，即可获得 ¥20 奖励金，可在平台内跨模型使用。硅基流动现已兼容 OpenClaw，用户可接入硅基流动 API Key 免费调用主流 AI 模型。</td>
+</tr>
+
 <tr>
 <td width="180"><a href="https://aigocode.com/invite/CC-SWITCH"><img src="assets/partners/logos/aigocode.png" alt="AIGoCode" width="150"></a></td>
 <td>感谢 AIGoCode 赞助了本项目！AIGoCode 是一个集成了 Claude Code、Codex 以及 Gemini 最新模型的一站式平台，为你提供稳定、高效且高性价比的AI编程服务。本站提供灵活的订阅计划，零封号风险，国内直连，无需魔法，极速响应。AIGoCode 为 CC Switch 的用户提供了特别福利，通过<a href="https://aigocode.com/invite/CC-SWITCH">此链接</a>注册的用户首次充值可以获得额外10%奖励额度！</td>
@@ -57,8 +62,8 @@ Claude Code / Codex / Gemini 官方渠道低至 3.8 / 0.2 / 0.9 折，充值更
 </tr>

 <tr>
-<td width="180"><a href="https://www.compshare.cn/coding-plan?ytag=GPU_YY_YX_git_cc-switch"><img src="assets/partners/logos/ucloud.png" alt="Ucloud" width="150"></a></td>
-<td>感谢优云智算赞助了本项目！优云智算是UCloud旗下AI云平台，提供稳定、全面的国内外模型API，仅一个key即可调用。主打包月、按量的高性价比 Coding Plan 套餐，基于官方2~5折优惠。支持接入 Claude Code、Codex 及 API 调用。支持企业高并发、7*24技术支持、自助开票。通过<a href="https://www.compshare.cn/?ytag=GPU_YY_YX_git_cc-switch">此链接</a>注册的用户，可得免费5元平台体验金！</td>
+<td width="180"><a href="https://www.compshare.cn/coding-plan?ytag=GPU_YY_YX_git_cc-switch"><img src="assets/partners/logos/ucloud.png" alt="优云智算" width="150"></a></td>
+<td>感谢优云智算赞助了本项目！优云智算是UCloud旗下AI云平台，提供稳定、全面的国内外模型API，仅一个key即可调用。主打包月、按量的高性价比 Coding Plan 套餐，基于官方2~5折优惠。支持接入 Claude Code、Codex 及 API 调用。支持企业高并发、7*24技术支持、自助开票。通过<a href="https://www.compshare.cn/coding-plan?ytag=GPU_YY_YX_git_cc-switch">此链接</a>注册的用户，可得免费5元平台体验金！</td>
 </tr>

 <tr>
@@ -72,7 +77,7 @@ Claude Code / Codex / Gemini 官方渠道低至 3.8 / 0.2 / 0.9 折，充值更
 </tr>

 <tr>
-<td width="180"><a href="https://crazyrouter.com/register?aff=OZcm&ref=cc-switch"><img src="assets/partners/logos/crazyrouter.jpg" alt="AICoding" width="150"></a></td>
+<td width="180"><a href="https://crazyrouter.com/register?aff=OZcm&ref=cc-switch"><img src="assets/partners/logos/crazyrouter.jpg" alt="Crazyrouter" width="150"></a></td>
 <td>感谢 Crazyrouter 赞助了本项目！Crazyrouter 是一个高性能 AI API 聚合平台——一个 API Key 即可访问 300+ 模型，包括 Claude Code、Codex、Gemini CLI 等。全部模型低至官方定价的 55%，支持自动故障转移、智能路由和无限并发。Crazyrouter 为 CC Switch 用户提供了专属优惠：通过<a href="https://crazyrouter.com/register?aff=OZcm&ref=cc-switch">此链接</a>注册即可获得 <strong>$2 免费额度</strong>，首次充值时输入优惠码 `CCSWITCH` 还可获得额外 <strong>30% 奖励额度</strong>！</td>
 </tr>

@@ -81,6 +86,21 @@ Claude Code / Codex / Gemini 官方渠道低至 3.8 / 0.2 / 0.9 折，充值更
 <td>感谢 SSSAiCode 赞助了本项目！SSSAiCode 是一家稳定可靠的API中转站，致力于提供稳定、可靠、平价的Claude、CodeX模型服务，<strong>提供高性价比折合0.5￥/$的官方Claude服务</strong>，支持包月、Paygo多种计费方式、支持当日快速开票，SSSAiCode为本软件的用户提供特别优惠，使用<a href="https://www.sssaicode.com/register?ref=DCP0SM">此链接</a>注册每次充值均可享受10$的额外奖励！</td>
 </tr>

+<tr>
+<td width="180"><a href="https://www.openclaudecode.cn/register?aff=aOYQ"><img src="assets/partners/logos/mikubanner.svg" alt="Micu" width="150"></a></td>
+<td>感谢 米醋API 赞助了本项目！米醋API 是一家致力于提供极致性价比与高稳定性的全球大模型中转服务商。米醋API 背后有实体企业做核心保障，杜绝跑路风险，支持极速正规开票！我们主打“试错零成本”：1 元起充低门槛，0 手续费随时退款！米醋API 为本软件的用户提供了特别优惠，使用<a href="https://www.openclaudecode.cn/register?aff=aOYQ">此链接</a>注册并在充值时填写"ccswitch"优惠码可享九折优惠！</td>
+</tr>
+
+<tr>
+<td width="180"><a href="https://x-code.cc/register?aff=IbPp"><img src="assets/partners/logos/xcodeapi.png" alt="XCodeAPI" width="150"></a></td>
+<td>感谢 XCodeAPI 赞助了本项目！XCodeAPI 为本软件的用户提供特别福利，使用<a href="https://x-code.cc/register?aff=IbPp">此链接</a>注册后首单加赠10%的额度!(联系站长领取)</td>
+</tr>
+
+<tr>
+<td width="180"><a href="https://ctok.ai"><img src="assets/partners/logos/ctok.png" alt="CTok" width="150"></a></td>
+<td>感谢 CTok.ai 赞助了本项目！CTok.ai 致力于打造一站式 AI 编程工具服务平台。我们提供 Claude Code 专业套餐及技术社群服务，同时支持 Google Gemini 和 OpenAI Codex。通过精心设计的套餐方案和专业的技术社群，为开发者提供稳定的服务保障和持续的技术支持，让 AI 辅助编程真正成为开发者的生产力工具。点击<a href="https://ctok.ai">这里</a>注册！</td>
+</tr>
+
 </table>

 </details>
@@ -107,7 +127,7 @@ Claude Code / Codex / Gemini 官方渠道低至 3.8 / 0.2 / 0.9 折，充值更

 ## 功能特性

-[完整更新日志](CHANGELOG.md) | [发布说明](docs/release-notes/v3.12.0-zh.md)
+[完整更新日志](CHANGELOG.md) | [发布说明](docs/release-notes/v3.12.1-zh.md)

 ### 供应商管理

@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg id="_图层_2" data-name="图层 2" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1075.78 240.6">
+  <defs>
+    <style>
+      .cls-1 {
+        fill: #068cde;
+      }
+
+      .cls-2 {
+        fill: #02a4fd;
+      }
+
+      .cls-3 {
+        fill: #fff;
+      }
+
+      .cls-4 {
+        fill: #02a6ff;
+      }
+    </style>
+  </defs>
+  <g id="_图层_1-2" data-name="图层 1">
+    <path class="cls-1" d="M226.14,157.63c-3.62,0-7.24,0-10.95,0v-24.96c5.2,0,10.17,0,15.13,0,5.55-.01,8.52-4.01,10.18-8.16,1.34-3.37,1.36-7.51-1.34-11.1-3.16-4.2-7.23-5.72-12.25-5.63-3.87.07-7.74.01-11.66.01v-24.79c6.56-.43,12.93.45,19.3-1.13.4-.42.85-1.05,1.44-1.49,4.61-3.47,6.48-9.22,4.67-14.51-1.63-4.76-6.67-8.03-12.22-7.99-4.37.03-8.74,0-13.42,0,0-5.79.1-11.16-.04-16.54-.08-3.23-1.09-6.23-3.22-8.79-7.6-9.17-17.84-6.02-28.13-6.29-.39-.23-.63-1.14-.45-2.35.73-4.72.37-9.44-.24-14.13-.51-3.95-5.79-9.24-9.1-9.56-10.42-1-15.88,5.21-15.83,14.89.02,3.54,0,7.08,0,10.92h-24.44c-.76-1.03-.45-2.13-.42-3.19.15-5.2.71-10.35-1.11-15.5-2.15-6.08-11.68-9.27-17.05-5.79-5.27,3.41-7.22,7.95-6.99,13.99.14,3.56.53,7.22-.44,10.6h-23.98c-.22-.38-.37-.51-.37-.66-.05-4.56,0-9.12-.14-13.68-.15-5.18-4.72-10.76-9.31-11.57-8.81-1.55-15.64,4.23-15.64,13.24,0,4.11,0,8.21,0,12.61-4.92,0-9.32.08-13.72-.02-10.41-.22-18.81,7.79-17.84,18.57.39,4.32.06,8.7.06,13.34-5.17,0-9.9-.05-14.63.01-5.36.07-11.08,5.57-11.83,10.1-1.39,8.44,6.23,15.25,14.55,14.78,3.86-.22,7.74-.04,11.75-.04v24.92c-4.45,0-8.67-.07-12.89.02-3.2.07-6.5.62-8.75,2.93-3.6,3.69-6.1,8.11-4.12,13.5,2.13,5.8,6.42,8.43,12.98,8.43,4.21,0,8.42,0,12.83,0v24.95c-3.48,0-6.79-.12-10.08.03-3.74.18-7.43.36-10.78,2.69-4.11,2.87-6.48,8.21-5.32,12.83,1.1,4.36,7.17,9.83,11.59,9.41,4.82-.46,9.72-.1,14.69-.1,0,5.18.51,9.88-.1,14.44-1.36,10,8.64,18.06,17.22,17.5,4.62-.3,9.28-.05,14.15-.05,1.26,9.11-3.28,19.95,9.5,25.9,10.27,1.43,15.74-3.33,15.75-15.14,0-3.45,0-6.9,0-10.55h24.94c0,3.39,0,6.6,0,9.8,0,3.81.26,7.41,2.73,10.76,3.09,4.2,8.64,6.68,14,4.87,3.62-1.22,8.31-5.43,8.3-10.7,0-4.85,0-9.7,0-14.7h24.92c0,3.98-.14,7.7.03,11.41.22,4.83,1.4,9.35,5.68,12.32,5.16,3.59,12.81,2.96,17.28-2.41,3.93-7.43,2.05-14.57,2.39-21.58,5.71,0,11.1.03,16.49-.02,1.98-.02,4.05-.06,5.8-1.09,6.78-3.99,9.8-9.94,9.36-17.81-.23-4.18-.04-8.39-.04-12.56,8.59-1.68,18.23,2.96,24.73-6.3.08-.31.31-1.1.5-1.9.97-4.19,1.82-8.06-1.59-12.01-3.49-4.05-7.66-5.05-12.52-5.04ZM168.3,160.54c0,3.41-1.48,4.58-4.69,4.49-4.41-.12-8.82-.09-13.23-.05-3.15.03-4.43-1.39-4.41-4.56.06-16.85.02-33.69-.03-50.54,0-.99.44-2.13-.73-3.15-4.49,13.97-8.94,27.8-13.44,41.79h-21.8c-4.39-13.78-8.8-27.62-13.55-42.54-.15,1.94-.29,2.89-.29,3.84-.01,16.68-.08,33.36.04,50.04.03,3.7-1.18,5.38-5.05,5.16-5.51-.31-11.08.38-16.22-.44-1.24-1.59-1.21-2.95-1.21-4.26.07-27.3.18-54.6.22-81.9,0-2.16.89-3.46,2.97-3.48,9.9-.06,19.8,0,29.7.05.31,0,.63.19,1.39.44,4.22,14.29,8.51,28.79,12.8,43.3.29.05.58.1.87.15,4.53-14.59,9.07-29.17,13.66-43.95,10.35,0,20.48-.03,30.62.03,1.76.01,2.38,1.37,2.42,2.92.08,2.57.1,5.14.1,7.71-.06,24.98-.16,49.95-.15,74.93Z"/>
+    <rect class="cls-4" x="48.86" y="48.46" width="143.67" height="143.67" rx="10.57" ry="10.57"/>
+    <path class="cls-3" d="M165.55,75.28c-10.14-.06-20.27-.03-30.62-.03-4.59,14.78-9.12,29.36-13.66,43.95-.29-.05-.58-.1-.87-.15-4.29-14.51-8.58-29.01-12.8-43.3-.77-.25-1.08-.44-1.39-.44-9.9-.04-19.8-.1-29.7-.05-2.08.01-2.96,1.32-2.97,3.48-.04,27.3-.15,54.6-.22,81.9,0,1.31-.03,2.67,1.21,4.26,5.13.82,10.7.13,16.22.44,3.87.22,5.07-1.46,5.05-5.16-.12-16.68-.06-33.36-.04-50.04,0-.95.14-1.9.29-3.84,4.75,14.91,9.16,28.76,13.55,42.54h21.8c4.5-13.99,8.94-27.82,13.44-41.79,1.18,1.01.73,2.16.73,3.15.04,16.85.09,33.69.03,50.54-.01,3.17,1.26,4.59,4.41,4.56,4.41-.04,8.82-.07,13.23.05,3.21.09,4.69-1.08,4.69-4.49-.01-24.98.09-49.95.15-74.93,0-2.57-.02-5.14-.1-7.71-.05-1.55-.67-2.91-2.42-2.92Z"/>
+    <g>
+      <path class="cls-2" d="M372.64,135.48c-.13-.49-.54-.78-.71-.89-7.15-4.87-14.15-9.95-21.35-14.75-4.85-3.24-7.95-5.93-8.98-6.85-3.54-3.13-6.16-6.05-7.88-8.11,18.27.05,31.65-.03,32.44-.05.12,0,.6-.03.98-.42.22-.22.31-.45.35-.59.02-4.96.04-9.91.06-14.87,0-.78-.62-1.42-1.39-1.42-8.12.04-16.23.08-24.35.12,4.03-4.67,7.45-8.18,9.86-10.55,2.43-2.39,4.46-5.14,6.77-7.64,1.93-2.09,4.11-4.37,3.5-6.38-.2-.66-.63-1.08-.87-1.29-3.46-2.9-6.93-5.8-10.39-8.7-.41-.25-1.2-.63-2.04-.42-.82.21-1.3.88-1.47,1.12-3.4,4.75-5.17,7.07-5.2,7.12,0,0-1.32,2.51-13.36,16.27-.12.14-.48.54-.48,1.08,0,.5.31.88.49,1.07,2.96,2.73,5.93,5.46,8.89,8.2h-10.94v-37.5c0-.78-.62-1.42-1.39-1.42h-15.19c-.77,0-1.39.64-1.39,1.42v37.5h-13.87l10.91-9.45c.55-.48.65-1.31.23-1.91-1.08-1.54-2.47-3.35-4.11-5.37-1.64-2.02-3.6-4.28-5.8-6.7-2.13-2.43-4.13-4.59-5.93-6.43-1.8-1.83-3.5-3.43-5.06-4.75-.53-.45-1.31-.43-1.82.04l-10.51,9.67c-.29.27-.46.65-.46,1.05s.17.78.46,1.05c.96.88,2.1,2.06,3.39,3.49,1.33,1.47,2.71,3.04,4.15,4.7,1.44,1.66,2.87,3.36,4.26,5.04,1.41,1.71,2.71,3.27,3.89,4.68,1.17,1.39,2.11,2.54,2.83,3.44.86,1.09,1.04,1.35,1.04,1.35.02.03.03.06.05.09h-23.14c-.77,0-1.39.64-1.39,1.42v14.45c0,.78.62,1.42,1.39,1.42,10.73.14,21.47.29,32.2.43-3.44,3.44-6.64,6.34-9.41,8.73-4.74,4.08-8.53,6.9-9.53,7.64-5.15,3.8-7.72,5.7-9.46,6.47,0,0-1.99,2.06-9.47,6.03-.37.2-.63.55-.72.96-.09.41.01.84.27,1.18,3.31,4.84,6.62,9.68,9.93,14.51,2.17-1.39,5.05-3.3,8.34-5.71,1.13-.83,4.24-3.11,8.34-6.5,6.58-5.43,8.21-7.48,15.62-13.59,1.43-1.18,2.61-2.13,3.36-2.73v32.48c0,.78.62,1.42,1.39,1.42h15.19c.77,0,1.39-.64,1.39-1.42v-32.91c2.78,2.65,6.21,5.83,10.21,9.33,10.52,9.2,9.2,6.82,12.78,10.6,0,0,7.52,6.23,12.33,9.29.65.41,1.5.21,1.91-.45l8.68-14c.21-.34.27-.75.17-1.13Z"/>
+      <g>
+        <path class="cls-2" d="M481.65,98.3h-43.96c-.78,0-1.42.63-1.42,1.42v51.72c0,.78.63,1.42,1.42,1.42h43.96c.78,0,1.42-.63,1.42-1.42v-51.72c0-.78-.63-1.42-1.42-1.42ZM467.34,137.4h-15.33v-4.1h15.33v4.1ZM467.34,118.08h-15.33v-4.1h15.33v4.1Z"/>
+        <path class="cls-2" d="M485.91,80.91h-8.67v-6.03h6.54c.78,0,1.42-.63,1.42-1.42v-13.3c0-.78-.63-1.42-1.42-1.42h-6.54v-9.15c0-.78-.63-1.42-1.42-1.42h-12.56c-.78,0-1.42.63-1.42,1.42v9.15h-4.46v-9.15c0-.78-.63-1.42-1.42-1.42h-12.45c-.78,0-1.42.63-1.42,1.42v9.15h-5.54c-.56,0-1.04.32-1.27.79v-5.86c0-.78-.63-1.42-1.42-1.42h-48.55c-.78,0-1.42.63-1.42,1.42v12.96c0,.78.63,1.42,1.42,1.42h11.48v5.24h-9.91c-.78,0-1.42.63-1.42,1.42v76.27c0,.78.63,1.42,1.42,1.42h46.2c.78,0,1.42-.63,1.42-1.42v-54.75c.26.29.63.46,1.05.46h50.35c.78,0,1.42-.63,1.42-1.42v-12.96c0-.78-.63-1.42-1.42-1.42ZM421.7,136.6h-23.18v-3.98h23.18v3.98ZM421.7,117.28h-19.16c1.54-2.24,2.74-4.23,3.57-5.91.83-1.69,1.57-3.33,2.19-4.91,1.19-3.22,1.77-7.95,1.77-14.47v-3.02h.08v13.36c0,3.98.93,7.04,2.78,9.08,1.84,2.04,4.77,3.29,8.61,3.69l.17.03v2.16ZM442.11,80.91h-6.54c-.42,0-.79.18-1.05.46v-6.66c0-.78-.63-1.42-1.42-1.42h-9.57v-5.24h10.36c.56,0,1.04-.32,1.27-.79v6.2c0,.78.63,1.42,1.42,1.42h5.54v6.03ZM461.85,80.91h-4.46v-6.03h4.46v6.03Z"/>
+      </g>
+      <path class="cls-2" d="M608.47,127.84c-4.56-1.17-9.11-2.33-13.67-3.5-.16-20.74-.33-41.47-.49-62.21,0-.79-.63-1.43-1.42-1.43h-34.31v-10.58c0-.79-.63-1.43-1.42-1.43h-14.6c-.78,0-1.42.64-1.42,1.43v10.58h-32.96c-.78,0-1.42.64-1.42,1.43v66c0,.79.63,1.43,1.42,1.43h32.96v6.12c0,3.15.28,5.89.83,8.12.57,2.35,1.57,4.34,2.95,5.92,1.39,1.59,3.28,2.81,5.6,3.61,2.2.76,4.97,1.27,8.25,1.51,1.43.07,3.35.15,5.76.23,2.44.08,4.95.11,7.46.11s5-.02,7.33-.06c2.4-.04,4.24-.14,5.62-.29,3.19-.31,5.93-.72,8.16-1.23,3.05-.7,5.13-2.13,5.99-2.65,1.51-.92,3.64-2.22,5.55-4.66,1.81-2.3,2.48-4.4,3.28-6.89.81-2.52,1.79-5.71,1.06-9.61-.15-.82-.35-1.48-.5-1.94ZM541.15,112.97h-17.16v-9.73h17.16v9.73ZM541.15,87.12h-17.16v-9.84h17.16v9.84ZM558.59,77.28h18.51v9.84h-18.51v-9.84ZM558.59,103.24h18.51v9.73h-18.51v-9.73ZM590.3,133.5c-.06.19-.43,1.31-.83,1.94-1.12,1.76-3.83,1.83-12.61,1.89-7.06.05-.21-.03-7.33-.06-5.89-.02-7.51.05-8.56-1.22-1.02-1.24-1.31-3.54-1.44-4.56-.1-.8-.12-1.48-.11-1.95,10.48.04,20.96.08,31.44.12.02.9-.05,2.27-.56,3.83Z"/>
+      <path class="cls-2" d="M721.16,93.62h-39.92v-.2c6.24-3.1,12.4-6.63,18.31-10.49,6.14-4.01,12.31-8.35,18.34-12.9.35-.27.56-.69.56-1.13v-14.44c0-.78-.63-1.42-1.42-1.42h-87.02c-.78,0-1.42.63-1.42,1.42v14.32c0,.78.63,1.42,1.42,1.42h54.17c-.81.75-2.1,1.91-3.75,3.22-3.49,2.77-5.95,4.13-9.75,6.58-1.85,1.19-4.54,2.98-7.75,5.33-.03,2.76-.06,5.52-.1,8.29h-41.41c-.78,0-1.41.63-1.41,1.42v15c0,.78.63,1.42,1.41,1.42h41.41v21.77c0,1.22-.04,2.25-.11,3.05-.05.57-.06,1.11-.42,1.34-.35.22-.82.04-1.08-.04-1.08-.36-2.28-.11-3.42-.17-2.27-.12-2.51.11-5,.04-2.39-.07-4.79.16-7.17-.08-.27-.03-.93-.1-1.29.29-.44.48-.17,1.38-.04,1.75,1.43,4.35,2.86,8.69,4.29,13.04.11.5.34,1.22.92,1.83,1.16,1.24,2.98,1.26,4.12,1.25,9.2-.06,11.21-.21,11.21-.21,4.83-.36,5.78-.39,7.58-.96,1.76-.56,3.69-1.19,5.38-2.95,1.68-1.74,2.36-3.6,2.76-5.45.44-2.03.66-4.52.66-7.4v-27.11h39.92c.78,0,1.41-.63,1.41-1.42v-15c0-.78-.63-1.42-1.41-1.42Z"/>
+      <path class="cls-2" d="M839.47,131.72h-40.52v-59.68h33.89c.78,0,1.42-.63,1.42-1.42v-15.57c0-.78-.63-1.42-1.42-1.42h-86.74c-.78,0-1.42.63-1.42,1.42v15.57c0,.78.63,1.42,1.42,1.42h33.55v59.68h-40.41c-.78,0-1.42.63-1.42,1.42v15.35c0,.78.63,1.42,1.42,1.42h100.22c.78,0,1.42-.63,1.42-1.42v-15.35c0-.78-.63-1.42-1.42-1.42Z"/>
+      <path class="cls-2" d="M955.36,61.13h-39.83c.46-1.11.9-2.22,1.3-3.32.65-1.74,1.31-3.52,2-5.34.14-.37.12-.79-.06-1.14-.18-.35-.5-.62-.88-.72l-14.29-3.98c-.73-.2-1.49.2-1.73.93-2.48,7.62-5.66,15.09-9.45,22.22-3,5.64-6.11,10.87-9.28,15.62v-12.58c1.19-3.03,2.37-6.23,3.52-9.52,1.16-3.3,2.38-6.9,3.73-10.99.12-.36.09-.76-.09-1.1-.18-.34-.48-.59-.85-.7l-13.84-4.21c-.36-.11-.76-.07-1.09.11-.33.18-.58.49-.68.86-1.13,4.04-2.62,8.43-4.42,13.05-1.81,4.65-3.82,9.34-5.97,13.95-2.16,4.62-4.45,9.15-6.82,13.44-2.37,4.3-4.71,8.14-6.96,11.42-.42.61-.3,1.43.27,1.9l11.21,9.21c.31.26.72.37,1.12.31.4-.06.75-.29.97-.63l1.97-3.03v46.25c0,.78.63,1.42,1.42,1.42h15.09c.78,0,1.42-.63,1.42-1.42v-57.07l8.02,6.03c.62.47,1.5.35,1.98-.27,2.9-3.8,5.62-7.74,8.08-11.71,2.03-3.29,3.95-6.68,5.73-10.12v73.83c0,.78.63,1.42,1.42,1.42h14.98c.78,0,1.42-.63,1.42-1.42v-20.29h27.52c.78,0,1.42-.63,1.42-1.42v-15.12c0-.78-.63-1.42-1.42-1.42h-27.52v-10.01h25.11c.78,0,1.42-.63,1.42-1.42v-14.89c0-.78-.63-1.42-1.42-1.42h-25.11v-9.21h30.6c.78,0,1.42-.63,1.42-1.42v-14.66c0-.78-.63-1.42-1.42-1.42Z"/>
+      <path class="cls-2" d="M1074.36,137.97h-41.39v-4.55h31.04c.78,0,1.42-.63,1.42-1.42v-13.19c0-.78-.63-1.42-1.42-1.42h-2.25l8.41-9.22c.49-.53.5-1.35.02-1.89-2.83-3.22-6.98-7.17-12.38-11.75l-3.96-3.29h9.69c.78,0,1.42-.63,1.42-1.42v-10.52h8.59c.78,0,1.42-.63,1.42-1.42v-19.1c0-.78-.63-1.42-1.42-1.42h-39.96l-2.28-8.83c-.17-.67-.81-1.12-1.49-1.06l-16.17,1.36c-.42.04-.8.25-1.04.59-.24.34-.32.77-.21,1.18.61,2.31,1.17,4.58,1.68,6.75h-39.86c-.78,0-1.42.63-1.42,1.42v19.1c0,.78.63,1.42,1.42,1.42h8.47v10.52c0,.78.63,1.42,1.42,1.42h11.51c-1.07.86-2.12,1.69-3.13,2.46-1.91,1.47-3.64,2.66-5.15,3.54-1.12.66-2.24,1.28-3.31,1.84-.94.49-1.91.8-2.9.93-.38.05-.71.25-.94.55-.23.3-.33.68-.28,1.06l1.63,11.71c.1.69.68,1.21,1.38,1.22,5.55.08,11.18.06,16.74-.06,5.06-.1,10.15-.22,15.25-.36v3.26h-31.39c-.78,0-1.42.63-1.42,1.42v13.19c0,.78.63,1.42,1.42,1.42h31.39v4.55h-41.86c-.78,0-1.42.63-1.42,1.42v12.62c0,.78.63,1.42,1.42,1.42h101.32c.78,0,1.42-.63,1.42-1.42v-12.62c0-.78-.63-1.42-1.42-1.42ZM1055.75,115.62c.57.62,1.11,1.21,1.64,1.77h-24.42v-3.81c3.26-.13,6.47-.27,9.64-.4,3.37-.14,6.82-.32,10.27-.53,1.04,1.03,2.01,2.03,2.87,2.97ZM990.4,76.13v-3.3h66.73v3.3h-66.73ZM1009.78,99.75c1.14-.79,2.29-1.62,3.43-2.48,2.38-1.78,4.82-3.8,7.26-6.03h15.11l-2.47,2.47c-.29.29-.44.7-.41,1.11s.24.79.58,1.03c.92.68,1.91,1.41,2.95,2.2.21.16.43.33.66.51-5.44.39-10.57.68-15.27.87-4.02.16-7.98.26-11.83.31Z"/>
+    </g>
+    <g>
+      <polygon class="cls-2" points="700.41 193.09 700.29 193.09 695.84 175.52 688.42 175.52 688.42 199.6 692.65 199.6 692.65 179.03 692.76 178.9 698.35 199.6 702.12 199.6 708.05 178.9 708.05 179.03 708.05 199.6 712.28 199.6 712.28 175.52 705.2 175.52 700.41 193.09"/>
+      <path class="cls-2" d="M727.36,178.51c3.04.09,4.65,1.61,4.83,4.56h5.64c-.36-5.47-3.85-8.24-10.47-8.33-6.62.26-10.07,4.47-10.33,12.63.18,7.98,3.62,12.06,10.33,12.23,6.71-.09,10.2-2.78,10.47-8.07h-5.64c-.09,2.95-1.7,4.47-4.83,4.56-2.95-.17-4.52-3.08-4.7-8.72.18-5.73,1.75-8.68,4.7-8.85Z"/>
+      <path class="cls-2" d="M756.74,188.14c.08,2.86-.24,4.82-.98,5.86-.73,1.22-2.03,1.82-3.9,1.82s-3.21-.61-4.02-1.82c-.73-1.04-1.06-2.99-.97-5.86v-13.15h-4.87v15.1c.16,5.99,3.45,9.07,9.87,9.24,6.25-.17,9.5-3.25,9.75-9.24v-15.1h-4.87v13.15Z"/>
+      <polygon class="cls-2" points="782.14 188.79 792.21 188.79 792.21 184.76 782.14 184.76 782.14 179.16 792.98 179.16 792.98 175.13 776.98 175.13 776.98 199.2 793.37 199.2 793.37 195.17 782.14 195.17 782.14 188.79"/>
+      <rect class="cls-2" x="797.64" y="174.74" width="4.33" height="24.08"/>
+      <path class="cls-2" d="M822.27,188.31c-.09-1.04-.4-2.04-.94-2.99-1.34-2.6-3.8-3.9-7.38-3.9-5.19.26-7.92,3.21-8.19,8.85-.09,5.81,2.64,8.68,8.19,8.59,4.83,0,7.47-1.73,7.92-5.21h-4.7c-.45,1.48-1.52,2.17-3.22,2.08-2.06.09-3.04-1.3-2.95-4.17h11.41c0-1.13-.05-2.21-.13-3.25ZM810.99,188.18c.09-2.34,1.07-3.51,2.95-3.51,2.06,0,3.09,1.17,3.09,3.51h-6.04Z"/>
+      <path class="cls-2" d="M831.26,189.46c.28-3.34,1.07-5.01,2.37-5.01,1.67,0,2.6,1.08,2.79,3.25h5.3c-.19-4.24-2.84-6.45-7.96-6.63-4.93.36-7.63,3.43-8.1,9.2.37,5.78,3.07,8.75,8.1,8.93,5.02,0,7.68-2.21,7.96-6.63h-5.3c-.09,2.26-.98,3.38-2.65,3.38-1.49,0-2.33-1.8-2.51-5.41v-1.08Z"/>
+      <path class="cls-2" d="M927.16,189.69c.28-3.34,1.07-5.01,2.37-5.01,1.67,0,2.6,1.08,2.79,3.25h5.3c-.19-4.24-2.84-6.45-7.96-6.63-4.93.36-7.63,3.43-8.1,9.2.37,5.78,3.07,8.75,8.1,8.93,5.02,0,7.68-2.21,7.96-6.63h-5.3c-.09,2.26-.98,3.38-2.65,3.38-1.49,0-2.33-1.8-2.51-5.41v-1.08Z"/>
+      <path class="cls-2" d="M854.41,195.73c-1.36.26-1.97-.65-1.8-2.73v-7.81h3.37v-3.38h-3.37v-5.08c-1.56,0-3.12,0-4.69,0,0,1.69,0,3.39,0,5.08h-3.13v3.38h3.13c0,3.23-.02,6.45-.03,9.68.03.49.17,2.15,1.47,3.24.82.7,1.73.84,2.75,1,.82.13,2.18.24,3.88-.17,0-1.11,0-2.23-.01-3.34-.48.09-1,.13-1.56.13Z"/>
+      <path class="cls-2" d="M999.9,195.61c-1.36.26-1.97-.65-1.8-2.73v-7.81h3.37v-3.38h-3.37v-5.08c-1.56,0-3.12,0-4.69,0,0,1.69,0,3.39,0,5.08h-3.13v3.38h3.13l-.03,9.68c.03.49.17,2.15,1.47,3.24.82.7,1.73.84,2.75,1,.82.13,2.18.24,3.88-.17v-3.34c-.5.09-1.02.13-1.58.13Z"/>
+      <path class="cls-2" d="M863.85,184.64h-.13v-3.25h-4.7c0,.54.04,1.31.13,2.3v15.17h5.1v-9.21c.18-1.08.4-1.94.67-2.57.45-.54,1.3-.95,2.55-1.22h2.28v-4.6c-2.95-.18-4.92.95-5.91,3.39Z"/>
+      <path class="cls-2" d="M881.19,181.41c-5.4.26-8.23,3.21-8.49,8.85.25,5.55,3.08,8.42,8.49,8.59,5.4-.17,8.23-3.04,8.49-8.59-.25-5.64-3.08-8.59-8.49-8.85ZM881.19,195.73c-2.28,0-3.42-1.82-3.42-5.47s1.14-5.6,3.42-5.6c2.45,0,3.63,1.87,3.55,5.6,0,3.64-1.18,5.47-3.55,5.47Z"/>
+      <path class="cls-2" d="M908.77,185.85c-.08-.78-.14-1.32-.38-1.9-.5-1.26-1.5-1.96-1.82-2.16-1.45-.93-2.93-.77-3.33-.71-.79-.01-2.53.08-4.12,1.26-.46.34-.82.71-1.1,1.06,0-.67,0-1.34-.01-2h-5.1v17.48h5.1v-10.43c.27-2.53,1.3-3.88,3.09-4.07,2.06,0,3.09,1.36,3.09,4.07v10.43c1.56,0,3.12,0,4.68.01,0-3.79-.02-7.57-.03-11.36.01-.42,0-.99-.07-1.67Z"/>
+      <rect class="cls-2" x="913.06" y="174.68" width="4.81" height="4.29"/>
+      <rect class="cls-2" x="913.18" y="181.97" width="4.58" height="16.79"/>
+      <path class="cls-2" d="M950.52,188.05c-2.08-.52-3.12-1.13-3.12-1.82,0-1.04.62-1.56,1.87-1.56,1.33.09,2.04.65,2.12,1.69h4.37c-.25-3.3-2.41-4.95-6.49-4.95-4.41.35-6.7,2-6.86,4.95-.17,2.86,1.79,4.69,5.86,5.47,2.08.44,3.16,1.13,3.24,2.08,0,1.22-.75,1.82-2.24,1.82-1.58-.09-2.45-.74-2.62-1.95h-4.49c.17,3.3,2.54,4.99,7.11,5.08,4.57-.35,6.99-2.08,7.24-5.21-.67-3.47-2.66-5.34-5.99-5.6Z"/>
+      <path class="cls-2" d="M980.42,184.99c-.32-.09-.51-.13-.59-.13-2.84-.43-4.18-1.56-4.02-3.38.08-1.91,1.26-2.95,3.55-3.12,2.29,0,3.47,1.22,3.55,3.64h4.5c-.24-4.69-2.72-7.16-7.45-7.42-5.84.35-8.87,2.99-9.11,7.94,0,3.21,2.4,5.42,7.22,6.64.16.09.43.17.83.26,2.76.61,4.14,1.74,4.14,3.38-.08,2-1.54,3.04-4.38,3.12-2.45-.17-3.67-1.65-3.67-4.43h-4.73c-.08,5.29,2.72,7.94,8.4,7.94,6.15-.17,9.26-2.78,9.34-7.81.08-3.3-2.45-5.51-7.57-6.64Z"/>
+      <path class="cls-2" d="M1020.78,181.81h-3.98c0,3.43.01,6.87.02,10.3,0,.19-.07,2.13-1.58,3.1-.96.62-2.02.54-2.38.52-.37-.03-1.06-.05-1.65-.47-.81-.57-1.24-1.68-1.29-3.31v-10.15h-4.23c-.01,3.67-.03,7.34-.04,11.01-.01.42.01,1.04.21,1.75.62,2.23,2.61,4.11,4.98,4.62,2.07.45,3.82-.28,4.27-.48.4-.17.72-.36.95-.5,0,.34,0,.68.01,1.02,1.58-.01,3.15-.03,4.73-.04,0-1.2-.01-2.39-.02-3.59v-13.8Z"/>
+      <path class="cls-2" d="M1042.61,174.52h-4.95v9.24c-1.1-1.47-2.58-2.26-4.44-2.34-4.74.26-7.27,3.21-7.61,8.85.34,5.55,2.71,8.42,7.1,8.59,2.37,0,4.01-.87,4.95-2.6,0,.26.04.65.13,1.17v1.17h4.95c-.09-1.04-.13-2.17-.13-3.38v-20.69ZM1034.24,195.73c-2.45,0-3.64-1.82-3.55-5.47-.09-3.73,1.1-5.6,3.55-5.6,2.11.17,3.25,2.04,3.42,5.6-.17,3.47-1.31,5.29-3.42,5.47Z"/>
+      <rect class="cls-2" x="1046.8" y="174.52" width="4.96" height="4.29"/>
+      <rect class="cls-2" x="1046.92" y="181.81" width="4.71" height="16.79"/>
+      <path class="cls-2" d="M1063.98,181.41c-5.35.26-8.14,3.21-8.39,8.85.25,5.55,3.05,8.42,8.39,8.59,5.34-.17,8.14-3.04,8.39-8.59-.25-5.64-3.05-8.59-8.39-8.85ZM1063.98,195.73c-2.25,0-3.38-1.82-3.38-5.47s1.13-5.6,3.38-5.6c2.42,0,3.59,1.87,3.51,5.6,0,3.64-1.17,5.47-3.51,5.47Z"/>
+    </g>
+  </g>
+</svg>
@@ -0,0 +1,146 @@
+# CC Switch v3.12.1
+
+> Stability Fixes, StepFun Presets, OpenClaw authHeader, and New Sponsor Partners
+
+**[中文版 →](v3.12.1-zh.md) | [日本語版 →](v3.12.1-ja.md)**
+
+---
+
+## Overview
+
+CC Switch v3.12.1 is a patch release focused on stability improvements and bug fixes. It resolves a Common Config modal infinite reopen loop, a WebDAV sync foreign key constraint failure, and several i18n interpolation issues. It also adds **StepFun** provider presets, **OpenClaw input type selection** and **authHeader** support, upgrades the default Gemini model to **3.1-pro**, and welcomes four new sponsor partners.
+
+**Release Date**: 2026-03-12
+
+**Update Scale**: 19 commits | 56 files changed | +1,429 / -396 lines
+
+---
+
+## Highlights
+
+- **Common Config modal fix**: Resolved an infinite reopen loop in the Common Config modal and added draft editing support
+- **WebDAV sync reliability**: Fixed a foreign key constraint failure when restoring `provider_health` during WebDAV sync
+- **StepFun presets**: Added StepFun (阶跃星辰) provider presets including the step-3.5-flash model
+- **OpenClaw enhancements**: Added input type selection for model Advanced Options and `authHeader` field for vendor-specific auth header support
+- **Gemini model upgrade**: Upgraded default Gemini model to 3.1-pro in provider presets
+- **New sponsors**: Welcomed Micu API, XCodeAPI, SiliconFlow, and CTok as sponsor partners
+
+---
+
+## New Features
+
+### StepFun Provider Presets
+
+Added provider presets for StepFun (阶跃星辰), a leading Chinese AI model provider.
+
+- New preset entries for StepFun across supported applications
+- Includes the step-3.5-flash model (#1369, thanks @hengm3467)
+
+### OpenClaw Enhancements
+
+Enhanced the OpenClaw configuration with more granular control and better vendor compatibility.
+
+- Added input type selection dropdown for model Advanced Options (#1368, thanks @liuxxxu)
+- Added optional `authHeader` boolean to `OpenClawProviderConfig` for vendor-specific auth header support (e.g. Longcat), and refactored form state to reuse the shared type
+
+### Sponsor Partners
+
+- **Micu API**: Added Micu API as sponsor partner with affiliate links
+- **XCodeAPI**: Added XCodeAPI as sponsor partner
+- **SiliconFlow**: Added SiliconFlow (硅基流动) as sponsor partner with affiliate links
+- **CTok**: Added CTok as sponsor partner
+
+---
+
+## Changes
+
+- **UCloud → Compshare**: Renamed UCloud provider to Compshare (优云智算) with full i18n support across all three locales (EN/ZH/JA)
+- **Compshare Links**: Updated Compshare sponsor registration links to coding-plan page
+- **Gemini Model Upgrade**: Upgraded default Gemini model from 2.5-pro to 3.1-pro in provider presets
+
+---
+
+## Bug Fixes
+
+### Common Config & UI
+
+- Fixed an infinite reopen loop in the Common Config modal and added draft editing support to prevent data loss during edits
+- Fixed toolbar compact mode not triggering on Windows due to left-side overflow (#1375, thanks @zuoliangyu)
+- Fixed session search index not syncing with query data, causing stale list display after session deletion
+
+### Sync & Data
+
+- Fixed foreign key constraint failure when restoring `provider_health` table during WebDAV sync
+
+### Provider & Preset
+
+- Added missing `authHeader: true` to Longcat provider preset (#1377, thanks @wavever)
+- Aligned OpenClaw tool permission profiles with upstream schema (#1355, thanks @bigsongeth)
+- Corrected X-Code API URL from `www.x-code.cn` to `x-code.cc`
+
+### i18n & Localization
+
+- Fixed stream check toast i18n interpolation keys not matching translation placeholders
+- Fixed proxy startup toast not interpolating address and port values (#1399, thanks @Mason-mengze)
+- Renamed OpenCode API format label from "OpenAI" to "OpenAI Responses" for accuracy
+
+---
+
+## Special Thanks
+
+Thanks to all contributors for their contributions to this release!
+
+@hengm3467 @liuxxxu @bigsongeth @zuoliangyu @wavever @Mason-mengze
+
+---
+
+## 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.1-Windows.msi`            | **Recommended** - MSI installer with auto-update     |
+| `CC-Switch-v3.12.1-Windows-Portable.zip`   | Portable version, extract and run, no registry write |
+
+### macOS
+
+| File                               | Description                                                          |
+| ---------------------------------- | -------------------------------------------------------------------- |
+| `CC-Switch-v3.12.1-macOS.zip`      | **Recommended** - Extract and drag to Applications, Universal Binary |
+| `CC-Switch-v3.12.1-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`              |
@@ -0,0 +1,146 @@
+# CC Switch v3.12.1
+
+> 安定性修正、StepFun プリセット、OpenClaw authHeader 対応、新スポンサーパートナー
+
+**[中文版 →](v3.12.1-zh.md) | [English →](v3.12.1-en.md)**
+
+---
+
+## 概要
+
+CC Switch v3.12.1 は、安定性の改善とバグ修正に焦点を当てたパッチリリースです。共通設定モーダルの無限再オープンループ、WebDAV 同期時の外部キー制約エラー、複数の i18n 補間問題を修正しました。また、**StepFun（阶跃星辰）** プロバイダープリセットの追加、OpenClaw の**入力タイプ選択**と **authHeader** サポート、デフォルト Gemini モデルの **3.1-pro** へのアップグレード、4 つの新スポンサーパートナーの追加が含まれます。
+
+**リリース日**: 2026-03-12
+
+**更新規模**: 19 commits | 56 files changed | +1,429 / -396 lines
+
+---
+
+## ハイライト
+
+- **共通設定モーダル修正**: 共通設定モーダルの無限再オープンループを解決し、下書き編集サポートを追加
+- **WebDAV 同期の信頼性向上**: WebDAV 同期で `provider_health` 復元時の外部キー制約エラーを修正
+- **StepFun プリセット**: StepFun（阶跃星辰）プロバイダープリセットを追加、step-3.5-flash モデルを含む
+- **OpenClaw 強化**: モデル詳細設定に入力タイプ選択を追加、ベンダー固有の認証ヘッダーサポート用 `authHeader` フィールドを追加
+- **Gemini モデルアップグレード**: プロバイダープリセットのデフォルト Gemini モデルを 3.1-pro にアップグレード
+- **新スポンサー**: Micu API、XCodeAPI、SiliconFlow、CTok をスポンサーパートナーとして追加
+
+---
+
+## 新機能
+
+### StepFun プロバイダープリセット
+
+中国の主要 AI モデルプロバイダーである StepFun（阶跃星辰）のプロバイダープリセットを追加しました。
+
+- サポート対象アプリケーション全体に StepFun プリセットエントリーを追加
+- step-3.5-flash モデルを含む（#1369、@hengm3467 に感謝）
+
+### OpenClaw 強化
+
+OpenClaw 設定をより細かく制御でき、ベンダー互換性を向上させました。
+
+- モデル詳細設定に入力タイプ（input type）選択ドロップダウンを追加（#1368、@liuxxxu に感謝）
+- `OpenClawProviderConfig` にオプションの `authHeader` ブール値を追加し、ベンダー固有の認証ヘッダー（例: Longcat）をサポート。フォーム状態を共有型の再利用にリファクタリング
+
+### スポンサーパートナー
+
+- **Micu API**: Micu API をスポンサーパートナーとして追加、アフィリエイトリンク付き
+- **XCodeAPI**: XCodeAPI をスポンサーパートナーとして追加
+- **SiliconFlow**: SiliconFlow（硅基流动）をスポンサーパートナーとして追加、アフィリエイトリンク付き
+- **CTok**: CTok をスポンサーパートナーとして追加
+
+---
+
+## 変更
+
+- **UCloud → Compshare**: UCloud プロバイダーを Compshare（优云智算）にリネームし、3 言語（EN/ZH/JA）の完全な i18n サポートを追加
+- **Compshare リンク**: Compshare スポンサー登録リンクを coding-plan ページに更新
+- **Gemini モデルアップグレード**: プロバイダープリセットのデフォルト Gemini モデルを 2.5-pro から 3.1-pro にアップグレード
+
+---
+
+## バグ修正
+
+### 共通設定と UI
+
+- 共通設定モーダルの無限再オープンループを修正し、編集中のデータ損失を防ぐための下書き編集サポートを追加
+- Windows でツールバーコンパクトモードが左側のオーバーフローにより機能しない問題を修正（#1375、@zuoliangyu に感謝）
+- セッション削除後にクエリデータと検索インデックスが同期されず、リストが更新されない問題を修正
+
+### 同期とデータ
+
+- WebDAV 同期で `provider_health` テーブルを復元する際の外部キー制約エラーを修正
+
+### プロバイダーとプリセット
+
+- Longcat プロバイダープリセットに欠落していた `authHeader: true` を追加（#1377、@wavever に感謝）
+- OpenClaw のツール権限プロファイルをアップストリームスキーマに合わせて修正（#1355、@bigsongeth に感謝）
+- X-Code API の URL を `www.x-code.cn` から `x-code.cc` に修正
+
+### i18n とローカリゼーション
+
+- Stream Check トーストの i18n 補間キーが翻訳プレースホルダーと一致しない問題を修正
+- プロキシ起動トーストでアドレスとポート値が補間されない問題を修正（#1399、@Mason-mengze に感謝）
+- OpenCode の API フォーマットラベルを「OpenAI」から「OpenAI Responses」にリネームし、正確性を向上
+
+---
+
+## 謝辞
+
+以下のコントリビューターの皆様、このリリースへの貢献に感謝します！
+
+@hengm3467 @liuxxxu @bigsongeth @zuoliangyu @wavever @Mason-mengze
+
+---
+
+## ダウンロードとインストール
+
+[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.1-Windows.msi`            | **推奨** - MSI インストーラー、自動更新対応          |
+| `CC-Switch-v3.12.1-Windows-Portable.zip`   | ポータブル版、解凍して実行、レジストリ書き込みなし   |
+
+### macOS
+
+| ファイル                           | 説明                                                              |
+| ---------------------------------- | ----------------------------------------------------------------- |
+| `CC-Switch-v3.12.1-macOS.zip`      | **推奨** - 解凍して Applications にドラッグ、Universal Binary     |
+| `CC-Switch-v3.12.1-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`              |
@@ -0,0 +1,146 @@
+# CC Switch v3.12.1
+
+> 稳定性修复、StepFun 预设、OpenClaw authHeader 支持，以及新赞助商伙伴
+
+**[English →](v3.12.1-en.md) | [日本語版 →](v3.12.1-ja.md)**
+
+---
+
+## 概览
+
+CC Switch v3.12.1 是一个以稳定性改进和 Bug 修复为主的补丁版本。修复了通用配置弹窗无限重复打开的循环问题、WebDAV 同步时的外键约束失败以及多个 i18n 插值问题。同时新增了 **StepFun（阶跃星辰）** 供应商预设、OpenClaw **输入类型选择** 和 **authHeader** 支持，将默认 Gemini 模型升级到 **3.1-pro**，并欢迎四位新赞助商伙伴加入。
+
+**发布日期**：2026-03-12
+
+**更新规模**：19 commits | 56 files changed | +1,429 / -396 lines
+
+---
+
+## 重点内容
+
+- **通用配置弹窗修复**：解决了通用配置弹窗无限重复打开的循环问题，并新增草稿编辑支持
+- **WebDAV 同步可靠性**：修复了 WebDAV 同步恢复 `provider_health` 时的外键约束失败
+- **StepFun 预设**：新增 StepFun（阶跃星辰）供应商预设，包含 step-3.5-flash 模型
+- **OpenClaw 增强**：新增模型高级选项的输入类型选择和 `authHeader` 字段，支持供应商特定的认证头
+- **Gemini 模型升级**：供应商预设中的默认 Gemini 模型升级到 3.1-pro
+- **新赞助商**：欢迎 Micu API、XCodeAPI、SiliconFlow、CTok 加入赞助伙伴
+
+---
+
+## 新功能
+
+### StepFun 供应商预设
+
+新增 StepFun（阶跃星辰）供应商预设，阶跃星辰是领先的中国 AI 模型提供商。
+
+- 在各支持应用中新增 StepFun 预设条目
+- 包含 step-3.5-flash 模型（#1369，感谢 @hengm3467）
+
+### OpenClaw 增强
+
+增强 OpenClaw 配置能力，提供更细粒度的控制和更好的供应商兼容性。
+
+- 新增模型高级选项的输入类型（input type）选择下拉框（#1368，感谢 @liuxxxu）
+- 在 `OpenClawProviderConfig` 中新增可选的 `authHeader` 布尔字段，支持供应商特定的认证头（如 Longcat），并重构表单状态以复用共享类型
+
+### 赞助商伙伴
+
+- **Micu API**：新增 Micu API 赞助商及推广链接
+- **XCodeAPI**：新增 XCodeAPI 赞助商
+- **SiliconFlow**：新增 SiliconFlow（硅基流动）赞助商及推广链接
+- **CTok**：新增 CTok 赞助商
+
+---
+
+## 变更
+
+- **UCloud → Compshare**：将 UCloud 供应商更名为 Compshare（优云智算），支持三种语言（中/英/日）的完整国际化
+- **Compshare 链接**：更新 Compshare 赞助商注册链接指向 coding-plan 页面
+- **Gemini 模型升级**：供应商预设中的默认 Gemini 模型从 2.5-pro 升级到 3.1-pro
+
+---
+
+## Bug 修复
+
+### 通用配置与 UI
+
+- 修复通用配置弹窗无限重复打开的循环问题，并新增草稿编辑支持以防止编辑过程中数据丢失
+- 修复 Windows 下因左侧溢出导致工具栏紧凑模式不触发的问题（#1375，感谢 @zuoliangyu）
+- 修复会话删除后搜索索引未与查询数据同步，导致列表显示过期的问题
+
+### 同步与数据
+
+- 修复 WebDAV 同步恢复 `provider_health` 表时的外键约束失败
+
+### 供应商与预设
+
+- 为 Longcat 供应商预设补充缺失的 `authHeader: true`（#1377，感谢 @wavever）
+- 对齐 OpenClaw 工具权限配置与上游 schema（#1355，感谢 @bigsongeth）
+- 修正 X-Code API URL，从 `www.x-code.cn` 改为 `x-code.cc`
+
+### i18n 与本地化
+
+- 修复 Stream Check Toast 的 i18n 插值 key 与翻译占位符不匹配
+- 修复代理启动 Toast 未正确插值地址和端口的问题（#1399，感谢 @Mason-mengze）
+- 将 OpenCode API 格式标签从 "OpenAI" 改为 "OpenAI Responses"，更准确地反映实际格式
+
+---
+
+## 特别感谢
+
+感谢以下贡献者为本版本做出的贡献！
+
+@hengm3467 @liuxxxu @bigsongeth @zuoliangyu @wavever @Mason-mengze
+
+---
+
+## 下载与安装
+
+访问 [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.1-Windows.msi`            | **推荐** - MSI 安装包，支持自动更新 |
+| `CC-Switch-v3.12.1-Windows-Portable.zip`   | 便携版，解压即用，不写入注册表      |
+
+### macOS
+
+| 文件                               | 说明                                                      |
+| ---------------------------------- | --------------------------------------------------------- |
+| `CC-Switch-v3.12.1-macOS.zip`      | **推荐** - 解压后拖入 Applications 即可，Universal Binary |
+| `CC-Switch-v3.12.1-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`              |
@@ -1,6 +1,6 @@
 {
  "name": "cc-switch",
-  "version": "3.12.0",
+  "version": "3.12.1",
  "description": "All-in-One Assistant for Claude Code, Codex & Gemini CLI",
  "type": "module",
  "scripts": {
@@ -1,6 +1,6 @@
 [package]
 name = "cc-switch"
-version = "3.12.0"
+version = "3.12.1"
 description = "All-in-One Assistant for Claude Code, Codex & Gemini CLI"
 authors = ["Jason Young"]
 license = "MIT"
@@ -15,9 +15,8 @@ use tempfile::NamedTempFile;

 const CC_SWITCH_SQL_EXPORT_HEADER: &str = "-- CC Switch SQLite 导出";

-/// Tables that are local-only (not synced via WebDAV snapshots).
-/// Schema is still exported, but data rows are skipped.
-const LOCAL_ONLY_TABLES: &[&str] = &[
+/// Tables whose data rows are skipped when exporting for WebDAV sync.
+const SYNC_SKIP_TABLES: &[&str] = &[
    "proxy_request_logs",
    "stream_check_logs",
    "provider_health",
@@ -25,6 +24,15 @@ const LOCAL_ONLY_TABLES: &[&str] = &[
    "usage_daily_rollups",
 ];

+/// Tables whose local data is preserved (restored from local snapshot) during WebDAV import.
+/// Excludes ephemeral tables like provider_health that can safely rebuild at runtime.
+const SYNC_PRESERVE_TABLES: &[&str] = &[
+    "proxy_request_logs",
+    "stream_check_logs",
+    "proxy_live_backup",
+    "usage_daily_rollups",
+];
+
 /// A database backup entry for the UI
 #[derive(Debug, serde::Serialize)]
 #[serde(rename_all = "camelCase")]
@@ -44,7 +52,7 @@ impl Database {
    /// Export SQL for sync (WebDAV), skipping local-only tables' data
    pub fn export_sql_string_for_sync(&self) -> Result<String, AppError> {
        let snapshot = self.snapshot_to_memory()?;
-        Self::dump_sql(&snapshot, LOCAL_ONLY_TABLES)
+        Self::dump_sql(&snapshot, SYNC_SKIP_TABLES)
    }

    /// 导出为 SQLite 兼容的 SQL 文本
@@ -80,7 +88,7 @@ impl Database {
    /// Import SQL generated for sync, then restore local-only tables from the
    /// current device snapshot before replacing the main database.
    pub(crate) fn import_sql_string_for_sync(&self, sql_raw: &str) -> Result<String, AppError> {
-        self.import_sql_string_inner(sql_raw, LOCAL_ONLY_TABLES)
+        self.import_sql_string_inner(sql_raw, SYNC_PRESERVE_TABLES)
    }

    fn import_sql_string_inner(
@@ -242,14 +242,9 @@ pub struct ProviderMeta {
    /// - "openai_responses": OpenAI Responses API 格式，需要转换
    #[serde(rename = "apiFormat", skip_serializing_if = "Option::is_none")]
    pub api_format: Option<String>,
-    /// Claude 认证字段名（仅 Claude 供应商使用）
-    /// - "ANTHROPIC_AUTH_TOKEN" (默认): 大多数第三方/聚合供应商
-    /// - "ANTHROPIC_API_KEY": 少数供应商需要原生 API Key
+    /// Claude 认证字段名（"ANTHROPIC_AUTH_TOKEN" 或 "ANTHROPIC_API_KEY"）
    #[serde(rename = "apiKeyField", skip_serializing_if = "Option::is_none")]
    pub api_key_field: Option<String>,
-    /// 是否将 base_url 视为完整 API 端点（不拼接 endpoint 路径）
-    #[serde(rename = "isFullUrl", skip_serializing_if = "Option::is_none")]
-    pub is_full_url: Option<bool>,
    /// Prompt cache key for OpenAI-compatible endpoints.
    /// When set, injected into converted requests to improve cache hit rate.
    /// If not set, provider ID is used automatically during format conversion.
@@ -792,61 +792,21 @@ impl RequestForwarder {
        // 检查是否需要格式转换
        let needs_transform = adapter.needs_transform(provider);

-        // 检查 isFullUrl 模式：直接使用 base_url 作为完整 API 端点
-        let is_full_url = provider
-            .meta
-            .as_ref()
-            .and_then(|m| m.is_full_url)
-            .unwrap_or(false);
-
-        let url = if is_full_url {
-            // 全链接模式：直接使用 base_url，将客户端 query 追加
-            let query = endpoint.split_once('?').map(|(_, q)| q);
-            match query {
-                Some(q) if !q.is_empty() => {
-                    if base_url.contains('?') {
-                        format!("{base_url}&{q}")
-                    } else {
-                        format!("{base_url}?{q}")
-                    }
-                }
-                _ => base_url.clone(),
-            }
-        } else {
-            // 正常模式：endpoint 可能带 query string，需拆分路径和参数
-            let effective_endpoint: String = if needs_transform && adapter.name() == "Claude" {
-                let (path, query) = match endpoint.split_once('?') {
-                    Some((p, q)) => (p, Some(q)),
-                    None => (endpoint, None),
-                };
-                if path == "/v1/messages" || path == "/claude/v1/messages" {
-                    // 转换到 OpenAI 兼容端点时剥离 beta=true（Anthropic 专有参数）
-                    let api_format = super::providers::get_claude_api_format(provider);
-                    let target_path = if api_format == "openai_responses" {
-                        "/v1/responses"
-                    } else {
-                        "/v1/chat/completions"
-                    };
-                    let filtered = query.map(|q| {
-                        q.split('&')
-                            .filter(|p| !p.starts_with("beta="))
-                            .collect::<Vec<_>>()
-                            .join("&")
-                    });
-                    match filtered.as_deref() {
-                        Some(q) if !q.is_empty() => format!("{target_path}?{q}"),
-                        _ => target_path.to_string(),
-                    }
+        let effective_endpoint =
+            if needs_transform && adapter.name() == "Claude" && endpoint == "/v1/messages" {
+                // 根据 api_format 选择目标端点
+                let api_format = super::providers::get_claude_api_format(provider);
+                if api_format == "openai_responses" {
+                    "/v1/responses"
                } else {
-                    endpoint.to_string()
+                    "/v1/chat/completions"
                }
            } else {
-                endpoint.to_string()
+                endpoint
            };

-            // 使用适配器构建 URL
-            adapter.build_url(&base_url, &effective_endpoint)
-        };
+        // 使用适配器构建 URL
+        let url = adapter.build_url(&base_url, effective_endpoint);

        // 应用模型映射（独立于格式转换）
        let (mapped_body, _original_model, _mapped_model) =
@@ -61,19 +61,12 @@ pub async fn get_status(State(state): State<ProxyState>) -> Result<Json<ProxySta
 /// - 现在 OpenRouter 已推出 Claude Code 兼容接口，默认不再启用该转换（逻辑保留以备回退）
 pub async fn handle_messages(
    State(state): State<ProxyState>,
-    uri: axum::http::Uri,
    headers: axum::http::HeaderMap,
    Json(body): Json<Value>,
 ) -> Result<axum::response::Response, ProxyError> {
    let mut ctx =
        RequestContext::new(&state, &body, &headers, AppType::Claude, "Claude", "claude").await?;

-    // 提取完整路径+query（如 "/v1/messages?beta=true"），透传客户端 URI
-    let endpoint = uri
-        .path_and_query()
-        .map(|pq| pq.as_str())
-        .unwrap_or(uri.path());
-
    let is_stream = body
        .get("stream")
        .and_then(|s| s.as_bool())
@@ -84,7 +77,7 @@ pub async fn handle_messages(
    let result = match forwarder
        .forward_with_retry(
            &AppType::Claude,
-            endpoint,
+            "/v1/messages",
            body.clone(),
            headers,
            ctx.get_providers(),
@@ -261,8 +261,6 @@ impl ProviderAdapter for ClaudeAdapter {
        //
        // 现在 OpenRouter 已推出 Claude Code 兼容接口，因此默认直接透传 endpoint。
        // 如需回退旧逻辑，可在 forwarder 中根据 needs_transform 改写 endpoint。
-        //
-        // ?beta=true 不再由代理注入，而是由客户端自身发送并透传。

        let mut base = format!(
            "{}/{}",
@@ -275,7 +273,19 @@ impl ProviderAdapter for ClaudeAdapter {
            base = base.replace("/v1/v1", "/v1");
        }

-        base
+        // 为 Claude 原生 /v1/messages 端点添加 ?beta=true 参数
+        // 这是某些上游服务（如 DuckCoding）验证请求来源的关键参数
+        // 注意：不要为 OpenAI Chat Completions (/v1/chat/completions) 添加此参数
+        //       当 apiFormat="openai_chat" 时，请求会转发到 /v1/chat/completions，
+        //       但该端点是 OpenAI 标准，不支持 ?beta=true 参数
+        if endpoint.contains("/v1/messages")
+            && !endpoint.contains("/v1/chat/completions")
+            && !endpoint.contains('?')
+        {
+            format!("{base}?beta=true")
+        } else {
+            base
+        }
    }

    fn add_auth_headers(&self, request: RequestBuilder, auth: &AuthInfo) -> RequestBuilder {
@@ -512,21 +522,23 @@ mod tests {
    #[test]
    fn test_build_url_anthropic() {
        let adapter = ClaudeAdapter::new();
-        // ?beta=true 不再由代理注入，而是由客户端自身发送并透传
+        // /v1/messages 端点会自动添加 ?beta=true 参数
        let url = adapter.build_url("https://api.anthropic.com", "/v1/messages");
-        assert_eq!(url, "https://api.anthropic.com/v1/messages");
+        assert_eq!(url, "https://api.anthropic.com/v1/messages?beta=true");
    }

    #[test]
    fn test_build_url_openrouter() {
        let adapter = ClaudeAdapter::new();
+        // /v1/messages 端点会自动添加 ?beta=true 参数
        let url = adapter.build_url("https://openrouter.ai/api", "/v1/messages");
-        assert_eq!(url, "https://openrouter.ai/api/v1/messages");
+        assert_eq!(url, "https://openrouter.ai/api/v1/messages?beta=true");
    }

    #[test]
    fn test_build_url_no_beta_for_other_endpoints() {
        let adapter = ClaudeAdapter::new();
+        // 非 /v1/messages 端点不添加 ?beta=true
        let url = adapter.build_url("https://api.anthropic.com", "/v1/complete");
        assert_eq!(url, "https://api.anthropic.com/v1/complete");
    }
@@ -534,14 +546,16 @@ mod tests {
    #[test]
    fn test_build_url_preserve_existing_query() {
        let adapter = ClaudeAdapter::new();
-        // 客户端携带的 query 参数原样透传
-        let url = adapter.build_url("https://api.anthropic.com", "/v1/messages?beta=true");
-        assert_eq!(url, "https://api.anthropic.com/v1/messages?beta=true");
+        // 已有查询参数时不重复添加
+        let url = adapter.build_url("https://api.anthropic.com", "/v1/messages?foo=bar");
+        assert_eq!(url, "https://api.anthropic.com/v1/messages?foo=bar");
    }

    #[test]
    fn test_build_url_no_beta_for_openai_chat_completions() {
        let adapter = ClaudeAdapter::new();
+        // OpenAI Chat Completions 端点不添加 ?beta=true
+        // 这是 Nvidia 等 apiFormat="openai_chat" 供应商使用的端点
        let url = adapter.build_url("https://integrate.api.nvidia.com", "/v1/chat/completions");
        assert_eq!(url, "https://integrate.api.nvidia.com/v1/chat/completions");
    }
@@ -313,19 +313,8 @@ impl StreamCheckService {

        let is_openai_chat = api_format == "openai_chat";

-        let is_full_url = provider
-            .meta
-            .as_ref()
-            .and_then(|m| m.is_full_url)
-            .unwrap_or(false);
-
-        // URL rules:
-        // - full URL mode: use base_url as-is
-        // - openai_chat: /v1/chat/completions
-        // - anthropic: /v1/messages?beta=true
-        let url = if is_full_url {
-            base_url.to_string()
-        } else if is_openai_chat {
+        // URL: /v1/chat/completions for openai_chat, /v1/messages?beta=true for anthropic
+        let url = if is_openai_chat {
            if base.ends_with("/v1") {
                format!("{base}/chat/completions")
            } else {
@@ -661,8 +661,11 @@ fn validate_artifact_size_limit(artifact_name: &str, size: u64) -> Result<(), Ap
        let max_mb = MAX_SYNC_ARTIFACT_BYTES / 1024 / 1024;
        return Err(localized(
            "webdav.sync.artifact_too_large",
-            format!("artifact {artifact_name} 超过下载上限（{max_mb} MB）"),
-            format!("Artifact {artifact_name} exceeds download limit ({max_mb} MB)"),
+            format!("artifact {artifact_name} 超过下载上限（{} MB）", max_mb),
+            format!(
+                "Artifact {artifact_name} exceeds download limit ({} MB)",
+                max_mb
+            ),
        ));
    }
    Ok(())
@@ -350,8 +350,8 @@ fn copy_entry_with_total_limit<R: Read, W: Write>(
            let max_mb = max_total_bytes / 1024 / 1024;
            return Err(localized(
                "webdav.sync.skills_zip_too_large",
-                format!("skills.zip 解压后体积超过上限（{max_mb} MB）"),
-                format!("skills.zip extracted size exceeds limit ({max_mb} MB)"),
+                format!("skills.zip 解压后体积超过上限（{} MB）", max_mb),
+                format!("skills.zip extracted size exceeds limit ({} MB)", max_mb),
            ));
        }

@@ -1,7 +1,7 @@
 {
  "$schema": "https://schema.tauri.app/config/2",
  "productName": "CC Switch",
-  "version": "3.12.0",
+  "version": "3.12.1",
  "identifier": "com.ccswitch.desktop",
  "build": {
    "frontendDist": "../dist",
@@ -255,7 +255,7 @@ function App() {
    deleteProvider,
    saveUsageScript,
    setAsDefaultModel,
-  } = useProviderActions(activeApp, isProxyRunning);
+  } = useProviderActions(activeApp);

  const disableOmoMutation = useDisableCurrentOmo();
  const handleDisableOmo = () => {
@@ -73,13 +73,9 @@ interface ClaudeFormFieldsProps {
  apiFormat: ClaudeApiFormat;
  onApiFormatChange: (format: ClaudeApiFormat) => void;

-  // Auth Key Field (ANTHROPIC_AUTH_TOKEN vs ANTHROPIC_API_KEY)
+  // Auth Field (ANTHROPIC_AUTH_TOKEN or ANTHROPIC_API_KEY)
  apiKeyField: ClaudeApiKeyField;
  onApiKeyFieldChange: (field: ClaudeApiKeyField) => void;
-
-  // Full URL mode
-  isFullUrl: boolean;
-  onFullUrlChange: (value: boolean) => void;
 }

 export function ClaudeFormFields({
@@ -116,8 +112,6 @@ export function ClaudeFormFields({
  onApiFormatChange,
  apiKeyField,
  onApiKeyFieldChange,
-  isFullUrl,
-  onFullUrlChange,
 }: ClaudeFormFieldsProps) {
  const { t } = useTranslation();

@@ -187,9 +181,6 @@ export function ClaudeFormFields({
                : t("providerForm.apiHint")
          }
          onManageClick={() => onEndpointModalToggle(true)}
-          showFullUrlToggle={true}
-          isFullUrl={isFullUrl}
-          onFullUrlChange={onFullUrlChange}
        />
      )}

@@ -245,17 +236,17 @@ export function ClaudeFormFields({
        </div>
      )}

-      {/* 认证字段选择（仅非官方供应商显示） */}
+      {/* 认证字段选择器 */}
      {shouldShowModelSelector && (
        <div className="space-y-2">
-          <FormLabel htmlFor="apiKeyField">
+          <FormLabel>
            {t("providerForm.authField", { defaultValue: "认证字段" })}
          </FormLabel>
          <Select
            value={apiKeyField}
            onValueChange={(v) => onApiKeyFieldChange(v as ClaudeApiKeyField)}
          >
-            <SelectTrigger id="apiKeyField" className="w-full">
+            <SelectTrigger>
              <SelectValue />
            </SelectTrigger>
            <SelectContent>
@@ -9,7 +9,7 @@ interface CodexCommonConfigModalProps {
  isOpen: boolean;
  onClose: () => void;
  value: string;
-  onChange: (value: string) => void;
+  onSave: (value: string) => boolean;
  error?: string;
  onExtract?: () => void;
  isExtracting?: boolean;
@@ -23,13 +23,14 @@ export const CodexCommonConfigModal: React.FC<CodexCommonConfigModalProps> = ({
  isOpen,
  onClose,
  value,
-  onChange,
+  onSave,
  error,
  onExtract,
  isExtracting,
 }) => {
  const { t } = useTranslation();
  const [isDarkMode, setIsDarkMode] = useState(false);
+  const [draftValue, setDraftValue] = useState(value);

  useEffect(() => {
    setIsDarkMode(document.documentElement.classList.contains("dark"));
@@ -46,11 +47,28 @@ export const CodexCommonConfigModal: React.FC<CodexCommonConfigModalProps> = ({
    return () => observer.disconnect();
  }, []);

+  useEffect(() => {
+    if (isOpen) {
+      setDraftValue(value);
+    }
+  }, [isOpen, value]);
+
+  const handleClose = () => {
+    setDraftValue(value);
+    onClose();
+  };
+
+  const handleSave = () => {
+    if (onSave(draftValue)) {
+      onClose();
+    }
+  };
+
  return (
    <FullScreenPanel
      isOpen={isOpen}
      title={t("codexConfig.editCommonConfigTitle")}
-      onClose={onClose}
+      onClose={handleClose}
      footer={
        <>
          {onExtract && (
@@ -71,10 +89,10 @@ export const CodexCommonConfigModal: React.FC<CodexCommonConfigModalProps> = ({
              })}
            </Button>
          )}
-          <Button type="button" variant="outline" onClick={onClose}>
+          <Button type="button" variant="outline" onClick={handleClose}>
            {t("common.cancel")}
          </Button>
-          <Button type="button" onClick={onClose} className="gap-2">
+          <Button type="button" onClick={handleSave} className="gap-2">
            <Save className="w-4 h-4" />
            {t("common.save")}
          </Button>
@@ -87,8 +105,8 @@ export const CodexCommonConfigModal: React.FC<CodexCommonConfigModalProps> = ({
        </p>

        <JsonEditor
-          value={value}
-          onChange={onChange}
+          value={draftValue}
+          onChange={setDraftValue}
          placeholder={`# Common Codex config

 # Add your common TOML configuration here`}
@@ -1,4 +1,4 @@
-import React, { useState, useEffect } from "react";
+import React, { useState } from "react";
 import { CodexAuthSection, CodexConfigSection } from "./CodexConfigSections";
 import { CodexCommonConfigModal } from "./CodexCommonConfigModal";

@@ -19,7 +19,9 @@ interface CodexConfigEditorProps {

  commonConfigSnippet: string;

-  onCommonConfigSnippetChange: (value: string) => void;
+  onCommonConfigSnippetChange: (value: string) => boolean;
+
+  onCommonConfigErrorClear: () => void;

  commonConfigError: string;

@@ -42,6 +44,7 @@ const CodexConfigEditor: React.FC<CodexConfigEditorProps> = ({
  onCommonConfigToggle,
  commonConfigSnippet,
  onCommonConfigSnippetChange,
+  onCommonConfigErrorClear,
  commonConfigError,
  authError,
  configError,
@@ -50,12 +53,10 @@ const CodexConfigEditor: React.FC<CodexConfigEditorProps> = ({
 }) => {
  const [isCommonConfigModalOpen, setIsCommonConfigModalOpen] = useState(false);

-  // Auto-open common config modal if there's an error
-  useEffect(() => {
-    if (commonConfigError && !isCommonConfigModalOpen) {
-      setIsCommonConfigModalOpen(true);
-    }
-  }, [commonConfigError, isCommonConfigModalOpen]);
+  const handleCloseCommonConfigModal = () => {
+    onCommonConfigErrorClear();
+    setIsCommonConfigModalOpen(false);
+  };

  return (
    <div className="space-y-6">
@@ -81,9 +82,9 @@ const CodexConfigEditor: React.FC<CodexConfigEditorProps> = ({
      {/* Common Config Modal */}
      <CodexCommonConfigModal
        isOpen={isCommonConfigModalOpen}
-        onClose={() => setIsCommonConfigModalOpen(false)}
+        onClose={handleCloseCommonConfigModal}
        value={commonConfigSnippet}
-        onChange={onCommonConfigSnippetChange}
+        onSave={onCommonConfigSnippetChange}
        error={commonConfigError}
        onExtract={onExtract}
        isExtracting={isExtracting}
@@ -9,7 +9,7 @@ interface GeminiCommonConfigModalProps {
  isOpen: boolean;
  onClose: () => void;
  value: string;
-  onChange: (value: string) => void;
+  onSave: (value: string) => boolean;
  error?: string;
  onExtract?: () => void;
  isExtracting?: boolean;
@@ -21,9 +21,10 @@ interface GeminiCommonConfigModalProps {
 */
 export const GeminiCommonConfigModal: React.FC<
  GeminiCommonConfigModalProps
-> = ({ isOpen, onClose, value, onChange, error, onExtract, isExtracting }) => {
+> = ({ isOpen, onClose, value, onSave, error, onExtract, isExtracting }) => {
  const { t } = useTranslation();
  const [isDarkMode, setIsDarkMode] = useState(false);
+  const [draftValue, setDraftValue] = useState(value);

  useEffect(() => {
    setIsDarkMode(document.documentElement.classList.contains("dark"));
@@ -40,13 +41,30 @@ export const GeminiCommonConfigModal: React.FC<
    return () => observer.disconnect();
  }, []);

+  useEffect(() => {
+    if (isOpen) {
+      setDraftValue(value);
+    }
+  }, [isOpen, value]);
+
+  const handleClose = () => {
+    setDraftValue(value);
+    onClose();
+  };
+
+  const handleSave = () => {
+    if (onSave(draftValue)) {
+      onClose();
+    }
+  };
+
  return (
    <FullScreenPanel
      isOpen={isOpen}
      title={t("geminiConfig.editCommonConfigTitle", {
        defaultValue: "编辑 Gemini 通用配置片段",
      })}
-      onClose={onClose}
+      onClose={handleClose}
      footer={
        <>
          {onExtract && (
@@ -67,10 +85,10 @@ export const GeminiCommonConfigModal: React.FC<
              })}
            </Button>
          )}
-          <Button type="button" variant="outline" onClick={onClose}>
+          <Button type="button" variant="outline" onClick={handleClose}>
            {t("common.cancel")}
          </Button>
-          <Button type="button" onClick={onClose} className="gap-2">
+          <Button type="button" onClick={handleSave} className="gap-2">
            <Save className="w-4 h-4" />
            {t("common.save")}
          </Button>
@@ -86,8 +104,8 @@ export const GeminiCommonConfigModal: React.FC<
        </p>

        <JsonEditor
-          value={value}
-          onChange={onChange}
+          value={draftValue}
+          onChange={setDraftValue}
          placeholder={`{
  "GEMINI_MODEL": "gemini-3-pro-preview"
 }`}
@@ -1,4 +1,4 @@
-import React, { useState, useEffect } from "react";
+import React, { useState } from "react";
 import { GeminiEnvSection, GeminiConfigSection } from "./GeminiConfigSections";
 import { GeminiCommonConfigModal } from "./GeminiCommonConfigModal";

@@ -11,7 +11,8 @@ interface GeminiConfigEditorProps {
  useCommonConfig: boolean;
  onCommonConfigToggle: (checked: boolean) => void;
  commonConfigSnippet: string;
-  onCommonConfigSnippetChange: (value: string) => void;
+  onCommonConfigSnippetChange: (value: string) => boolean;
+  onCommonConfigErrorClear: () => void;
  commonConfigError: string;
  envError: string;
  configError: string;
@@ -29,6 +30,7 @@ const GeminiConfigEditor: React.FC<GeminiConfigEditorProps> = ({
  onCommonConfigToggle,
  commonConfigSnippet,
  onCommonConfigSnippetChange,
+  onCommonConfigErrorClear,
  commonConfigError,
  envError,
  configError,
@@ -37,12 +39,10 @@ const GeminiConfigEditor: React.FC<GeminiConfigEditorProps> = ({
 }) => {
  const [isCommonConfigModalOpen, setIsCommonConfigModalOpen] = useState(false);

-  // Auto-open common config modal if there's an error
-  useEffect(() => {
-    if (commonConfigError && !isCommonConfigModalOpen) {
-      setIsCommonConfigModalOpen(true);
-    }
-  }, [commonConfigError, isCommonConfigModalOpen]);
+  const handleCloseCommonConfigModal = () => {
+    onCommonConfigErrorClear();
+    setIsCommonConfigModalOpen(false);
+  };

  return (
    <div className="space-y-6">
@@ -68,9 +68,9 @@ const GeminiConfigEditor: React.FC<GeminiConfigEditorProps> = ({
      {/* Common Config Modal */}
      <GeminiCommonConfigModal
        isOpen={isCommonConfigModalOpen}
-        onClose={() => setIsCommonConfigModalOpen(false)}
+        onClose={handleCloseCommonConfigModal}
        value={commonConfigSnippet}
-        onChange={onCommonConfigSnippetChange}
+        onSave={onCommonConfigSnippetChange}
        error={commonConfigError}
        onExtract={onExtract}
        isExtracting={isExtracting}
@@ -197,9 +197,6 @@ export function ProviderForm({
      setDraftCustomEndpoints([]);
    }
    setEndpointAutoSelect(initialData?.meta?.endpointAutoSelect ?? true);
-    setLocalIsFullUrl(
-      appId === "claude" ? (initialData?.meta?.isFullUrl ?? false) : false,
-    );
    setTestConfig(initialData?.meta?.testConfig ?? { enabled: false });
    setProxyConfig(initialData?.meta?.proxyConfig ?? { enabled: false });
    setPricingConfig({
@@ -248,20 +245,6 @@ export function ProviderForm({
    [form],
  );

-  const [localApiFormat, setLocalApiFormat] = useState<ClaudeApiFormat>(() => {
-    if (appId !== "claude") return "anthropic";
-    return initialData?.meta?.apiFormat ?? "anthropic";
-  });
-
-  const [localIsFullUrl, setLocalIsFullUrl] = useState<boolean>(() => {
-    if (appId !== "claude") return false;
-    return initialData?.meta?.isFullUrl ?? false;
-  });
-
-  const handleApiFormatChange = useCallback((format: ClaudeApiFormat) => {
-    setLocalApiFormat(format);
-  }, []);
-
  const [localApiKeyField, setLocalApiKeyField] = useState<ClaudeApiKeyField>(
    () => {
      if (appId !== "claude") return "ANTHROPIC_AUTH_TOKEN";
@@ -273,6 +256,7 @@ export function ProviderForm({
      return "ANTHROPIC_AUTH_TOKEN";
    },
  );
+
  const {
    apiKey,
    handleApiKeyChange,
@@ -307,6 +291,15 @@ export function ProviderForm({
    onConfigChange: handleSettingsConfigChange,
  });

+  const [localApiFormat, setLocalApiFormat] = useState<ClaudeApiFormat>(() => {
+    if (appId !== "claude") return "anthropic";
+    return initialData?.meta?.apiFormat ?? "anthropic";
+  });
+
+  const handleApiFormatChange = useCallback((format: ClaudeApiFormat) => {
+    setLocalApiFormat(format);
+  }, []);
+
  const handleApiKeyFieldChange = useCallback(
    (field: ClaudeApiKeyField) => {
      const prev = localApiKeyField;
@@ -330,6 +323,7 @@ export function ProviderForm({
    },
    [localApiKeyField, form, handleSettingsConfigChange],
  );
+
  const {
    codexAuth,
    codexConfig,
@@ -453,6 +447,7 @@ export function ProviderForm({
    handleCommonConfigSnippetChange: handleCodexCommonConfigSnippetChange,
    isExtracting: isCodexExtracting,
    handleExtract: handleCodexExtract,
+    clearCommonConfigError: clearCodexCommonConfigError,
  } = useCodexCommonConfig({
    codexConfig,
    onConfigChange: handleCodexConfigChange,
@@ -536,6 +531,7 @@ export function ProviderForm({
    handleCommonConfigSnippetChange: handleGeminiCommonConfigSnippetChange,
    isExtracting: isGeminiExtracting,
    handleExtract: handleGeminiExtract,
+    clearCommonConfigError: clearGeminiCommonConfigError,
  } = useGeminiCommonConfig({
    envValue: geminiEnv,
    onEnvChange: handleGeminiEnvChange,
@@ -894,10 +890,6 @@ export function ProviderForm({
        localApiKeyField !== "ANTHROPIC_AUTH_TOKEN"
          ? localApiKeyField
          : undefined,
-      isFullUrl:
-        appId === "claude" && category !== "official" && localIsFullUrl
-          ? true
-          : undefined,
    };

    onSubmit(payload);
@@ -1043,7 +1035,7 @@ export function ProviderForm({
      resetCodexConfig(auth, config);

      form.reset({
-        name: preset.name,
+        name: preset.nameKey ? t(preset.nameKey) : preset.name,
        websiteUrl: preset.websiteUrl ?? "",
        settingsConfig: JSON.stringify({ auth, config }, null, 2),
        icon: preset.icon ?? "",
@@ -1060,7 +1052,7 @@ export function ProviderForm({
      resetGeminiConfig(env, config);

      form.reset({
-        name: preset.name,
+        name: preset.nameKey ? t(preset.nameKey) : preset.name,
        websiteUrl: preset.websiteUrl ?? "",
        settingsConfig: JSON.stringify(preset.settingsConfig, null, 2),
        icon: preset.icon ?? "",
@@ -1088,7 +1080,7 @@ export function ProviderForm({
      opencodeForm.resetOpencodeState(config);

      form.reset({
-        name: preset.name,
+        name: preset.nameKey ? t(preset.nameKey) : preset.name,
        websiteUrl: preset.websiteUrl ?? "",
        settingsConfig: JSON.stringify(config, null, 2),
        icon: preset.icon ?? "",
@@ -1115,7 +1107,7 @@ export function ProviderForm({

      // Update form fields
      form.reset({
-        name: preset.name,
+        name: preset.nameKey ? t(preset.nameKey) : preset.name,
        websiteUrl: preset.websiteUrl ?? "",
        settingsConfig: JSON.stringify(config, null, 2),
        icon: preset.icon ?? "",
@@ -1139,7 +1131,7 @@ export function ProviderForm({
    setLocalApiKeyField(preset.apiKeyField ?? "ANTHROPIC_AUTH_TOKEN");

    form.reset({
-      name: preset.name,
+      name: preset.nameKey ? t(preset.nameKey) : preset.name,
      websiteUrl: preset.websiteUrl ?? "",
      settingsConfig: JSON.stringify(config, null, 2),
      icon: preset.icon ?? "",
@@ -1345,8 +1337,6 @@ export function ProviderForm({
            onApiFormatChange={handleApiFormatChange}
            apiKeyField={localApiKeyField}
            onApiKeyFieldChange={handleApiKeyFieldChange}
-            isFullUrl={localIsFullUrl}
-            onFullUrlChange={setLocalIsFullUrl}
          />
        )}

@@ -1479,6 +1469,7 @@ export function ProviderForm({
              onCommonConfigToggle={handleCodexCommonConfigToggle}
              commonConfigSnippet={codexCommonConfigSnippet}
              onCommonConfigSnippetChange={handleCodexCommonConfigSnippetChange}
+              onCommonConfigErrorClear={clearCodexCommonConfigError}
              commonConfigError={codexCommonConfigError}
              authError={codexAuthError}
              configError={codexConfigError}
@@ -1500,6 +1491,7 @@ export function ProviderForm({
              onCommonConfigSnippetChange={
                handleGeminiCommonConfigSnippetChange
              }
+              onCommonConfigErrorClear={clearGeminiCommonConfigError}
              commonConfigError={geminiCommonConfigError}
              envError={envError}
              configError={geminiConfigError}
@@ -159,7 +159,9 @@ export function ProviderPresetSelector({
                }
              >
                {renderPresetIcon(entry.preset)}
-                {entry.preset.name}
+                {entry.preset.nameKey
+                  ? t(entry.preset.nameKey)
+                  : entry.preset.name}
                {isPartner && (
                  <span className="absolute -top-1 -right-1 flex items-center gap-0.5 rounded-full bg-gradient-to-r from-amber-500 to-yellow-500 px-1.5 py-0.5 text-[10px] font-bold text-white shadow-md">
                    <Star className="h-2.5 w-2.5 fill-current" />
@@ -29,7 +29,7 @@ export function useApiKeyState({
 }: UseApiKeyStateProps) {
  const [apiKey, setApiKey] = useState(() => {
    if (initialConfig) {
-      return getApiKeyFromConfig(initialConfig, appType, apiKeyField);
+      return getApiKeyFromConfig(initialConfig, appType);
    }
    return "";
  });
@@ -46,11 +46,11 @@ export function useApiKeyState({
    }

    // 从配置中提取 API Key（如果不存在则返回空字符串）
-    const extracted = getApiKeyFromConfig(initialConfig, appType, apiKeyField);
+    const extracted = getApiKeyFromConfig(initialConfig, appType);
    if (extracted !== apiKey) {
      setApiKey(extracted);
    }
-  }, [initialConfig, appType, apiKeyField, apiKey]);
+  }, [initialConfig, appType, apiKey]);

  const handleApiKeyChange = useCallback(
    (key: string) => {
@@ -1,10 +1,12 @@
 import { useState, useEffect, useCallback, useRef } from "react";
 import { useTranslation } from "react-i18next";
+import { parse as parseToml } from "smol-toml";
 import {
  updateTomlCommonConfigSnippet,
  hasTomlCommonConfigSnippet,
 } from "@/utils/providerConfigUtils";
 import { configApi } from "@/lib/api";
+import { normalizeTomlText } from "@/utils/textNormalization";

 const LEGACY_STORAGE_KEY = "cc-switch:codex-common-config-snippet";
 const DEFAULT_CODEX_COMMON_CONFIG_SNIPPET = `# Common Codex config
@@ -53,6 +55,30 @@ export function useCodexCommonConfig({
    hasInitializedEditMode.current = false;
  }, [selectedPresetId, initialEnabled]);

+  const parseCommonConfigSnippet = useCallback((snippetString: string) => {
+    const trimmed = snippetString.trim();
+    if (!trimmed) {
+      return {
+        hasContent: false,
+      };
+    }
+
+    try {
+      const parsed = parseToml(normalizeTomlText(snippetString)) as Record<
+        string,
+        unknown
+      >;
+      return {
+        hasContent: Object.keys(parsed).length > 0,
+      };
+    } catch (error) {
+      return {
+        hasContent: false,
+        error: error instanceof Error ? error.message : String(error),
+      };
+    }
+  }, []);
+
  // 初始化：从 config.json 加载，支持从 localStorage 迁移
  useEffect(() => {
    let mounted = true;
@@ -107,36 +133,59 @@ export function useCodexCommonConfig({

  // 初始化时检查通用配置片段（编辑模式）
  useEffect(() => {
-    if (initialData?.settingsConfig && !isLoading) {
-      const config =
-        typeof initialData.settingsConfig.config === "string"
-          ? initialData.settingsConfig.config
-          : "";
-      const inferredHasCommon = hasTomlCommonConfigSnippet(
-        config,
-        commonConfigSnippet,
-      );
-      const hasCommon = initialEnabled ?? inferredHasCommon;
-      setUseCommonConfig(hasCommon);
-
-      if (hasCommon && !inferredHasCommon && !hasInitializedEditMode.current) {
-        hasInitializedEditMode.current = true;
-        const { updatedConfig, error } = updateTomlCommonConfigSnippet(
-          codexConfig,
-          commonConfigSnippet,
-          true,
-        );
-        if (!error) {
-          isUpdatingFromCommonConfig.current = true;
-          onConfigChange(updatedConfig);
-          setTimeout(() => {
-            isUpdatingFromCommonConfig.current = false;
-          }, 0);
-        }
-      } else {
-        hasInitializedEditMode.current = true;
-      }
+    if (
+      !initialData?.settingsConfig ||
+      isLoading ||
+      hasInitializedEditMode.current
+    ) {
+      return;
    }
+
+    hasInitializedEditMode.current = true;
+
+    const parsedSnippet = parseCommonConfigSnippet(commonConfigSnippet);
+    if (parsedSnippet.error) {
+      if (commonConfigSnippet.trim()) {
+        setCommonConfigError(parsedSnippet.error);
+      }
+      setUseCommonConfig(false);
+      return;
+    }
+
+    const config =
+      typeof initialData.settingsConfig.config === "string"
+        ? initialData.settingsConfig.config
+        : "";
+    const inferredHasCommon = hasTomlCommonConfigSnippet(
+      config,
+      commonConfigSnippet,
+    );
+    const hasCommon = initialEnabled ?? inferredHasCommon;
+
+    if (hasCommon && !inferredHasCommon) {
+      const { updatedConfig, error } = updateTomlCommonConfigSnippet(
+        codexConfig,
+        commonConfigSnippet,
+        true,
+      );
+      if (error) {
+        setCommonConfigError(error);
+        setUseCommonConfig(false);
+        return;
+      }
+
+      setCommonConfigError("");
+      setUseCommonConfig(true);
+      isUpdatingFromCommonConfig.current = true;
+      onConfigChange(updatedConfig);
+      setTimeout(() => {
+        isUpdatingFromCommonConfig.current = false;
+      }, 0);
+      return;
+    }
+
+    setCommonConfigError("");
+    setUseCommonConfig(hasCommon);
  }, [
    codexConfig,
    commonConfigSnippet,
@@ -144,49 +193,75 @@ export function useCodexCommonConfig({
    initialEnabled,
    isLoading,
    onConfigChange,
+    parseCommonConfigSnippet,
  ]);

  // 新建模式：如果通用配置片段存在且有效，默认启用
  useEffect(() => {
-    // 仅新建模式、加载完成、尚未初始化过
-    if (!initialData && !isLoading && !hasInitializedNewMode.current) {
-      hasInitializedNewMode.current = true;
-
-      // 检查 TOML 片段是否有实质内容（不只是注释和空行）
-      const lines = commonConfigSnippet.split("\n");
-      const hasContent = lines.some((line) => {
-        const trimmed = line.trim();
-        return trimmed && !trimmed.startsWith("#");
-      });
-
-      if (hasContent) {
-        setUseCommonConfig(true);
-        // 合并通用配置到当前配置
-        const { updatedConfig, error } = updateTomlCommonConfigSnippet(
-          codexConfig,
-          commonConfigSnippet,
-          true,
-        );
-        if (!error) {
-          isUpdatingFromCommonConfig.current = true;
-          onConfigChange(updatedConfig);
-          setTimeout(() => {
-            isUpdatingFromCommonConfig.current = false;
-          }, 0);
-        }
-      }
+    if (initialData || isLoading || hasInitializedNewMode.current) {
+      return;
    }
+
+    hasInitializedNewMode.current = true;
+
+    const parsedSnippet = parseCommonConfigSnippet(commonConfigSnippet);
+    if (parsedSnippet.error) {
+      if (commonConfigSnippet.trim()) {
+        setCommonConfigError(parsedSnippet.error);
+      }
+      setUseCommonConfig(false);
+      return;
+    }
+    if (!parsedSnippet.hasContent) {
+      return;
+    }
+
+    const { updatedConfig, error } = updateTomlCommonConfigSnippet(
+      codexConfig,
+      commonConfigSnippet,
+      true,
+    );
+    if (error) {
+      setCommonConfigError(error);
+      setUseCommonConfig(false);
+      return;
+    }
+
+    setCommonConfigError("");
+    setUseCommonConfig(true);
+    isUpdatingFromCommonConfig.current = true;
+    onConfigChange(updatedConfig);
+    setTimeout(() => {
+      isUpdatingFromCommonConfig.current = false;
+    }, 0);
  }, [
    initialData,
    commonConfigSnippet,
    isLoading,
    codexConfig,
    onConfigChange,
+    parseCommonConfigSnippet,
  ]);

  // 处理通用配置开关
  const handleCommonConfigToggle = useCallback(
    (checked: boolean) => {
+      const parsedSnippet = parseCommonConfigSnippet(commonConfigSnippet);
+      if (parsedSnippet.error) {
+        setCommonConfigError(parsedSnippet.error);
+        setUseCommonConfig(false);
+        return;
+      }
+      if (!parsedSnippet.hasContent) {
+        setCommonConfigError(
+          t("codexConfig.noCommonConfigToApply", {
+            defaultValue: "通用配置片段为空或没有可写入的内容",
+          }),
+        );
+        setUseCommonConfig(false);
+        return;
+      }
+
      const { updatedConfig, error: snippetError } =
        updateTomlCommonConfigSnippet(
          codexConfig,
@@ -210,18 +285,39 @@ export function useCodexCommonConfig({
        isUpdatingFromCommonConfig.current = false;
      }, 0);
    },
-    [codexConfig, commonConfigSnippet, onConfigChange],
+    [codexConfig, commonConfigSnippet, onConfigChange, parseCommonConfigSnippet, t],
  );

  // 处理通用配置片段变化
  const handleCommonConfigSnippetChange = useCallback(
-    (value: string) => {
+    (value: string): boolean => {
      const previousSnippet = commonConfigSnippet;
-      setCommonConfigSnippetState(value);

      if (!value.trim()) {
        setCommonConfigError("");
-        // 保存到 config.json（清空）
+
+        if (useCommonConfig) {
+          const previousParsed = parseCommonConfigSnippet(previousSnippet);
+          let updatedConfig = codexConfig;
+
+          if (!previousParsed.error && previousParsed.hasContent) {
+            const removeResult = updateTomlCommonConfigSnippet(
+              codexConfig,
+              previousSnippet,
+              false,
+            );
+            if (removeResult.error) {
+              setCommonConfigError(removeResult.error);
+              return false;
+            }
+            updatedConfig = removeResult.updatedConfig;
+          }
+
+          onConfigChange(updatedConfig);
+          setUseCommonConfig(false);
+        }
+
+        setCommonConfigSnippetState("");
        configApi
          .setCommonConfigSnippet("codex", "")
          .catch((error: unknown) => {
@@ -230,51 +326,42 @@ export function useCodexCommonConfig({
              t("codexConfig.saveFailed", { error: String(error) }),
            );
          });
+        return true;
+      }

-        if (useCommonConfig) {
-          const { updatedConfig } = updateTomlCommonConfigSnippet(
+      const parsedNextSnippet = parseCommonConfigSnippet(value);
+      if (parsedNextSnippet.error) {
+        setCommonConfigError(parsedNextSnippet.error);
+        return false;
+      }
+
+      // 若当前启用通用配置，需要替换为最新片段
+      if (useCommonConfig) {
+        let nextConfig = codexConfig;
+        const previousParsed = parseCommonConfigSnippet(previousSnippet);
+
+        if (!previousParsed.error && previousParsed.hasContent) {
+          const removeResult = updateTomlCommonConfigSnippet(
            codexConfig,
            previousSnippet,
            false,
          );
-          onConfigChange(updatedConfig);
-          setUseCommonConfig(false);
+          if (removeResult.error) {
+            setCommonConfigError(removeResult.error);
+            return false;
+          }
+          nextConfig = removeResult.updatedConfig;
        }
-        return;
-      }

-      // TOML 格式校验较为复杂，暂时不做校验，直接清空错误
-      setCommonConfigError("");
-      // 保存到 config.json
-      configApi
-        .setCommonConfigSnippet("codex", value)
-        .catch((error: unknown) => {
-          console.error("保存 Codex 通用配置失败:", error);
-          setCommonConfigError(
-            t("codexConfig.saveFailed", { error: String(error) }),
-          );
-        });
-
-      // 若当前启用通用配置，需要替换为最新片段
-      if (useCommonConfig) {
-        const removeResult = updateTomlCommonConfigSnippet(
-          codexConfig,
-          previousSnippet,
-          false,
-        );
-        if (removeResult.error) {
-          setCommonConfigError(removeResult.error);
-          return;
-        }
        const addResult = updateTomlCommonConfigSnippet(
-          removeResult.updatedConfig,
+          nextConfig,
          value,
          true,
        );

        if (addResult.error) {
          setCommonConfigError(addResult.error);
-          return;
+          return false;
        }

        // 标记正在通过通用配置更新，避免触发状态检查
@@ -285,8 +372,28 @@ export function useCodexCommonConfig({
          isUpdatingFromCommonConfig.current = false;
        }, 0);
      }
+
+      setCommonConfigError("");
+      setCommonConfigSnippetState(value);
+      configApi
+        .setCommonConfigSnippet("codex", value)
+        .catch((error: unknown) => {
+          console.error("保存 Codex 通用配置失败:", error);
+          setCommonConfigError(
+            t("codexConfig.saveFailed", { error: String(error) }),
+          );
+        });
+
+      return true;
    },
-    [commonConfigSnippet, codexConfig, useCommonConfig, onConfigChange],
+    [
+      commonConfigSnippet,
+      codexConfig,
+      onConfigChange,
+      parseCommonConfigSnippet,
+      t,
+      useCommonConfig,
+    ],
  );

  // 当配置变化时检查是否包含通用配置（但避免在通过通用配置更新时检查）
@@ -294,12 +401,17 @@ export function useCodexCommonConfig({
    if (isUpdatingFromCommonConfig.current || isLoading) {
      return;
    }
+    const parsedSnippet = parseCommonConfigSnippet(commonConfigSnippet);
+    if (parsedSnippet.error) {
+      setUseCommonConfig(false);
+      return;
+    }
    const hasCommon = hasTomlCommonConfigSnippet(
      codexConfig,
      commonConfigSnippet,
    );
    setUseCommonConfig(hasCommon);
-  }, [codexConfig, commonConfigSnippet, isLoading]);
+  }, [codexConfig, commonConfigSnippet, isLoading, parseCommonConfigSnippet]);

  // 从编辑器当前内容提取通用配置片段
  const handleExtract = useCallback(async () => {
@@ -333,6 +445,10 @@ export function useCodexCommonConfig({
    }
  }, [codexConfig, t]);

+  const clearCommonConfigError = useCallback(() => {
+    setCommonConfigError("");
+  }, []);
+
  return {
    useCommonConfig,
    commonConfigSnippet,
@@ -342,5 +458,6 @@ export function useCodexCommonConfig({
    handleCommonConfigToggle,
    handleCommonConfigSnippetChange,
    handleExtract,
+    clearCommonConfigError,
  };
 }
@@ -216,43 +216,55 @@ export function useGeminiCommonConfig({

  // 初始化时检查通用配置片段（编辑模式）
  useEffect(() => {
-    if (initialData?.settingsConfig && !isLoading) {
-      try {
-        const env =
-          isPlainObject(initialData.settingsConfig.env) &&
-          Object.keys(initialData.settingsConfig.env).length > 0
-            ? (initialData.settingsConfig.env as Record<string, string>)
-            : {};
-        const parsed = parseSnippetEnv(commonConfigSnippet);
-        if (parsed.error) return;
-        const inferredHasCommon = hasEnvCommonConfigSnippet(
-          env,
-          parsed.env as Record<string, string>,
-        );
-        const hasCommon = initialEnabled ?? inferredHasCommon;
-        setUseCommonConfig(hasCommon);
+    if (
+      !initialData?.settingsConfig ||
+      isLoading ||
+      hasInitializedEditMode.current
+    ) {
+      return;
+    }

-        if (
-          hasCommon &&
-          !inferredHasCommon &&
-          !hasInitializedEditMode.current
-        ) {
-          hasInitializedEditMode.current = true;
-          const currentEnv = envStringToObj(envValue);
-          const merged = applySnippetToEnv(currentEnv, parsed.env);
-          const nextEnvString = envObjToString(merged);
+    hasInitializedEditMode.current = true;

-          isUpdatingFromCommonConfig.current = true;
-          onEnvChange(nextEnvString);
-          setTimeout(() => {
-            isUpdatingFromCommonConfig.current = false;
-          }, 0);
-        } else {
-          hasInitializedEditMode.current = true;
+    try {
+      const env =
+        isPlainObject(initialData.settingsConfig.env) &&
+        Object.keys(initialData.settingsConfig.env).length > 0
+          ? (initialData.settingsConfig.env as Record<string, string>)
+          : {};
+      const parsed = parseSnippetEnv(commonConfigSnippet);
+      if (parsed.error) {
+        if (commonConfigSnippet.trim()) {
+          setCommonConfigError(parsed.error);
        }
-      } catch {
-        // ignore parse error
+        setUseCommonConfig(false);
+        return;
      }
+      const inferredHasCommon = hasEnvCommonConfigSnippet(
+        env,
+        parsed.env as Record<string, string>,
+      );
+      const hasCommon = initialEnabled ?? inferredHasCommon;
+
+      if (hasCommon && !inferredHasCommon) {
+        const currentEnv = envStringToObj(envValue);
+        const merged = applySnippetToEnv(currentEnv, parsed.env);
+        const nextEnvString = envObjToString(merged);
+
+        setCommonConfigError("");
+        setUseCommonConfig(true);
+        isUpdatingFromCommonConfig.current = true;
+        onEnvChange(nextEnvString);
+        setTimeout(() => {
+          isUpdatingFromCommonConfig.current = false;
+        }, 0);
+        return;
+      }
+
+      setCommonConfigError("");
+      setUseCommonConfig(hasCommon);
+    } catch {
+      // ignore parse error
    }
  }, [
    applySnippetToEnv,
@@ -270,26 +282,34 @@ export function useGeminiCommonConfig({

  // 新建模式：如果通用配置片段存在且有效，默认启用
  useEffect(() => {
-    // 仅新建模式、加载完成、尚未初始化过
-    if (!initialData && !isLoading && !hasInitializedNewMode.current) {
-      hasInitializedNewMode.current = true;
-
-      const parsed = parseSnippetEnv(commonConfigSnippet);
-      if (parsed.error) return;
-      const hasContent = Object.keys(parsed.env).length > 0;
-      if (!hasContent) return;
-
-      setUseCommonConfig(true);
-      const currentEnv = envStringToObj(envValue);
-      const merged = applySnippetToEnv(currentEnv, parsed.env);
-      const nextEnvString = envObjToString(merged);
-
-      isUpdatingFromCommonConfig.current = true;
-      onEnvChange(nextEnvString);
-      setTimeout(() => {
-        isUpdatingFromCommonConfig.current = false;
-      }, 0);
+    if (initialData || isLoading || hasInitializedNewMode.current) {
+      return;
    }
+
+    hasInitializedNewMode.current = true;
+
+    const parsed = parseSnippetEnv(commonConfigSnippet);
+    if (parsed.error) {
+      if (commonConfigSnippet.trim()) {
+        setCommonConfigError(parsed.error);
+      }
+      setUseCommonConfig(false);
+      return;
+    }
+    const hasContent = Object.keys(parsed.env).length > 0;
+    if (!hasContent) return;
+
+    setCommonConfigError("");
+    setUseCommonConfig(true);
+    const currentEnv = envStringToObj(envValue);
+    const merged = applySnippetToEnv(currentEnv, parsed.env);
+    const nextEnvString = envObjToString(merged);
+
+    isUpdatingFromCommonConfig.current = true;
+    onEnvChange(nextEnvString);
+    setTimeout(() => {
+      isUpdatingFromCommonConfig.current = false;
+    }, 0);
  }, [
    initialData,
    isLoading,
@@ -346,13 +366,29 @@ export function useGeminiCommonConfig({

  // 处理通用配置片段变化
  const handleCommonConfigSnippetChange = useCallback(
-    (value: string) => {
+    (value: string): boolean => {
      const previousSnippet = commonConfigSnippet;
-      setCommonConfigSnippetState(value);

      if (!value.trim()) {
        setCommonConfigError("");
-        // 保存到 config.json（清空）
+
+        if (useCommonConfig) {
+          const parsedPrevious = parseSnippetEnv(previousSnippet);
+          if (
+            !parsedPrevious.error &&
+            Object.keys(parsedPrevious.env).length > 0
+          ) {
+            const currentEnv = envStringToObj(envValue);
+            const updatedEnv = removeSnippetFromEnv(
+              currentEnv,
+              parsedPrevious.env,
+            );
+            onEnvChange(envObjToString(updatedEnv));
+          }
+          setUseCommonConfig(false);
+        }
+
+        setCommonConfigSnippetState("");
        configApi
          .setCommonConfigSnippet("gemini", "")
          .catch((error: unknown) => {
@@ -361,36 +397,16 @@ export function useGeminiCommonConfig({
              t("geminiConfig.saveFailed", { error: String(error) }),
            );
          });
-
-        if (useCommonConfig) {
-          const parsed = parseSnippetEnv(previousSnippet);
-          if (!parsed.error && Object.keys(parsed.env).length > 0) {
-            const currentEnv = envStringToObj(envValue);
-            const updatedEnv = removeSnippetFromEnv(currentEnv, parsed.env);
-            onEnvChange(envObjToString(updatedEnv));
-          }
-          setUseCommonConfig(false);
-        }
-        return;
+        return true;
      }

      // 校验 JSON 格式
      const parsed = parseSnippetEnv(value);
      if (parsed.error) {
        setCommonConfigError(parsed.error);
-        return;
+        return false;
      }

-      setCommonConfigError("");
-      configApi
-        .setCommonConfigSnippet("gemini", value)
-        .catch((error: unknown) => {
-          console.error("保存 Gemini 通用配置失败:", error);
-          setCommonConfigError(
-            t("geminiConfig.saveFailed", { error: String(error) }),
-          );
-        });
-
      // 若当前启用通用配置，需要替换为最新片段
      if (useCommonConfig) {
        const prevParsed = parseSnippetEnv(previousSnippet);
@@ -413,6 +429,19 @@ export function useGeminiCommonConfig({
          isUpdatingFromCommonConfig.current = false;
        }, 0);
      }
+
+      setCommonConfigError("");
+      setCommonConfigSnippetState(value);
+      configApi
+        .setCommonConfigSnippet("gemini", value)
+        .catch((error: unknown) => {
+          console.error("保存 Gemini 通用配置失败:", error);
+          setCommonConfigError(
+            t("geminiConfig.saveFailed", { error: String(error) }),
+          );
+        });
+
+      return true;
    },
    [
      applySnippetToEnv,
@@ -487,6 +516,10 @@ export function useGeminiCommonConfig({
    }
  }, [envStringToObj, envValue, parseSnippetEnv, t]);

+  const clearCommonConfigError = useCallback(() => {
+    setCommonConfigError("");
+  }, []);
+
  return {
    useCommonConfig,
    commonConfigSnippet,
@@ -496,5 +529,6 @@ export function useGeminiCommonConfig({
    handleCommonConfigToggle,
    handleCommonConfigSnippetChange,
    handleExtract,
+    clearCommonConfigError,
  };
 }
@@ -1,5 +1,5 @@
 import { useState, useCallback, useMemo } from "react";
-import type { OpenClawModel } from "@/types";
+import type { OpenClawModel, OpenClawProviderConfig } from "@/types";
 import type { AppId } from "@/lib/api";
 import { useProvidersQuery } from "@/lib/query/queries";
 import { OPENCLAW_DEFAULT_CONFIG } from "../helpers/opencodeFormUtils";
@@ -31,13 +31,7 @@ export interface OpenclawFormState {
  handleOpenclawApiChange: (api: string) => void;
  handleOpenclawModelsChange: (models: OpenClawModel[]) => void;
  handleOpenclawUserAgentChange: (enabled: boolean) => void;
-  resetOpenclawState: (config?: {
-    baseUrl?: string;
-    apiKey?: string;
-    api?: string;
-    models?: OpenClawModel[];
-    headers?: Record<string, string>;
-  }) => void;
+  resetOpenclawState: (config?: OpenClawProviderConfig) => void;
 }

 function parseOpenclawField<T>(
@@ -178,13 +172,7 @@ export function useOpenclawFormState({
  );

  const resetOpenclawState = useCallback(
-    (config?: {
-      baseUrl?: string;
-      apiKey?: string;
-      api?: string;
-      models?: OpenClawModel[];
-      headers?: Record<string, string>;
-    }) => {
+    (config?: OpenClawProviderConfig) => {
      setOpenclawProviderKey("");
      setOpenclawBaseUrl(config?.baseUrl || "");
      setOpenclawApiKey(config?.apiKey || "");
@@ -1,7 +1,7 @@
 import { useTranslation } from "react-i18next";
 import { FormLabel } from "@/components/ui/form";
 import { Input } from "@/components/ui/input";
-import { Zap, Link2 } from "lucide-react";
+import { Zap } from "lucide-react";

 interface EndpointFieldProps {
  id: string;
@@ -13,9 +13,6 @@ interface EndpointFieldProps {
  showManageButton?: boolean;
  onManageClick?: () => void;
  manageButtonLabel?: string;
-  showFullUrlToggle?: boolean;
-  isFullUrl?: boolean;
-  onFullUrlChange?: (value: boolean) => void;
 }

 export function EndpointField({
@@ -28,9 +25,6 @@ export function EndpointField({
  showManageButton = true,
  onManageClick,
  manageButtonLabel,
-  showFullUrlToggle = false,
-  isFullUrl = false,
-  onFullUrlChange,
 }: EndpointFieldProps) {
  const { t } = useTranslation();

@@ -61,35 +55,6 @@ export function EndpointField({
        placeholder={placeholder}
        autoComplete="off"
      />
-      {showFullUrlToggle && onFullUrlChange && (
-        <div className="flex items-center gap-2">
-          <button
-            type="button"
-            onClick={() => onFullUrlChange(!isFullUrl)}
-            className={`flex items-center gap-1.5 px-2.5 py-1 text-xs rounded-md border transition-colors ${
-              isFullUrl
-                ? "border-primary bg-primary/10 text-primary"
-                : "border-border text-muted-foreground hover:text-foreground hover:border-foreground/30"
-            }`}
-          >
-            <Link2 className="h-3.5 w-3.5" />
-            {isFullUrl
-              ? t("providerForm.fullUrlEnabled", {
-                  defaultValue: "完整 URL 模式",
-                })
-              : t("providerForm.fullUrlDisabled", {
-                  defaultValue: "标记为完整 URL",
-                })}
-          </button>
-          {isFullUrl && (
-            <span className="text-xs text-muted-foreground">
-              {t("providerForm.fullUrlHint", {
-                defaultValue: "代理将直接使用此 URL，不拼接路径",
-              })}
-            </span>
-          )}
-        </div>
-      )}
      {hint ? (
        <div className="p-3 bg-amber-50 dark:bg-amber-900/20 border border-amber-200 dark:border-amber-700 rounded-lg">
          <p className="text-xs text-amber-600 dark:text-amber-400">{hint}</p>
@@ -24,6 +24,7 @@ export interface PresetTheme {

 export interface ProviderPreset {
  name: string;
+  nameKey?: string; // i18n key for localized display name
  websiteUrl: string;
  // 新增：第三方/聚合等可单独配置获取 API Key 的链接
  apiKeyUrl?: string;
@@ -368,7 +369,7 @@ export const providerPresets: ProviderPreset[] = [
  {
    name: "SiliconFlow",
    websiteUrl: "https://siliconflow.cn",
-    apiKeyUrl: "https://cloud.siliconflow.cn/me/account/ak",
+    apiKeyUrl: "https://cloud.siliconflow.cn/i/drGuwc9k",
    settingsConfig: {
      env: {
        ANTHROPIC_BASE_URL: "https://api.siliconflow.cn",
@@ -388,7 +389,7 @@ export const providerPresets: ProviderPreset[] = [
  {
    name: "SiliconFlow en",
    websiteUrl: "https://siliconflow.com",
-    apiKeyUrl: "https://cloud.siliconflow.com/account/ak",
+    apiKeyUrl: "https://cloud.siliconflow.cn/i/drGuwc9k",
    settingsConfig: {
      env: {
        ANTHROPIC_BASE_URL: "https://api.siliconflow.com",
@@ -573,7 +574,8 @@ export const providerPresets: ProviderPreset[] = [
    iconColor: "#000000",
  },
  {
-    name: "Ucloud",
+    name: "Compshare",
+    nameKey: "providerForm.presets.ucloud",
    websiteUrl: "https://www.compshare.cn",
    apiKeyUrl:
      "https://www.compshare.cn/coding-plan?ytag=GPU_YY_YX_git_cc-switch",
@@ -593,7 +595,7 @@ export const providerPresets: ProviderPreset[] = [
  {
    name: "Micu",
    websiteUrl: "https://www.openclaudecode.cn",
-    apiKeyUrl: "https://www.openclaudecode.cn",
+    apiKeyUrl: "https://www.openclaudecode.cn/register?aff=aOYQ",
    settingsConfig: {
      env: {
        ANTHROPIC_BASE_URL: "https://www.openclaudecode.cn",
@@ -609,21 +611,37 @@ export const providerPresets: ProviderPreset[] = [
  },
  {
    name: "X-Code API",
-    websiteUrl: "https://www.x-code.cn",
-    apiKeyUrl: "https://www.x-code.cn",
+    websiteUrl: "https://x-code.cc",
+    apiKeyUrl: "https://x-code.cc",
    settingsConfig: {
      env: {
-        ANTHROPIC_BASE_URL: "https://www.x-code.cn",
+        ANTHROPIC_BASE_URL: "https://x-code.cc",
        ANTHROPIC_AUTH_TOKEN: "",
      },
    },
-    endpointCandidates: ["https://www.x-code.cn"],
+    endpointCandidates: ["https://x-code.cc"],
    category: "third_party",
    isPartner: true, // 合作伙伴
    partnerPromotionKey: "x-code", // 促销信息 i18n key
    icon: "x-code",
    iconColor: "#000000",
  },
+  {
+    name: "CTok.ai",
+    websiteUrl: "https://ctok.ai",
+    apiKeyUrl: "https://ctok.ai",
+    settingsConfig: {
+      env: {
+        ANTHROPIC_BASE_URL: "https://api.ctok.ai",
+        ANTHROPIC_AUTH_TOKEN: "",
+      },
+    },
+    category: "third_party",
+    isPartner: true, // 合作伙伴
+    partnerPromotionKey: "ctok", // 促销信息 i18n key
+    icon: "ctok",
+    iconColor: "#000000",
+  },
  {
    name: "OpenRouter",
    websiteUrl: "https://openrouter.ai",
@@ -6,6 +6,7 @@ import type { PresetTheme } from "./claudeProviderPresets";

 export interface CodexProviderPreset {
  name: string;
+  nameKey?: string; // i18n key for localized display name
  websiteUrl: string;
  // 第三方供应商可提供单独的获取 API Key 链接
  apiKeyUrl?: string;
@@ -281,13 +282,14 @@ requires_openai_auth = true`,
    iconColor: "#000000",
  },
  {
-    name: "Ucloud",
+    name: "Compshare",
+    nameKey: "providerForm.presets.ucloud",
    websiteUrl: "https://www.compshare.cn",
    apiKeyUrl:
      "https://www.compshare.cn/coding-plan?ytag=GPU_YY_YX_git_cc-switch",
    auth: generateThirdPartyAuth(""),
    config: generateThirdPartyConfig(
-      "ucloud",
+      "compshare",
      "https://api.modelverse.cn/v1",
      "gpt-5.4",
    ),
@@ -301,7 +303,7 @@ requires_openai_auth = true`,
  {
    name: "Micu",
    websiteUrl: "https://www.openclaudecode.cn",
-    apiKeyUrl: "https://www.openclaudecode.cn/v1",
+    apiKeyUrl: "https://www.openclaudecode.cn/register?aff=aOYQ",
    auth: generateThirdPartyAuth(""),
    config: generateThirdPartyConfig(
      "micu",
@@ -317,21 +319,38 @@ requires_openai_auth = true`,
  },
  {
    name: "X-Code API",
-    websiteUrl: "https://www.x-code.cn",
-    apiKeyUrl: "https://www.x-code.cn",
+    websiteUrl: "https://x-code.cc",
+    apiKeyUrl: "https://x-code.cc",
    auth: generateThirdPartyAuth(""),
    config: generateThirdPartyConfig(
      "x-code",
-      "https://www.x-code.cn/v1",
+      "https://x-code.cc/v1",
      "gpt-5.4",
    ),
-    endpointCandidates: ["https://www.x-code.cn/v1"],
+    endpointCandidates: ["https://x-code.cc/v1"],
    category: "third_party",
    isPartner: true, // 合作伙伴
    partnerPromotionKey: "x-code", // 促销信息 i18n key
    icon: "x-code",
    iconColor: "#000000",
  },
+  {
+    name: "CTok.ai",
+    websiteUrl: "https://ctok.ai",
+    apiKeyUrl: "https://ctok.ai",
+    auth: generateThirdPartyAuth(""),
+    config: generateThirdPartyConfig(
+      "ctok",
+      "https://api.ctok.ai/v1",
+      "gpt-5.4",
+    ),
+    endpointCandidates: ["https://api.ctok.ai/v1"],
+    category: "third_party",
+    isPartner: true, // 合作伙伴
+    partnerPromotionKey: "ctok", // 促销信息 i18n key
+    icon: "ctok",
+    iconColor: "#000000",
+  },
  {
    name: "OpenRouter",
    websiteUrl: "https://openrouter.ai",
@@ -14,6 +14,7 @@ export interface GeminiPresetTheme {

 export interface GeminiProviderPreset {
  name: string;
+  nameKey?: string; // i18n key for localized display name
  websiteUrl: string;
  apiKeyUrl?: string;
  settingsConfig: object;
@@ -56,11 +57,11 @@ export const geminiProviderPresets: GeminiProviderPreset[] = [
    settingsConfig: {
      env: {
        GOOGLE_GEMINI_BASE_URL: "https://www.packyapi.com",
-        GEMINI_MODEL: "gemini-3-pro",
+        GEMINI_MODEL: "gemini-3.1-pro",
      },
    },
    baseURL: "https://www.packyapi.com",
-    model: "gemini-3-pro",
+    model: "gemini-3.1-pro",
    description: "PackyCode",
    category: "third_party",
    isPartner: true,
@@ -78,11 +79,11 @@ export const geminiProviderPresets: GeminiProviderPreset[] = [
    settingsConfig: {
      env: {
        GOOGLE_GEMINI_BASE_URL: "https://api.cubence.com",
-        GEMINI_MODEL: "gemini-3-pro",
+        GEMINI_MODEL: "gemini-3.1-pro",
      },
    },
    baseURL: "https://api.cubence.com",
-    model: "gemini-3-pro",
+    model: "gemini-3.1-pro",
    description: "Cubence",
    category: "third_party",
    isPartner: true,
@@ -103,11 +104,11 @@ export const geminiProviderPresets: GeminiProviderPreset[] = [
    settingsConfig: {
      env: {
        GOOGLE_GEMINI_BASE_URL: "https://api.aigocode.com",
-        GEMINI_MODEL: "gemini-3-pro",
+        GEMINI_MODEL: "gemini-3.1-pro",
      },
    },
    baseURL: "https://api.aigocode.com",
-    model: "gemini-3-pro",
+    model: "gemini-3.1-pro",
    description: "AIGoCode",
    category: "third_party",
    isPartner: true,
@@ -123,11 +124,11 @@ export const geminiProviderPresets: GeminiProviderPreset[] = [
    settingsConfig: {
      env: {
        GOOGLE_GEMINI_BASE_URL: "https://api.aicodemirror.com/api/gemini",
-        GEMINI_MODEL: "gemini-3-pro",
+        GEMINI_MODEL: "gemini-3.1-pro",
      },
    },
    baseURL: "https://api.aicodemirror.com/api/gemini",
-    model: "gemini-3-pro",
+    model: "gemini-3.1-pro",
    description: "AICodeMirror",
    category: "third_party",
    isPartner: true,
@@ -146,11 +147,11 @@ export const geminiProviderPresets: GeminiProviderPreset[] = [
    settingsConfig: {
      env: {
        GOOGLE_GEMINI_BASE_URL: "https://api.aicoding.sh",
-        GEMINI_MODEL: "gemini-3-pro",
+        GEMINI_MODEL: "gemini-3.1-pro",
      },
    },
    baseURL: "https://api.aicoding.sh",
-    model: "gemini-3-pro",
+    model: "gemini-3.1-pro",
    description: "AICoding",
    category: "third_party",
    isPartner: true,
@@ -166,11 +167,11 @@ export const geminiProviderPresets: GeminiProviderPreset[] = [
    settingsConfig: {
      env: {
        GOOGLE_GEMINI_BASE_URL: "https://crazyrouter.com",
-        GEMINI_MODEL: "gemini-3-pro",
+        GEMINI_MODEL: "gemini-3.1-pro",
      },
    },
    baseURL: "https://crazyrouter.com",
-    model: "gemini-3-pro",
+    model: "gemini-3.1-pro",
    description: "CrazyRouter",
    category: "third_party",
    isPartner: true,
@@ -186,11 +187,11 @@ export const geminiProviderPresets: GeminiProviderPreset[] = [
    settingsConfig: {
      env: {
        GOOGLE_GEMINI_BASE_URL: "https://node-hk.sssaicode.com/api",
-        GEMINI_MODEL: "gemini-3-pro",
+        GEMINI_MODEL: "gemini-3.1-pro",
      },
    },
    baseURL: "https://node-hk.sssaicode.com/api",
-    model: "gemini-3-pro",
+    model: "gemini-3.1-pro",
    description: "SSSAiCode",
    category: "third_party",
    isPartner: true,
@@ -203,6 +204,26 @@ export const geminiProviderPresets: GeminiProviderPreset[] = [
    icon: "sssaicode",
    iconColor: "#000000",
  },
+  {
+    name: "CTok.ai",
+    websiteUrl: "https://ctok.ai",
+    apiKeyUrl: "https://ctok.ai",
+    settingsConfig: {
+      env: {
+        GOOGLE_GEMINI_BASE_URL: "https://api.ctok.ai/v1beta",
+        GEMINI_MODEL: "gemini-3.1-pro",
+      },
+    },
+    baseURL: "https://api.ctok.ai/v1beta",
+    model: "gemini-3.1-pro",
+    description: "CTok",
+    category: "third_party",
+    isPartner: true,
+    partnerPromotionKey: "ctok",
+    endpointCandidates: ["https://api.ctok.ai/v1beta"],
+    icon: "ctok",
+    iconColor: "#000000",
+  },
  {
    name: "OpenRouter",
    websiteUrl: "https://openrouter.ai",
@@ -210,11 +231,11 @@ export const geminiProviderPresets: GeminiProviderPreset[] = [
    settingsConfig: {
      env: {
        GOOGLE_GEMINI_BASE_URL: "https://openrouter.ai/api",
-        GEMINI_MODEL: "gemini-3-pro-preview",
+        GEMINI_MODEL: "gemini-3.1-pro",
      },
    },
    baseURL: "https://openrouter.ai/api",
-    model: "gemini-3-pro",
+    model: "gemini-3.1-pro",
    description: "OpenRouter",
    category: "aggregator",
    icon: "openrouter",
@@ -226,10 +247,10 @@ export const geminiProviderPresets: GeminiProviderPreset[] = [
    settingsConfig: {
      env: {
        GOOGLE_GEMINI_BASE_URL: "",
-        GEMINI_MODEL: "gemini-3-pro",
+        GEMINI_MODEL: "gemini-3.1-pro",
      },
    },
-    model: "gemini-3-pro",
+    model: "gemini-3.1-pro",
    description: "自定义 Gemini API 端点",
    category: "custom",
  },
@@ -19,6 +19,7 @@ export interface OpenClawSuggestedDefaults {

 export interface OpenClawProviderPreset {
  name: string;
+  nameKey?: string; // i18n key for localized display name
  websiteUrl: string;
  apiKeyUrl?: string;
  /** OpenClaw settings_config structure */
@@ -759,7 +760,7 @@ export const openclawProviderPresets: OpenClawProviderPreset[] = [
  {
    name: "SiliconFlow",
    websiteUrl: "https://siliconflow.cn",
-    apiKeyUrl: "https://cloud.siliconflow.cn/me/account/ak",
+    apiKeyUrl: "https://cloud.siliconflow.cn/i/drGuwc9k",
    settingsConfig: {
      baseUrl: "https://api.siliconflow.cn/v1",
      apiKey: "",
@@ -795,7 +796,7 @@ export const openclawProviderPresets: OpenClawProviderPreset[] = [
  {
    name: "SiliconFlow en",
    websiteUrl: "https://siliconflow.com",
-    apiKeyUrl: "https://cloud.siliconflow.com/account/ak",
+    apiKeyUrl: "https://cloud.siliconflow.cn/i/drGuwc9k",
    settingsConfig: {
      baseUrl: "https://api.siliconflow.com/v1",
      apiKey: "",
@@ -1264,7 +1265,8 @@ export const openclawProviderPresets: OpenClawProviderPreset[] = [
    },
  },
  {
-    name: "Ucloud",
+    name: "Compshare",
+    nameKey: "providerForm.presets.ucloud",
    websiteUrl: "https://www.compshare.cn",
    apiKeyUrl:
      "https://www.compshare.cn/coding-plan?ytag=GPU_YY_YX_git_cc-switch",
@@ -1295,17 +1297,17 @@ export const openclawProviderPresets: OpenClawProviderPreset[] = [
    },
    suggestedDefaults: {
      model: {
-        primary: "ucloud/claude-opus-4-6",
+        primary: "compshare/claude-opus-4-6",
      },
      modelCatalog: {
-        "ucloud/claude-opus-4-6": { alias: "Opus" },
+        "compshare/claude-opus-4-6": { alias: "Opus" },
      },
    },
  },
  {
    name: "Micu",
    websiteUrl: "https://www.openclaudecode.cn",
-    apiKeyUrl: "https://www.openclaudecode.cn",
+    apiKeyUrl: "https://www.openclaudecode.cn/register?aff=aOYQ",
    settingsConfig: {
      baseUrl: "https://www.openclaudecode.cn",
      apiKey: "",
@@ -1340,6 +1342,44 @@ export const openclawProviderPresets: OpenClawProviderPreset[] = [
      },
    },
  },
+  {
+    name: "CTok.ai",
+    websiteUrl: "https://ctok.ai",
+    apiKeyUrl: "https://ctok.ai",
+    settingsConfig: {
+      baseUrl: "https://api.ctok.ai",
+      apiKey: "",
+      api: "anthropic-messages",
+      models: [
+        {
+          id: "claude-opus-4-6",
+          name: "Claude Opus 4.6",
+          contextWindow: 200000,
+          cost: { input: 5, output: 25 },
+        },
+      ],
+    },
+    category: "third_party",
+    isPartner: true,
+    partnerPromotionKey: "ctok",
+    icon: "ctok",
+    iconColor: "#000000",
+    templateValues: {
+      apiKey: {
+        label: "API Key",
+        placeholder: "",
+        editorValue: "",
+      },
+    },
+    suggestedDefaults: {
+      model: {
+        primary: "ctok/claude-opus-4-6",
+      },
+      modelCatalog: {
+        "ctok/claude-opus-4-6": { alias: "Opus" },
+      },
+    },
+  },
  // ========== Cloud Providers ==========
  {
    name: "AWS Bedrock",
@@ -3,6 +3,7 @@ import type { PresetTheme, TemplateValueConfig } from "./claudeProviderPresets";

 export interface OpenCodeProviderPreset {
  name: string;
+  nameKey?: string; // i18n key for localized display name
  websiteUrl: string;
  apiKeyUrl?: string;
  settingsConfig: OpenCodeProviderConfig;
@@ -18,7 +19,7 @@ export interface OpenCodeProviderPreset {
 }

 export const opencodeNpmPackages = [
-  { value: "@ai-sdk/openai", label: "OpenAI" },
+  { value: "@ai-sdk/openai", label: "OpenAI Responses" },
  { value: "@ai-sdk/openai-compatible", label: "OpenAI Compatible" },
  { value: "@ai-sdk/anthropic", label: "Anthropic" },
  { value: "@ai-sdk/amazon-bedrock", label: "Amazon Bedrock" },
@@ -1119,7 +1120,7 @@ export const opencodeProviderPresets: OpenCodeProviderPreset[] = [
  {
    name: "Micu",
    websiteUrl: "https://www.openclaudecode.cn",
-    apiKeyUrl: "https://www.openclaudecode.cn/v1",
+    apiKeyUrl: "https://www.openclaudecode.cn/register?aff=aOYQ",
    settingsConfig: {
      npm: "@ai-sdk/anthropic",
      name: "Micu",
@@ -1147,13 +1148,13 @@ export const opencodeProviderPresets: OpenCodeProviderPreset[] = [
  },
  {
    name: "X-Code API",
-    websiteUrl: "https://www.x-code.cn",
-    apiKeyUrl: "https://www.x-code.cn",
+    websiteUrl: "https://x-code.cc",
+    apiKeyUrl: "https://x-code.cc",
    settingsConfig: {
      npm: "@ai-sdk/anthropic",
      name: "X-Code API",
      options: {
-        baseURL: "https://www.x-code.cn/v1",
+        baseURL: "https://x-code.cc/v1",
        apiKey: "",
      },
      models: {
@@ -1174,6 +1175,35 @@ export const opencodeProviderPresets: OpenCodeProviderPreset[] = [
      },
    },
  },
+  {
+    name: "CTok.ai",
+    websiteUrl: "https://ctok.ai",
+    apiKeyUrl: "https://ctok.ai",
+    settingsConfig: {
+      npm: "@ai-sdk/anthropic",
+      name: "CTok",
+      options: {
+        baseURL: "https://api.ctok.ai/v1",
+        apiKey: "",
+      },
+      models: {
+        "claude-opus-4-6": { name: "Claude Opus 4.6" },
+        "claude-sonnet-4-6": { name: "Claude Sonnet 4.6" },
+      },
+    },
+    category: "third_party",
+    isPartner: true,
+    partnerPromotionKey: "ctok",
+    icon: "ctok",
+    iconColor: "#000000",
+    templateValues: {
+      apiKey: {
+        label: "API Key",
+        placeholder: "",
+        editorValue: "",
+      },
+    },
+  },
  {
    name: "AWS Bedrock",
    websiteUrl: "https://aws.amazon.com/bedrock/",
@@ -23,7 +23,7 @@ import { openclawKeys } from "@/hooks/useOpenClaw";
 * Hook for managing provider actions (add, update, delete, switch)
 * Extracts business logic from App.tsx
 */
-export function useProviderActions(activeApp: AppId, isProxyRunning?: boolean) {
+export function useProviderActions(activeApp: AppId) {
  const { t } = useTranslation();
  const queryClient = useQueryClient();

@@ -139,23 +139,6 @@ export function useProviderActions(activeApp: AppId, isProxyRunning?: boolean) {
  // 切换供应商
  const switchProvider = useCallback(
    async (provider: Provider) => {
-      // 阻断逻辑：需要代理的供应商在代理未运行时不允许切换
-      if (
-        activeApp === "claude" &&
-        provider.category !== "official" &&
-        (provider.meta?.isFullUrl ||
-          provider.meta?.apiFormat === "openai_chat" ||
-          provider.meta?.apiFormat === "openai_responses") &&
-        !isProxyRunning
-      ) {
-        toast.warning(
-          t("notifications.proxyRequiredForSwitch", {
-            defaultValue: "此供应商需要代理服务，请先启动代理",
-          }),
-        );
-        return;
-      }
-
      try {
        const result = await switchProviderMutation.mutateAsync(provider.id);
        await syncClaudePlugin(provider);
@@ -209,7 +192,7 @@ export function useProviderActions(activeApp: AppId, isProxyRunning?: boolean) {
        // 错误提示由 mutation 处理
      }
    },
-    [switchProviderMutation, syncClaudePlugin, activeApp, isProxyRunning, t],
+    [switchProviderMutation, syncClaudePlugin, activeApp, t],
  );

  // 删除供应商
@@ -1,10 +1,7 @@
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useCallback, useMemo } from "react";
 import FlexSearch from "flexsearch";
 import type { SessionMeta } from "@/types";

-// FlexSearch Index 类型
-type FlexSearchIndex = InstanceType<typeof FlexSearch.Index>;
-
 interface UseSessionSearchOptions {
  sessions: SessionMeta[];
  providerFilter: string;
@@ -12,7 +9,6 @@ interface UseSessionSearchOptions {

 interface UseSessionSearchResult {
  search: (query: string) => SessionMeta[];
-  isIndexing: boolean;
 }

 /**
@@ -23,27 +19,14 @@ export function useSessionSearch({
  sessions,
  providerFilter,
 }: UseSessionSearchOptions): UseSessionSearchResult {
-  const [isIndexing, setIsIndexing] = useState(false);
-
-  // 会话元数据索引
-  const indexRef = useRef<FlexSearchIndex | null>(null);
-  // 索引 ID 到 session 的映射
-  const sessionByIdxRef = useRef<SessionMeta[]>([]);
-
-  // 初始化索引
-  useEffect(() => {
-    setIsIndexing(true);
-
-    // 创建索引实例
+  const index = useMemo(() => {
    // 使用 forward tokenizer 支持中文前缀搜索
-    const index = new FlexSearch.Index({
+    const nextIndex = new FlexSearch.Index({
      tokenize: "forward",
      resolution: 9,
    });

-    // 索引所有会话
    sessions.forEach((session, idx) => {
-      // 索引会话元数据
      const metaContent = [
        session.sessionId,
        session.title,
@@ -54,13 +37,10 @@ export function useSessionSearch({
        .filter(Boolean)
        .join(" ");

-      index.add(idx, metaContent);
+      nextIndex.add(idx, metaContent);
    });

-    indexRef.current = index;
-    sessionByIdxRef.current = sessions;
-
-    setIsIndexing(false);
+    return nextIndex;
  }, [sessions]);

  // 搜索函数
@@ -83,37 +63,12 @@ export function useSessionSearch({
        });
      }

-      const index = indexRef.current;
-
-      if (!index) {
-        // 索引未就绪，使用简单搜索
-        return filtered
-          .filter((session) => {
-            const haystack = [
-              session.sessionId,
-              session.title,
-              session.summary,
-              session.projectDir,
-              session.sourcePath,
-            ]
-              .filter(Boolean)
-              .join(" ")
-              .toLowerCase();
-            return haystack.includes(needle);
-          })
-          .sort((a, b) => {
-            const aTs = a.lastActiveAt ?? a.createdAt ?? 0;
-            const bTs = b.lastActiveAt ?? b.createdAt ?? 0;
-            return bTs - aTs;
-          });
-      }
-
      // 使用 FlexSearch 搜索
      const results = index.search(needle, { limit: 100 }) as number[];

      // 转换为 session 并过滤
      const matchedSessions = results
-        .map((idx) => sessionByIdxRef.current[idx])
+        .map((idx) => sessions[idx])
        .filter(
          (session) =>
            session &&
@@ -127,8 +82,8 @@ export function useSessionSearch({
        return bTs - aTs;
      });
    },
-    [sessions, providerFilter],
+    [index, providerFilter, sessions],
  );

-  return useMemo(() => ({ search, isIndexing }), [search, isIndexing]);
+  return useMemo(() => ({ search }), [search]);
 }
@@ -26,8 +26,8 @@ export function useStreamCheck(appId: AppId) {
        if (result.status === "operational") {
          toast.success(
            t("streamCheck.operational", {
-              name: providerName,
-              time: result.responseTimeMs,
+              providerName: providerName,
+              responseTimeMs: result.responseTimeMs,
              defaultValue: `${providerName} 运行正常 (${result.responseTimeMs}ms)`,
            }),
            { closeButton: true },
@@ -38,8 +38,8 @@ export function useStreamCheck(appId: AppId) {
        } else if (result.status === "degraded") {
          toast.warning(
            t("streamCheck.degraded", {
-              name: providerName,
-              time: result.responseTimeMs,
+              providerName: providerName,
+              responseTimeMs: result.responseTimeMs,
              defaultValue: `${providerName} 响应较慢 (${result.responseTimeMs}ms)`,
            }),
          );
@@ -49,8 +49,8 @@ export function useStreamCheck(appId: AppId) {
        } else {
          toast.error(
            t("streamCheck.failed", {
-              name: providerName,
-              error: result.message,
+              providerName: providerName,
+              message: result.message,
              defaultValue: `${providerName} 检查失败: ${result.message}`,
            }),
          );
@@ -60,7 +60,7 @@ export function useStreamCheck(appId: AppId) {
      } catch (e) {
        toast.error(
          t("streamCheck.error", {
-            name: providerName,
+            providerName: providerName,
            error: String(e),
            defaultValue: `${providerName} 检查出错: ${String(e)}`,
          }),
@@ -173,7 +173,6 @@
    "settingsSaveFailed": "Failed to save settings: {{error}}",
    "openAIChatFormatHint": "This provider uses OpenAI Chat format and requires the proxy service to be enabled",
    "openAIFormatHint": "This provider uses OpenAI-compatible format and requires the proxy service to be enabled",
-    "proxyRequiredForSwitch": "This provider requires the proxy service. Please start the proxy first",
    "openLinkFailed": "Failed to open link",
    "openclawModelsRegistered": "Models have been registered to /model list",
    "openclawDefaultModelSet": "Set as default model",
@@ -707,9 +706,13 @@
      "crazyrouter": "CrazyRouter offers an exclusive bonus for CC Switch users — 30% extra credit on your first top-up!",
      "sssaicode": "SSAI Code offers an exclusive bonus for CC Switch users — $10 extra credit on every top-up!",
      "siliconflow": "SiliconFlow is an official partner of CC Switch",
-      "ucloud": "UCloud offers an exclusive bonus for CC Switch users — register via this link to get ¥5 platform trial credit!",
+      "ucloud": "Compshare offers an exclusive bonus for CC Switch users — register via this link to get ¥5 platform trial credit!",
      "micu": "Micu is an official partner of CC Switch",
-      "x-code": "XCodeAPI offers a special bonus for CC Switch users — register via this link and get 10% extra credit on your first order (contact admin to claim)"
+      "x-code": "XCodeAPI offers a special bonus for CC Switch users — register via this link and get 10% extra credit on your first order (contact admin to claim)",
+      "ctok": "Join the CTok community on the official website and subscribe to a plan."
+    },
+    "presets": {
+      "ucloud": "Compshare"
    },
    "parameterConfig": "Parameter Config - {{name}} *",
    "mainModel": "Main Model (optional)",
@@ -737,9 +740,6 @@
    "anthropicReasoningModel": "Reasoning Model (Thinking)",
    "apiFormat": "API Format",
    "apiFormatHint": "Select the input format for the provider's API",
-    "fullUrlEnabled": "Full URL Mode",
-    "fullUrlDisabled": "Mark as Full URL",
-    "fullUrlHint": "Proxy will use this URL as-is",
    "apiFormatAnthropic": "Anthropic Messages (Native)",
    "apiFormatOpenAIChat": "OpenAI Chat Completions (Requires proxy)",
    "apiFormatOpenAIResponses": "OpenAI Responses API (Requires proxy)",
@@ -173,7 +173,6 @@
    "settingsSaveFailed": "設定の保存に失敗しました: {{error}}",
    "openAIChatFormatHint": "このプロバイダーは OpenAI Chat フォーマットを使用しており、プロキシサービスの有効化が必要です",
    "openAIFormatHint": "このプロバイダーは OpenAI 互換フォーマットを使用しており、プロキシサービスの有効化が必要です",
-    "proxyRequiredForSwitch": "このプロバイダーにはプロキシが必要です。先にプロキシを起動してください",
    "openLinkFailed": "リンクを開けませんでした",
    "openclawModelsRegistered": "モデルが /model リストに登録されました",
    "openclawDefaultModelSet": "デフォルトモデルに設定しました",
@@ -707,9 +706,13 @@
      "crazyrouter": "CrazyRouter は CC Switch ユーザー向けに特別ボーナスを提供しています。初回チャージで 30% の追加クレジットがもらえます！",
      "sssaicode": "SSAI Code は CC Switch ユーザー向けに特別ボーナスを提供しています。チャージごとに $10 の追加クレジットがもらえます！",
      "siliconflow": "SiliconFlow は CC Switch の公式パートナーです",
-      "ucloud": "UCloud は CC Switch ユーザー向けに特別ボーナスを提供しています。このリンクから登録すると、5元のプラットフォーム体験クレジットがもらえます！",
+      "ucloud": "Compshare は CC Switch ユーザー向けに特別ボーナスを提供しています。このリンクから登録すると、5元のプラットフォーム体験クレジットがもらえます！",
      "micu": "Micu は CC Switch の公式パートナーです",
-      "x-code": "XCodeAPI は CC Switch ユーザー向けに特別ボーナスを提供しています。このリンクから登録すると、初回注文で 10% の追加クレジットがもらえます（管理者に連絡して受け取り）"
+      "x-code": "XCodeAPI は CC Switch ユーザー向けに特別ボーナスを提供しています。このリンクから登録すると、初回注文で 10% の追加クレジットがもらえます（管理者に連絡して受け取り）",
+      "ctok": "公式サイトで CTok コミュニティに参加し、プランを購読してください。"
+    },
+    "presets": {
+      "ucloud": "Compshare"
    },
    "parameterConfig": "パラメーター設定 - {{name}} *",
    "mainModel": "メインモデル（任意）",
@@ -737,9 +740,6 @@
    "anthropicReasoningModel": "推論モデル（Thinking）",
    "apiFormat": "API フォーマット",
    "apiFormatHint": "プロバイダー API の入力フォーマットを選択",
-    "fullUrlEnabled": "フル URL モード",
-    "fullUrlDisabled": "フル URL として設定",
-    "fullUrlHint": "プロキシはこの URL をそのまま使用",
    "apiFormatAnthropic": "Anthropic Messages（ネイティブ）",
    "apiFormatOpenAIChat": "OpenAI Chat Completions（プロキシが必要）",
    "apiFormatOpenAIResponses": "OpenAI Responses API（プロキシが必要）",
@@ -173,7 +173,6 @@
    "settingsSaveFailed": "保存设置失败：{{error}}",
    "openAIChatFormatHint": "此供应商使用 OpenAI Chat 格式，需要开启代理服务才能正常使用",
    "openAIFormatHint": "此供应商使用 OpenAI 兼容格式，需要开启代理服务才能正常使用",
-    "proxyRequiredForSwitch": "此供应商需要代理服务，请先启动代理",
    "openLinkFailed": "链接打开失败",
    "openclawModelsRegistered": "模型已注册到 /model 列表",
    "openclawDefaultModelSet": "已设为默认模型",
@@ -709,7 +708,11 @@
      "siliconflow": "硅基流动是 CC Switch 的官方合作伙伴",
      "ucloud": "优云智算为CC Switch 的用户提供了特殊优惠，通过此链接注册，可以获得五元平台体验金！",
      "micu": "Micu 是 CC Switch 的官方合作伙伴",
-      "x-code": "XCodeAPI 为CC Switch 的用户提供特别福利，使用此链接注册后首单加赠10%的额度(联系站长领取)"
+      "x-code": "XCodeAPI 为CC Switch 的用户提供特别福利，使用此链接注册后首单加赠10%的额度(联系站长领取)",
+      "ctok": "官网加入CTok社群，订阅套餐。"
+    },
+    "presets": {
+      "ucloud": "优云智算"
    },
    "parameterConfig": "参数配置 - {{name}} *",
    "mainModel": "主模型 (可选)",
@@ -737,9 +740,6 @@
    "anthropicReasoningModel": "推理模型 (Thinking)",
    "apiFormat": "API 格式",
    "apiFormatHint": "选择供应商 API 的输入格式",
-    "fullUrlEnabled": "完整 URL 模式",
-    "fullUrlDisabled": "标记为完整 URL",
-    "fullUrlHint": "代理将直接使用此 URL，不拼接路径",
    "apiFormatAnthropic": "Anthropic Messages (原生)",
    "apiFormatOpenAIChat": "OpenAI Chat Completions (需开启代理)",
    "apiFormatOpenAIResponses": "OpenAI Responses API (需开启代理)",
@@ -0,0 +1,21 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" width="200" height="200">
+  <!-- 圆角方形背景 -->
+  <rect x="0" y="0" width="200" height="200" rx="40" ry="40" fill="#3B82F6"/>
+
+  <!-- 中心白色圆环 -->
+  <circle cx="100" cy="100" r="45" fill="white"/>
+  <circle cx="100" cy="100" r="25" fill="#3B82F6"/>
+
+  <!-- 装饰小圆点 -->
+  <circle cx="50" cy="50" r="6" fill="white" opacity="0.6"/>
+  <circle cx="165" cy="70" r="5" fill="white" opacity="0.5"/>
+  <circle cx="170" cy="140" r="7" fill="white" opacity="0.4"/>
+
+  <!-- 右下角深蓝色装饰 -->
+  <defs>
+    <clipPath id="roundedCorner">
+      <rect x="0" y="0" width="200" height="200" rx="40" ry="40"/>
+    </clipPath>
+  </defs>
+  <path d="M 200 150 Q 175 175 150 200 L 200 200 Z" fill="#2563EB" opacity="0.6" clip-path="url(#roundedCorner)"/>
+</svg>
@@ -16,6 +16,7 @@ export const icons: Record<string, string> = {
  cloudflare: `<svg height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Cloudflare</title><path d="M16.493 17.4c.135-.52.08-.983-.161-1.338-.215-.328-.592-.519-1.05-.519l-8.663-.109a.148.148 0 01-.135-.082c-.027-.054-.027-.109-.027-.163.027-.082.108-.164.189-.164l8.744-.11c1.05-.054 2.153-.9 2.556-1.937l.511-1.31c.027-.055.027-.11.027-.164C17.92 8.91 15.66 7 12.942 7c-2.503 0-4.628 1.638-5.381 3.903a2.432 2.432 0 00-1.803-.491c-1.21.109-2.153 1.092-2.287 2.32-.027.328 0 .628.054.9C1.56 13.688 0 15.326 0 17.319c0 .19.027.355.027.545 0 .082.08.137.161.137h15.983c.08 0 .188-.055.215-.164l.107-.437" fill="#F38020"></path><path d="M19.238 11.75h-.242c-.054 0-.108.054-.135.109l-.35 1.2c-.134.52-.08.983.162 1.338.215.328.592.518 1.05.518l1.855.11c.054 0 .108.027.135.082.027.054.027.109.027.163-.027.082-.108.164-.188.164l-1.91.11c-1.05.054-2.153.9-2.557 1.937l-.134.355c-.027.055.026.137.107.137h6.592c.081 0 .162-.055.162-.137.107-.41.188-.846.188-1.31-.027-2.62-2.153-4.777-4.762-4.777" fill="#FCAD32"></path></svg>`,
  cohere: `<svg height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Cohere</title><path clip-rule="evenodd" d="M8.128 14.099c.592 0 1.77-.033 3.398-.703 1.897-.781 5.672-2.2 8.395-3.656 1.905-1.018 2.74-2.366 2.74-4.18A4.56 4.56 0 0018.1 1H7.549A6.55 6.55 0 001 7.55c0 3.617 2.745 6.549 7.128 6.549z" fill="#39594D" fill-rule="evenodd"></path><path clip-rule="evenodd" d="M9.912 18.61a4.387 4.387 0 012.705-4.052l3.323-1.38c3.361-1.394 7.06 1.076 7.06 4.715a5.104 5.104 0 01-5.105 5.104l-3.597-.001a4.386 4.386 0 01-4.386-4.387z" fill="#D18EE2" fill-rule="evenodd"></path><path d="M4.776 14.962A3.775 3.775 0 001 18.738v.489a3.776 3.776 0 007.551 0v-.49a3.775 3.775 0 00-3.775-3.775z" fill="#FF7759"></path></svg>`,
  copilot: `<svg height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Copilot</title><path d="M17.533 1.829A2.528 2.528 0 0015.11 0h-.737a2.531 2.531 0 00-2.484 2.087l-1.263 6.937.314-1.08a2.528 2.528 0 012.424-1.833h4.284l1.797.706 1.731-.706h-.505a2.528 2.528 0 01-2.423-1.829l-.715-2.453z" fill="url(#lobe-icons-copilot-fill-0)" transform="translate(0 1)"></path><path d="M6.726 20.16A2.528 2.528 0 009.152 22h1.566c1.37 0 2.49-1.1 2.525-2.48l.17-6.69-.357 1.228a2.528 2.528 0 01-2.423 1.83h-4.32l-1.54-.842-1.667.843h.497c1.124 0 2.113.75 2.426 1.84l.697 2.432z" fill="url(#lobe-icons-copilot-fill-1)" transform="translate(0 1)"></path><path d="M15 0H6.252c-2.5 0-4 3.331-5 6.662-1.184 3.947-2.734 9.225 1.75 9.225H6.78c1.13 0 2.12-.753 2.43-1.847.657-2.317 1.809-6.359 2.713-9.436.46-1.563.842-2.906 1.43-3.742A1.97 1.97 0 0115 0" fill="url(#lobe-icons-copilot-fill-2)" transform="translate(0 1)"></path><path d="M15 0H6.252c-2.5 0-4 3.331-5 6.662-1.184 3.947-2.734 9.225 1.75 9.225H6.78c1.13 0 2.12-.753 2.43-1.847.657-2.317 1.809-6.359 2.713-9.436.46-1.563.842-2.906 1.43-3.742A1.97 1.97 0 0115 0" fill="url(#lobe-icons-copilot-fill-3)" transform="translate(0 1)"></path><path d="M9 22h8.749c2.5 0 4-3.332 5-6.663 1.184-3.948 2.734-9.227-1.75-9.227H17.22c-1.129 0-2.12.754-2.43 1.848a1149.2 1149.2 0 01-2.713 9.437c-.46 1.564-.842 2.907-1.43 3.743A1.97 1.97 0 019 22" fill="url(#lobe-icons-copilot-fill-4)" transform="translate(0 1)"></path><path d="M9 22h8.749c2.5 0 4-3.332 5-6.663 1.184-3.948 2.734-9.227-1.75-9.227H17.22c-1.129 0-2.12.754-2.43 1.848a1149.2 1149.2 0 01-2.713 9.437c-.46 1.564-.842 2.907-1.43 3.743A1.97 1.97 0 019 22" fill="url(#lobe-icons-copilot-fill-5)" transform="translate(0 1)"></path><defs><radialGradient cx="85.44%" cy="100.653%" fx="85.44%" fy="100.653%" gradientTransform="scale(-.8553 -1) rotate(50.927 2.041 -1.946)" id="lobe-icons-copilot-fill-0" r="105.116%"><stop offset="9.6%" stop-color="#00AEFF"></stop><stop offset="77.3%" stop-color="#2253CE"></stop><stop offset="100%" stop-color="#0736C4"></stop></radialGradient><radialGradient cx="18.143%" cy="32.928%" fx="18.143%" fy="32.928%" gradientTransform="scale(.8897 1) rotate(52.069 .193 .352)" id="lobe-icons-copilot-fill-1" r="95.612%"><stop offset="0%" stop-color="#FFB657"></stop><stop offset="63.4%" stop-color="#FF5F3D"></stop><stop offset="92.3%" stop-color="#C02B3C"></stop></radialGradient><radialGradient cx="82.987%" cy="-9.792%" fx="82.987%" fy="-9.792%" gradientTransform="scale(-1 -.9441) rotate(-70.872 .142 1.17)" id="lobe-icons-copilot-fill-4" r="140.622%"><stop offset="6.6%" stop-color="#8C48FF"></stop><stop offset="50%" stop-color="#F2598A"></stop><stop offset="89.6%" stop-color="#FFB152"></stop></radialGradient><linearGradient id="lobe-icons-copilot-fill-2" x1="39.465%" x2="46.884%" y1="12.117%" y2="103.774%"><stop offset="15.6%" stop-color="#0D91E1"></stop><stop offset="48.7%" stop-color="#52B471"></stop><stop offset="65.2%" stop-color="#98BD42"></stop><stop offset="93.7%" stop-color="#FFC800"></stop></linearGradient><linearGradient id="lobe-icons-copilot-fill-3" x1="45.949%" x2="50%" y1="0%" y2="100%"><stop offset="0%" stop-color="#3DCBFF"></stop><stop offset="24.7%" stop-color="#0588F7" stop-opacity="0"></stop></linearGradient><linearGradient id="lobe-icons-copilot-fill-5" x1="83.507%" x2="83.453%" y1="-6.106%" y2="21.131%"><stop offset="5.8%" stop-color="#F8ADFA"></stop><stop offset="70.8%" stop-color="#A86EDD" stop-opacity="0"></stop></linearGradient></defs></svg>`,
+  ctok: `<svg xmlns="http://www.w3.org/2000/svg" height="1em" width="1em" style="flex:none;line-height:1" viewBox="0 0 200 200"><title>CTok</title><rect x="0" y="0" width="200" height="200" rx="40" ry="40" fill="#3B82F6"/><circle cx="100" cy="100" r="45" fill="white"/><circle cx="100" cy="100" r="25" fill="#3B82F6"/><circle cx="50" cy="50" r="6" fill="white" opacity="0.6"/><circle cx="165" cy="70" r="5" fill="white" opacity="0.5"/><circle cx="170" cy="140" r="7" fill="white" opacity="0.4"/><defs><clipPath id="ctok-rc"><rect x="0" y="0" width="200" height="200" rx="40" ry="40"/></clipPath></defs><path d="M 200 150 Q 175 175 150 200 L 200 200 Z" fill="#2563EB" opacity="0.6" clip-path="url(#ctok-rc)"/></svg>`,
  crazyrouter: `<svg xmlns="http://www.w3.org/2000/svg" width="1em" height="1em" style="flex:none;line-height:1" viewBox="0 0 563 648"><title>CrazyRouter</title><path fill="currentColor" d="M 167.5 190 L 276.5 190 L 277 191.5 L 253 234 L 247.5 235 L 246.5 234 L 235.5 234 L 230.5 235 L 229.5 234 L 217.5 234 L 215.5 234 L 191.5 234 L 189.5 235 L 186.5 234 L 164.5 235 L 150.5 239 Q 132.7 246.7 121 260.5 Q 108.2 275.2 102 296.5 L 99 312.5 L 99 335.5 L 102 351.5 L 110 371.5 Q 118.1 386.4 130.5 397 Q 143.5 409 164.5 413 L 173.5 413 L 174.5 414 L 258.5 414 L 314.5 318 L 433.5 318 Q 449.3 314.8 457 303.5 L 462 294.5 L 465 283.5 L 465 269.5 L 460 253.5 L 449.5 241 L 440.5 236 L 430.5 234 L 332.5 234 L 258.5 361 L 212.5 361 L 212 359.5 L 310.5 190 L 438.5 190 L 448.5 192 L 461.5 197 Q 476 205 486 217.5 L 496 233.5 L 502 250.5 L 504 260.5 L 504 268.5 L 505 269.5 L 505 283.5 L 504 284.5 L 503 297.5 L 499 311.5 Q 490.8 331.8 475.5 345 L 462.5 354 L 446 360.5 L 502 452.5 L 504 458 L 456.5 458 L 454 455.5 L 416 389.5 L 398.5 362 L 336.5 362 L 335 363.5 L 285 452.5 L 280.5 458 L 167.5 458 L 166.5 457 L 153.5 456 Q 112.4 445.6 90 416.5 Q 72.7 396.3 64 367.5 L 59 343.5 L 58 314.5 L 59 313.5 L 60 297.5 L 64 280.5 L 73 257.5 Q 85.3 233.8 104.5 217 Q 116.8 206.3 132.5 199 L 149.5 193 L 166.5 191 L 167.5 190 Z"/></svg>`,
  cubence: `<svg height="1em" style="flex:none;line-height:1" viewBox="0 0 179 203" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Cubence</title><rect width="100" height="100" rx="13" transform="matrix(0.866025 -0.5 0 1 92 103)" fill="#4B5563"></rect><rect width="100" height="100" rx="13" transform="matrix(0.866025 0.5 -0.866025 0.5 88.6025 -3)" fill="#1F2937"></rect><rect width="100" height="100" rx="13" transform="matrix(0.866025 0.5 0 1 0 53)" fill="#111827"></rect><rect width="72.7816" height="72.7816" rx="13" transform="matrix(0.866025 0.5 0 1 11 73)" fill="#374151"></rect><rect width="28.1436" height="28.1436" rx="3" transform="matrix(0.866025 0.5 0 1 11 86)" fill="#E5E7EB" fill-opacity="0.9"></rect><rect width="28.1436" height="28.1436" rx="3" transform="matrix(0.866025 0.5 0 1 50 107)" fill="#E5E7EB" fill-opacity="0.9"></rect><rect width="13.8564" height="13.8564" rx="3" transform="matrix(0.866025 0.5 0 1 43 148)" fill="#E5E7EB" fill-opacity="0.9"></rect></svg>`,
  deepseek: `<svg height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>DeepSeek</title><path d="M23.748 4.482c-.254-.124-.364.113-.512.234-.051.039-.094.09-.137.136-.372.397-.806.657-1.373.626-.829-.046-1.537.214-2.163.848-.133-.782-.575-1.248-1.247-1.548-.352-.156-.708-.311-.955-.65-.172-.241-.219-.51-.305-.774-.055-.16-.11-.323-.293-.35-.2-.031-.278.136-.356.276-.313.572-.434 1.202-.422 1.84.027 1.436.633 2.58 1.838 3.393.137.093.172.187.129.323-.082.28-.18.552-.266.833-.055.179-.137.217-.329.14a5.526 5.526 0 01-1.736-1.18c-.857-.828-1.631-1.742-2.597-2.458a11.365 11.365 0 00-.689-.471c-.985-.957.13-1.743.388-1.836.27-.098.093-.432-.779-.428-.872.004-1.67.295-2.687.684a3.055 3.055 0 01-.465.137 9.597 9.597 0 00-2.883-.102c-1.885.21-3.39 1.102-4.497 2.623C.082 8.606-.231 10.684.152 12.85c.403 2.284 1.569 4.175 3.36 5.653 1.858 1.533 3.997 2.284 6.438 2.14 1.482-.085 3.133-.284 4.994-1.86.47.234.962.327 1.78.397.63.059 1.236-.03 1.705-.128.735-.156.684-.837.419-.961-2.155-1.004-1.682-.595-2.113-.926 1.096-1.296 2.746-2.642 3.392-7.003.05-.347.007-.565 0-.845-.004-.17.035-.237.23-.256a4.173 4.173 0 001.545-.475c1.396-.763 1.96-2.015 2.093-3.517.02-.23-.004-.467-.247-.588zM11.581 18c-2.089-1.642-3.102-2.183-3.52-2.16-.392.024-.321.471-.235.763.09.288.207.486.371.739.114.167.192.416-.113.603-.673.416-1.842-.14-1.897-.167-1.361-.802-2.5-1.86-3.301-3.307-.774-1.393-1.224-2.887-1.298-4.482-.02-.386.093-.522.477-.592a4.696 4.696 0 011.529-.039c2.132.312 3.946 1.265 5.468 2.774.868.86 1.525 1.887 2.202 2.891.72 1.066 1.494 2.082 2.48 2.914.348.292.625.514.891.677-.802.09-2.14.11-3.054-.614zm1-6.44a.306.306 0 01.415-.287.302.302 0 01.2.288.306.306 0 01-.31.307.303.303 0 01-.304-.308zm3.11 1.596c-.2.081-.399.151-.59.16a1.245 1.245 0 01-.798-.254c-.274-.23-.47-.358-.552-.758a1.73 1.73 0 01.016-.588c.07-.327-.008-.537-.239-.727-.187-.156-.426-.199-.688-.199a.559.559 0 01-.254-.078c-.11-.054-.2-.19-.114-.358.028-.054.16-.186.192-.21.356-.202.767-.136 1.146.016.352.144.618.408 1.001.782.391.451.462.576.685.914.176.265.336.537.445.848.067.195-.019.354-.25.452z" fill="#4D6BFE"></path></svg>`,
@@ -93,6 +93,13 @@ export const iconMetadata: Record<string, IconMetadata> = {
    keywords: [],
    defaultColor: "currentColor",
  },
+  ctok: {
+    name: "ctok",
+    displayName: "CTok",
+    category: "ai-provider",
+    keywords: ["ctok", "ai", "programming"],
+    defaultColor: "#3B82F6",
+  },
  cubence: {
    name: "cubence",
    displayName: "Cubence",
@@ -151,8 +151,6 @@ export interface ProviderMeta {
  apiFormat?: "anthropic" | "openai_chat" | "openai_responses";
  // Claude 认证字段名
  apiKeyField?: ClaudeApiKeyField;
-  // 是否将 base_url 视为完整 API 端点（代理直接使用此 URL，不拼接路径）
-  isFullUrl?: boolean;
  // Prompt cache key for OpenAI-compatible endpoints (improves cache hit rate)
  promptCacheKey?: string;
 }
@@ -525,6 +523,7 @@ export interface OpenClawProviderConfig {
  api?: string; // API 协议类型（如 "openai-completions"、"anthropic"）
  models?: OpenClawModel[]; // 可用模型列表
  headers?: Record<string, string>; // 自定义请求头（如 User-Agent）
+  authHeader?: boolean; // 供应商自定义认证开关（如 Longcat）
 }

 // OpenClaw agents.defaults 完整配置
@@ -170,7 +170,6 @@ export const hasCommonConfigSnippet = (
 export const getApiKeyFromConfig = (
  jsonString: string,
  appType?: string,
-  apiKeyField?: string,
 ): string => {
  try {
    const config = JSON.parse(jsonString);
@@ -204,17 +203,11 @@ export const getApiKeyFromConfig = (
    const token = env.ANTHROPIC_AUTH_TOKEN;
    const apiKey = env.ANTHROPIC_API_KEY;
    const value =
-      apiKeyField === "ANTHROPIC_API_KEY"
-        ? typeof apiKey === "string"
+      typeof token === "string"
+        ? token
+        : typeof apiKey === "string"
          ? apiKey
-          : typeof token === "string"
-            ? token
-            : ""
-        : typeof token === "string"
-          ? token
-          : typeof apiKey === "string"
-            ? apiKey
-            : "";
+          : "";
    return value;
  } catch (err) {
    return "";
@@ -348,20 +341,13 @@ export const setApiKeyInConfig = (
      return JSON.stringify(config, null, 2);
    }

-    // Claude API Key: follow the selected field when provided.
-    const preferredClaudeField = apiKeyField ?? "ANTHROPIC_AUTH_TOKEN";
-    const alternateClaudeField =
-      preferredClaudeField === "ANTHROPIC_API_KEY"
-        ? "ANTHROPIC_AUTH_TOKEN"
-        : "ANTHROPIC_API_KEY";
-
-    if (preferredClaudeField in env) {
-      env[preferredClaudeField] = apiKey;
-    } else if (alternateClaudeField in env) {
-      env[preferredClaudeField] = apiKey;
-      delete env[alternateClaudeField];
+    // Claude API Key (优先写入已存在的字段；若两者均不存在且允许创建，则使用 apiKeyField 或默认 AUTH_TOKEN 字段)
+    if ("ANTHROPIC_AUTH_TOKEN" in env) {
+      env.ANTHROPIC_AUTH_TOKEN = apiKey;
+    } else if ("ANTHROPIC_API_KEY" in env) {
+      env.ANTHROPIC_API_KEY = apiKey;
    } else if (createIfMissing) {
-      env[preferredClaudeField] = apiKey;
+      env[apiKeyField ?? "ANTHROPIC_AUTH_TOKEN"] = apiKey;
    } else {
      return jsonString;
    }
@@ -0,0 +1,121 @@
+import type { ReactNode } from "react";
+import { fireEvent, render, screen, waitFor } from "@testing-library/react";
+import { describe, expect, it, vi } from "vitest";
+import CodexConfigEditor from "@/components/providers/forms/CodexConfigEditor";
+import GeminiConfigEditor from "@/components/providers/forms/GeminiConfigEditor";
+
+vi.mock("@/components/common/FullScreenPanel", () => ({
+  FullScreenPanel: ({
+    isOpen,
+    title,
+    onClose,
+    children,
+    footer,
+  }: {
+    isOpen: boolean;
+    title: string;
+    onClose: () => void;
+    children: ReactNode;
+    footer?: ReactNode;
+  }) =>
+    isOpen ? (
+      <div data-testid="common-config-panel">
+        <button type="button" onClick={onClose}>
+          panel-close
+        </button>
+        <h2>{title}</h2>
+        <div>{children}</div>
+        <div>{footer}</div>
+      </div>
+    ) : null,
+}));
+
+vi.mock("@/components/JsonEditor", () => ({
+  default: ({
+    value,
+    onChange,
+  }: {
+    value: string;
+    onChange: (value: string) => void;
+  }) => (
+    <textarea
+      value={value}
+      onChange={(event) => onChange(event.target.value)}
+      aria-label="mock-editor"
+    />
+  ),
+}));
+
+describe("Common config modals", () => {
+  it("keeps the Codex common config modal closed after user closes it with an error present", async () => {
+    render(
+      <CodexConfigEditor
+        authValue="{}"
+        configValue=""
+        onAuthChange={() => {}}
+        onConfigChange={() => {}}
+        useCommonConfig={false}
+        onCommonConfigToggle={() => {}}
+        commonConfigSnippet={`base_url = "https://example.com"`}
+        onCommonConfigSnippetChange={() => false}
+        onCommonConfigErrorClear={() => {}}
+        commonConfigError="Invalid TOML"
+        authError=""
+        configError=""
+      />,
+    );
+
+    expect(screen.queryByTestId("common-config-panel")).not.toBeInTheDocument();
+
+    fireEvent.click(
+      screen.getByRole("button", { name: /codexConfig.editCommonConfig|编辑通用配置/ }),
+    );
+
+    expect(screen.getByTestId("common-config-panel")).toBeInTheDocument();
+
+    fireEvent.click(screen.getByRole("button", { name: "common.cancel" }));
+
+    await waitFor(() =>
+      expect(
+        screen.queryByTestId("common-config-panel"),
+      ).not.toBeInTheDocument(),
+    );
+  });
+
+  it("keeps the Gemini common config modal closed after user closes it with an error present", async () => {
+    render(
+      <GeminiConfigEditor
+        envValue="{}"
+        configValue="{}"
+        onEnvChange={() => {}}
+        onConfigChange={() => {}}
+        useCommonConfig={false}
+        onCommonConfigToggle={() => {}}
+        commonConfigSnippet={`{"GEMINI_MODEL":"gemini-2.5-pro"}`}
+        onCommonConfigSnippetChange={() => false}
+        onCommonConfigErrorClear={() => {}}
+        commonConfigError="Invalid JSON"
+        envError=""
+        configError=""
+      />,
+    );
+
+    expect(screen.queryByTestId("common-config-panel")).not.toBeInTheDocument();
+
+    fireEvent.click(
+      screen.getByRole("button", {
+        name: /geminiConfig.editCommonConfig|编辑通用配置/,
+      }),
+    );
+
+    expect(screen.getByTestId("common-config-panel")).toBeInTheDocument();
+
+    fireEvent.click(screen.getByRole("button", { name: "common.cancel" }));
+
+    await waitFor(() =>
+      expect(
+        screen.queryByTestId("common-config-panel"),
+      ).not.toBeInTheDocument(),
+    );
+  });
+});
@@ -69,6 +69,18 @@ const renderPage = () => {
  );
 };

+const openSearch = () => {
+  const searchButton = Array.from(screen.getAllByRole("button")).find((button) =>
+    button.querySelector(".lucide-search"),
+  );
+
+  if (!searchButton) {
+    throw new Error("Search button not found");
+  }
+
+  fireEvent.click(searchButton);
+};
+
 describe("SessionManagerPage", () => {
  beforeEach(() => {
    toastSuccessMock.mockReset();
@@ -137,4 +149,40 @@ describe("SessionManagerPage", () => {
    expect(toastErrorMock).not.toHaveBeenCalled();
    expect(toastSuccessMock).toHaveBeenCalled();
  });
+
+  it("removes a deleted session from filtered search results", async () => {
+    renderPage();
+
+    await waitFor(() =>
+      expect(
+        screen.getByRole("heading", { name: "Alpha Session" }),
+      ).toBeInTheDocument(),
+    );
+
+    openSearch();
+
+    fireEvent.change(screen.getByRole("textbox"), {
+      target: { value: "Alpha" },
+    });
+
+    await waitFor(() =>
+      expect(screen.getAllByText("Alpha Session")).toHaveLength(2),
+    );
+
+    fireEvent.click(screen.getByRole("button", { name: /删除会话/i }));
+
+    const dialog = screen.getByTestId("confirm-dialog");
+    fireEvent.click(within(dialog).getByRole("button", { name: /删除会话/i }));
+
+    await waitFor(() =>
+      expect(screen.queryByText("Alpha Session")).not.toBeInTheDocument(),
+    );
+
+    expect(screen.getByText("sessionManager.selectSession")).toBeInTheDocument();
+    expect(
+      screen.queryByText("sessionManager.emptySession"),
+    ).not.toBeInTheDocument();
+    expect(toastErrorMock).not.toHaveBeenCalled();
+    expect(toastSuccessMock).toHaveBeenCalled();
+  });
 });
@@ -0,0 +1,79 @@
+import { act, renderHook, waitFor } from "@testing-library/react";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { useCodexCommonConfig } from "@/components/providers/forms/hooks/useCodexCommonConfig";
+import { useGeminiCommonConfig } from "@/components/providers/forms/hooks/useGeminiCommonConfig";
+
+const getCommonConfigSnippetMock = vi.fn();
+const setCommonConfigSnippetMock = vi.fn();
+const extractCommonConfigSnippetMock = vi.fn();
+
+vi.mock("@/lib/api", () => ({
+  configApi: {
+    getCommonConfigSnippet: (...args: unknown[]) =>
+      getCommonConfigSnippetMock(...args),
+    setCommonConfigSnippet: (...args: unknown[]) =>
+      setCommonConfigSnippetMock(...args),
+    extractCommonConfigSnippet: (...args: unknown[]) =>
+      extractCommonConfigSnippetMock(...args),
+  },
+}));
+
+describe("common config snippet saving", () => {
+  beforeEach(() => {
+    getCommonConfigSnippetMock.mockResolvedValue("");
+    setCommonConfigSnippetMock.mockResolvedValue(undefined);
+    extractCommonConfigSnippetMock.mockResolvedValue("");
+  });
+
+  it("does not persist an invalid Codex common config snippet", async () => {
+    const onConfigChange = vi.fn();
+    const { result } = renderHook(() =>
+      useCodexCommonConfig({
+        codexConfig: "model = \"gpt-5\"",
+        onConfigChange,
+      }),
+    );
+
+    await waitFor(() => expect(result.current.isLoading).toBe(false));
+
+    let saved = false;
+    act(() => {
+      saved = result.current.handleCommonConfigSnippetChange(
+        "base_url = https://bad.example/v1",
+      );
+    });
+
+    expect(saved).toBe(false);
+    expect(setCommonConfigSnippetMock).not.toHaveBeenCalled();
+    expect(onConfigChange).not.toHaveBeenCalled();
+    expect(result.current.commonConfigError).toContain("invalid value");
+  });
+
+  it("does not persist an invalid Gemini common config snippet", async () => {
+    const onEnvChange = vi.fn();
+    const { result } = renderHook(() =>
+      useGeminiCommonConfig({
+        envValue: "",
+        onEnvChange,
+        envStringToObj: () => ({}),
+        envObjToString: () => "",
+      }),
+    );
+
+    await waitFor(() => expect(result.current.isLoading).toBe(false));
+
+    let saved = false;
+    act(() => {
+      saved = result.current.handleCommonConfigSnippetChange(
+        JSON.stringify({ GEMINI_MODEL: 123 }),
+      );
+    });
+
+    expect(saved).toBe(false);
+    expect(setCommonConfigSnippetMock).not.toHaveBeenCalled();
+    expect(onEnvChange).not.toHaveBeenCalled();
+    expect(result.current.commonConfigError).toBe(
+      "geminiConfig.commonConfigInvalidValues",
+    );
+  });
+});
@@ -52,3 +52,4 @@ describe("Codex TOML utils", () => {
    expect(extractCodexModelName(output2)).toBe("new-model");
  });
 });
+
Author	SHA1	Message	Date
Jason	3dad255a2a	chore: bump version to v3.12.1 and add release notes	2026-03-12 00:15:05 +08:00
Jason	51825dac20	feat: add authHeader field to OpenClawProviderConfig and reuse type in form state Add optional `authHeader` boolean to support vendor-specific auth headers (e.g. Longcat). Refactor `resetOpenclawState` to use the shared `OpenClawProviderConfig` type instead of an inline duplicate definition.	2026-03-11 23:56:41 +08:00
Jason	ce985763f0	fix: rename OpenCode API format label from "OpenAI" to "OpenAI Responses"	2026-03-11 23:51:11 +08:00
Jason	19dca7cd2b	feat: add CTok as sponsor and upgrade Gemini model to 3.1-pro	2026-03-11 23:47:08 +08:00
Jason	70632249a8	feat: add SiliconFlow as sponsor and update affiliate links Replace SDS logos with SiliconFlow logos, add SiliconFlow sponsor entries to all three README files (en/zh/ja), fix incorrect alt attribute, and update all SiliconFlow provider preset apiKeyUrl to affiliate link.	2026-03-11 16:25:38 +08:00
Jason	55210d90d2	fix: update Compshare sponsor registration links to coding-plan page	2026-03-11 15:23:04 +08:00
Jason	239c6fb2d7	fix: prevent common config modal infinite reopen loop and add draft editing The auto-open useEffect in CodexConfigEditor and GeminiConfigEditor created an inescapable loop: commonConfigError triggered modal open, closing the modal didn't clear the error, so the effect immediately reopened it — locking the entire UI. - Remove auto-open useEffect from both Codex and Gemini config editors - Convert common config modals to draft editing (edit locally, validate before save) instead of persisting on every keystroke - Add TOML/JSON pre-validation via parseCommonConfigSnippet before any merge operation to prevent invalid content from being persisted - Expose clearCommonConfigError so editors can clear stale errors on modal close	2026-03-11 14:40:14 +08:00
Jason	4ac7e28b10	feat: add XCodeAPI as sponsor and fix incorrect alt attributes - Add XCodeAPI sponsor entry to all three READMEs (zh, en, ja) - Fix XCodeAPI logo alt from "Micu" to "XCodeAPI" in README_ZH.md - Fix Crazyrouter logo alt from "AICoding" to "Crazyrouter" in all READMEs	2026-03-11 11:12:29 +08:00
Jason	47e956bb63	feat: add Micu API as sponsor and update affiliate links Add Micu (米醋API) sponsor entry to all three README files (EN/ZH/JA) with logo and description. Update apiKeyUrl for Micu provider presets across claude, codex, opencode, and openclaw to use affiliate registration link.	2026-03-11 00:14:40 +08:00
Jason	0bcbffb8a0	feat: rename UCloud provider to Compshare/优云智算 with i18n support Add optional `nameKey` field to all preset interfaces for localized display names. The preset selector and form now resolve `nameKey` via i18next, falling back to `name` when unset. - zh: 优云智算 / en+ja: Compshare - Update model ID prefix ucloud/ → compshare/ in OpenClaw presets - Update partner promotion copy and README sponsor descriptions	2026-03-10 23:43:23 +08:00
Jason	273a756869	fix: sync session search index with query data to refresh list after deletion Replace useRef+useEffect async index rebuild with useMemo so the FlexSearch index and the sessions array always reference the same data. This ensures filtered search results update immediately when a session is deleted via TanStack Query setQueryData.	2026-03-10 23:06:45 +08:00
Jason	c2b60623a6	fix: avoid FK constraint failure when restoring provider_health during WebDAV sync Split LOCAL_ONLY_TABLES into SYNC_SKIP_TABLES (export) and SYNC_PRESERVE_TABLES (import). provider_health is skipped on export but no longer restored on import, since it has a foreign key on providers(id, app_type) that may not match the remote dataset. Health data is ephemeral and rebuilds automatically at runtime.	2026-03-10 23:06:45 +08:00
Jason	f4ad17d314	fix: align stream check toast i18n interpolation keys with translation placeholders	2026-03-10 23:06:45 +08:00
Jason	236f96b583	fix: correct X-Code API URL from www.x-code.cn to x-code.cc	2026-03-10 23:06:45 +08:00