mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-04-03 22:49:15 +08:00
48db113b37
- Add special thanks section for contributors @xunyu @deijing @su-fen - Update macOS tip: replace xattr command with System Settings GUI guidance - Reformat markdown tables with aligned columns - Move Linux section after Homebrew section
189 lines
11 KiB
Markdown
189 lines
11 KiB
Markdown
# CC Switch v3.9.0
|
||
|
||
> ローカル API プロキシ、自動フェイルオーバー、Universal Provider、多アプリ対応の強化
|
||
|
||
**[English →](release-note-v3.9.0-en.md) | [中文版 →](release-note-v3.9.0-zh.md)**
|
||
|
||
---
|
||
|
||
## 概要
|
||
|
||
CC Switch v3.9.0 は v3.9 ベータ（`3.9.0-1`、`3.9.0-2`、`3.9.0-3`）の安定版です。
|
||
ローカル API プロキシ（アプリ別テイクオーバー対応）、自動フェイルオーバー、Universal Provider を追加し、Claude Code / Codex / Gemini CLI の安定性と操作性を大きく改善しました。
|
||
|
||
**リリース日**：2026-01-07
|
||
|
||
---
|
||
|
||
## ハイライト
|
||
|
||
- ローカル API プロキシ：Claude Code / Codex / Gemini CLI を統一的にプロキシ
|
||
- 自動フェイルオーバー：サーキットブレーカーとアプリ別のフェイルオーバーキュー
|
||
- Universal Provider：1つの設定を複数アプリへ同期（NewAPI などのゲートウェイ向け）
|
||
- Skills の改善：マルチアプリ対応、SSOT + React Query による管理の統一
|
||
- 共通設定スニペット：エディタ内容または現在のプロバイダから抽出
|
||
- MCP インポート：インストール済みアプリから MCP servers を取り込み
|
||
- 使用量の改善：自動更新、キャッシュ指標、タイムゾーン修正
|
||
- Linux パッケージ：RPM / Flatpak の成果物を追加
|
||
|
||
---
|
||
|
||
## 主要機能
|
||
|
||
### ローカル API プロキシ（Local API Proxy）
|
||
|
||
- ローカルで高性能な HTTP プロキシサーバーを起動（Axum ベース）
|
||
- Claude Code / Codex / Gemini CLI の API リクエストを統一的に扱う
|
||
- アプリ別テイクオーバー：アプリごとにプロキシ経由にするかを個別に切り替え可能
|
||
- Live 設定テイクオーバー：有効化時に CLI の live 設定をバックアップし、ローカルプロキシへリダイレクト
|
||
- 監視：リクエストログと使用量統計でデバッグとコスト把握を支援
|
||
- エラーリクエストのログ：失敗したプロキシリクエストも詳細に記録してデバッグを容易に（#401、@yovinchen に感謝）
|
||
|
||
### 自動フェイルオーバー（Auto Failover / サーキットブレーカー）
|
||
|
||
- 障害を検知して保護（サーキットブレーカー）を自動で発動
|
||
- 現在のプロバイダが不調な場合、バックアッププロバイダへ自動切り替え
|
||
- アプリごとに独立したフェイルオーバーキューとヘルス状態を管理
|
||
- フェイルオーバーを無効化している場合、タイムアウト/リトライ関連の設定は通常フローに影響しません
|
||
|
||
### Skills 管理
|
||
|
||
- Claude Code と Codex の Skills をマルチアプリで利用可能にし、旧レイアウトからの移行もよりスムーズに（#365、#378、@yovinchen に感謝）
|
||
- SSOT + React Query による Skills 管理の統一で、状態の一貫性と更新挙動を改善
|
||
- Discovery の体験と性能を改善：
|
||
- スキャン時に隠しディレクトリをスキップ
|
||
- Discoverable skills に長寿命キャッシュを適用して高速化
|
||
- ローディング表示の改善と、インポート/更新などの操作導線を整理
|
||
- Skills リポジトリのブランチ設定を修正（#505、@kjasn に感謝）
|
||
|
||
### Universal Provider
|
||
|
||
- 複数アプリで共有できるプロバイダ設定を追加（Claude/Codex/Gemini へ同期）（#348、@Calcium-Ion に感謝）
|
||
- NewAPI のような複数プロトコル対応の API ゲートウェイを想定
|
||
- 1つのプロバイダ内でアプリ別にデフォルトモデルを割り当て可能
|
||
|
||
### 共通設定スニペット（Claude/Codex/Gemini）
|
||
|
||
- 「共通設定スニペット」を保持し、有効化したプロバイダへマージ/追記
|
||
- 新しい抽出フロー：
|
||
- エディタの現在内容から抽出（編集している内容）
|
||
- エディタ内容がない場合は、現在アクティブなプロバイダから抽出
|
||
- Codex の抽出はより安全：
|
||
- `model_provider`、`model`、および `model_providers` テーブル全体など、プロバイダ固有の設定を除去
|
||
- `[mcp_servers.*]` 配下の `base_url` は保持し、MCP 設定を壊しにくくしています
|
||
|
||
### MCP 管理
|
||
|
||
- インストール済みアプリから MCP servers をインポート
|
||
- 安定性向上：対象 CLI が未インストールなら同期をスキップし、無効な Codex `config.toml` も適切に扱います（#461、@majiayu000 に感謝）
|
||
- Windows 互換性：MCP エクスポート時の npx/npm 呼び出しを `cmd /c` でラップ
|
||
|
||
### 使用量と価格データ
|
||
|
||
- 使用量/価格の改善：自動更新、キャッシュ指標、タイムゾーン修正、内蔵価格テーブル更新（#508、@yovinchen に感謝）
|
||
- DeepLink 対応：deeplink から使用量クエリ設定をインポート（#400、@qyinter に感謝）
|
||
- 使用量統計からモデル情報を抽出（#455、@yovinchen に感謝）
|
||
- 使用量クエリ資格情報はプロバイダ設定へフォールバック可能（#360、@Sirhexs に感謝）
|
||
|
||
---
|
||
|
||
## 使い勝手の改善
|
||
|
||
- プロバイダ検索フィルター（名前で素早く検索）（#435、@TinsFox に感謝）
|
||
- プロバイダのアイコン色：アイコンに任意の色を設定して見分けやすく（#385、@yovinchen に感謝）
|
||
- ショートカット：`Cmd/Ctrl + ,` で設定を開く（#436、@TinsFox に感謝）
|
||
- Claude Code の初回確認ダイアログをスキップ可能（任意）
|
||
- トースト通知のクローズボタン：切り替え通知と成功通知を閉じられるように（#350、@ForteScarlet に感謝）
|
||
- 更新バッジをクリックすると About タブへ移動
|
||
- 設定ページのタブスタイル改善（#342、@wenyuanw に感謝）
|
||
- アプリ/ビュー切り替えのフェードとパネル終了アニメーション
|
||
- プロキシテイクオーバー中はエメラルド系テーマを適用して状態を分かりやすく
|
||
- ダークモードの視認性改善
|
||
- FullScreenPanel のウィンドウドラッグ領域を改善（#525、@zerob13 に感謝）
|
||
|
||
---
|
||
|
||
## プラットフォーム別メモ
|
||
|
||
### Windows
|
||
|
||
- バージョンチェック時にターミナルが表示されないよう改善
|
||
- ウィンドウ最小サイズのデフォルトを調整
|
||
- 起動時の黒画面を避けるため、システムタイトルバー方式を採用
|
||
- 古い WebView 向けに `crypto.randomUUID()` のフォールバックを追加
|
||
|
||
### macOS
|
||
|
||
- 自動起動で `.app` バンドルパスを使用し、ターミナル表示を回避（#462、@majiayu000 に感謝）
|
||
- トレイとヘッダー周りの体験を改善
|
||
|
||
---
|
||
|
||
## パッケージ
|
||
|
||
- Linux：RPM と Flatpak のパッケージングを追加し、リリース成果物の生成に対応
|
||
|
||
---
|
||
|
||
## 注意事項
|
||
|
||
- セキュリティ強化：JavaScript 実行器と使用量スクリプト実行に関するセキュリティ問題を修正（#151、@luojiyin1987 に感謝）。
|
||
- SQL インポートは CC Switch がエクスポートしたバックアップのみに制限されます（安全性のため）。
|
||
- プロキシのテイクオーバーは CLI の live 設定を変更します。CC Switch はリダイレクト前に live 設定をバックアップします。元に戻す場合はテイクオーバー無効化/プロキシ停止を行い、必要に応じてバックアップから復元してください。
|
||
|
||
## 特別な謝辞
|
||
|
||
@xunyu @deijing @su-fen の皆様のサポートと貢献に特別な感謝を申し上げます。皆様なしではこのリリースは実現しませんでした！
|
||
|
||
## ダウンロード & インストール
|
||
|
||
[Releases](https://github.com/farion1231/cc-switch/releases/latest) から該当するバージョンをダウンロードしてください。
|
||
|
||
### システム要件
|
||
|
||
| システム | 最低バージョン | アーキテクチャ |
|
||
| -------- | ----------------------------- | ----------------------------------- |
|
||
| Windows | Windows 10 以降 | x64 |
|
||
| macOS | macOS 10.15 (Catalina) 以降 | Intel (x64) / Apple Silicon (arm64) |
|
||
| Linux | 下表参照 | x64 |
|
||
|
||
### Windows
|
||
|
||
| ファイル | 説明 |
|
||
| --------------------------------------- | -------------------------------------------- |
|
||
| `CC-Switch-v3.9.0-Windows.msi` | **推奨** - MSI インストーラー、自動更新対応 |
|
||
| `CC-Switch-v3.9.0-Windows-Portable.zip` | ポータブル版、インストール不要 |
|
||
|
||
### macOS
|
||
|
||
| ファイル | 説明 |
|
||
| ------------------------------- | ----------------------------------------------------------------- |
|
||
| `CC-Switch-v3.9.0-macOS.zip` | **推奨** - 解凍して Applications へドラッグ、Universal Binary |
|
||
| `CC-Switch-v3.9.0-macOS.tar.gz` | Homebrew インストールおよび自動更新用 |
|
||
|
||
> **注意**: 作者が 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 | `.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` |
|
||
| サンドボックスで実行したい場合 | `.flatpak` | `flatpak install CC-Switch-*.flatpak` |
|