From df40d53c36b604e044b4d5b9091aeb961aa56990 Mon Sep 17 00:00:00 2001 From: Jason Date: Sat, 10 Oct 2026 23:32:26 +0800 Subject: [PATCH] docs(release): add v4.0.8 release notes --- docs/release-notes/v4.0.8-en.md | 36 +++++++++++++++++++++++++++++++++ docs/release-notes/v4.0.8-ja.md | 36 +++++++++++++++++++++++++++++++++ docs/release-notes/v4.0.8-zh.md | 36 +++++++++++++++++++++++++++++++++ src/whats-new/4.0.8.json | 33 ++++++++++++++++++++++++++++++ 4 files changed, 141 insertions(+) create mode 100644 docs/release-notes/v4.0.8-en.md create mode 100644 docs/release-notes/v4.0.8-ja.md create mode 100644 docs/release-notes/v4.0.8-zh.md create mode 100644 src/whats-new/4.0.8.json diff --git a/docs/release-notes/v4.0.8-en.md b/docs/release-notes/v4.0.8-en.md new file mode 100644 index 000000000..f333221b9 --- /dev/null +++ b/docs/release-notes/v4.0.8-en.md @@ -0,0 +1,36 @@ +# CC Switch v4.0.8 + +### The fourth fix release for 4.0 stable + +Users who installed only the Codex desktop app, without a separate Codex CLI, can now use Codex Aggregation mode too. When the official model list can't be read, the prompt now says why, and it goes away on its own once the problem is fixed. When adding and editing providers, "Fetch Models" now sends the request headers you configured, so gateways that require extra headers no longer reject it. "Settings → Data" adds an "Open log" button. Dark mode text is a bit dimmer and no longer as glaring. For everything new in 4.0, see the [v4.0 release notes](https://github.com/farion1231/cc-switch/blob/main/docs/release-notes/v4.0.4-en.md). + +--- + +## New + +**"Settings → Data → Application Diagnostic Logs" adds an "Open log" button.** Clicking it selects `cc-switch.log` in your system's file manager; if the log file has not been created yet, it opens the folder where the log lives. When reporting an issue, you can attach it directly instead of digging through the hidden config directory. + +## Fixes + +- **With only the Codex desktop app installed, the Aggregation page said "the Codex model list can't be read", and Aggregation mode did not work.** When fetching the official list online fails, CC Switch falls back to the model list bundled with the Codex CLI, but it used to look for the `codex` command only on the system path. Users with only the desktop app don't have this command, so it always failed. Now, if it can't find one there, it uses the CLI bundled with the Codex desktop app: on macOS it looks for ChatGPT.app and the pre-rename Codex.app in "Applications", and when both are present it uses ChatGPT.app, so an old Codex.app does not supply an outdated model list; on Windows it looks for the newest version in the desktop app's install directory. A separately installed Codex CLI still takes priority. +- **When the official model list could not be read, the prompt did not say why, and it did not go away after the problem was fixed.** Every cause used to show the same line, "the Codex model list can't be read". The prompt now lists the specific cause below it and tells you what to do: Codex has no usable ChatGPT sign-in, the sign-in has not been refreshed for more than 8 days, the sign-in information is incomplete, the Codex version can't be read, fetching online failed, or the returned data is incomplete; for the list bundled with Codex, the causes are that the Codex CLI can't be found, the CLI did not output a list, or the list has no usable models. Details of online and CLI failures are written to the log. Also, after falling back to the backup list, the prompt used to stay until your next manual switch even if the official list later recovered (for example, when Codex automatically refreshed an expired sign-in); CC Switch now switches back to the official list automatically, and the prompt goes away with it. +- **"Fetch Models" did not send the request headers you configured, so gateways that require extra headers rejected it.** For example, Cloudflare AI Gateway requires the `cf-aig-authorization` header. OpenCode providers now send the request headers configured for them; Claude Code, Codex and Grok Build providers send the headers entered in "Header overrides", and fetching works as usual when the format is wrong or the field is empty. In the Codex and Grok Build forms, changing "Header overrides" clears the model list already fetched, so you don't pick a model the current identity can't use. +- **Dark mode text was too bright and became glaring after a while.** All three text colors were close to pure white, which felt harsh on screens full of tables and labels and made it hard to tell primary from secondary text. All three are now a bit dimmer, and secondary text still keeps enough contrast on cards and selected backgrounds. Light mode is unchanged. + +**Other:** +- The "Compress old Codex sessions" section of the v4.0.7 release notes now also covers how to turn it on, when compression happens, how to continue old sessions, how CC Switch shows them, and things to note. +- The English and Japanese help text for the quota display setting, and the English, Japanese and Traditional Chinese backup notices, now use the names actually shown in the interface. + +## Upgrade Notes + +**The database schema is unchanged**, still at 20. + +--- + +## Thanks + +Thanks to [@SailingLoong](https://github.com/SailingLoong) (sending request headers when OpenCode fetches models) and [@ggbdpq](https://github.com/ggbdpq) (sending "Header overrides" when Claude Code and Codex fetch models) for their contributions. + +Thanks to [@xovow](https://github.com/xovow), [@YX-bobi](https://github.com/YX-bobi) and [@cydebbb](https://github.com/cydebbb) for reporting issues and making suggestions. + +For the full technical details, see the [CHANGELOG](https://github.com/farion1231/cc-switch/blob/main/CHANGELOG.md). diff --git a/docs/release-notes/v4.0.8-ja.md b/docs/release-notes/v4.0.8-ja.md new file mode 100644 index 000000000..6ca8533d0 --- /dev/null +++ b/docs/release-notes/v4.0.8-ja.md @@ -0,0 +1,36 @@ +# CC Switch v4.0.8 + +### 4.0 正式版の 4 回目の修正リリース + +Codex のデスクトップ版だけをインストールし、Codex CLI を別にインストールしていない場合でも、Codex の集約モードを使えるようになりました。公式モデル一覧を読み込めないときは案内に原因が表示され、問題が解決すると案内も自動で消えます。プロバイダーの追加・編集時に「モデル一覧を取得」が設定済みのリクエストヘッダーを送るようになり、追加のリクエストヘッダーが必要なゲートウェイに拒否されなくなりました。「設定 → データ」に「ログを開く」ボタンを追加しました。ダークモードの文字を少し暗くし、まぶしさを抑えました。4.0 の更新内容の全体は [v4.0 リリースノート](https://github.com/farion1231/cc-switch/blob/main/docs/release-notes/v4.0.4-ja.md) をご覧ください。 + +--- + +## 新機能 + +**「設定 → データ → アプリ診断ログ」に「ログを開く」ボタンを追加しました。** クリックすると、システムのファイルマネージャーで `cc-switch.log` が選択された状態になります。ログファイルがまだ作成されていない場合は、ログのあるフォルダーを開きます。問題を報告するときにそのまま添付でき、隠れた設定ディレクトリを探す必要がなくなります。 + +## 修正 + +- **Codex のデスクトップ版だけをインストールしていると、集約ページに「Codex のモデル一覧を読み込めないため、集約したモデルは現在使用できません」と表示され、集約モードを使えなかった問題。** 公式一覧をネットワーク経由で取得できなかったとき、CC Switch は Codex CLI に内蔵されたモデル一覧を代わりに使いますが、これまではシステムのパスからしか `codex` コマンドを探していませんでした。デスクトップ版だけをインストールしている場合はこのコマンドがないため、常に失敗していました。現在は見つからないとき、Codex のデスクトップ版に同梱された CLI も使います。macOS では「アプリケーション」フォルダーの ChatGPT.app と、名前が変わる前の Codex.app を探し、両方ある場合は ChatGPT.app を使います。古い Codex.app から古いモデル一覧が返されるのを避けるためです。Windows ではデスクトップ版のインストールディレクトリにある最新のバージョンを使います。別にインストールした Codex CLI が引き続き優先されます。 +- **公式モデル一覧を読み込めないとき、案内から原因がわからず、問題が解決しても案内が消えなかった問題。** これまではどの原因でも同じ「Codex のモデル一覧を読み込めない」という表示でした。現在は案内の下に具体的な原因と対処方法を表示します。公式一覧では、Codex に使える ChatGPT ログインがない、ログインが 8 日以上更新されていない、ログイン情報が不完全、Codex のバージョンを読み取れない、ネットワーク経由での取得に失敗した、返されたデータが不完全、のいずれかです。Codex 内蔵の一覧では、Codex CLI が見つからない、CLI がモデル一覧を出力しなかった、一覧に使えるモデルがない、に分けて表示します。ネットワーク経由での取得と CLI の失敗の詳細はログに記録します。また、これまでは予備の一覧に切り替えた後、公式一覧が回復しても（期限切れのログインが Codex によって自動で更新された場合など）、次に手動で切り替えるまで案内が消えませんでした。現在は CC Switch が自動で公式一覧に戻し、案内も消えます。 +- **「モデル一覧を取得」が設定済みのリクエストヘッダーを送らず、追加のリクエストヘッダーが必要なゲートウェイに拒否されていた問題。** たとえば Cloudflare AI Gateway は `cf-aig-authorization` リクエストヘッダーを必要とします。現在は OpenCode のプロバイダーでは設定済みのリクエストヘッダーを送り、Claude Code、Codex、Grok Build のプロバイダーでは「Header 上書き」に入力したリクエストヘッダーを送ります。形式が正しくない場合や空欄の場合は、通常どおり取得します。Codex と Grok Build のフォームで「Header 上書き」を変更すると、取得済みのモデル一覧はクリアされます。現在の認証情報では使えないモデルを選んでしまうのを防ぐためです。 +- **ダークモードの文字が明るすぎて、長く見ているとまぶしかった問題。** 3 段階の文字色がどれも純白に近く、表やラベルが画面いっぱいにあると強すぎて、主従の区別もつきにくくなっていました。現在は 3 段階とも少し暗くし、補助的な文字もカードや選択中の背景の上で十分なコントラストを保ちます。ライトモードは変わっていません。 + +**その他：** +- v4.0.7 リリースノートの「Codex の古いセッションを圧縮」の節に、有効にする方法、圧縮されるタイミング、古いセッションを続ける方法、CC Switch での表示、注意点を追記しました。 +- 英語版と日本語版の残量表示の説明、および英語版・日本語版・繁体字中国語版のバックアップの案内で、画面に実際に表示される名称を使うようにしました。 + +## アップグレードに関する注意 + +**データベースの構造は変わっていません。** バージョンは 20 のままです。 + +--- + +## 謝辞 + +[@SailingLoong](https://github.com/SailingLoong)（OpenCode でモデル一覧を取得するときにリクエストヘッダーを送る）、[@ggbdpq](https://github.com/ggbdpq)（Claude Code、Codex でモデル一覧を取得するときに「Header 上書き」を送る）の貢献に感謝します。 + +問題の報告や提案をしてくださった [@xovow](https://github.com/xovow)、[@YX-bobi](https://github.com/YX-bobi)、[@cydebbb](https://github.com/cydebbb) にも感謝します。 + +技術的な詳細は [CHANGELOG](https://github.com/farion1231/cc-switch/blob/main/CHANGELOG.md) をご覧ください。 diff --git a/docs/release-notes/v4.0.8-zh.md b/docs/release-notes/v4.0.8-zh.md new file mode 100644 index 000000000..8d026cba2 --- /dev/null +++ b/docs/release-notes/v4.0.8-zh.md @@ -0,0 +1,36 @@ +# CC Switch v4.0.8 + +### 4.0 正式版的第四个修复版本 + +只装了 Codex 桌面版、没有单独装 Codex 命令行的用户，现在也能用 Codex 聚合模式了。官方模型列表读不到时，提示会写明原因，问题解决后提示也会自己消失。添加和编辑供应商时，「获取模型列表」会带上你配置的请求头，需要额外请求头的网关不会再拒绝。「设置 → 数据」新增「打开日志」按钮。深色模式的文字调暗了一些，不再那么刺眼。4.0 完整的更新内容请见 [v4.0 发布说明](https://github.com/farion1231/cc-switch/blob/main/docs/release-notes/v4.0.4-zh.md)。 + +--- + +## 新增 + +**「设置 → 数据 → 应用诊断日志」新增「打开日志」按钮。** 点击后会在系统的文件管理器里选中 `cc-switch.log`；日志文件还没生成时打开日志所在的文件夹。报告问题时可以直接把它附上，不用再去找隐藏的配置目录。 + +## 修复 + +- **只装了 Codex 桌面版时，聚合页提示「读取不到 Codex 模型列表」，聚合模式用不了。** 联网获取官方列表失败时，CC Switch 会改用 Codex 命令行自带的模型列表，但以前只在系统路径里找 `codex` 命令。只装桌面版的用户没有这个命令，所以一直失败。现在找不到时会再去用 Codex 桌面版自带的命令行：macOS 上找「应用程序」里的 ChatGPT.app 和改名前的 Codex.app，两个都在时用 ChatGPT.app，避免旧的 Codex.app 给出过时的模型列表；Windows 上找桌面版安装目录里最新的一个版本。单独安装的 Codex 命令行仍然优先。 +- **官方模型列表读不到时，提示看不出原因，问题解决后提示也不会消失。** 以前所有原因都显示成同一句「读取不到 Codex 模型列表」。现在提示下面会列出具体原因，并告诉你怎么处理：Codex 没有可用的 ChatGPT 登录、登录超过 8 天没有刷新、登录信息不完整、读不到 Codex 版本、联网获取失败、返回的数据不完整；Codex 自带的列表则分为找不到 Codex 命令行、命令行没能输出列表、列表里没有能用的模型。联网失败和命令行失败的详细信息会写进日志。另外，以前换用备用列表后，即使官方列表后来恢复了（比如过期的登录被 Codex 自动刷新），提示也要等你下次手动切换才会消失；现在 CC Switch 会自动换回官方列表，提示随之消失。 +- **「获取模型列表」不带你配置的请求头，需要额外请求头的网关会拒绝。** 比如 Cloudflare AI Gateway 要求 `cf-aig-authorization` 请求头。现在 OpenCode 供应商会带上它配置的请求头；Claude Code、Codex 和 Grok Build 供应商会带上「Header 覆盖」里填的请求头，格式不对或留空时照常获取。在 Codex 和 Grok Build 的表单里修改「Header 覆盖」后，已经获取的模型列表会清空，避免选到当前身份用不了的模型。 +- **深色模式的文字太亮，看久了刺眼。** 三档文字颜色都接近纯白，满屏表格和标签时显得很冲，主次也分不清。现在三档都调暗了一些，次要文字在卡片和选中背景上仍然保持足够的对比度。浅色模式没有变化。 + +**其他：** +- v4.0.7 发布说明里「压缩 Codex 历史会话」一节补充了怎么打开、什么时候压缩、怎么继续旧会话、CC Switch 里怎么显示和需要注意的地方。 +- 英文和日文的额度显示说明、英文、日文和繁体中文的备份提示，改用界面上实际显示的名称。 + +## 升级说明 + +**数据库结构没有变化**，仍然是 20。 + +--- + +## 致谢 + +感谢 [@SailingLoong](https://github.com/SailingLoong)（OpenCode 获取模型列表时带上请求头）、[@ggbdpq](https://github.com/ggbdpq)（Claude Code、Codex 获取模型列表时带上「Header 覆盖」）的贡献。 + +感谢 [@xovow](https://github.com/xovow)、[@YX-bobi](https://github.com/YX-bobi)、[@cydebbb](https://github.com/cydebbb) 报告问题和提出建议。 + +完整的技术细节请见 [CHANGELOG](https://github.com/farion1231/cc-switch/blob/main/CHANGELOG.md)。 diff --git a/src/whats-new/4.0.8.json b/src/whats-new/4.0.8.json new file mode 100644 index 000000000..7ba454e5f --- /dev/null +++ b/src/whats-new/4.0.8.json @@ -0,0 +1,33 @@ +{ + "version": "4.0.8", + "items": [ + { + "type": "fix", + "zh": "只装了 Codex 桌面版也能用 Codex 聚合模式", + "zh-TW": "只安裝 Codex 桌面版也能使用 Codex 聚合模式", + "en": "Codex aggregation now works when only the Codex desktop app is installed", + "ja": "Codex デスクトップ版だけでも Codex の集約モードを使えるように" + }, + { + "type": "improve", + "zh": "读不到官方模型列表时提示写明原因，恢复后自动消失", + "zh-TW": "讀不到官方模型列表時提示會寫明原因，恢復後自動消失", + "en": "When the official model list is unavailable, the notice says why and clears once it is back", + "ja": "公式モデル一覧を読めないときは理由を表示し、復旧すると自動で消えるように" + }, + { + "type": "fix", + "zh": "获取模型列表时会带上供应商配置的请求头", + "zh-TW": "取得模型列表時會帶上供應商設定的請求標頭", + "en": "Fetching model lists now sends the provider's configured request headers", + "ja": "モデル一覧の取得時にプロバイダーで設定したリクエストヘッダーを送信" + }, + { + "type": "improve", + "zh": "深色模式的文字调暗一些，不再刺眼", + "zh-TW": "深色模式的文字調暗一些，不再刺眼", + "en": "Dark-mode text is softer and less glaring", + "ja": "ダークモードの文字を少し暗くし、まぶしさを軽減" + } + ] +}