Files
cc-switch/docs/release-notes/v3.12.0-ja.md

14 KiB
Raw Blame History

CC Switch v3.12.0

Stream Check が復活し、OpenAI Responses API に対応、OpenClaw と WebDAV も大幅強化

中文版 → | English →


概要

CC Switch v3.12.0 は、プロバイダー互換性、OpenClaw の設定編集、共通設定の使い勝手、同期とデータ保守性を強化する機能リリースです。安定性を強化した Model Health Check (Stream Check) UI を復元し、OpenAI Responses API 形式変換を追加、UcloudMicuX-Code APINovitaBailian For Coding などのプリセットを拡張し、WebDAV 同期 に二層バージョニングを導入しました。

リリース日: 2026-03-09

更新規模: 56 commits | 221 files changed | +20,582 / -8,026 lines


ハイライト

  • Stream Check 復活: モデルヘルスチェック UI を復元し、初回確認ダイアログを追加、openai_chat プロバイダー対応も修正
  • OpenAI Responses API: api_format = "openai_responses" を追加し、双方向変換と共有変換ロジックの整理を実施 — プロバイダー追加時に Responses API フォーマットを選択してプロキシテイクオーバーを有効にするだけで、Claude Code で GPT シリーズモデルが使えます!
  • OpenClaw パネル強化: JSON5 round-trip 編集、設定ヘルスバナー、改良された Agent Model 選択、User-Agent トグルを導入
  • プリセット拡張: Ucloud、Micu、X-Code API、Novita、Bailian For Coding を追加・更新し、SiliconFlow partner badge とモデルロールバッジも追加
  • 同期と保守の改善: WebDAV protocol v2 + db-v6、daily rollups、incremental auto-vacuum、sync-aware backup を追加
  • 共通設定の使い勝手向上: 共通設定スニペットを更新すると、プロバイダー切り替え時に自動的に反映されるようになりました。手動でチェックを入れ直す必要はありません

主な機能

モデルヘルスチェック (Stream Check)

Stream Check パネルを復元し、プロバイダーの可用性をリアルタイムで検証できるようにしました。

  • Stream Check UI パネルを復元し、単一またはバッチでのプロバイダー可用性検出をサポート
  • 初回使用確認ダイアログを追加、ヘルスチェック非対応プロバイダーの誤検出によるユーザー混乱を防止
  • openai_chat API フォーマットプロバイダーの検出互換性を修正

OpenAI Responses API

新しい openai_responses API フォーマットを追加し、OpenAI Responses API を使用するプロバイダーのネイティブサポートを提供します。

  • api_format = "openai_responses" プロバイダーフォーマットオプションを追加
  • Anthropic Messages <-> OpenAI Responses API の双方向フォーマット変換をサポート
  • 共有変換ロジックを整理し、重複コードを削減

Bedrock リクエストオプティマイザー

