docs(release): add v4.0.5 release notes

docs/release-notes/v4.0.5-en.md

@@ -0,0 +1,49 @@
+# CC Switch v4.0.5
+
+### The first fix release for 4.0 stable
+
+Codex can now use a GitHub Copilot account. The "All" heatmap in Usage is no longer limited to the past year: you can go back all the way to the first day with records. This release also fixes subagents always being sent to a worktree when Claude Code is mapped to GPT over the Responses protocol, and GLM and other models disappearing from `/model` in Codex's Aggregation mode; Linux deb and rpm packages can now be updated in-app too. 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).
+
+> **Linux deb and rpm users, please install this version manually.** Installed deb and rpm versions still carry the old install type marker, so updating to this version in-app still reports insufficient permissions. After you download and install 4.0.5 manually once, automatic updates work normally from then on.
+
+---
+
+## New
+
+**Codex can use a GitHub Copilot account.** When adding a provider in Codex, pick the "GitHub Copilot" preset and sign in to your GitHub account in "Accounts"; a Copilot account already signed in for Claude Code can be used directly. Codex needs Routing turned on. Different models on Copilot support different protocols: local routing picks Responses or Chat Completions automatically for each model, and you can also set it by hand under "Upstream Format" in the editor. Context windows differ by account tier, so the preset defaults to conservative values; clicking "Fetch Models" fills in the model catalog with your account's actual windows and reasoning levels.
+
+**The "All" heatmap shows your full history.** With the time range set to "All", the heatmap used to show only the last 53 weeks. It still shows the last 53 weeks by default; clicking "Show more" adds earlier sections of 53 weeks each, going back to the first day with records. Each section shows its date range, tokens, requests and cost, and the color shading can be compared directly across sections.
+
+## Fixes
+
+- **With Claude Code mapped to GPT over the Responses protocol, subagents were always sent to a worktree.** When Claude Code calls a subagent, "isolation" and "model" are optional parameters, but unless told otherwise the Responses protocol treats optional parameters as required, so the model filled them in every time. As a result, subagents were sent to run in a worktree and failed outright outside a git repository, or the model configured for the subagent was overridden. Conversion now declares these parameters optional explicitly. Providers using the Responses protocol and ChatGPT accounts were both affected, and both are fixed now.
+- **In Codex's Aggregation mode, GLM and other models were missing from `/model`.** CC Switch builds the model catalog using the official gpt-5.5 entry as a template; once the official catalog marked that entry hidden, all third-party models in Aggregation were hidden along with it, while the Aggregation count still included them.
+- **Codex's MoArk preset showed only one model in `/model`.** The preset came without a model catalog, so Codex listed only the default model. All 5 models are now listed, with their context windows, image input and reasoning levels. MoArk providers you have already added are not updated automatically; add it again from the preset.
+- **On Linux, versions installed from deb or rpm reported insufficient permissions when updating in-app.** The updater used to not recognize deb and rpm installs and wrote files into `/usr/bin` the way it does for AppImage. Deb and rpm now have their own update packages. Versions already installed need this version installed manually once; see the note above.
+- **On Linux Wayland, the title bar's minimize, maximize and close buttons did nothing when clicked.** When the window was first opened, or reopened from the tray, an invisible area covered the buttons.
+- **On Windows, after upgrading with the MSI, the icon pinned to the taskbar went blank after restarting the computer.** The shortcut used to point to an icon cache that was deleted on every upgrade; it now uses the program's own icon. An icon pinned earlier may still go blank once after this upgrade; unpin it and pin it again, and it will not happen on later upgrades.
+- **Claude Code installed with npm 12 would not run, and Windows reported the program as incompatible.** npm 12 does not run Claude Code's install script by default but still reports a successful install, leaving only a placeholder file. Installing and upgrading on the "Apps" page, as well as the install commands you can copy, now allow this install script to run.
+- **Without Routing on, Grok Build's usage took 10 minutes to appear in Usage**; it now takes about 1 minute.
+
+**Other:**
+- The user manual and README are updated to the 4.0 interface.
+
+## Upgrade Notes
+
+**The database schema is unchanged**, still at 20.
+
+**Linux deb and rpm users, please install this version manually**; automatic updates work normally after that.
+
+**Windows users**: if the icon pinned to the taskbar goes blank after upgrading, unpin it and pin it again.
+
+---
+
+## Thanks
+
+Thanks to [@ljie-PI](https://github.com/ljie-PI) (GitHub Copilot for Codex, together with [@ump45nose](https://github.com/ump45nose)), [@SailingLoong](https://github.com/SailingLoong) (subagents no longer sent to a worktree), [@cenglin123](https://github.com/cenglin123) (GLM models disappearing in Aggregation mode), [@lcgash](https://github.com/lcgash) (the MoArk model catalog), [@Lingbou](https://github.com/Lingbou) (deb and rpm auto-updates on Linux), [@Railgun-wiki](https://github.com/Railgun-wiki) (the Wayland title bar buttons), [@Besty0728](https://github.com/Besty0728) (the Windows taskbar icon) and [@funkpopo](https://github.com/funkpopo) (installing Claude Code with npm 12, and reviewing the MoArk presets) for their contributions.
+
+Thanks to [@Timetraps-x](https://github.com/Timetraps-x), [@ggbdpq](https://github.com/ggbdpq), [@c2519352073-star](https://github.com/c2519352073-star), [@yukitakasama](https://github.com/yukitakasama), [@liuziyuan](https://github.com/liuziyuan) and [@Suaig](https://github.com/Suaig) for submitting fixes or implementations for the same problems.
+
+Thanks to [@WK-Apollo](https://github.com/WK-Apollo), [@caoguanjie](https://github.com/caoguanjie), [@kirkchinese](https://github.com/kirkchinese), [@ZMKC404](https://github.com/ZMKC404), [@sunwayking](https://github.com/sunwayking), [@Vistonz](https://github.com/Vistonz), [@van23qf](https://github.com/van23qf), [@echoescheng](https://github.com/echoescheng), [@xlht4106](https://github.com/xlht4106), [@YueZhang2019](https://github.com/YueZhang2019), [@hueifeng](https://github.com/hueifeng) and [@jingzhang94](https://github.com/jingzhang94) for reporting issues and making suggestions.
+
+For the full technical details, see the [CHANGELOG](https://github.com/farion1231/cc-switch/blob/main/CHANGELOG.md).

docs/release-notes/v4.0.5-ja.md

@@ -0,0 +1,49 @@
+# CC Switch v4.0.5
+
+### 4.0 正式版の最初の修正リリース
+
+Codex で GitHub Copilot アカウントを使えるようになりました。使用量の「すべて」のヒートマップは直近 1 年だけでなく、記録のある最初の日までさかのぼって見られるようになりました。このバージョンでは、Claude Code を Responses プロトコル経由で GPT にマッピングしたときにサブエージェントが常に worktree に送られる問題と、Codex の集約モードで GLM などのモデルが `/model` から消える問題も修正しました。Linux の deb、rpm パッケージもアプリ内で更新できるようになりました。4.0 の更新内容の全体は [v4.0 リリースノート](https://github.com/farion1231/cc-switch/blob/main/docs/release-notes/v4.0.4-ja.md) をご覧ください。
+
+> **Linux の deb、rpm をお使いの方は、このバージョンを手動でインストールしてください。** インストール済みの deb、rpm 版には古いインストール種別の目印が残っているため、アプリ内でこのバージョンに更新しても権限不足と表示されます。4.0.5 を一度手動でダウンロードしてインストールすれば、それ以降は通常どおり自動更新されます。
+
+---
+
+## 新機能
+
+**Codex で GitHub Copilot アカウントを使えるように。** Codex でプロバイダーを追加するときに「GitHub Copilot」プリセットを選び、「アカウント」で GitHub アカウントにログインするだけです。Claude Code ですでにログインした Copilot アカウントはそのまま使えます。Codex のルーティングをオンにする必要があります。Copilot ではモデルによって対応するプロトコルが異なるため、ローカルルーティングがモデルに応じて Responses か Chat Completions を自動で選びます。エディターの「上流フォーマット」で手動で指定することもできます。アカウントのプランによってコンテキストウィンドウが異なるため、プリセットはデフォルトで控えめな値を使います。「モデル一覧を取得」を押すと、お使いのアカウントの実際のウィンドウと推論レベルでモデルカタログを埋めます。
+
+**「すべて」のヒートマップで全履歴を見られるように。** これまでは期間で「すべて」を選んでも、ヒートマップには直近 53 週しか表示されませんでした。現在もデフォルトは直近 53 週ですが、「もっと見る」を押すと 53 週ごとに 1 段ずつさかのぼって並び、記録のある最初の日まで表示します。各段には期間、Token 数、リクエスト数、コストを表示し、段どうしで色の濃さをそのまま比較できます。
+
+## 修正
+
+- **Claude Code を Responses プロトコル経由で GPT にマッピングすると、サブエージェントが常に worktree に送られていた問題。** Claude Code がサブエージェントを呼び出すとき、「分離方式」と「モデル」は省略可能なパラメータですが、Responses プロトコルは明示されていないと省略可能なパラメータを必須として扱うため、モデルが毎回値を入れていました。その結果、サブエージェントが worktree で実行され、git リポジトリの外ではそのまま失敗したり、サブエージェント自身に設定したモデルが上書きされたりしていました。現在は変換時にこれらのパラメータが省略可能であることを明示します。Responses プロトコルを使うプロバイダーと ChatGPT アカウントの両方が影響を受けていましたが、どちらも修正しました。
+- **Codex の集約モードで、GLM などのモデルが `/model` に表示されなかった問題。** CC Switch はモデルカタログを生成するときに公式の gpt-5.5 エントリをテンプレートにしています。公式がこのエントリを非表示に設定したため、集約内のサードパーティのモデルもすべて一緒に非表示になっていましたが、集約の件数にはそれらが数えられたままでした。
+- **Codex の MoArk プリセットで、`/model` にモデルが 1 つしか表示されなかった問題。** プリセットにモデルカタログが含まれていなかったため、Codex はデフォルトのモデルしか表示していませんでした。現在は 5 つのモデルがすべて表示され、コンテキストウィンドウ、画像入力、推論レベルも付きます。すでに追加済みの MoArk プロバイダーは自動では更新されないため、プリセットからもう一度追加してください。
+- **Linux で deb、rpm からインストールした版で、アプリ内更新が権限不足と表示されていた問題。** これまで更新プログラムは deb、rpm のインストールを認識できず、AppImage と同じ方法で `/usr/bin` にファイルを書き込もうとしていました。現在は deb、rpm それぞれに専用の更新パッケージがあります。インストール済みの版では、先にこのバージョンを一度手動でインストールする必要があります。上の案内をご覧ください。
+- **Linux の Wayland で、タイトルバーの最小化、最大化、閉じるボタンを押しても反応しなかった問題。** 初めてウィンドウを開いたときや、トレイからウィンドウを開き直した後に、ボタンの上に見えない領域が重なっていました。
+- **Windows で MSI からアップグレードした後、タスクバーにピン留めしたアイコンが PC の再起動後に空白になっていた問題。** これまでショートカットはアップグレードのたびに削除されるアイコンキャッシュを指していましたが、現在はプログラム自体のアイコンを直接使います。以前ピン留めしたアイコンは、今回のアップグレード後にもう一度空白になることがあります。その場合はピン留めを外して、もう一度ピン留めしてください。今後のアップグレードでは起きなくなります。
+- **npm 12 で Claude Code をインストールすると実行できず、Windows では互換性のないプログラムと表示されていた問題。** npm 12 はデフォルトで Claude Code のインストールスクリプトを実行しないのに、インストール成功と表示し、残るのはプレースホルダーのファイルだけでした。現在は「アプリ」ページのインストールとアップグレード、そしてコピーできるインストールコマンドのすべてで、このインストールスクリプトの実行を許可します。
+- **ルーティングをオンにしていないとき、Grok Build の使用量が使用量統計に表示されるまで 10 分かかっていた問題**。現在は 1 分ほどで表示されます。
+
+**その他：**
+- ユーザーマニュアルと README を 4.0 の画面に合わせて更新しました。
+
+## アップグレードに関する注意
+
+**データベースの構造は変わっていません。** バージョンは 20 のままです。
+
+**Linux の deb、rpm をお使いの方は、このバージョンを手動でインストールしてください。** その後は通常どおり自動更新されます。
+
+**Windows をお使いの方**：アップグレード後にタスクバーにピン留めしたアイコンが空白になった場合は、ピン留めを外してもう一度ピン留めしてください。
+
+---
+
+## 謝辞
+
+[@ljie-PI](https://github.com/ljie-PI)（Codex の GitHub Copilot 対応、[@ump45nose](https://github.com/ump45nose) と共同）、[@SailingLoong](https://github.com/SailingLoong)（サブエージェントが worktree に送られないように）、[@cenglin123](https://github.com/cenglin123)（集約モードで GLM モデルが消える問題）、[@lcgash](https://github.com/lcgash)（MoArk のモデルカタログ）、[@Lingbou](https://github.com/Lingbou)（Linux の deb、rpm の自動更新）、[@Railgun-wiki](https://github.com/Railgun-wiki)（Wayland のタイトルバーボタン）、[@Besty0728](https://github.com/Besty0728)（Windows のタスクバーアイコン）、[@funkpopo](https://github.com/funkpopo)（npm 12 での Claude Code のインストール、MoArk プリセットのレビュー）の貢献に感謝します。
+
+同じ問題の修正や実装を提出してくださった [@Timetraps-x](https://github.com/Timetraps-x)、[@ggbdpq](https://github.com/ggbdpq)、[@c2519352073-star](https://github.com/c2519352073-star)、[@yukitakasama](https://github.com/yukitakasama)、[@liuziyuan](https://github.com/liuziyuan)、[@Suaig](https://github.com/Suaig) にも感謝します。
+
+問題の報告や提案をしてくださった [@WK-Apollo](https://github.com/WK-Apollo)、[@caoguanjie](https://github.com/caoguanjie)、[@kirkchinese](https://github.com/kirkchinese)、[@ZMKC404](https://github.com/ZMKC404)、[@sunwayking](https://github.com/sunwayking)、[@Vistonz](https://github.com/Vistonz)、[@van23qf](https://github.com/van23qf)、[@echoescheng](https://github.com/echoescheng)、[@xlht4106](https://github.com/xlht4106)、[@YueZhang2019](https://github.com/YueZhang2019)、[@hueifeng](https://github.com/hueifeng)、[@jingzhang94](https://github.com/jingzhang94) にも感謝します。
+
+技術的な詳細は [CHANGELOG](https://github.com/farion1231/cc-switch/blob/main/CHANGELOG.md) をご覧ください。

docs/release-notes/v4.0.5-zh.md

@@ -0,0 +1,49 @@
+# CC Switch v4.0.5
+
+### 4.0 正式版的第一个修复版本
+
+Codex 现在可以用 GitHub Copilot 账号了。用量统计的「全部」热力图不再只显示最近一年，可以一直往前看到第一天的记录。这个版本还修复了 Claude Code 经 Responses 协议映射到 GPT 时子代理总被派去 worktree、Codex 聚合模式下 GLM 等模型在 `/model` 里消失的问题，Linux 的 deb、rpm 安装包也能应用内更新了。4.0 完整的更新内容请见 [v4.0 发布说明](https://github.com/farion1231/cc-switch/blob/main/docs/release-notes/v4.0.4-zh.md)。
+
+> **Linux deb、rpm 用户请手动安装这一版。** 已经装好的 deb、rpm 版本还带着旧的安装类型标记，应用内更新到这一版仍会提示权限不足。手动下载安装一次 4.0.5 之后，以后就能正常自动更新。
+
+---
+
+## 新增
+
+**Codex 可以用 GitHub Copilot 账号。** 在 Codex 添加供应商时选「GitHub Copilot」预设，在「授权中心」登录 GitHub 账号即可；Claude Code 已经登录过的 Copilot 账号可以直接用。需要开启 Codex 的路由。Copilot 上不同模型支持的协议不一样，本地路由会按模型自动选择 Responses 或 Chat Completions，也可以在编辑器的「上游格式」里手动指定。不同账号等级的上下文窗口不同，预设默认取较保守的值，点「获取模型列表」会按你账号的实际窗口和推理档位填好模型目录。
+
+**「全部」热力图可以看完整历史。** 以前时间范围选「全部」时，热力图只显示最近 53 周。现在默认仍是最近 53 周，点「显示更多」会每 53 周一段往前排，一直到有记录的第一天；每段标出日期范围、Token 数、请求数和花费，各段的颜色深浅可以直接对比。
+
+## 修复
+
+- **Claude Code 经 Responses 协议映射到 GPT 时，子代理总被派去 worktree。** Claude Code 调用子代理时，「隔离方式」和「模型」是可选参数，但 Responses 协议在没有明确说明时会把可选参数当成必填，模型每次都会填上。结果子代理被派到 worktree 里运行，不在 git 仓库里就直接失败，或者子代理自己配置的模型被覆盖。现在转换时会明确声明这些参数可选。用 Responses 协议的供应商和 ChatGPT 账号都受影响，现在都修好了。
+- **Codex 聚合模式下，GLM 等模型在 `/model` 里看不到。** CC Switch 生成模型目录时会以官方的 gpt-5.5 条目为模板，官方把这个条目设为隐藏后，聚合里的第三方模型也跟着全被隐藏了，聚合计数却还在算它们。
+- **Codex 的模力方舟预设在 `/model` 里只有一个模型。** 预设没有带模型目录，Codex 只列出默认模型。现在 5 个模型都会列出来，并带上上下文窗口、图片输入和推理档位。已经添加的模力方舟供应商不会自动更新，需要重新从预设添加一次。
+- **Linux 上用 deb、rpm 安装的版本，应用内更新提示权限不足。** 以前更新器认不出 deb、rpm 安装，按 AppImage 的方式往 `/usr/bin` 里写文件。现在 deb、rpm 有了各自的更新包。已经装好的版本要先手动装一次这一版，见上方的提示。
+- **Linux Wayland 下，标题栏的最小化、最大化、关闭按钮点了没反应。** 第一次打开窗口时，或者从托盘重新打开窗口后，按钮上会盖着一层看不见的区域。
+- **Windows 用 MSI 升级后，任务栏上固定的图标在重启电脑后变成空白。** 快捷方式以前指向一个每次升级都会被删掉的图标缓存，现在直接用程序本身的图标。之前固定的图标在这次升级后可能还会变白一次，取消固定再重新固定一次就好，以后升级不会再出现。
+- **用 npm 12 安装 Claude Code 后无法运行，Windows 上提示程序不兼容。** npm 12 默认不运行 Claude Code 的安装脚本，却照样提示安装成功，留下的只是一个占位文件。现在「应用」页的安装、升级，以及可以复制的安装命令都会允许这个安装脚本运行。
+- **没开路由时，Grok Build 的用量要等 10 分钟才出现在用量统计里**，现在 1 分钟左右。
+
+**其他：**
+- 用户手册和 README 更新到 4.0 的界面。
+
+## 升级说明
+
+**数据库结构没有变化**，仍然是 20。
+
+**Linux deb、rpm 用户请手动安装这一版**，之后就能正常自动更新。
+
+**Windows 用户**：如果升级后任务栏上固定的图标变成空白，取消固定再重新固定一次即可。
+
+---
+
+## 致谢
+
+感谢 [@ljie-PI](https://github.com/ljie-PI)（Codex 接入 GitHub Copilot，与 [@ump45nose](https://github.com/ump45nose) 共同完成）、[@SailingLoong](https://github.com/SailingLoong)（子代理不再被派去 worktree）、[@cenglin123](https://github.com/cenglin123)（聚合模式下 GLM 模型消失）、[@lcgash](https://github.com/lcgash)（模力方舟模型目录）、[@Lingbou](https://github.com/Lingbou)（Linux deb、rpm 自动更新）、[@Railgun-wiki](https://github.com/Railgun-wiki)（Wayland 标题栏按钮）、[@Besty0728](https://github.com/Besty0728)（Windows 任务栏图标）、[@funkpopo](https://github.com/funkpopo)（npm 12 安装 Claude Code，以及模力方舟预设的审查）的贡献。
+
+感谢 [@Timetraps-x](https://github.com/Timetraps-x)、[@ggbdpq](https://github.com/ggbdpq)、[@c2519352073-star](https://github.com/c2519352073-star)、[@yukitakasama](https://github.com/yukitakasama)、[@liuziyuan](https://github.com/liuziyuan)、[@Suaig](https://github.com/Suaig) 为同样的问题提交了修复或实现。
+
+感谢 [@WK-Apollo](https://github.com/WK-Apollo)、[@caoguanjie](https://github.com/caoguanjie)、[@kirkchinese](https://github.com/kirkchinese)、[@ZMKC404](https://github.com/ZMKC404)、[@sunwayking](https://github.com/sunwayking)、[@Vistonz](https://github.com/Vistonz)、[@van23qf](https://github.com/van23qf)、[@echoescheng](https://github.com/echoescheng)、[@xlht4106](https://github.com/xlht4106)、[@YueZhang2019](https://github.com/YueZhang2019)、[@hueifeng](https://github.com/hueifeng)、[@jingzhang94](https://github.com/jingzhang94) 报告问题和提出建议。
+
+完整的技术细节请见 [CHANGELOG](https://github.com/farion1231/cc-switch/blob/main/CHANGELOG.md)。

src/whats-new/4.0.5.json

@@ -0,0 +1,33 @@
+{
+  "version": "4.0.5",
+  "items": [
+    {
+      "type": "new",
+      "zh": "Codex 可以用 GitHub Copilot 账号",
+      "zh-TW": "Codex 可以使用 GitHub Copilot 帳號",
+      "en": "Codex can now use a GitHub Copilot account",
+      "ja": "Codex で GitHub Copilot アカウントを使えるように"
+    },
+    {
+      "type": "fix",
+      "zh": "修复映射到 GPT 后 Claude Code 子代理总被派去 worktree",
+      "zh-TW": "修復對應到 GPT 後 Claude Code 子代理總被派去 worktree",
+      "en": "Fixed Claude Code sub-agents always sent to a worktree when mapped to GPT",
+      "ja": "GPT へのマッピング時にサブエージェントが常に worktree で動く問題を修正"
+    },
+    {
+      "type": "fix",
+      "zh": "修复 Codex 聚合模式下 GLM 等模型在 /model 里看不到",
+      "zh-TW": "修復 Codex 聚合模式下 GLM 等模型在 /model 中看不到",
+      "en": "Fixed GLM and other models missing from /model in Codex aggregation mode",
+      "ja": "Codex の集約モードで GLM などのモデルが /model に表示されない問題を修正"
+    },
+    {
+      "type": "new",
+      "zh": "「全部」热力图可以往前查看完整历史",
+      "zh-TW": "「全部」熱力圖可以往前查看完整歷史",
+      "en": "The all-time heatmap can now show your full usage history",
+      "ja": "「すべて」のヒートマップで過去の全履歴を表示できるように"
+    }
+  ]
+}