Files
CC-Switch/docs/release-notes/v3.12.3-ja.md
T
Jason 9336001746 feat(skills): auto-backup skill files before uninstall
Create a local backup under ~/.cc-switch/skill-backups/ before removing
skill directories. The backup includes all skill files and a meta.json
with original skill metadata. Old backups are pruned to keep at most 20.
The backup path is returned to the frontend and shown in the success
toast. Bump version to 3.12.3.
2026-03-15 23:26:50 +08:00

8.4 KiB

CC Switch v3.12.3

Tool Search ドメイン制限バイパス、プロキシ Gzip 圧縮と o シリーズモデル互換性、Skills インポートの堅牢性向上

中文版 → | English →


概要

CC Switch v3.12.3 は、バイナリパッチによる Tool Search ドメインホワイトリスト制限のバイパス機能を追加し、OpenAI o シリーズモデルのプロキシ互換性と gzip 圧縮を改善し、Skills インポート、プロバイダーフォーム、ターミナルセッション復元の堅牢性を修正しました。Skills インポートフローがファイルシステムベースの暗黙的な推論から明示的なアプリ選択に変更され、複数アプリの誤った有効化バグが解消されました。

リリース日: 2026-03-15

更新規模: 13 commits | 47 files changed | +1,764 / -122 lines


ハイライト

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

  • プロキシ 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 のバージョンアップグレード後も有効
  • 設定が有効な場合、アプリ起動時にパッチを自動的に再適用
  • フロントエンドがパッチ結果を確認し、失敗時に設定を自動ロールバック

変更

プロキシ 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)

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

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

システム要件

システム 最小バージョン アーキテクチャ
Windows Windows 10 以降 x64
macOS macOS 10.15 (Catalina) 以降 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