AWS Bedrock プロバイダー向けに PRE-SEND フェーズのリクエスト最適化を追加し、互換性とパフォーマンスを向上させました。

  • PRE-SEND thinking + cache injection オプティマイザー(#1301、@keithyt06 に感謝)

OpenClaw 設定強化

OpenClaw の設定編集体験を全面的にアップグレードし、より豊富な設定管理をサポートします。

  • JSON5 round-trip 書き戻し: 編集時にコメントとフォーマットを保持
  • EnvPanel の JSON 編集モードと tools.profile 選択をサポート
  • 設定検証バナーと設定ヘルスステータスチェックを追加
  • Agent モデルのドロップダウン改善、プロバイダープリセットから推奨モデルを自動入力
  • User-Agent トグル: リクエストに OpenClaw 識別子を付加する機能(デフォルトオフ)
  • Legacy timeout 設定の自動マイグレーション

プロバイダープリセット

新規および既存のプロバイダープリセットを拡張し、より多くのプロバイダーとユースケースをカバーします。

  • Ucloud: endpointCandidates および OpenClaw デフォルト値を追加、templateValues / suggestedDefaults を更新
  • Micu: プリセットデフォルト値および OpenClaw 推奨モデルを追加
  • X-Code API: Claude プリセットおよび endpointCandidates を追加
  • Novita: プロバイダープリセットを追加(#1192、@Alex-wuhu に感謝)
  • Bailian For Coding: プロバイダープリセットを追加(#1263、@suki135246 に感謝)
  • SiliconFlow: partner badge 識別を追加
  • モデルロールバッジ: プロバイダープリセットでモデルロール badge 表示をサポート

WebDAV 同期強化

WebDAV 同期に二層バージョン管理を導入し、同期の信頼性とデータ安全性を向上させました。

  • WebDAV protocol v2 + db-v6 二層バージョン管理を追加
  • WebDAV auto-sync の切り替え時に確認ダイアログを表示し、誤操作を防止
  • sync-aware backup: 同期時にローカル専用テーブルを除外した sync バリアントバックアップを使用

使用量とデータ

使用量統計とデータ保守機能を強化し、より精密なデータ管理を実現、データベースの増加速度を大幅に抑制します。

  • Daily rollups: 日次で使用量データを集計し、ストレージ使用量を削減
  • Auto-vacuum: インクリメンタルなデータベースクリーンアップ、データベースの健全性を維持
  • UsageFooter に追加統計フィールドを追加(#1137、@bugparty に感謝)

その他の新機能

  • セッション削除: プロバイダー単位のクリーンアップとパス安全性検証付きのセッション削除
  • Claude auth field selector 復元: 認証フィールドセレクターを復元
  • Failover トグルをメインページへ移動: failover toggle を設定パネルからメインページに独立表示し、初回確認ダイアログを追加
  • 共通設定の自動抽出: 初回起動時に live config から共通設定スニペットを自動抽出
  • 新規プロバイダーページの改善: 新規プロバイダーページの体験を最適化(#1155、@wugeer に感謝)

アーキテクチャ改善

Common Config ランタイムオーバーレイ

共通設定スニペットCommon Config Snippetをランタイムオーバーレイ方式に変更し、保存済みプロバイダー設定への物理マージを廃止しました。

変更前: Common Config の内容は保存時または切り替え時に各プロバイダーの settings_config に直接マージされていました。これにより共通設定が各プロバイダーエントリーにコピーされ、変更時には一つずつ同期する必要がありました。

変更後: Common Config はプロバイダー切り替え時に live ファイルへ書き込む際のみ runtime overlay として注入され、プロバイダーエントリー自体には共通設定を含みません。つまり Common Config の変更は即座に反映され、各プロバイダーを個別に更新する必要はありません。

Common Config 初回自動抽出

初回起動時にデータベースに Common Config Snippet がまだ存在しない場合、現在の live config から自動抽出します。これにより旧バージョンからアップグレードしたユーザーの既存の共通設定が失われないことを保証します。

定期メンテナンスタイマー統合

daily rollups と auto-vacuum を統一の定期メンテナンスタイマーに統合し、複数の独立タイマーによるリソース競合と複雑さを回避しました。


バグ修正

プロキシとストリーミング

  • OpenAI ChatCompletion -> Anthropic Messages のストリーミング変換問題を修正
  • Codex /responses/compact ルーティングをサポート(#1194、@Tsukumi233 に感謝)
  • TOML 設定マージロジックを改善し、キー値の欠落を回避
  • proxy forwarder の失敗ログを改善し、診断情報を追加

プロバイダーとプリセットの修正

  • X-Code を X-Code API にリネームし、ブランド名称を統一
  • SSSAiCode の /v1 パス問題を修正
  • AICoding URL の誤った www プレフィックスを削除
  • 新規プロバイダーページの改行削除問題を修正(#1155、@wugeer に感謝)

プラットフォーム修正

  • cache hit token の統計欠落を修正(#1244、@a1398394385 に感謝)
  • 最小化後しばらくすると自動終了する問題を修正(#1245、@YewFence に感謝)

i18n 修正

  • 69 個の欠落翻訳キーを補完し、残りのハードコード中国語を除去
  • model test panel の i18n 問題を修正
  • JSON5 slash escaping を正規化し、国際化文字列の解析異常を回避

UI 修正

  • Skills カウント表示の問題を修正(#1295、@fzzv に感謝)
  • endpoint speed test から HTTP ステータスコード表示を削除し、視覚的ノイズを軽減
  • outline button のスタイル問題を修正(#1222、@Sube-py に感謝)

パフォーマンス

  • OpenClaw 設定が未変更の場合に不要な書き込みをスキップし、ディスク I/O を削減

ドキュメント

  • ユーザーマニュアルを i18n 対応で再構成し、EN/JA の内容を拡充
  • OpenClaw の説明を追加し、設定ドキュメントを補完
  • UCloud スポンサー情報を追加
  • docs ディレクトリを再編成し、EN/ZH/JA の README 機能説明を同期

注意事項

  • Common Config はランタイムオーバーレイに変更: 共通設定スニペットは各プロバイダー設定への物理マージではなく、切り替え時に動的にオーバーレイされます。Common Config の変更は即座に反映され、各プロバイダーを個別に更新する必要はありません。
  • Stream Check は初回使用時に確認が必要: 初回使用時にモデルヘルスチェックの確認ダイアログが表示され、確認後に使用可能になります。
  • OpenClaw の User-Agent トグルはデフォルトオフ: OpenClaw 設定で User-Agent 識別子の付加機能を手動で有効にする必要があります。

謝辞

以下のコントリビューターの皆様、このリリースへの貢献に感謝します!

@keithyt06 @bugparty @Alex-wuhu @suki135246 @Tsukumi233 @wugeer @fzzv @Sube-py @a1398394385 @YewFence


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

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

システム要件

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

Windows

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

macOS

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

注意: 作者が Apple Developer アカウントを持っていないため、初回起動時に「開発元を確認できません」という警告が表示される場合があります。一度閉じてから、「システム設定」→「プライバシーとセキュリティ」→「このまま開く」をクリックすると、その後は正常に開けます。

Homebrew (macOS)

brew tap farion1231/ccswitch
brew install --cask cc-switch

更新:

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