企业官网建设流程全解析

CC Switch v4.0.19 升级指南：第 12 个应用 Kimi Code 接入与用量页重排的完整说明

【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode,DeepSeek Harness and more. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch

CC Switch v4.0.19 于 2026-10-23 发布，45 个提交改动了 206 个文件（合计 +15661 / -2347 行），最大的变化是 Kimi Code 正式成为受管应用，同时用量统计页换了一套全新排版。如果你在用 Kimi Code 的命令行版或桌面版，或者之前在聚合模式里被unsupported call: exec报错坑过，这版值得直接升级。

这一版改了什么

三步给 Kimi Code 添加多个供应商

定位：Kimi Code（命令是kimi）的用户受益，CLI 与桌面版共用同一份配置，改一处两边生效。

变化：供应商以原生[providers]/[models]条目写进~/.kimi-code/config.toml（设置了KIMI_CODE_HOME时以该目录为准），其他节点、环境变量与 OAuth 引用原样保留，多个供应商可同时启用。添加表单按「模型厂商 / 第三方平台 / 云服务商 / 本地 / 账号登录」五组给预设，「获取模型列表」后选中模型会自动填上下文窗口、思考档与图片输入。写入逻辑见 Kimi Code 配置。

上手：

1. 进 Kimi Code 应用页，点「添加供应商」，选一组预设；
2. 点「获取模型列表」，勾选模型，参数自动补全；
3. 点「添加」写入配置；「设为默认」在卡片更多菜单里。

边界与坑：

• ⚠️「添加」只写配置，不会改动默认模型；
• ⚠️ 正被用作默认或子代理模型的供应商删不掉，要先换掉；
• 每个模型可单独填显示名称，/model里显示的就是它；
• Kimi Code 不走本地路由与聚合模式，直连供应商自己的端点。

认证中心绑定多个 Kimi 官方账号

定位：持有 Kimi 官方订阅、尤其是有多个账号的人，可以在这一个入口切换。

变化：认证中心点「登录 Kimi」，选国内版或海外版，在浏览器完成设备码授权；Kimi Code 里已登录的号会自动出现。第一个账号占用 Kimi Code 自己的登录槽位managed:kimi-code，之后的账号各有独立凭据文件、供应商节点与模型别名（kimi-code-ccs-<hash>形态），模型选择器里显示为「Kimi 订阅 <昵称>」。

上手：

1. 认证中心点「登录 Kimi」，选版本，浏览器完成授权；
2. 核对账号卡片上的昵称与额度；
3. 点「使用此账号」，默认模型即切到该账号。

边界与坑：

• ⚠️ 官方订阅绑定复用 Kimi 自己的 OAuth 登录，账号可能被限制，风险自负；
• ⚠️ 官方卡片只能在认证中心管理，供应商页里编辑、删除均不可用；
• 快过期的登录后台续期，与 Kimi Code 共用oauth/下的槽位锁，互不抢占；
• Windows 上只读额度，不代写凭据；
• ⚠️ 删除单独添加的账号会连带删掉其供应商、模型与凭据，正在使用时拒绝删除。

看懂用量统计页的新布局

定位：所有用户，打开即是新布局，没有开关可退回旧版。

变化：时间、应用、供应商、模型排在同一行，供应商与模型合成一个两级联动菜单；概览里点选任意指标，趋势图与热力图随之切换，输入、输出、缓存读写四项 Token 可展开成第二行。旧的「设置」页签被直接删除，数据来源、显示、价格设置全收进设置弹层。详见 用量统计文档。

上手：

1. 在筛选行选时间范围与应用、供应商、模型；
2. 概览中点一个指标，图表即跟随切换；
3. 请求日志页选每页 10 / 20 / 50 条，默认 20 并会记住；
4. 列的显隐在「请求日志的列」菜单里选。

边界与坑：

• ⚠️ 旧「设置」页签没了，升级后到弹层里核对价格配置；
• 明细区只剩「请求日志 / 供应商 / 模型」三个页签，标签带数量；
• 表格过宽时横向滚动，时间与应用两列钉在左侧，空格显示「—」；
• ⚠️ 「近 7 / 14 / 30 天」现按日历日起算，横跨夏令时切换的区间与旧版有 1 天级别出入，属修正。

聚合模式unsupported call: exec报错修复

定位：聚合模式下从第三方 GPT 行切到其他模型行的 Codex 用户，此修复无需任何操作。

症状：从第三方 GPT 行切到 DeepSeek、Kimi 等行后，Codex 每一轮都报unsupported call: exec。

成因：这两类行以前共用同一个comp_hash，跨协议切换时 Codex 跳过历史压缩，新模型照抄了历史里它不认识的工具调用记录。

解法：现在按工具协议分组——直连行保留cc-switch，聚合行走cc-switch-<tool_mode>（实现见 codex_config.rs），跨协议切换时先用原模型压缩一次历史再切。

边界与坑：

• 同协议内的切换照旧不压缩；
• 直连与路由模式不受影响；
• ⚠️ 暂时无法升级的话，留在第三方 GPT 行工作可绕过。

其余改动一览

升级操作路径

1. 确认当前数据库版本。升级前为 21 版，本次自动升到 22 版，mcp_servers与skills表各加一个enabled_kimi列，升级前会自动备份数据库。
2. 记下关键信息：Kimi 各账号的昵称与默认模型、旧用量页配过的数据来源与价格。
3. 安装 v4.0.19 制品（各平台文件见下一节）。
4. 启动应用，让数据库迁移完成。
5. 按下述清单逐项验证。

需要核对的事项：

• 升级前数据库是 21 版，且备份文件已生成
• ⚠️ 本版运行过一次后，旧版本会拒绝打开 v22 数据库——回退必须先还原该备份
• 不用 Kimi Code 的话，去「应用」页关掉「在侧栏显示 Kimi Code」
• 旧「设置」页签里的数据来源与价格配置已在设置弹层中核对
• 聚合模式跨协议切换时，首次切换触发一次历史压缩属预期行为
• 多个 Kimi 官方账号的绑定关系与额度显示已在认证中心核对

安装与校验

brew install --cask cc-switch # 或 brew upgrade --cask cc-switch sudo apt install ./CC-Switch-*.deb

装完打开「设置 → 关于」，版本号应显示 4.0.19，「近期更新」里能看到本版本摘要，即表示升级生效。

相关资源

• 本版本发布说明：docs/release-notes/v4.0.19-zh.md
• 添加供应商：docs/user-manual/zh/2-providers/2.1-add.md
• 安装指南：docs/user-manual/zh/1-getting-started/1.2-installation.md
• Kimi Code 接入源码：src-tauri/src/kimi_config.rs

本版由 @funkpopo（Kimi Code 全链路与官方账号）、@94mashiro（用量统计页重排）、@AkimioJR（MCP 显示名称）、@minimote（会话分组标题）、@StrengW（Codex 会话请求头）、@clarkchen（百炼模型列表）、@allenxu09（钥匙串条目修复）等外部贡献者参与完成。

CC Switch 完全免费开源，唯一官网为 ccswitch.io——任何收费、要求充值或索取登录凭据的「CC Switch」网站与客户端均为假冒。

【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode,DeepSeek Harness and more. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch