wehub-resource-sync
239 lines
14 KiB
Markdown
239 lines
14 KiB
Markdown
# CC Switch v3.12.0
|
|
|
|
> Stream Check が復活し、OpenAI Responses API に対応、OpenClaw と WebDAV も大幅強化
|
|
|
|
**[中文版 →](v3.12.0-zh.md) | [English →](v3.12.0-en.md)**
|
|
|
|
---
|
|
|
|
## 概要
|
|
|
|
CC Switch v3.12.0 は、プロバイダー互換性、OpenClaw の設定編集、共通設定の使い勝手、同期とデータ保守性を強化する機能リリースです。安定性を強化した **Model Health Check (Stream Check)** UI を復元し、**OpenAI Responses API** 形式変換を追加、**Ucloud**、**Micu**、**X-Code API**、**Novita**、**Bailian 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](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.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)
|
|
|
|
```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` |
|