From df01755328ddeb0328f5fd323cdaab38a8e03827 Mon Sep 17 00:00:00 2001 From: Jason Date: Fri, 10 Apr 2026 23:44:06 +0800 Subject: [PATCH] docs(release-notes): sync user edits across en/zh/ja and add PR credits MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Simplify "ChatGPT Plus / Pro" → "ChatGPT" across all three languages - Clarify Codex OAuth description to highlight Claude Code usage - Add "requires manual activation" note for Token Plan and third-party balances - Add Copilot API consumption caveat to the interaction optimizer section - Update overview with skills.sh search, usage tracking, and onboarding mentions - Add PR credits for TheRouter (@cmzz), Kaku/OMO Slim/Thinking fallback/auth tab (@yovinchen) --- docs/release-notes/v3.13.0-en.md | 35 +++++++++--------- docs/release-notes/v3.13.0-ja.md | 35 +++++++++--------- docs/release-notes/v3.13.0-zh.md | 61 ++++++++++++++++---------------- 3 files changed, 64 insertions(+), 67 deletions(-) diff --git a/docs/release-notes/v3.13.0-en.md b/docs/release-notes/v3.13.0-en.md index f63f8c732..2dded22b3 100644 --- a/docs/release-notes/v3.13.0-en.md +++ b/docs/release-notes/v3.13.0-en.md @@ -8,7 +8,7 @@ ## Overview -CC Switch v3.13.0 is a major feature release centered on observability, provider workflow ergonomics, and proxy compatibility. It adds inline **quota and balance displays** across official Claude / Codex / Gemini providers plus Token Plan, Copilot, and third-party balance APIs; introduces a **Lightweight Mode** that keeps CC Switch running from the system tray without a main window; delivers **automatic model discovery** via OpenAI-compatible `/v1/models` across all five supported applications; ships a **Codex OAuth reverse proxy** for ChatGPT Plus / Pro subscribers; reorganizes the tray menu into **per-app submenus**; rebuilds the proxy forwarding stack on a **Hyper-based client**; and overhauls the **Skills workflow** with discovery, batch updates, and storage-location toggling. Additional improvements include full URL endpoint mode, session-log usage tracking without proxy interception, the Copilot interaction optimizer, a UTF-8 streaming chunk boundary fix for multi-byte output, and a Linux startup UI responsiveness fix. +CC Switch v3.13.0 is a major feature release centered on observability, provider workflow ergonomics, and proxy compatibility. It adds inline **quota and balance displays** across official Claude / Codex / Gemini providers plus Token Plan, Copilot, and third-party balance APIs; introduces a **Lightweight Mode** that keeps CC Switch running from the system tray without a main window; delivers **automatic model discovery** via OpenAI-compatible `/v1/models` across all five supported applications; ships a **Codex OAuth reverse proxy** for ChatGPT subscribers; reorganizes the tray menu into **per-app submenus**; rebuilds the proxy forwarding stack on a **Hyper-based client**; and overhauls the **Skills workflow** with discovery, batch updates, storage-location toggling, and built-in skills.sh search and install. Additional improvements include full URL endpoint mode, enhanced token usage tracking, the Copilot interaction optimizer, a UTF-8 streaming chunk boundary fix for multi-byte output, a Linux startup UI responsiveness fix, and a friendlier new-user onboarding experience. **Release Date**: 2026-04-10 @@ -21,9 +21,9 @@ CC Switch v3.13.0 is a major feature release centered on observability, provider - **Lightweight Mode**: Tray-only operating mode that destroys the main window on exit to tray and recreates it on demand, reducing CC Switch's desktop footprint to near zero when idle - **Quota & Balance Visibility**: Inline quota or balance readout across provider cards — official Claude / Codex / Gemini subscriptions, GitHub Copilot premium interactions, Codex OAuth, Token Plan providers (Kimi / Zhipu GLM / MiniMax), plus official balance queries for DeepSeek, StepFun, SiliconFlow, OpenRouter, and Novita AI - **Provider Model Auto-Fetch**: OpenAI-compatible `/v1/models` discovery across Claude, Codex, Gemini, OpenCode, and OpenClaw provider forms, with grouped dropdown selection and failure-specific error messages -- **Codex OAuth Reverse Proxy**: ChatGPT Plus / Pro Codex reverse proxy exposed as a new Claude provider card with managed OAuth login and inline subscription quota display ([⚠️ Risk Notice](#️-risk-notice)) +- **Codex OAuth Reverse Proxy**: ChatGPT Codex reverse proxy exposed as a new Claude provider card type, allowing users to use their ChatGPT subscription in Claude Code. Includes managed OAuth login and inline subscription quota display ([⚠️ Risk Notice](#️-risk-notice)) - **Tray Per-App Submenus**: Reworked the tray menu into per-application submenus so it never overflows the screen and background provider switching scales to dozens of providers per app -- **Skills Discovery & Batch Updates**: SHA-256-based skill update detection, per-skill and "Update All" batch actions, public `skills.sh` search integration, and a storage-location toggle between CC Switch storage and `~/.agents/skills` +- **Skills Discovery & Batch Updates**: SHA-256-based skill update detection, per-skill and "Update All" batch actions, `skills.sh` search integration, and a storage-location toggle between CC Switch storage and `~/.agents/skills` - **Session Workflow Upgrades**: Batch session deletion, a directory picker before launching Claude terminal restore, usage import from Claude / Codex / Gemini session logs without proxy interception, precise Codex JSONL parsing, and per-app usage filtering - **OpenCode / OpenClaw Stream Check Coverage**: OpenCode detection via npm package mapping, OpenClaw `openai-completions` support, and the remaining OpenClaw protocol variants — with custom-header passthrough and auth-header detection fixes - **Full URL Endpoint Mode**: Provider option that treats `base_url` as a complete upstream endpoint, unblocking vendors that require nonstandard URL layouts @@ -54,11 +54,10 @@ Added inline quota and balance readouts to provider cards so users can see remai - **Official subscriptions**: Inline quota display for Claude, Codex, and Gemini official providers - **GitHub Copilot**: Premium interactions quota display on the Copilot provider card -- **Codex OAuth**: ChatGPT Plus / Pro subscription quota inline with the Codex OAuth provider card -- **Token Plan providers**: Kimi, Zhipu GLM, and MiniMax with corrected quota math and consistent 0% → 100% usage progression -- **Third-party balances**: Official balance queries for DeepSeek, StepFun, SiliconFlow, OpenRouter, and Novita AI +- **Codex OAuth**: ChatGPT subscription quota inline with the Codex OAuth provider card +- **Token Plan providers**: Kimi, Zhipu GLM, and MiniMax usage progression display (requires manual activation to avoid confusion) +- **Third-party balances**: Official balance queries for DeepSeek, StepFun, SiliconFlow, OpenRouter, and Novita AI (requires manual activation to avoid confusion) - Health-check and usage-config buttons are hidden for official providers to keep the card clean -- Copilot / ChatGPT OAuth and CLI subscription quota now only auto-poll for the currently active provider, preventing unnecessary API calls on non-current cards ### Provider Model Auto-Fetch @@ -71,13 +70,12 @@ Added OpenAI-compatible model discovery to every provider form, removing the man ### Codex OAuth Reverse Proxy -Added a reverse proxy path for ChatGPT Plus / Pro subscribers who want to route their Codex OAuth session through CC Switch. +Added a reverse proxy path for ChatGPT subscribers who want to use their ChatGPT subscription in Claude Code. -- Managed OAuth login flow with ChatGPT Plus / Pro authentication +- Managed OAuth login flow with ChatGPT authentication - Surfaces as a new Claude provider card type alongside API-key providers - Inline subscription quota display -- Integrated into the Auth Center with tightened copy, layout, and icon presentation -- Bumped the Codex OAuth preset to the GPT-5.4 model family +- Integrated into the Auth Center for unified token management - See the [⚠️ Risk Notice](#️-risk-notice) below before enabling ### Tray Per-App Submenus @@ -136,6 +134,7 @@ Added request classification and routing logic that reduces unnecessary GitHub C - Classifies incoming requests by intent and weight - Routes low-value requests away from premium interaction consumption paths - Designed to extend the usable lifetime of a Copilot subscription +- Note: Even with optimized consumption, using the Copilot API outside of Copilot still consumes more than using it within Copilot. ### First-Run Welcome Dialog @@ -169,15 +168,15 @@ Added a one-time welcome dialog on fresh installs to guide new users through the ### Kaku Terminal Support -- Added Kaku as a selectable terminal for session launch on macOS, reusing the WezTerm-compatible launch path +- Added Kaku as a selectable terminal for session launch on macOS, reusing the WezTerm-compatible launch path (#1983, thanks @yovinchen) ### OMO Slim Council Support -- Restored first-class council support as a built-in oh-my-opencode-slim agent with updated metadata and UI copy +- Restored first-class council support as a built-in oh-my-opencode-slim agent with updated metadata and UI copy (#1982, thanks @yovinchen) ### New Provider Presets -- **TheRouter**: Added across Claude, Codex, Gemini, OpenCode, and OpenClaw +- **TheRouter**: Added across Claude, Codex, Gemini, OpenCode, and OpenClaw (#1891, #1892, thanks @cmzz) - **DDSHub**: Added as a third-party partner provider for Claude with icon and partner promotion text - **LionCCAPI**: Added across all five apps with anthropic-messages protocol for OpenCode and OpenClaw - **Shengsuanyun (胜算云)**: Added as an aggregator partner provider across all five apps with URL-based icon and localized display name @@ -330,11 +329,11 @@ Fixed a long-standing Linux bug where the window UI (including native title bar ### Thinking Model Fallback Display -- Fixed the Claude provider form showing an empty Thinking model field after saving only a main model by applying read-only fallback to ANTHROPIC_MODEL +- Fixed the Claude provider form showing an empty Thinking model field after saving only a main model by applying read-only fallback to ANTHROPIC_MODEL (#1984, thanks @yovinchen) ### Auth Tab Localization -- Fixed missing i18n translation keys for the settings auth tab label across all locale bundles +- Fixed missing i18n translation keys for the settings auth tab label across all locale bundles (#1985, thanks @yovinchen) ### Schema Migration Guard @@ -369,10 +368,10 @@ Fixed a long-standing Linux bug where the window UI (including native title bar **Codex OAuth Reverse Proxy Disclaimer** -The Codex OAuth reverse proxy introduced in this release accesses ChatGPT Plus / Pro Codex services through reverse-engineered OAuth flows. Please be aware of the following risks before enabling this feature: +The Codex OAuth reverse proxy introduced in this release accesses ChatGPT Codex services through reverse-engineered OAuth flows. Please be aware of the following risks before enabling this feature: 1. **Terms of Service**: Using reverse-engineered OAuth flows to access OpenAI services may violate OpenAI's terms of service, which prohibit unauthorized automated access, service reproduction, and circumventing intended access paths. -2. **Account Risk**: OpenAI may flag unusual usage patterns as suspicious automated activity, potentially resulting in temporary or permanent restrictions on ChatGPT Plus / Pro access. +2. **Account Risk**: OpenAI may flag unusual usage patterns as suspicious automated activity, potentially resulting in temporary or permanent restrictions on ChatGPT access. 3. **No Guarantee**: OpenAI may update its authentication and detection mechanisms at any time, and usage patterns that work today may be flagged in the future. The **GitHub Copilot reverse proxy** introduced in v3.12.3 also remains subject to its existing risk notice — see the [v3.12.3 release notes](v3.12.3-en.md#️-risk-notice) for the full disclosure. diff --git a/docs/release-notes/v3.13.0-ja.md b/docs/release-notes/v3.13.0-ja.md index 5c48d7f34..a3550039b 100644 --- a/docs/release-notes/v3.13.0-ja.md +++ b/docs/release-notes/v3.13.0-ja.md @@ -8,7 +8,7 @@ ## 概要 -CC Switch v3.13.0 は、可観測性、プロバイダーワークフローの使いやすさ、プロキシ互換性を中心とした大型機能リリースです。Claude / Codex / Gemini の公式プロバイダー、Token Plan、Copilot、サードパーティ残高 API にわたる**クォータと残高のインライン表示**を追加し、メインウィンドウなしでシステムトレイから CC Switch を動作させる**軽量モード**を導入しました。OpenAI 互換の `/v1/models` による**自動モデル発見**を 5 つのサポート対象アプリケーションすべてに提供し、ChatGPT Plus / Pro サブスクライバー向けの **Codex OAuth リバースプロキシ**を同梱しています。トレイメニューを**アプリ別サブメニュー**に再編成し、プロキシ転送スタックを **Hyper ベースのクライアント**に再構築し、**Skills ワークフロー**を発見、バッチ更新、ストレージ位置切り替えで刷新しました。さらに、フル URL エンドポイントモード、プロキシ傍受なしのセッションログ用量追跡、Copilot インタラクション最適化、マルチバイト UTF-8 ストリームチャンク境界修正、Linux 起動時の UI 応答性修正なども含まれます。 +CC Switch v3.13.0 は、可観測性、プロバイダーワークフローの使いやすさ、プロキシ互換性を中心とした大型機能リリースです。Claude / Codex / Gemini の公式プロバイダー、Token Plan、Copilot、サードパーティ残高 API にわたる**クォータと残高のインライン表示**を追加し、メインウィンドウなしでシステムトレイから CC Switch を動作させる**軽量モード**を導入しました。OpenAI 互換の `/v1/models` による**自動モデル発見**を 5 つのサポート対象アプリケーションすべてに提供し、ChatGPT サブスクライバー向けの **Codex OAuth リバースプロキシ**を同梱しています。トレイメニューを**アプリ別サブメニュー**に再編成し、プロキシ転送スタックを **Hyper ベースのクライアント**に再構築し、**Skills ワークフロー**を発見、バッチ更新、ストレージ位置切り替え、および組み込みの skills.sh 検索・インストールで刷新しました。さらに、フル URL エンドポイントモード、強化されたトークン用量追跡、Copilot インタラクション最適化、マルチバイト UTF-8 ストリームチャンク境界修正、Linux 起動時の UI 応答性修正、およびよりフレンドリーな新規ユーザーオンボーディングなども含まれます。 **リリース日**: 2026-04-10 @@ -21,9 +21,9 @@ CC Switch v3.13.0 は、可観測性、プロバイダーワークフローの - **軽量モード**: トレイ専用の動作モード。トレイへの終了時にメインウィンドウを破棄し、必要時に再作成することで、アイドル時の CC Switch のデスクトップフットプリントを最小化 - **クォータと残高の可視化**: プロバイダーカードでのインラインクォータ/残高表示 — Claude / Codex / Gemini 公式サブスクリプション、GitHub Copilot premium interactions、Codex OAuth、Token Plan プロバイダー（Kimi / Zhipu GLM / MiniMax）、および DeepSeek / StepFun / SiliconFlow / OpenRouter / Novita AI の公式残高クエリをカバー - **プロバイダーモデル自動取得**: Claude / Codex / Gemini / OpenCode / OpenClaw のプロバイダーフォームに OpenAI 互換の `/v1/models` 発見機能を追加。グループ化ドロップダウンと失敗時の具体的なエラーメッセージ付き -- **Codex OAuth リバースプロキシ**: ChatGPT Plus / Pro の Codex リバースプロキシを新しい Claude プロバイダーカードタイプとして追加。マネージド OAuth ログインとサブスクリプションクォータのインライン表示を提供（[⚠️ リスクに関する注意事項](#️-リスクに関する注意事項)） +- **Codex OAuth リバースプロキシ**: ChatGPT の Codex リバースプロキシを新しい Claude プロバイダーカードタイプとして追加。ユーザーは ChatGPT サブスクリプションを Claude Code で利用可能に。マネージド OAuth ログインとサブスクリプションクォータのインライン表示を提供（[⚠️ リスクに関する注意事項](#️-リスクに関する注意事項)） - **トレイのアプリ別サブメニュー**: トレイメニューをアプリ別サブメニューに再編成し、プロバイダー数が多くてもメニューがオーバーフローせず、バックグラウンドのプロバイダー切り替えが長いリストでもスケール -- **Skills 発見とバッチ更新**: SHA-256 ベースの skill 更新検出、各 skill および「すべて更新」のバッチ更新、公開 `skills.sh` 検索統合、CC Switch ストレージと `~/.agents/skills` の間のストレージ位置切り替え +- **Skills 発見とバッチ更新**: SHA-256 ベースの skill 更新検出、各 skill および「すべて更新」のバッチ更新、`skills.sh` 検索統合、CC Switch ストレージと `~/.agents/skills` の間のストレージ位置切り替え - **セッションワークフローの改善**: Session Manager でのバッチ削除、Claude ターミナル復元前のディレクトリピッカー、プロキシ傍受なしでの Claude / Codex / Gemini セッションログからの用量インポート、正確な Codex JSONL 解析、アプリ別の用量フィルタリング - **OpenCode / OpenClaw Stream Check カバレッジ**: OpenCode の npm パッケージマッピング検出、OpenClaw `openai-completions` サポート、および残りの OpenClaw プロトコルバリアント - **フル URL エンドポイントモード**: `base_url` を完全な上流エンドポイントとして扱うプロバイダーオプションを追加し、非標準 URL レイアウトを要求するベンダーに対応 @@ -54,11 +54,10 @@ CC Switch のアイドル時のデスクトップフットプリントを大幅 - **公式サブスクリプション**: Claude / Codex / Gemini 公式プロバイダーのサブスクリプションクォータ表示 - **GitHub Copilot**: Copilot プロバイダーカードに premium interactions 残量を表示 -- **Codex OAuth**: Codex OAuth カードに ChatGPT Plus / Pro サブスクリプションクォータをインライン表示 -- **Token Plan プロバイダー**: Kimi、Zhipu GLM、MiniMax。クォータ計算と 0% → 100% 使用量進行を修正 -- **サードパーティ残高**: DeepSeek、StepFun、SiliconFlow、OpenRouter、Novita AI に公式残高クエリを追加 +- **Codex OAuth**: Codex OAuth カードに ChatGPT サブスクリプションクォータをインライン表示 +- **Token Plan プロバイダー**: Kimi、Zhipu GLM、MiniMax の使用量進行表示（混乱を避けるため手動で有効化が必要） +- **サードパーティ残高**: DeepSeek、StepFun、SiliconFlow、OpenRouter、Novita AI に公式残高クエリを追加（混乱を避けるため手動で有効化が必要） - 公式プロバイダーではヘルスチェックと用量設定ボタンを非表示にし、カードをクリーンに保つ -- Copilot / ChatGPT OAuth と CLI サブスクリプションクォータは現在アクティブなプロバイダーのみ自動ポーリングされ、非アクティブカードでの不要な API コールを防止 ### プロバイダーモデル自動取得 @@ -71,13 +70,12 @@ CC Switch のアイドル時のデスクトップフットプリントを大幅 ### Codex OAuth リバースプロキシ -ChatGPT Plus / Pro のサブスクライバーが Codex OAuth セッションを CC Switch 経由で利用できるリバースプロキシパスを追加。 +ChatGPT サブスクライバーが ChatGPT サブスクリプションを Claude Code で利用できるリバースプロキシパスを追加。 -- ChatGPT Plus / Pro 認証を使ったマネージド OAuth ログインフロー +- ChatGPT 認証を使ったマネージド OAuth ログインフロー - API キー型プロバイダーと並ぶ新しい Claude プロバイダーカードタイプとして表示 - サブスクリプションクォータのインライン表示 -- Auth Center との緊密な統合と、コピー・レイアウト・アイコンの調整 -- Codex OAuth プリセットを GPT-5.4 モデルファミリーに更新 +- Auth Center との統合によるトークンの一元管理 - 有効化前に下記の [⚠️ リスクに関する注意事項](#️-リスクに関する注意事項) をご確認ください ### トレイのアプリ別サブメニュー @@ -136,6 +134,7 @@ GitHub Copilot premium interaction の不要な消費を削減するリクエス - 受信リクエストを意図と重要度で分類 - 価値の低いリクエストを premium interaction 消費パスから迂回 - Copilot サブスクリプションの使用可能期間を延長することを目的 +- 注意: 消費を最適化しても、Copilot 外で Copilot API を使用する場合、Copilot 内で使用するよりも消費量は多くなります。 ### 初回起動ウェルカムダイアログ @@ -169,15 +168,15 @@ GitHub Copilot premium interaction の不要な消費を削減するリクエス ### Kaku ターミナルサポート -- macOS でセッション起動用の選択可能なターミナルとして Kaku を追加。WezTerm 互換の起動パスを再利用 +- macOS でセッション起動用の選択可能なターミナルとして Kaku を追加。WezTerm 互換の起動パスを再利用 (#1983, @yovinchen に感謝) ### OMO Slim Council サポート -- 内蔵 oh-my-opencode-slim エージェントとしての council のファーストクラスサポートを復元。メタデータと UI コピーを更新 +- 内蔵 oh-my-opencode-slim エージェントとしての council のファーストクラスサポートを復元。メタデータと UI コピーを更新 (#1982, @yovinchen に感謝) ### 新プロバイダープリセット -- **TheRouter**: Claude / Codex / Gemini / OpenCode / OpenClaw の 5 アプリに追加 +- **TheRouter**: Claude / Codex / Gemini / OpenCode / OpenClaw の 5 アプリに追加 (#1891, #1892, @cmzz に感謝) - **DDSHub**: Claude のサードパーティパートナープロバイダーとして追加。アイコンとパートナープロモーションテキスト付き - **LionCCAPI**: 5 アプリすべてに追加。OpenCode / OpenClaw は anthropic-messages プロトコルを使用 - **Shengsuanyun（胜算云）**: アグリゲーターパートナープロバイダーとして 5 アプリすべてに追加。URL ベースのアイコンとローカライズ名をサポート @@ -330,11 +329,11 @@ Claude Code で Copilot リバースプロキシ経由時、中国語文字や ### Thinking モデルフォールバック表示 -- Claude プロバイダーフォームでメインモデルのみ保存後に Thinking モデルフィールドが空で表示される問題を修正。ANTHROPIC_MODEL への読み取り専用フォールバックを適用 +- Claude プロバイダーフォームでメインモデルのみ保存後に Thinking モデルフィールドが空で表示される問題を修正。ANTHROPIC_MODEL への読み取り専用フォールバックを適用 (#1984, @yovinchen に感謝) ### Auth タブのローカライゼーション -- 設定の auth タブラベルに不足していた i18n 翻訳キーをすべてのロケールバンドルで修正 +- 設定の auth タブラベルに不足していた i18n 翻訳キーをすべてのロケールバンドルで修正 (#1985, @yovinchen に感謝) ### スキーマ移行ガード @@ -369,10 +368,10 @@ Claude Code で Copilot リバースプロキシ経由時、中国語文字や **Codex OAuth リバースプロキシに関する免責事項** -本リリースで追加された Codex OAuth リバースプロキシ機能は、リバースエンジニアリングによる OAuth フローを通じて ChatGPT Plus / Pro の Codex サービスにアクセスします。この機能を有効にする前に、以下のリスクをご確認ください： +本リリースで追加された Codex OAuth リバースプロキシ機能は、リバースエンジニアリングによる OAuth フローを通じて ChatGPT の Codex サービスにアクセスします。この機能を有効にする前に、以下のリスクをご確認ください： 1. **利用規約違反の可能性**: リバースエンジニアリングされた OAuth フローを使用して OpenAI サービスにアクセスすることは、OpenAI の利用規約に違反する可能性があります。これらの規約では、未承認の自動アクセス、サービス複製、および意図されたアクセスパスの回避が禁止されています。 -2. **アカウントリスク**: OpenAI は異常な使用パターンを疑わしい自動化活動としてフラグ付けし、ChatGPT Plus / Pro へのアクセスに一時的または永久的な制限を科す可能性があります。 +2. **アカウントリスク**: OpenAI は異常な使用パターンを疑わしい自動化活動としてフラグ付けし、ChatGPT へのアクセスに一時的または永久的な制限を科す可能性があります。 3. **将来の利用保証なし**: OpenAI は認証および検出メカニズムをいつでも更新する可能性があり、現在動作する使用パターンが将来的にフラグ付けされる可能性があります。 v3.12.3 で導入された **GitHub Copilot リバースプロキシ**も、既存のリスク通知の対象となります — 詳細は [v3.12.3 リリースノート](v3.12.3-ja.md#️-リスクに関する注意事項) を参照してください。 diff --git a/docs/release-notes/v3.13.0-zh.md b/docs/release-notes/v3.13.0-zh.md index 723c4eeb5..4eb5eddd5 100644 --- a/docs/release-notes/v3.13.0-zh.md +++ b/docs/release-notes/v3.13.0-zh.md @@ -8,7 +8,7 @@ ## 概览 -CC Switch v3.13.0 是一次重要的功能版本，聚焦于可观测性、供应商工作流与代理兼容性。本版本在各主要供应商卡片上新增了**配额与余额展示**，覆盖 Claude / Codex / Gemini 官方订阅、Token Plan（Kimi / Zhipu GLM / MiniMax）、Copilot premium interactions 以及 DeepSeek / StepFun / SiliconFlow / OpenRouter / Novita AI 等第三方余额查询；引入了**轻量模式**，让 CC Switch 可以仅驻留在系统托盘中运行；通过 OpenAI 兼容的 `/v1/models` 端点在 Claude / Codex / Gemini / OpenCode / OpenClaw 五个应用的供应商表单中实现了**模型自动发现**；为 ChatGPT Plus / Pro 订阅者提供了 **Codex OAuth 反向代理**；将托盘菜单重构为**按应用分级的子菜单**；将代理转发层重建在 **Hyper 客户端**之上；并完成了 **Skills 工作流**的发现、批量更新和存储位置切换改造。其他改进还包括完整 URL 端点模式、无需代理拦截的会话日志用量追踪、Copilot 调用优化器、多字节 UTF-8 流式分片边界修复以及 Linux 启动时 UI 无响应修复等。 +CC Switch v3.13.0 是一次重要的功能版本，聚焦于可观测性、供应商工作流与代理兼容性。本版本在各主要供应商卡片上新增了**配额与余额展示**，覆盖 Claude / Codex / Gemini 官方订阅、Token Plan（Kimi / Zhipu GLM / MiniMax）、Copilot premium interactions 以及 DeepSeek / StepFun / SiliconFlow / OpenRouter / Novita AI 等第三方余额查询；引入了**轻量模式**，让 CC Switch 可以仅驻留在系统托盘中运行；通过 OpenAI 兼容的 `/v1/models` 端点在 Claude / Codex / Gemini / OpenCode / OpenClaw 五个应用的供应商表单中实现了**模型自动发现**；为 ChatGPT 订阅者提供了 **Codex OAuth 反向代理**；将托盘菜单重构为**按应用分级的子菜单**；将代理转发层重建在 **Hyper 客户端**之上；并完成了 **Skills 工作流**的发现、批量更新和存储位置切换改造，内置了 skills.sh 搜索安装。其他改进还包括完整 URL 端点模式、更完善的 token 用量追踪、Copilot 调用优化器、多字节 UTF-8 流式分片边界修复以及 Linux 启动时 UI 无响应修复，以及更友善的新用户引导等。 **发布日期**：2026-04-10 @@ -21,9 +21,9 @@ CC Switch v3.13.0 是一次重要的功能版本，聚焦于可观测性、供 - **轻量模式**：新增仅托盘运行模式，退出到托盘时销毁主窗口、按需重建，空闲时资源占用接近零 - **配额与余额展示**：供应商卡片上直接展示配额或余额 —— 覆盖 Claude / Codex / Gemini 官方订阅、GitHub Copilot premium interactions、Codex OAuth、Token Plan（Kimi / Zhipu GLM / MiniMax），以及 DeepSeek / StepFun / SiliconFlow / OpenRouter / Novita AI 的官方余额查询 - **供应商模型自动获取**：为 Claude / Codex / Gemini / OpenCode / OpenClaw 的供应商表单新增 OpenAI 兼容的 `/v1/models` 发现能力，按分组下拉展示并提供针对性错误提示 -- **Codex OAuth 反向代理**：新增 ChatGPT Plus / Pro 的 Codex 反向代理，作为新的 Claude 供应商卡片类型，包含受管 OAuth 登录流程和订阅配额展示（[⚠️ 风险提示](#️-风险提示)） +- **Codex OAuth 反向代理**：新增 ChatGPT 的 Codex 反向代理，作为新的 Claude 供应商卡片类型，让用户在可以在 Claude Code 里面使用 ChatGPT 订阅。包含受管 OAuth 登录流程和订阅配额展示（[⚠️ 风险提示](#️-风险提示)） - **托盘按应用分级菜单**：将托盘菜单重构为按应用分组的子菜单，防止供应商多时菜单溢出，让后台切换供应商在大量供应商场景下仍可用 -- **Skills 发现与批量更新**：基于 SHA-256 内容哈希的更新检测、单项和"全部更新"批量操作、`skills.sh` 公共注册表搜索集成，以及 CC Switch 与 `~/.agents/skills` 的存储位置切换 +- **Skills 发现与批量更新**：基于 SHA-256 内容哈希的更新检测、单项和"全部更新"批量操作、`skills.sh` 表搜索集成，以及 CC Switch 与 `~/.agents/skills` 的存储位置切换 - **会话工作流升级**：会话管理器批量删除、Claude 终端恢复前的目录选择器、无需代理拦截即可导入 Claude / Codex / Gemini 会话日志用量、精确的 Codex JSONL 解析、按应用筛选用量面板 - **OpenCode / OpenClaw 流式检测覆盖**：新增 OpenCode 的 npm 包映射检测、OpenClaw `openai-completions` 支持，以及其余所有 OpenClaw 协议变体 - **完整 URL 端点模式**：新增将 `base_url` 视作完整上游端点的供应商选项，支持非标准 URL 布局的厂商 @@ -54,11 +54,10 @@ CC Switch v3.13.0 是一次重要的功能版本，聚焦于可观测性、供 - **官方订阅**：Claude / Codex / Gemini 官方供应商的订阅配额展示 - **GitHub Copilot**：在 Copilot 供应商卡片上显示 premium interactions 剩余量 -- **Codex OAuth**：在 Codex OAuth 卡片上内联展示 ChatGPT Plus / Pro 订阅配额 -- **Token Plan 供应商**：Kimi、Zhipu GLM、MiniMax，修正配额数学与 0% → 100% 用量进度 -- **第三方余额**：为 DeepSeek、StepFun、SiliconFlow、OpenRouter、Novita AI 提供官方余额查询 +- **Codex OAuth**：在 Codex OAuth 卡片上内联展示 ChatGPT 订阅配额 +- **Token Plan 供应商**：Kimi、Zhipu GLM、MiniMax 用量进度显示（为避免混淆，需要手动开启） +- **第三方余额**：为 DeepSeek、StepFun、SiliconFlow、OpenRouter、Novita AI 提供官方余额查询（为避免混淆，需要手动开启） - 官方供应商的健康检查和用量配置按钮自动隐藏，保持卡片简洁 -- Copilot / ChatGPT OAuth 和 CLI 订阅配额仅在当前活跃供应商卡片上自动轮询，避免非当前卡片上的不必要 API 调用 ### 供应商模型自动获取 @@ -71,13 +70,12 @@ CC Switch v3.13.0 是一次重要的功能版本，聚焦于可观测性、供 ### Codex OAuth 反向代理 -新增 ChatGPT Plus / Pro 订阅者的 Codex OAuth 反向代理路径，让 ChatGPT 订阅者可以在 Claude Code 中使用自己的订阅。 +新增 ChatGPT 订阅者的 Codex OAuth 反向代理路径，让 ChatGPT 订阅者可以在 Claude Code 中使用自己的订阅。 -- 受管 OAuth 登录流程，通过 ChatGPT Plus / Pro 认证 +- 受管 OAuth 登录流程，通过 ChatGPT 认证 - 作为新的 Claude 供应商卡片类型出现在列表中，与 API-key 型供应商并列 - 订阅配额内联展示 - 与 Auth Center UI 紧密集成，统一管理 Token -- Codex OAuth 预设升级到 GPT-5.4 系列 - 启用前请参见下文的 [⚠️ 风险提示](#️-风险提示) ### 托盘按应用分级菜单 @@ -136,6 +134,7 @@ CC Switch v3.13.0 是一次重要的功能版本，聚焦于可观测性、供 - 根据请求意图和权重进行分类 - 将低价值请求路由到非 premium 通道 - 旨在延长 Copilot 订阅的可用时长 +- 注意，即使优化过消耗以后，在 Copilot 外使用 Copilot 的 API 消耗仍然会高于在 Copilot 内使用。 ### 首次运行欢迎对话框 @@ -169,15 +168,15 @@ CC Switch v3.13.0 是一次重要的功能版本，聚焦于可观测性、供 ### Kaku 终端支持 -- macOS 上新增 Kaku 作为可选终端用于启动会话，复用 WezTerm 兼容的启动路径 +- macOS 上新增 Kaku 作为可选终端用于启动会话，复用 WezTerm 兼容的启动路径 (#1983, 感谢 @yovinchen) ### OMO Slim Council 支持 -- 恢复 council 作为内置 oh-my-opencode-slim agent 的一等支持，更新元数据和 UI 文案 +- 恢复 council 作为内置 oh-my-opencode-slim agent 的一等支持，更新元数据和 UI 文案 (#1982, 感谢 @yovinchen) ### 新供应商预设 -- **TheRouter**：覆盖 Claude / Codex / Gemini / OpenCode / OpenClaw 五个应用 +- **TheRouter**：覆盖 Claude / Codex / Gemini / OpenCode / OpenClaw 五个应用 (#1891, #1892, 感谢 @cmzz) - **DDSHub**：作为 Claude 的第三方合作伙伴供应商，含图标和推广文案 - **LionCCAPI**：覆盖全部五个应用，OpenCode / OpenClaw 使用 anthropic-messages 协议 - **胜算云 (Shengsuanyun)**：作为聚合类合作伙伴供应商覆盖全部五个应用，支持 URL 图标和本地化名称 @@ -331,11 +330,11 @@ CC Switch v3.13.0 是一次重要的功能版本，聚焦于可观测性、供 ### Thinking 模型回退显示 -- 修复 Claude 供应商表单仅填写主模型后 Thinking 模型字段显示为空，改为只读回退到 ANTHROPIC_MODEL +- 修复 Claude 供应商表单仅填写主模型后 Thinking 模型字段显示为空，改为只读回退到 ANTHROPIC_MODEL (#1984, 感谢 @yovinchen) ### Auth Tab 本地化 -- 修复设置面板 auth tab 标签在所有语言包中缺失 i18n 翻译 key +- 修复设置面板 auth tab 标签在所有语言包中缺失 i18n 翻译 key (#1985, 感谢 @yovinchen) ### 数据库迁移守卫 @@ -370,10 +369,10 @@ CC Switch v3.13.0 是一次重要的功能版本，聚焦于可观测性、供 **Codex OAuth 反向代理免责声明** -本版本新增的 Codex OAuth 反向代理功能通过逆向工程的 OAuth 流程访问 ChatGPT Plus / Pro 的 Codex 服务。启用此功能前，请注意以下风险： +本版本新增的 Codex OAuth 反向代理功能通过逆向工程的 OAuth 流程访问 ChatGPT 的 Codex 服务。启用此功能前，请注意以下风险： 1. **违反服务条款**：使用逆向 OAuth 流程访问 OpenAI 服务可能违反 OpenAI 的服务条款，其中禁止未经授权的自动化访问、服务复制以及绕过既定的访问路径。 -2. **账号风险**：OpenAI 可能将异常使用模式标记为可疑的自动化行为，从而对 ChatGPT Plus / Pro 访问施加临时或永久限制。 +2. **账号风险**：OpenAI 可能将异常使用模式标记为可疑的自动化行为，从而对 ChatGPT 访问施加临时或永久限制。 3. **无法保证长期可用**：OpenAI 可能随时更新其认证和检测机制，当前可用的使用方式未来可能被标记。 v3.12.3 引入的 **GitHub Copilot 反向代理**同样适用原有风险提示 —— 详见 [v3.12.3 release notes](v3.12.3-zh.md#️-风险提示)。 @@ -388,26 +387,26 @@ v3.12.3 引入的 **GitHub Copilot 反向代理**同样适用原有风险提示 ### 系统要求 -| 系统 | 最低版本 | 架构 | -| ------- | ----------------------------- | ----------------------------------- | -| Windows | Windows 10 及以上 | x64 | -| macOS | macOS 12 (Monterey) 及以上 | Intel (x64) / Apple Silicon (arm64) | -| Linux | 见下表 | x64 | +| 系统 | 最低版本 | 架构 | +| ------- | -------------------------- | ----------------------------------- | +| Windows | Windows 10 及以上 | x64 | +| macOS | macOS 12 (Monterey) 及以上 | Intel (x64) / Apple Silicon (arm64) | +| Linux | 见下表 | x64 | ### Windows -| 文件 | 说明 | -| ------------------------------------------ | ----------------------------------- | -| `CC-Switch-v3.13.0-Windows.msi` | **推荐** - MSI 安装包，支持自动更新 | -| `CC-Switch-v3.13.0-Windows-Portable.zip` | 便携版，解压即用，不写入注册表 | +| 文件 | 说明 | +| ---------------------------------------- | ----------------------------------- | +| `CC-Switch-v3.13.0-Windows.msi` | **推荐** - MSI 安装包，支持自动更新 | +| `CC-Switch-v3.13.0-Windows-Portable.zip` | 便携版，解压即用，不写入注册表 | ### macOS -| 文件 | 说明 | -| ---------------------------------- | --------------------------------------------------------- | -| `CC-Switch-v3.13.0-macOS.dmg` | **推荐** - DMG 安装包，拖入 Applications 即可 | -| `CC-Switch-v3.13.0-macOS.zip` | 解压后拖入 Applications，Universal Binary | -| `CC-Switch-v3.13.0-macOS.tar.gz` | 用于 Homebrew 安装和自动更新 | +| 文件 | 说明 | +| -------------------------------- | --------------------------------------------- | +| `CC-Switch-v3.13.0-macOS.dmg` | **推荐** - DMG 安装包，拖入 Applications 即可 | +| `CC-Switch-v3.13.0-macOS.zip` | 解压后拖入 Applications，Universal Binary | +| `CC-Switch-v3.13.0-macOS.tar.gz` | 用于 Homebrew 安装和自动更新 | > macOS 版本已通过 Apple 代码签名和公证，可直接安装使用。