farion1231/cc-switch v4.0.10

这是 4.0 正式版的第六个修复版本，核心围绕 ccswitch:// 一键导入深度链接做全面加固（不再丢链接、可声明接口格式、保留供应商原生配置、可选导入后立即切换），同时新增本地图标上传与「我的图标」库、用量页首字时间统计，并修复一批路由与用量相关的遗留问题。数据库结构未变（仍为 20），无破坏性变更。

新增能力

深度链接（一键导入）稳健性 - CC Switch 未运行时点击链接不再丢失：此前 Windows / Linux 上应用会启动但确认框不出现，轻量模式窗口重建时也会丢，macOS 上同一链接会弹两次确认框；现在链接先落盘，确认框显示后才算处理完成，中途被打断不丢，后到的旧链接也不会覆盖新链接。 - 确认框新增「导入后立即切换到这个供应商」开关（默认关闭，开启时提示客户端请求将改发到链接里的地址）。共存式应用（OpenCode、OpenClaw、Hermes、MiniMax Code）显示为「导入后立即添加到 OpenCode 配置」这类开关，Pi 为「导入后立即在 Pi 中启用」，这两类默认打开；提示词为「导入后立即启用」。链接里的 enabled 只决定开关初始状态，关掉则只保存供应商、不改客户端配置（即使这是该应用的第一个供应商）。

深度链接安全与配置保留 - Codex 链接保留供应商自带配置：连接与认证字段、模型、推理强度、上下文窗口、子代理模型等；模型目录地址仅在与接口地址同源时保留；[features]、MCP、权限等全局设置不导入；auth、aws、gateway_oauth、env_http_headers 这类会让 Codex 执行命令或读本机凭据的配置整条拒绝。不带配置的链接行为与以前逐字一致。 - Grok Build 链接保留 [models] default 指向的模型表（显示名、说明、接口类型、上下文窗口），地址 / Key / 模型仍以链接参数为准；使用 auth_provider、env_http_headers、mtls_cert_dir 的链接被拒绝；一个供应商只占一张表，其他模型表不导入。 - 会被展开执行的值一律拒绝：Pi 的 ! 开头值（命令执行）与 $NAME / ${NAME}（读环境变量）、OpenCode 的 {env:} / {file:}、OpenClaw 与 Hermes 的 ${...}；在解析链接、合并配置、生成供应商三处均检查。 - 带用量查询脚本的链接导入后默认开启用量查询（usageEnabled=false 时仍关闭；无脚本链接行为不变）。脚本在沙箱运行，只能向供应商地址的同源 HTTPS 发一次请求，确认框完整显示脚本内容。 - 其他：带 configUrl 的链接一打开即提示不支持；提示词链接支持 MiniMax Code，MCP 链接支持 Pi 与 MiniMax Code；导入供应商后托盘菜单立即刷新。

站长新参数 - apiFormat：声明上游接口格式（anthropic / openai_chat / openai_responses / gemini_native），CC Switch 转换为各应用字段；Claude Code、Codex、Grok Build 的非原生格式需开启本地路由，不支持的组合解析时即拒绝。 - Pi 供应商链接：写入 Pi 的 models.json，链接必须带模型。 - iconUrl：填网站 logo 的 https 地址，确认框打开时下载并显示在顶部，导入后作为卡片自定义图标，失败则回退内置图标或名称首字母。图片重绘为小尺寸 PNG 保存，地址本身不保存也不渲染。安全策略：只连公网地址并锁定解析结果（防二次 DNS 重定向）、重定向逐跳检查最多 3 跳、不走系统代理、不带 Cookie、5 秒超时、最大 256 KB、文件类型必须与内容一致。

文档与工具 - 发布中 / 英 / 日三语站长接入指南（如何生成链接、如何在页面放「一键导入」按钮使 Key 不出现在页面源码、未安装时的提示、附用量查询脚本）。New API 与 Sub2API 搭建的站点 Key 列表已自带「导入到 CC Switch」按钮，区别是 New API 的链接不带用量查询脚本。 - 在线链接生成器迁至 https://ccswitch.io/deplink.html：分供应商、MCP、提示词、Skill 四类，按应用列出可选 apiFormat，内置用量脚本模板，icon / iconUrl 按应用内同样规则校验；手册与 README 中原本 404 的 GitHub Pages 链接一并更正。

图标与用量 - 供应商图标支持上传本地图片并存入「我的图标」：图标选择器分「我的图标」「内置图标」两组，可传 PNG / JPG / WebP / SVG（≤ 2 MB）并命名，缩为 96×96 PNG，随云同步、不在磁盘另存文件；SVG 先转位图，脚本与外部请求不执行。重复上传同一张图复用已有记录，重命名 / 删除不影响正在使用的供应商；链接带来的网站图标以「当前图标」显示，可存入「我的图标」；点一下图标即选中并关闭，移除图标改由搜索框旁的「清除图标」操作。 - 用量页新增「首字」列：供应商统计与模型统计取经路由服务的成功流式请求中位数，请求日志在「速度」后加「首字」。未开路由时按会话日志时间戳估算并以 ≈ 标注：Claude Code 看以思考开头的回复，Codex 看较新版本写入的时间戳；以正文或工具调用开头的回复无估算值，升级前记录不补算。 - 用量查询新增 Sub2API 模板：只需 Key 和地址（带不带 /v1 均可），显示套餐名，额度不限的订阅不再显示成负余额。 - 新增预设：NekoCode（Claude Code、Claude Desktop、Codex、OpenCode、OpenClaw、Hermes、Pi，MiniMax Code 沿用 Pi 预设）；YYLX 中文界面显示为「鱼鱼连线」（繁体「魚魚連線」）。

修复的问题

路由模式下 Claude Code 的 haiku 档请求被上游拒绝（#8118）：settings.json 中写的别名由 claude-haiku-4-5 改为 claude-haiku-5-5，与 sonnet、opus 档发法一致；路由仍按「haiku」关键词映射，选到的模型不变。
v3.20 及更早用官方账号走路由留下的 Codex 会话打不开（#7948）：报错 Model provider 'cc-switch-official' not found，现在启动时把会话移回 Codex 内置的 openai 分组，只改会话记录、不碰 config.toml；每个配置目录只做一次，改动前记录有备份，手动恢复过该表且仍在使用的会跳过。
Grok Build 第三方供应商生成不了会话标题（#7003）：session_summary 未设或指向 CC Switch 写的表时跟随当前供应商，切回官方账号时删除；用户自己设的内置模型或表保持不动。
OpenRouter、Novita 余额为零时显示「套餐已过期」（#8148）：改为「余额已用完」；接口返回缺失或格式错误的余额时报错，不再当作零余额。
Codex 中途换模型后用量记在原来模型上：现在读取线程设置中的新模型；已导入记录可用用量页「数据来源 → 重建 Codex 用量」重建（重建前自动备份数据库）。
设置中改了配置目录但未保存，改另一项时目录被一起保存（#7849）：自动保存只带已确认的目录，放弃的草稿不再留在输入框。
Windows 打开添加 / 编辑供应商页面时窗口闪烁：这两个页面不再做淡入淡出（v4.0.9 已修先显示加载页的问题）。
Windows 升级后已删除的桌面快捷方式被装回来：MSI 升级不再重建，只有全新安装时创建。
其他：「连接模式」说明改为先讲各模式长处（直连最原生、路由可热切换与故障转移 / 格式转换、聚合可在客户端内切换多家模型）；用量页表格列统一左对齐，请求日志中供应商与模型两列让出宽度给数字列；日文界面「高級オプション」改为「詳細オプション」。

兼容性与升级

数据库结构无变化（仍为 20），无 breaking change。
已用路由模式的 Claude Code 升级后启动时会写入新的 haiku 别名，新会话生效；Codex 会话迁移自动进行并带备份；新增预设只影响新添加的供应商。