"Failed to upload "image.png"" 截图上传失败 - cc-switch
Quick fix
这不是 cc-switch 的报错，而是 GitHub 截图没传上去留下的占位符；重新上传截图或直接粘贴文字版报错，否则维护者看不到任何信息。
Symptom
Section titled “Symptom”<!-- Failed to upload "image.png" -->在 GitHub 上提交 issue 或评论时，如果图片还在上传中就点了提交，或上传过程被网络中断（代理、网络波动、文件过大等），正文里只会留下 `<!-- Failed to upload "image.png" -->` 这样的 HTML 注释占位符，图片本身并没有传到服务器。由于 HTML 注释在渲染后不可见，其他人看到的就是一片空白——你以为贴了截图，实际上维护者什么都看不到。
本集群中的多个 issue 都踩了这个坑：有的正文唯一的报错证据就是一张没传成功的截图（如 #6046，维护者明确表示"截图当时没有上传成功，我们一直没能看到具体报错"，最终因超过 60 天无活动被关闭）；有的 issue 虽然部分截图上传成功，但关键的报错截图丢失（如 #2901、#116、#4617、#4668）。注意这个占位符与 cc-switch 软件本身无关，它不是程序输出的错误，而是 GitHub 网页端的上传失败痕迹，cc-switch 的各个版本（3.12.3 - 3.19.1）和各平台都可能出现在 issue 里，纯属巧合。
在 GitHub 编辑框里粘贴图片后，等缩略图和 user-attachments 链接完全生成再点提交，不要在显示 "Uploading..." 或仍只有注释占位符时提交。
提交后检查渲染效果：如果正文里出现 `<!-- Failed to upload "image.png" -->` 或图片位置空白，说明上传失败，编辑该条内容重新上传，或换个网络环境（关闭/更换代理）再试。
截图一直传不上时，直接用文字代替：把终端或 Claude Code / Codex 里的报错原文复制粘贴到正文（用代码块包裹），并附上 cc-switch 版本号、操作系统、base URL（隐去 Key）——#6046 的维护者正是这样要求补充信息的。
如果 issue 已经因为"看不到报错"被 stale 关闭，按维护者在 #6046 的建议：重开 issue 并附上具体报错文字、base URL、CC Switch 版本号，排查才能继续。
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 10 个真实 issue
- #116版本3.31无法通过内置更新器更新
- #1992claude cli返回的结果被分段
- #2901大佬救命！救命！Claude code配置Deepseek/三方都不成功
- #3006使用统计 的缓存创建和缓存命中一直都是0，为什么？
- #4482我发现使用go订阅的minimax和Qwen通过cc-switch接入claude code会乱码
- #4617多次切换不同供应商，API Key 会被改写
- #4668使用千问模型会产生大量换行 CC Switch causes excessive line breaks when using Qwen model
- #4801macOS 顶部系统菜单栏 File/Edit/View 无法跟随软件简体中文设置汉化
- #5988codex 不显示 deepseek 模型名称
- #6046opencode go配置连接失败
- 正文里出现 `<!-- Failed to upload "image.png" -->` 是 cc-switch 报的错吗？
- 不是。这是 GitHub 网页端图片上传失败留下的占位注释，与 cc-switch 软件无关。它意味着你想贴的截图没有传到服务器，别人（包括维护者）完全看不到这张图。
- 截图没传上去就提交了 issue，会有什么后果？
- 维护者看不到任何报错信息，无法排查。例如 #6046 中维护者明确回复"截图当时没有上传成功，我们一直没能看到具体报错"，该 issue 最终因超过 60 天无活动被标记 stale 并关闭。
- 截图反复上传失败，还有别的办法描述问题吗？
- 有。直接把终端里的报错原文以文字形式粘贴进正文，并写明 cc-switch 版本号、操作系统、涉及的供应商 base URL（隐去 API Key）。文字版报错通常比截图更便于搜索和定位问题。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。