数命令数会数漏：294 个 Tauri 命令与一个 grep 陷阱
cc-switch 的 Tauri 命令到底有多少个？按属性宏严格匹配数出来是 275，把带参数的写法一起算才是 294，差的 19 条全来自 `rename_all = "camelCase"`。这篇给出三条互相独立的计数路径，说清这个陷阱还会在哪些地方原样复现，以及 294 这个数能说明什么、不能说明什么。
README 说「50+ 预设」，八个预设文件里数出来 448 条
CC Switch 的预设到底有多少条？README 三处写「50+」，用户手册的表格只列几十行，而 src/config/ 下八个应用预设数组加起来是 448 条。这篇把三层口径各自的位置标出来，给出可复现的计数方法与一个会数错的 grep 陷阱，并说清 448 这个数究竟在数什么、不在数什么。
三个平台怎么装：msi / dmg / AppImage 与 brew、paru 的取舍
CC Switch 在 Windows、macOS、Linux 上各有两到三种安装方式。这篇按 README 与用户手册的原文把产物文件名、包管理器命令、系统要求逐条列清，重点标出一处会让你比对文件名时对不上的口径差：README 给的 Linux 包名没有架构后缀，而 CI 脚本拼出来的名字带架构。
README 说八个、用户手册只列七个：支持工具清单的三处口径差
CC Switch 到底管几个 AI CLI 工具？README 四处写「八个」，用户手册的三张清单都只有七个，而 package.json 与 Cargo.toml 的 description 只写了三个。这篇把三处口径的文件与行号标出来，给出可自己复核的比对动作，并说清为什么查「我的工具支不支持」不能只看标题行。
README 写 Rust 1.85+ 而 toolchain 钉的是 1.95：四条版本门槛的两层口径
想从源码构建 CC Switch，README 的「环境要求」给了 Node.js 18+、pnpm 8+、Rust 1.85+、Tauri CLI 2.8+ 四条。但这四条在仓库里各有第二个出处，其中三条对不上：Rust 在同一个仓库的两个文件里差了十个小版本。本文标出每一处的文件与行号，并给出可复现的比对动作。
测速的超时钳制：2 / 8 / 30 秒这三个数是怎么用的
CC Switch 的端点测速在源码里写死了三个常量：最小 2 秒、默认 8 秒、最大 30 秒。它们不是三档可选值，而是一个用 clamp 夹住的区间。这篇把三个常量所在的行、钳制发生的位置、以及「一次测速其实发两次请求」这件事讲清楚，并说明它们和代理转发的那套超时、和连通性检查的 8 秒是三套互不相干的配置。
27 个日志错误码与错误到 HTTP 状态的映射表
CC Switch 本地代理有两套互不重合的错误坐标系：`log_codes.rs` 里 27 个日志错误码打在日志文本里，`error_mapper.rs` 把内部错误折成十来个 HTTP 状态码返给客户端。这篇把两张表都摊开，说清为什么好几种完全不同的失败在客户端看来都是同一个 503，以及排查时该从哪一头往回查。
本地代理模式做什么：一条请求经过的完整管线
CC Switch 的本地代理不是把请求原样转出去。这篇按源码顺序把一条请求走过的每一站拆开：TCP 层为什么要在 hyper 解析前 peek 8192 字节、25 条路由为什么一个能力挂四个路径、请求体被加工过哪几道、响应回程怎么解压与计时、用量最后落在哪张表，并给出可自己复现的核查路径。
`ccswitch://` 一键导入：四类载荷与解析器的边界
CC Switch 的 ccswitch:// 深链只有一条固定骨架，但 provider / prompt / mcp / skill 四类载荷的参数契约互不相同。这篇把解析器每一道校验落到源码行号上，说清哪些参数要 Base64、用户手册与代码的四处口径差在哪，并给出你自己复核的方法。
模型定价表的三层来源与本地覆盖
CC Switch 算出来的那个花费数字，价格是从哪查到的？内置种子 189 条、修价表 34 条、本地覆盖文件三层各管一段，而最反直觉的一处是本地文件刻意不存全量。本文标出每一层的文件与行号，说清 INSERT OR IGNORE 为什么逼出第二张表，并给出可自行复现的核查动作。
CC Switch 后端四层：Commands → Services → DAO → Database 各自管什么
cc-switch 的 README 把后端画成 Commands → Services → DAO → Database 四层。我们按仓库快照逐目录核对了这四层的文件数、行数与职责边界，并指出「DAO 层其实不是一个对象」「箭头有一处是反向的」这两处容易读错的地方，以及注释目录树与实际模块数对不上的一处差异。
`category` 不只是个标签：它同时决定 UI 分组、路由判定和代理接管拦截
CC Switch 的预设里有个 category 字段，看着像给界面分组用的标签，实际上它在三个地方被当成开关读：分类筛选、providerNeedsRouting 的第一行早退、以及代理接管下的切换拦截。这篇给出八个取值的语义、八个应用的分类分布，并落到五条没填 category 的预设上，附可自己复现的计数方法。
格式转换层落在哪：三套协议适配器的位置与边界
CC Switch 的本地代理要同时伺候八个 AI CLI，但适配器只有 Claude、Codex、Gemini 三套实现。这篇把「协议转换」这件事在代理管线里拆成五段，指出真正调用适配器的那一行、它是按供应商而不是按工具开关的、以及三个 transform 大文件里我们没读到的部分，给出你自己就能跑一遍的核查动作。
「切回官方登录」是怎么实现的：CC Switch 里 official 类预设的机制
切回官方账号听上去像要写入一份官方配置，但在 CC Switch 的源码里恰恰相反：official 预设是一份刻意留空的配置，切过去之后还要专门擦掉残留的第三方凭据。本文按仓库快照逐处标出这套机制落在哪些文件的哪几行。
故障转移怎么挑下一家：候选队列与「忽略当前供应商」
CC Switch 的本地代理开启故障转移后，选下一家的依据不是「当前供应商失败了再找备胎」，而是完全按故障转移队列从头走一遍，当前供应商本身不参与起点判定。这篇把 provider_router.rs 的两条互斥分支、熔断器被问两次的不同语义、尝试次数上限与切换落盘的四道闸门逐行标出来，并给出可自行复现的核查路径。
想系统学会用 AI，或把 AI 落地到业务？
报名体系课、加入会员，或让我们陪你把 AI 数字员工搭起来。