企业官网建设流程全解析

CC Switch v4.0.20 升级指南：13 个 AI 编程工具的供应商一次管完

【免费下载链接】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.20（2026-10-24 发布）把 Oh My Pi 纳入为第 13 个受管应用，托管 ChatGPT 账号新增浏览器登录。用omp或有多个 Kimi 官方账号的用户应立刻升级；只单一供应商使用 Claude Code 或 Codex 的，可以等下一版。

先看 v4.0.20 改了什么

本版共 37 commits、198 个文件变更（+11737/-3046 行），核心是三件事：Oh My Pi（命令omp）的供应商、MCP、Skills、提示词与会话全链路接入；「应用」页拆成已安装/未安装两组并支持拖拽排序；托管 ChatGPT 账号可用浏览器登录。数据库 schema 从 22 升到 23，升级前自动备份。

升级决策：按场景对号入座

• Oh My Pi（omp)用户：必升。此前~/.omp/agent/models.yml只能手改，现在多供应商共存写入、MCP/Skills/提示词/会话全接入。
• Kimi 官方账号用户：建议升。官方卡片可以编辑模型、从 Kimi Code 移除；无套餐账号显示「未订阅」而不是空白。
• 企业工作区禁用设备码登录的 ChatGPT 用户：必升。浏览器登录（授权码 + PKCE）是唯一入口。
• Linux 上开启「应用级窗口按钮」的用户：建议升。修复页头拖不动窗口、边缘无缩放光标（#8091）。
• DeepSeek 余额清零后看到「套餐已过期」、Skills 更新一直 429 的用户：建议升，两者均已修复。
• 与上述都无关的单供应商用户：可缓。本版是纯增量功能，无破坏性改动。

Oh My Pi：三步接入供应商管理

怎么操作

1. 侧栏底部进「应用」页，点 Oh My Pi 一行的「安装」（官方安装脚本：有 Bun 走 Bun，否则下官方二进制）。
2. 安装后侧栏出现 Oh My Pi，点进「添加供应商」，表单与 Pi 共用，预设来自 Pi 目录。
3. 「获取模型列表」后在弹窗勾选模型，参数自动从预设或 models.dev 补全。
4. 填 API 地址与 Key（可写环境变量名）；请求头、「模型自动发现」在「高级选项」里。
5. 保存后卡片出现「启用」「移除」，多个供应商可同时写进models.yml共存。

设计意图

models.yml按纯文本编辑：只重写 CC Switch 写的那一条，其余字节原样保留；写入前按 omp 18.12 的 schema 校验api、compat、reasoningEffortMap等枚举值，因为 omp 只要一条供应商不合规就停用全部自定义供应商，所以非法值在保存时直接拒绝（实现见 src-tauri/src/omp_config.rs）。数据库提交失败时，文件按原字节回滚。

哪里会卡住

• 只剩旧版models.json：添加供应商会被拒，先跑一次omp让它自行迁移，CC Switch 不替你新建models.yml挤掉原有供应商。
• 文件里用了 YAML 锚点、标签或 flow 风格的条目：不会被重写，提示手动修改。
• MCP 与 Skills 的实际加载量：omp 还会从其他工具的目录发现 MCP 和 Skills，实际加载的可能比 CC Switch 列出的多，MCP/Skills 页 Oh My Pi 一列有说明。
• 本地路由与用量导入不适用Oh My Pi，别在这两项找它的开关。

托管 ChatGPT 账号：浏览器登录怎么走

怎么操作

1. 「授权中心」或 Codex 供应商表单里添加托管 ChatGPT 账号。
2. 「登录方式」选「浏览器登录」（设备码登录仍在，二选一）。
3. 浏览器完成授权后回到本机回环回调（端口 1455）。
4. 账号即出现在授权中心托管列表。
5. 重新登录同样可选浏览器，供工作区禁用设备码的账号使用。

设计意图

授权码 + PKCE、回环回调固定 1455 端口（#8288，修复 #8284）。有些企业工作区关闭了设备码登录，这类账号以前根本加不进来，现在两条登录路径并存。

哪里会卡住

• 1455 端口被占或回环被网络策略拦截：回调失败时换设备码登录（前提是工作区允许）。
• 登录只影响凭据槽位内的凭据，CC Switch 不改动订阅侧状态。

