ContextQMD
Back to Cc Switch

CC Switch v3.12.2

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

3.14.18.9 KB
Original Source

CC Switch v3.12.2

プロキシテイクオーバー中の共通設定保護、Snippet ライフサイクルの安定化、Codex TOML セクション対応編集

中文版 → | English →

概要

CC Switch v3.12.2 は、信頼性を重視したパッチリリースです。プロキシテイクオーバーモードでの共通設定（Common Config）の消失問題を解決し、Codex TOML 設定の編集精度を改善しました。テイクオーバーのホットスイッチとプロバイダー同期は、ライブ設定ファイルを上書きする代わりにリストアバックアップを更新するようになりました。起動シーケンスを再整理し、テイクオーバー状態を復元する前にクリーンなライブファイルから Snippet を抽出するようにしました。また Codex の base_url 編集をセクション対応モデルにリファクタリングし、ファイル末尾への誤追加を防止しました。

リリース日: 2026-03-12

更新規模: 5 commits | 22 files changed | +1,716 / -288 lines

ハイライト

  • 空状態ガイダンスの改善: プロバイダーリストが空の場合に詳細なインポート手順を表示し、Claude/Codex/Gemini には共通設定 Snippet のヒントを条件付きで表示

  • プロキシテイクオーバーリストアフロー刷新: ホットスイッチとプロバイダー同期がライブ設定ファイルの上書きではなくリストアバックアップの更新を行うようになり、ロールバック時に完全なユーザー設定を保持

  • Snippet ライフサイクルの安定化: cleared フラグを導入し、クリア済み Snippet の自動再抽出を防止。起動順序を調整してクリーンな状態から抽出

  • Codex TOML セクション対応編集: base_url と model フィールドの読み書きが正しい [model_providers.<name>] セクションを対象にするように改善

  • Codex MCP 設定の保護: プロバイダーホットスイッチ時にリストアスナップショット内の既存 mcp_servers ブロックが保持されるように修正。テーブル全体の置換からサーバー ID ごとのマージに変更し、プロバイダー/共通設定の MCP 定義が競合時に優先

新機能

空状態ガイダンスの改善

プロバイダーリストが空の場合の初回利用体験を改善しました。

  • 空状態ページにプロバイダーインポートの操作ガイドを表示
  • Claude/Codex/Gemini アプリケーションに共通設定 Snippet のヒントを条件付きで表示（OpenCode/OpenClaw には非表示）

変更

プロキシテイクオーバーリストアフロー

テイクオーバーのホットスイッチとプロバイダー同期ロジックをリファクタリングし、テイクオーバーライフサイクル全体で共通設定を保護します。

  • テイクオーバーがアクティブな場合、プロバイダー同期がライブ設定ファイルへの直接書き込みではなくリストアバックアップを更新
  • リストアスナップショットの保存前に共通設定を適用した実効プロバイダー設定を再構築し、ロールバックで実際のユーザー設定を復元
  • 共通設定の使用が推測されるレガシープロバイダーに commonConfigEnabled=true を自動マーク

Codex TOML 編集エンジン

Codex config.toml の更新ロジックを共有のセクション対応 TOML ヘルパーにリファクタリングしました。

  • Rust 側に新モジュール codex_config.rs を追加（update_codex_toml_field と remove_codex_toml_base_url_if）
  • フロントエンドにセクション対応ユーティリティ getTomlSectionRange / getCodexProviderSectionName を追加
  • proxy.rs に散在していたインライン TOML 編集ロジックを新モジュールに委譲

共通設定初期化ライフサイクル

Snippet の抽出とマイグレーションをより堅牢にするため、起動シーケンスを再整理しました。

  • 起動時にプロキシテイクオーバー状態を復元する前に、クリーンなライブファイルから共通設定 Snippet を自動抽出
  • Snippet の cleared フラグを導入し、ユーザーが意図的にクリアしたかどうかを追跡
  • 一回限りのレガシーマイグレーションフラグを永続化し、commonConfigEnabled のバックフィルの繰り返しを防止

バグ修正

共通設定の消失

  • プロキシテイクオーバー中に共通設定が消失する複数のシナリオを修正：同期によるライブファイルの上書き、ホットスイッチによる不完全なリストアスナップショット、プロバイダー切り替え時の設定変更の消失

Codex リストアスナップショットの保護

  • プロバイダーホットスイッチ時に Codex テイクオーバーリストアバックアップが既存の mcp_servers ブロックを破棄する問題を修正。MCP バックアップ保持をテーブル全体の置換からサーバー ID ごとのマージに変更し、プロバイダー/共通設定の MCP 更新が競合時に優先され、バックアップのみのサーバーも保持

クリア済み Snippet の復活

  • 起動時の自動抽出が、ユーザーが意図的にクリアした共通設定 Snippet を再作成する問題を修正

Codex base_url の配置エラー

  • Codex base_url の抽出と編集が正しい [model_providers.<name>] セクションを対象にせず、ファイル末尾に追加されたり mcp_servers.*.base_url をプロバイダーエンドポイントと誤認する問題を修正

ダウンロードとインストール

Releases から適切なバージョンをダウンロードしてください。

システム要件

システム最小バージョンアーキテクチャ
WindowsWindows 10 以降x64
macOSmacOS 10.15 (Catalina) 以降Intel (x64) / Apple Silicon (arm64)
Linux下表参照x64

Windows

ファイル説明
CC-Switch-v3.12.2-Windows.msi推奨 - MSI インストーラー、自動更新対応
CC-Switch-v3.12.2-Windows-Portable.zipポータブル版、解凍して実行、レジストリ書き込みなし

macOS

ファイル説明
CC-Switch-v3.12.2-macOS.zip推奨 - 解凍して Applications にドラッグ、Universal Binary
CC-Switch-v3.12.2-macOS.tar.gzHomebrew インストールと自動更新用

注意: 作者が 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.debsudo dpkg -i CC-Switch-*.deb または sudo apt install ./CC-Switch-*.deb
Fedora / RHEL / CentOS / Rocky Linux.rpmsudo rpm -i CC-Switch-*.rpm または sudo dnf install ./CC-Switch-*.rpm
openSUSE.rpmsudo zypper install ./CC-Switch-*.rpm
Arch Linux / Manjaro.AppImage実行権限を追加して直接実行、または AUR を使用
その他のディストリビューション / 不明.AppImagechmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage