cc-switch/docs/release-note-v3.11.1-ja.md

CC Switch v3.11.1

部分キーフィールドマージの撤回、共通設定スニペットの復元とバグ修正

中文版 → | English →

---

概要

CC Switch v3.11.1 は修正リリースです。v3.11.0 で導入された部分キーフィールドマージアーキテクチャを撤回し、実績のある「完全設定上書き + 共通設定スニペット」メカニズムを復元しました。また、複数の UI とプラットフォーム互換性の問題を修正しています。

リリース日: 2026-02-28

更新規模: 8 commits | 52 files changed | +3,948 / -1,411 lines

---

ハイライト

• 完全設定上書き + 共通設定スニペットの復元: 重大なデータ損失問題のため部分キーフィールドマージを撤回、完全設定スナップショット書き込みと共通設定スニペット UI を復元
• プロキシパネルの改善: プロキシトグルをパネル本体に移動し、テイクオーバーオプションの発見性を向上
• テーマとコンパクトモードの修正: 「システムに従う」テーマが正しく自動更新、コンパクトモードの終了が正常に動作
• Windows 互換性: プロトコルハンドラーの副作用を防ぐため、環境チェックとワンクリックインストールを無効化

---

撤回

完全設定上書き + 共通設定スニペットの復元

v3.11.0 で導入された部分キーフィールドマージリファクタリングを撤回しました（revert 992dda5c）。

撤回理由: 部分キーフィールドマージのアプローチには3つの重大な問題がありました：

1. 切り替え時のデータ損失: ホワイトリストにないカスタムフィールドがプロバイダー切り替え時にサイレントに破棄された
2. バックフィルによる永続的な剥離: バックフィル操作がデータベースから非キーフィールドを永続的に削除し、不可逆なデータ損失を引き起こした
3. メンテナンス負担: 「キーフィールド」のホワイトリストは新しい設定キーが追加されるたびに継続的なメンテナンスが必要

復元された内容:

• プロバイダー切り替え時の完全設定スナップショット書き込み（予測可能な完全上書き）
• 共通設定スニペット UI およびバックエンドコマンド
• 6つのフロントエンドファイル（コンポーネント 3つ + hooks 3つ）

移行ガイド:

• v3.11.0 にアップグレードしてプロバイダーのカスタムフィールドが失われた場合は、設定を再インポートするか、欠落したフィールドを手動で追加してください
• 共通設定スニペット機能が再び利用可能です — プロバイダー切り替え時に保持すべき共有設定を定義するために使用してください

---

変更

• プロキシパネルレイアウト: プロキシのオン/オフトグルをアコーディオンヘッダーからパネルのコンテンツエリアに移動し、アプリテイクオーバーオプションの直上に配置。プロキシを有効にした後すぐにテイクオーバー設定が見えるようになり、「プロキシだけ有効にしてテイクオーバーを設定しない」というよくある誤操作を防止
• OpenCode/OpenClaw の手動インポート: 起動時の自動インポートを削除。空の状態ページに「現在の設定をインポート」ボタンを表示し、Claude/Codex/Gemini と同じ動作に統一

---

修正

• 「システムに従う」テーマが自動更新されない: Tauri のネイティブテーマ追跡（set_window_theme(None)）に委譲し、WebView の prefers-color-scheme メディアクエリが OS テーマの変更に同期するように修正
• コンパクトモードを終了できない: toolbarRef の flex-1 を復元し、useAutoCompact の終了条件がコンテンツ幅ではなく利用可能な幅に基づいて正しくトリガーされるように修正
• プロキシテイクオーバー Toast に {{app}} が表示される: プロキシテイクオーバーの有効/無効メッセージの i18next t() 呼び出しに欠落していた app 補間パラメータを追加
• Windows プロトコルハンドラーの副作用: 意図しないプロトコルハンドラー登録を防ぐため、Windows で環境チェックとワンクリックインストールを無効化

---

注意事項

• 共通設定スニペットが復活しました: v3.10.x 以前でこの機能を使用していた場合、同じ方法で動作します。プロバイダー切り替え時に保持すべき共有設定を定義するために使用してください。
• v3.11.0 部分キーフィールドマージユーザーの方へ: v3.11.0 でプロバイダー切り替え後に設定フィールドが欠落していた場合は、設定を再インポートして復元してください。

---

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

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

システム要件

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

Windows

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

macOS

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