diff --git a/docs/release-notes/v4.0.0-en.md b/docs/release-notes/v4.0.0-en.md
index 11e777d85..223068f90 100644
--- a/docs/release-notes/v4.0.0-en.md
+++ b/docs/release-notes/v4.0.0-en.md
@@ -12,7 +12,7 @@ The interface has been redesigned from the sidebar to the tray, giving apps, con
The new interface uses a sidebar layout and an orange theme. Switching apps, plus global features like MCP, Skills, Prompts, Sessions, Accounts and Usage, are all one click away in the sidebar.
-
+

- **Modes at a glance**: Every app page has three tabs at the top: Direct / Routing / Aggregation. Clicking a tab only changes what you're looking at and never touches your config. The button that actually switches modes tells you what will happen, and going back to Direct takes one step and can be undone
- **A home for your tools**: The new Apps page shows each AI coding tool's version, install location and source, with install, upgrade and batch upgrade
@@ -21,7 +21,7 @@ The new interface uses a sidebar layout and an orange theme. Switching apps, plu
- **Tray organized by app**: Each row reads "name · mode · provider · quota", and submenus list only the providers you can switch to right now. The tray icon shows a dot only when something really needs your attention
- **Settings grouped by purpose**: General, App config, Local routing, Network, Data, About. Local routing's service status, listen address and failover settings now live in one place
-
+
Upgrading users see a short note on first launch explaining where things have moved.
@@ -33,7 +33,7 @@ Until now, using another provider's model meant going back to CC Switch, switchi
Turn on **Aggregation**, add a few providers, and their models all show up together in the Claude Code or Codex model picker. Whichever model you pick, the request goes straight to that provider, without ever leaving the client.
-
+
- **Add and remove anytime**: Click "Add" or "Remove" on a provider card, then choose one provider as the default to handle requests that don't name an aggregated model
- **Know every model at a glance**: Each model name carries its provider, like "Kimi K3 (Kimi For Coding)", and its description shows the real upstream model ID and context window, like `kimi-k3 · 256K`
@@ -42,7 +42,7 @@ Turn on **Aggregation**, add a few providers, and their models all show up toget
- **Switch models mid-session**: You can change to another model partway through a session. Note that after each switch, the new model has to build its prompt cache again, so the first turn after switching costs noticeably more
- **Restart reminders**: When the model list changes you're prompted to restart the client, and Codex CLI users can restart the background service from the banner in one click
-
+
Aggregation is opt-in and currently supports Claude Code and Codex. It routes each request by the model you pick, and does not offer failover.
@@ -64,7 +64,7 @@ Aggregation is opt-in and currently supports Claude Code and Codex. It routes ea
AI coding tools keep a complete record of every session on your machine, but the raw logs are thousands of lines of JSON and nearly impossible to read. This release rewrites session management from scratch to make those records as readable as possible, and adds token usage and cost for each session.
-
+
- **Nine clients, one way to read them**: Sessions from Claude Code, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw, Hermes, Pi and MiniMax Code are parsed into structured content, with text, thinking, tool calls, tool results and images each shown in their own form
- **One turn, one summary line**: A long run of AI actions folds into a single line, such as "Steps · 44 · 27 commands · 2 files changed · 1 failed · 27m45s". Failed commands are marked in red, and expanding one shows its parameters, output and exit code. Runs of file reads and searches merge into "Read N files, searched N times"
@@ -112,7 +112,7 @@ Turning routing on or off no longer relies on backing up and restoring your whol
**The Usage page** has redesigned metrics, a trend chart, a request log, and four paginated tables for providers, models and pricing. A new "All" time range shows your daily usage as a 53-week heatmap, and wide-range queries no longer freeze the window.
-
+
**Output speed** is now measured over generation time only, without the wait for the first token. Even without routing, requests imported from Claude Code and Codex session logs get an estimated speed, marked with "≈".
diff --git a/docs/release-notes/v4.0.0-ja.md b/docs/release-notes/v4.0.0-ja.md
index d02328741..f334aa257 100644
--- a/docs/release-notes/v4.0.0-ja.md
+++ b/docs/release-notes/v4.0.0-ja.md
@@ -12,7 +12,7 @@ CC Switch 史上最大規模のアップデートです。今回は、モデル
新しい画面はサイドバーレイアウトとオレンジのテーマを採用しています。アプリの切り替えに加え、MCP、Skills、プロンプト、セッション、アカウント、使用量といった共通機能にも、サイドバーから直接移動できます。
-
+
- **モードがひと目でわかる**:各アプリページの上部に「直接接続 / ルーティング / 集約」の 3 つのタブがあります。タブを押しても表示が切り替わるだけで、設定は変わりません。実際にモードを切り替えるボタンには何が起きるかが書かれており、直接接続へはワンステップで戻れて、元に戻すこともできます
- **ツールの居場所ができました**:新しい「アプリ」ページで、各 AI コーディングツールのバージョン、インストール場所、入手元をまとめて確認でき、インストール、アップグレード、一括アップグレードもここから行えます
@@ -21,7 +21,7 @@ CC Switch 史上最大規模のアップデートです。今回は、モデル
- **アプリごとに整理したトレイ**:各行に「名前 · モード · プロバイダー · 利用枠」を表示し、サブメニューには今切り替えられるプロバイダーだけを並べます。トレイアイコンのドットは、本当に対応が必要なときだけ表示されます
- **用途別の設定**:一般、アプリ設定、ローカルルーティング、ネットワーク、データ、情報に分類しました。ローカルルーティングのサービス状態、待ち受けアドレス、フェイルオーバー設定も 1 か所にまとまっています
-
+
既存ユーザーには、初回起動時に主な機能の移動先を説明する短い案内が表示されます。
@@ -33,7 +33,7 @@ CC Switch 史上最大規模のアップデートです。今回は、モデル
**集約**モードをオンにしてプロバイダーをいくつか追加すると、それぞれのモデルが Claude Code や Codex のモデル選択画面にまとめて表示されます。選んだモデルに応じてリクエストがそのプロバイダーへ直接送られるので、クライアントから離れる必要はありません。
-
+
- **いつでも追加・削除**:プロバイダーカードの「追加」「削除」を押すだけです。さらに 1 社をデフォルトプロバイダーに選ぶと、集約モデルを指定していないリクエストはそこへ送られます
- **モデルをひと目で見分けられる**:モデル名の後ろには提供元のプロバイダーが付き(例:「Kimi K3(Kimi For Coding)」)、説明には上流の実際のモデル ID とコンテキストウィンドウ(例:`kimi-k3 · 256K`)が表示されます
@@ -42,7 +42,7 @@ CC Switch 史上最大規模のアップデートです。今回は、モデル
- **同じセッション内でモデルを変更**:セッションの途中で別のモデルに切り替えられます。ただし切り替えるたびに新しいモデルでプロンプトキャッシュを作り直すため、切り替え直後の 1 ターン目は料金が明らかに高くなります
- **再起動のお知らせ**:モデル一覧が変わるとクライアントの再起動を促します。Codex CLI はバナーからワンクリックでバックグラウンドサービスを再起動できます
-
+
集約は手動でオンにする機能で、現在は Claude Code と Codex に対応しています。選んだモデルごとにリクエストを振り分ける仕組みのため、フェイルオーバーはありません。
@@ -64,7 +64,7 @@ CC Switch 史上最大規模のアップデートです。今回は、モデル
AI コーディングツールは各セッションの記録をローカルに丸ごと保存していますが、元の記録は何千行もの JSON で、そのまま読むのはほぼ不可能です。今回のバージョンではセッション管理をゼロから書き直し、記録をできる限り読みやすくしたうえで、トークン使用量と料金の集計も加えました。
-
+
- **9 つのクライアントを同じ読み方で**:Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code の記録を構造化して解析し、本文、思考、ツール呼び出し、ツール結果、画像をそれぞれの形で表示します
- **1 ターンの作業を 1 行に要約**:AI の長い一連の操作を「実行過程 · 44 ステップ · コマンド 27 件 · 2 ファイルを変更 · 1 件失敗 · 27m45s」のように 1 行にまとめます。失敗したコマンドは赤で表示され、展開すると引数、出力、終了コードを確認できます。ファイルの読み込みや検索が続く部分は「N ファイルを参照、N 回検索」にまとめられます
@@ -112,7 +112,7 @@ CC Switch を公開した 2025 年 8 月当時、API のエコシステムは今
**使用量ページ**では、指標、トレンドグラフ、リクエストログ、そしてプロバイダー、モデル、料金の各統計表を作り直し、すべてページ送りに対応しました。新しい「すべて」の期間では、53 週分のヒートマップで日ごとの使用量を表示します。広い範囲の集計でも、ウィンドウが固まらなくなりました。
-
+
**出力速度**は、最初のトークンまでの待ち時間を除いた生成時間だけで計算するようになりました。ルーティングを使っていなくても、Claude Code や Codex のセッションログから取り込んだリクエストには推定速度が「≈」付きで表示されます。
diff --git a/docs/release-notes/v4.0.0-zh.md b/docs/release-notes/v4.0.0-zh.md
index f606bd8f8..1a86edfd1 100644
--- a/docs/release-notes/v4.0.0-zh.md
+++ b/docs/release-notes/v4.0.0-zh.md
@@ -12,7 +12,7 @@
新界面采用侧边栏布局和橙色主题。应用切换,以及 MCP、Skills、提示词、会话、授权中心、用量统计这些全局功能,都可以从侧边栏直接进入。
-
+
- **模式一目了然**:每个应用页的顶部是「直连 / 路由 / 聚合」三个标签。点标签只切换查看的内容,不会改动配置;真正切换模式的按钮会写明会发生什么,回到直连只需一步,还能撤销
- **工具有了自己的家**:新的「应用」页集中显示每个 AI 编程工具的版本、安装位置和来源,支持安装、升级和批量升级
@@ -21,7 +21,7 @@
- **托盘按应用重新组织**:每行显示「名称 · 模式 · 供应商 · 额度」,子菜单里只列出当前能切换的供应商。只有真正需要你处理时,托盘图标才显示提醒点
- **设置按用途分组**:通用、应用配置、本地路由、网络、数据、关于。本地路由的服务状态、监听地址和故障转移参数都集中在一处
-
+
老用户第一次打开新版时,会看到一次简短的说明,告诉你常用功能搬到了哪里。
@@ -33,7 +33,7 @@
现在开启**聚合**模式,把几家供应商添加进来,它们的模型会同时出现在 Claude Code 或 Codex 的模型选择器里。选哪个模型,请求就发给哪一家,不用离开客户端。
-
+
- **随时添加和移除**:在供应商卡片上点「添加」或「移除」。再选一家作为默认供应商,没有指定聚合模型的请求都交给它
- **一眼认出模型**:每个模型名后面都标着来自哪家供应商,比如「Kimi K3(Kimi For Coding)」;说明里还会写出上游真实的模型 ID 和上下文窗口,比如 `kimi-k3 · 256K`
@@ -42,7 +42,7 @@
- **同一会话里换模型**:可以在一个会话中途换用其他模型。注意每次切换后,新模型都要重新建立提示词缓存,切换后的第一轮费用会明显高一些
- **重启提醒**:模型列表变化后会提示重启客户端,Codex CLI 可以在横幅里一键重启后台服务
-
+
聚合需要手动开启,目前支持 Claude Code 和 Codex。它按你选的模型分发请求,不提供故障转移。
@@ -64,7 +64,7 @@
AI 编程工具会把每次会话完整地记在本机,但原始记录是成千上万行 JSON,几乎没法直接读。这一版我们从头重写了会话管理,让会话记录尽可能地易读,同时添加了用量和消耗金额统计。
-
+
- **九个客户端,同一种读法**:Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code 的记录都解析成结构化内容,正文、思考、工具调用、工具结果和图片各自呈现
- **一轮工作,一行摘要**:AI 的一长串操作折叠成一行,比如「执行过程 · 44 步 · 27 个命令 · 改了 2 个文件 · 1 个失败 · 27m45s」。失败的命令标成红色,展开就能看到参数、输出和退出码;连续读文件、搜索这类步骤会合并成「查看了 N 个文件、搜索 N 次」
@@ -112,7 +112,7 @@ CC Switch 发布于 2025 年 8 月,那个时候 API 的生态远没有现在
**用量页**重新设计了指标、趋势图、请求日志,以及供应商、模型、定价四张统计表,都支持分页。新增「全部」时间范围,用 53 周热力图显示每天的用量。大范围统计时,窗口不再卡顿。
-
+
**输出速度**改为只按生成时间计算,去掉了首字等待。即使没开路由,从 Claude Code、Codex 会话日志导入的请求也能显示估算速度,用「≈」标记。