Files
cc-switch/docs/release-notes/v3.12.3-ja.md
Jason 36bbdc36f5 chore(release): update release notes, changelog and macOS minimum version for v3.12.3
Update CHANGELOG.md with full v3.12.3 entry, create release notes in
three languages (en/zh/ja), bump macOS minimumSystemVersion from 10.15
to 12.0 (Monterey) to match actual runtime requirements, and update
README version badges and links.
2026-03-16 08:32:05 +08:00

10 KiB
Raw Blame History

CC Switch v3.12.3

Tool Search ドメイン制限バイパス、Skill バックアップ/リストアライフサイクル、プロキシ Gzip 圧縮と o シリーズモデル互換性

中文版 → | English →


概要

CC Switch v3.12.3 は、バイナリパッチによる Tool Search ドメインホワイトリスト制限のバイパス機能を追加し、完全な Skill バックアップ/リストアライフサイクルを導入し、OpenAI o シリーズモデルのプロキシ互換性と gzip 圧縮を改善し、Skills インポート、プロバイダーフォーム、ターミナルセッション復元の堅牢性を修正しました。Skill はアンインストール前に自動バックアップされ、リストアと削除の管理機能が追加されました。インポートフローはファイルシステムベースの暗黙的な推論から明示的なアプリ選択に変更されました。

リリース日: 2026-03-16

更新規模: 17 commits | 61 files changed | +3,335 / -194 lines


ハイライト

  • Tool Search ドメインバイパス: 等長バイナリパッチで Claude CLI Tool Search のドメインホワイトリストチェックを削除する新設定。起動時に自動バックアップと再適用

  • Skill バックアップ/リストアライフサイクル: アンインストール前に Skill ファイルを自動バックアップ。バックアップリスト、リストア、削除の管理機能を追加

  • プロキシ Gzip 圧縮: 非ストリーミングプロキシリクエストが gzip 圧縮を自動ネゴシエーションし、帯域幅消費を削減

  • o シリーズモデル互換性: Chat Completions プロキシが o1/o3/o4-mini モデルに max_completion_tokens を正しく使用。Responses API は正しい max_output_tokens フィールドを維持

  • Skills インポートの刷新: ファイルシステムベースの暗黙的なアプリ推論を明示的な ImportSkillSelection に置き換え、複数アプリの誤った有効化を防止

  • Ghostty ターミナルサポート: Ghostty ターミナルでの Claude セッション復元を修正


新機能

Tool Search ドメイン制限バイパス

Claude CLI Tool Search のドメインホワイトリスト制限をバイパスする設定を追加しました。

  • PATH からアクティブな claude コマンドを解決し、等長バイトパッチを適用してドメインホワイトリストチェックを削除
  • バックアップは ~/.cc-switch/toolsearch-backups/(パスの SHA-256に保存され、Claude Code のバージョンアップグレード後も有効
  • 設定が有効な場合、アプリ起動時にパッチを自動的に再適用
  • フロントエンドがパッチ結果を確認し、失敗時に設定を自動ロールバック

Skill アンインストール時の自動バックアップ

アンインストール前に Skill ファイルを自動バックアップし、意図しないデータ損失を防止します。

  • バックアップは ~/.cc-switch/skill-backups/ に保存され、すべての skill ファイルと元のメタデータを含む meta.json が含まれます
  • 古いバックアップは自動的にプルーニングされ、最大 20 個を保持
  • バックアップパスはフロントエンドに返され、成功トーストに表示

Skill バックアップのリストアと削除

アンインストール時に作成された Skill バックアップの管理コマンドを追加しました。

  • すべての利用可能な skill バックアップをメタデータ付きで一覧表示
  • リストアはファイルを SSOT にコピーし、DB レコードを保存し、現在のアプリに同期。失敗時は自動ロールバック
  • 削除は確認ダイアログの後にバックアップディレクトリを削除
  • ConfirmDialog にネストされたダイアログスタッキングをサポートする設定可能な zIndex プロパティを追加

変更

プロキシ Gzip 圧縮

非ストリーミングプロキシリクエストが gzip 圧縮をサポートし、帯域幅消費を削減しました。

  • 非ストリーミングリクエストは reqwest が gzip を自動ネゴシエーションし、レスポンスを透過的に解凍
  • ストリーミングリクエストは中断された SSE ストリームの解凍エラーを避けるため、保守的に Accept-Encoding: identity を維持

o1/o3 モデル互換性

プロキシ転送が OpenAI o シリーズモデルのトークンパラメータを正しく処理するようになりました。

  • Chat Completions パスが o1/o3/o4-mini モデルに max_tokens の代わりに max_completion_tokens を使用 (#1451)
  • Responses API パスが正しい max_output_tokens フィールドを維持し、max_completion_tokens の誤った注入を防止

OpenCode モデルバリアント

  • OpenCode のモデルバリアントを options 内部ではなくプリセットのトップレベルに配置し、発見しやすさを向上 (#1317)

Skills インポートフロー

Skills インポートフローが正確性とクリーンアップのためにリワークされました。

  • ファイルシステムベースの暗黙的なアプリ推論を明示的な ImportSkillSelection に置き換え、同じ skill ディレクトリが複数アプリパスに存在する場合の複数アプリ誤有効化を防止
  • sync_to_app に調整ロジックを追加し、無効化/孤立したシンボリックリンクを削除
  • MCP sync_all_enabled がライブ設定から無効化されたサーバーを削除するように改善
  • スキーママイグレーションがレガシーアプリマッピングのスナップショットを保持し、損失のある再構築を回避

バグ修正

プロバイダーフォームの二重送信

  • プロバイダー追加/編集フォームでの高速連続クリックによる重複送信を防止 (#1352)

Ghostty ターミナルセッション復元

  • Ghostty ターミナルでの Claude セッション復元の失敗を修正 (#1506、@canyonsehun に感謝)

Skill ZIP インポート拡張子

  • ZIP インポートダイアログが .skill ファイル拡張子をサポートするように修正 (#1240, #1455)

Skill ZIP インストール対象アプリ

  • ZIP 方式でインストールされた skill が常に Claude をデフォルトにするのではなく、現在アクティブなアプリを使用するように修正

OpenClaw アクティブカードのハイライト

  • OpenClaw の現在アクティブなプロバイダーカードがハイライト表示されない問題を修正 (#1419)

TOC 付きレスポンシブレイアウト

  • TOC タイトルが存在する場合のレスポンシブデザインを改善 (#1491)

Skills インポートダイアログの白い画面

  • ImportSkillsDialog に不足していた TooltipProvider を追加し、ダイアログを開く際のランタイムクラッシュを防止

パネル下部の空白エリア

  • すべてのコンテンツパネルのハードコードされた h-[calc(100vh-8rem)]flex-1 min-h-0 に置き換え、異なるプラットフォーム間のオフセット値の不一致による下部のギャップを解消

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

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

システム要件

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

Windows

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

macOS

ファイル 説明
CC-Switch-v3.12.3-macOS.zip 推奨 - 解凍して Applications にドラッグ、Universal Binary
CC-Switch-v3.12.3-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