其他变化与修复

额度与余额显示

• 症状：DeepSeek 余额为零或欠费时，卡片显示「套餐已过期」、余额数字消失。根因：DeepSeek 的is_available只表示余额够不够调用，Key 本身仍有效。解决：余额照常显示，Key 真失效仍按认证失败提示（#8812）；零或负数一律显示「余额 <金额>」，卡片红字、托盘橙色。
• Kimi 账号无套餐时额度栏显示「未订阅」；「额度没查到」改为「额度查询失败」（卡片、授权中心、托盘同步）。

用量统计

• Kimi Code 子代理用量漏计（#8792）：子代理记录写在各自的agents/<agent>/wire.jsonl，以前只读主代理那份。现在全部导入、按messageId逐次记账，父级的subagent.completed汇总不重复计算。
• Antigravity 子代理与 ACP 会话用量记成未知模型（#8693）：现从 agy 本地对话数据库只读找回模型。
• 用量页三个明细页签的数量一次查齐，切换应用时不再消失重排。

登录与网络

• Skills 安装/更新持续 HTTP 429（#8813）：下载 GitHub 压缩包时没带 User-Agent 被限流，现改发CC-Switch/<version>。
• Pi 的 API Key 写成$NAME/${NAME}环境变量引用时额度查询 401（#8822）：以前把引用原样当 Key 发出，现按 Pi 规则解析取值；变量未设置时发空 Key，取值不回写配置，!command形式仍不执行。

显示与交互

• Claude Code 会话标题显示成<local-command-stdout>Set model to opus</local-command-stdout>（#8798/#8799）：会话开头跑过/model这类本地命令所致，标题与摘要现跳过注入的本地命令输出。
• Linux 开启应用级窗口按钮后页头拖不动、无缩放光标（#8091）。
• Claude Code / Claude Desktop 选 Copilot 供应商时，上游格式锁定为「由路由按模型自动选择」，不再给无效手选项（#8195）。
• Codex Chat 上游的孤立工具结果里，图片占位文字改为「已作为图片附上」（#8157）。

其他小修

• 「应用」页分「已安装 · N」「未安装 · N」两组，空组隐藏；已安装行可拖拽排序，侧栏与默认应用跟随，顺序存本机settings.json的appOrder，不云同步。
• Kimi 官方卡片可编辑模型（读该账号当前官方目录）并可从 Kimi Code「移除」，卡片与登录保留，「添加」即恢复。
• Pi 获取模型改为弹窗勾选；请求头与兼容选项收进默认收起的「高级选项」。
• 预设刷新到各厂商最新型号；价格表新增 Kimi K3.1 Pro 与 K3.1 Pro HighSpeed；EveryAPI 赞助预设移除（现有供应商图标保留）；土耳其语翻译补全（#8616）。

动手升级：检查、步骤与回滚

1. 前置检查：确认升级前应用里无未保存的关键操作。schema 22 → 23 会给mcp_servers加enabled_omp列，升级前自动建数据库备份。
2. 留后路：需要回滚能力时，手动复制一份~/.cc-switch/backups/里的最新备份到其他位置（默认 24 小时间隔、保留最近 10 个）。
3. 升级：应用内检查更新，或按平台重装下方制品。
4. 验证：「应用」页出现 Oh My Pi 行；启动无数据库版本告警；不用 Oh My Pi 就在「应用」页关掉「在侧栏显示 Oh My Pi」。
5. 回滚：旧版本拒绝打开 v23 数据库（提示「数据库版本过新」）。先在「设置 → 数据 → 备份与恢复」还原升级前备份，再装回旧版本。

获取与安装

Linux 需 glibc 2.35+ 与 WebKitGTK 4.1（Ubuntu 22.04+、Debian 12+ 可用）。

相关文档与致谢

相关文档：v4.0.20 发布说明、安装指南、CHANGELOG。官方渠道为官网 ccswitch.io 与项目开源仓库的 Releases 页面——任何收费、要求充值或索取登录凭据的「CC Switch」均为假冒。本版感谢贡献 Oh My Pi 支持与 ChatGPT 浏览器登录的开发者，以及多位问题报告者。

【免费下载链接】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