README 说八个、用户手册只列七个：支持工具清单的三处口径差

2026-08-10

在 cc-switch 仓库里问一句「这东西到底管几个工具」，你会拿到三个不一样的答案：README 说八个，用户手册的清单只有七个，而 package.json 的 description 字段只写了三个。

三个数都在同一份仓库快照里，都能翻到具体行。这篇不去猜哪个「才算数」——按我们的纪律，把差异说完就停。有用的部分在后面：这个仓库里根本不存在一份统一的「支持工具清单」，八、七、三之外，功能条目自己列的覆盖范围还有 6、5、4、3 好几种。你要判断自己那个工具能不能用上某个功能，得知道去哪一层查。

以下全部基于我们本地 clone 的 cc-switch 仓库快照 c39c903（提交日期 2026-08-10），仓库内版本号 3.19.2。我们只读源码与文档文本，没有安装也没有运行过这个桌面应用。

第一层：README 的八个，出现在四处

中文 README_ZH.md 里「八个」这个口径至少出现在四个位置，每一处都把八个工具逐个列了出来：

README_ZH.md:5，标题下的定位行，写的是「Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 和 Hermes Agent 的全方位管理工具」
README_ZH.md:205，卖点行「一个应用，八个工具」，同样这八个
README_ZH.md:225，功能特性节的「8 个支持工具，50+ 预设」（这里的「50+ 预设」是 README 自称的数字，预设的实际条目数我们另有篇目专门统计，本篇不用它）
README_ZH.md:260，FAQ 第一条「CC Switch 支持八个工具」，再列一遍

英文 README 是同一口径：README.md:204 写 “One App, Eight Tools”，README.md:224 写 “8 supported tools, 50+ presets”。

也就是说，README 侧不是某一处笔误，八这个数在中英文、在卖点和 FAQ 里是一致的。

第二层：用户手册的三张清单，都是七个

差异出现在 docs/user-manual/zh/ 下。1.1 那篇的开头一句（1.1-introduction.md:5）把受管应用写成 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes，七个；同一篇的「支持的应用」表（1.1-introduction.md:41-49）逐行列的也是这七个。

再往后翻，同样的七个又出现了两次：

1.3 那篇讲应用切换器，正文列表（1.3-interface.md:22-28）与更上面那行概述（1.3-interface.md:14）都是七项
1.5 的「应用可见性」写「可配置的应用」（1.5-settings.md:86），也是这七个

三张清单彼此一致，与 README 的差别是同一个：没有 Grok Build。Claude Desktop 在两边都在，Hermes 在两边都在，缺的只有这一项。

同一份 1.5 里还有一张更短的：本地环境检查表（1.5-settings.md:328-335），只有六行。旁边的「CLI 工具目录」设置表（1.5-settings.md:123-132）同样是六行，给出各自的默认目录 ~/.claude/、~/.codex/、~/.gemini/、~/.config/opencode/、~/.openclaw/、~/.hermes/，改目录后需要重启应用。

第三层：包元数据里只有三个

第三个数字藏在最不起眼的地方。package.json:4 的 description 是：

All-in-One Assistant for Claude Code, Codex & Gemini CLI

src-tauri/Cargo.toml:4 的 description 与它逐字相同。这两处元数据会跟着包一路走到构建产物里，写的是三个工具。

至此三层齐了：README 八个、用户手册七个、包元数据三个。三处的位置我们都标了文件与行号，你可以自己去核。哪一处「才是对的」、为什么会这样，本文不做推断，也不拿它去评价这个项目。

反直觉的那一处：清单本来就不止一份

真正值得花时间的不是「七还是八」，而是：即便你认下 README 的八个，仓库里也没有任何一个功能是按八个全覆盖来写的。README 自己的功能特性节，几乎每条都另带一个更小的集合：

README 里的功能条目	自列的覆盖范围	位置
统一 MCP 面板	6 个：Claude、Codex、Gemini、Grok Build、OpenCode、Hermes	`README_ZH.md:236`
应用级代理接管	4 个：Claude、Codex、Gemini、Grok Build	`README_ZH.md:232`
通用供应商	3 个：Claude Code、Codex、Gemini CLI	`README_ZH.md:226`

用户手册那侧同样如此。1.4 讲切换后怎么生效，那张表（1.4-quickstart.md:35-39）只有五行，Claude Desktop、Grok Build、Hermes 三个在这张表里没有出现；表里 Gemini 被标成「即时生效（每次请求重新读取配置）」。

这张五行表和 README 的说法也对不上：README 快速开始那段写的是「重启终端或对应的 CLI 工具（Claude Code 无需重启）」（README_ZH.md:337），把 Gemini 也归到需要重启的那一类；手册的表把 Gemini 单独标成即时生效。README 的 FAQ 第二条是同一个口径，说大多数工具切换供应商后需要重启终端或 CLI，例外只有 Claude Code，「目前支持供应商数据的热切换，无需重启」（README_ZH.md:265-267）。同样，两处差异照实记下来就行，哪个更贴近实际运行结果，我们没装过，不做判断。

所以这张表的读法是：「支持某个工具」和「某个功能覆盖某个工具」是两件事。 你关心的如果是 MCP 管理，那就得看 6 那一行；你关心的是本地代理接管，那是 4 那一行；你关心的是一份配置同步过去，那是 3 那一行。拿标题行的「八个」去推断某个具体功能对你那个工具可用，中间是缺一步的。

你自己怎么把这几个数核一遍

不用装软件，clone 下来读文本就够。四个动作：

数 README 的口径。 打开 README_ZH.md，直接看第 5、205、225、260 这四行，确认八个工具的名字逐个列全。英文侧对照 README.md:204 与 README.md:224。
数手册的口径。 打开 docs/user-manual/zh/1-getting-started/1.1-introduction.md，看第 5 行那句和 41-49 行那张表；再看 1.3-interface.md:22-28 与 1.5-settings.md:86。三处是不是都七个、缺的是不是同一项，一眼可辨。
在手册目录里搜那个缺失项。 在 docs/user-manual/zh/1-getting-started/ 下搜 Grok，把命中位置与 README 第 5 行的清单摆在一起比。搜不到，就说明这层文档没覆盖它；搜到了，就看它出现在什么语境。这一步的价值在于：你验证的是「这份文档有没有讲」，而不是「这个功能存不存在」，两者别混。
看包元数据。 package.json:4 与 src-tauri/Cargo.toml:4 各一行，确认两处是否逐字相同、写的是几个工具。

四步做完，你手上就是三层口径的一手证据，而不是转述。

什么情况说明不是这个问题

有几种情形，看起来像「清单口径差」，其实不是，别往这上面归因：

你在应用里没看到某个工具，但手册和 README 都列了它。 那和文档清单无关——手册 1.5 有「应用可见性」这个设置项，能配置的就是上面那七个应用（1.5-settings.md:86）；README FAQ 那条讲「最小侵入性」时也写了，不常用的应用可以在设置里关掉显示（README_ZH.md:290）。先去看这个设置，别去翻文档差异。
某个功能对你那个工具不生效。 先回到上面那张覆盖范围表，看这个功能自己列的集合里有没有它。功能覆盖面小于工具总数，是 README 功能条目原文就写明了的，不是清单口径差造成的。
你读的不是这一版。 我们比对的是 2026-08-10 的 c39c903 快照、版本 3.19.2（版本号在 package.json:3、src-tauri/Cargo.toml:3、src-tauri/tauri.conf.json:4 三处一致）。文档清单是随版本变动的内容，你重新 clone 之后，以自己数出来的为准。

一点分寸

这篇从头到尾只做了一件事：把同一件事在三层文档里的不同写法，连同文件与行号一起摆出来，再给出你自己复核的路径。至于哪一层「才算数」、差异是怎么来的，我们不推断；这几处差异也不构成对这个项目的任何评价。

顺带说明本文的边界：我们没有安装过这个桌面应用，所以文中所有内容都是仓库里的文本，不涉及它跑起来是什么样。另外，CC Switch 会读写 ~/.claude、~/.codex 这些真实的 CLI 配置目录并在本机保存 API Key，这属于本机敏感数据，怎么放置与备份请结合你自己的环境评估。关于预设条目数、数据落盘细节这些话题，我们另有专门的篇目在讲，这里不展开。

本文依据 CC Switch 官方仓库（github.com/farion1231/cc-switch）的 README、docs/ 下的用户手册与发布说明、 src/config/ 的预设定义与 src-tauri/src/ 的后端源码整理，核对日 2026-08-10，对应仓库快照 c39c903。本文内容为仓库源码与文档口径，我们没有安装或运行过这个桌面应用，因此不涉及界面外观、操作手感与切换速度的任何描述。文中出现的阈值与默认值均为源码中的默认配置，不构成对实际运行结果的保证。该项目仍在快速迭代，版本与默认值随时可能变动，请以仓库最新内容为准。

安全相关做法请结合自身环境评估，本文不构成安全方案建议。