添加供应商时出现白屏 - CC Switch

Quick fix

先升级到 CC Switch 4.0.13；若仍能复现，请携带版本、系统环境、复现步骤和日志重新反馈。

Symptom

报错原文复制

添加供应商加号点击后会一闪而过信息后白屏

Cause

在 CC Switch 3.15.0、macOS Monterey 12.1 的 Intel MacBook Pro 上，点击加号添加供应商或修改 API 密钥设置时会出现白屏。线程没有提供日志或明确根因，也没有确认 4.0.13 已修复该问题；维护者仅表示 CC Switch 4.0 做过重构和修复，建议用最新版复测。

同一线程中，Fedora 44、Wayland 和 NVIDIA 独立显卡环境从 3.14 开始出现相似的界面冻结，但不是白屏；拖动窗口大小只能暂时刷新一帧。该变体可能与本问题相关，但现有证据不足以确认原因相同。Issue 最终因长期无更新而关闭，并非确认修复后关闭。

Fix

1. 1

   将 CC Switch 升级到维护者建议的最新版 4.0.13，然后重新尝试添加供应商或修改 API 密钥设置。

2. 2

   如果问题仍能复现，记录当前 CC Switch 版本、操作系统环境、完整复现步骤和相关日志，并重新提交反馈供维护者继续排查。

3. 3

   若 Linux 界面冻结，可拖动窗口右下角调整大小以暂时刷新一帧；这只是临时现象缓解，并非已确认的修复。

Affected Versions

Toolcc-switch

Version受影响报告版本：3.15.0；Linux 相似问题报告称从 3.14 开始

PlatformsmacOSLinux

Source Issues

本页汇总自 1 个真实 issue

• #2924添加供应商时出现白屏

FAQ

Linux 下不是白屏，而是窗口内画面卡住不动，是什么情况？

线程没有确定原因。报告环境为 Fedora 44、Wayland 和已安装驱动的 NVIDIA 独立显卡，拖动窗口大小只能暂时刷新一帧；建议先升级到 4.0.13，若仍复现则补充日志重新反馈。

升级到 CC Switch 4.0.13 能确定修复白屏吗？

不能确定。维护者只说明 4.0 做了不少重构和修复并建议尝试 4.0.13，线程中没有升级后成功或失败的复测结果。

相关问题

仍包含 `disable_response_storage = true`原帖尚未提供可验证的解法；已有 PR 提议清理 disable_response_storage 的生成路径，但未确认合并或发布。1 issues mergedCould not create default EGL displayLinux 下 cc-switch 强制 WEBKIT_DISABLE_DMABUF_RENDERER=1 导致白屏，预设该变量为 0 再启动即可恢复；点击失效/卡死另有对应变体解法。3 issues merged为 Claude Code 添加 CoderPlan provider这是功能请求：为 cc-switch 增加 CoderPlan provider preset，作者已准备 Claude Code preset PR，但维护者仅要求通过 readme 邮箱沟通，合并状态未确认。4 issues merged