拓冰网站定制 
cc-switch v3.6.1 深度解析用量查询凭证解耦、TOML 解析健壮性与 MCP 字段保留机制【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch本文基于 cc-switch 官方发布说明 v3.6.1 中文版 展开系统梳理该版本围绕“用量查询凭证解耦”“表单验证基础设施”“中文 IME 引号规范化”“MCP 自定义字段保留”“托盘菜单同步”等主题的全部改动并结合仓库源码逐条印证其实现细节。读完本文你将理解 cc-switch 在配置解析层如何防御 IME 输入导致的 TOML 解析失败MCP 服务器配置是如何做到向前兼容扩展字段的以及用量查询系统为何要与供应商配置解耦。版本概览v3.6.1 发布于 2025-11-10是建立在 v3.6.0 之上的稳定性提升与用户体验优化版本。官方定位非常明确聚焦用户体验优化与配置解析健壮性修复多个关键 Bug并增强用量查询系统。技术统计如下引自发布说明提交数: 17 commits 代码变更: 31 个文件 - 新增: 1,163 行 - 删除: 811 行 - 净增长: 352 行 贡献者: Jason (16), ZyphrZero (1)按模块分类UI/用户界面 3 commits、用量查询系统 3 commits、配置解析 2 commits、表单验证 1 commit、其他改进 8 commits。一、用量查询系统增强凭证与供应商配置解耦v3.6.1 用量查询系统最大的架构性变化是凭证解耦用量查询可以使用独立的 API Key 和 Base URL不再依赖供应商配置。这意味着支持不同的查询端点和认证方式例如用量查询走聚合平台的 OpenAPI而实际模型调用走另一条链路表单会根据模板类型自动显示对应的凭证输入框表单统一使用 shadcn/ui 输入组件样式与整个应用保持一致并使用 shadcn/ui Switch 替代原生 checkbox。三种凭证模板模板类型所需凭证字段典型场景GeneralAPI Key Base URL通用 OpenAI/Anthropic 风格兼容端点NewAPIBase URL Access Token User IDNewAPI 类中转/聚合面板需要用户级 token 查询用量Custom完全自定义用户自行编写 JavaScript 查询脚本并注入任意参数配套地本版本在表单中添加了密码显示切换能力API Key、Access Token 支持查看/隐藏切换并在 UI 上将用量开关升级为 shadcn/ui Switch 组件对应实现位于 switch.tsx。用量查询脚本的编辑与测试入口对应 UsageScriptModal.tsxv3.6.0 已提供“测试脚本 API”执行前验证 JavaScript 用量查询脚本与“自动刷新间隔”支持自定义查询间隔v3.6.1 在此基础上补齐了凭证层的独立性。二、表单验证基础设施通用 Schema 与 MCP 条件字段验证v3.6.1 新增了表单验证基础设施目标是减少重复代码通用 Schema 库新增 JSON/TOML 通用验证器。发布说明中列出的三个验证器为jsonConfigSchema通用 JSON 对象验证器tomlConfigSchema通用 TOML 格式验证器mcpJsonConfigSchemaMCP 专用 JSON 验证器MCP 条件字段验证严格的类型检查——stdio类型强制要求command字段http类型强制要求url字段。从当前仓库源码结构看MCP 条件字段验证的落地实现集中在 useMcpValidation.tsvalidateTomlConfig先调用validateToml做语法级校验再调用tomlToMcpServer做结构级校验——stdio类型缺command返回“需要 command”错误http/sse类型缺url返回“需要 url”错误JSON 侧的validateJsonConfig还额外拒绝包含mcpServers键的输入要求只提交单个服务器对象见 useMcpValidation.ts。供应商表单侧则使用 zod 构建providerSchema其settingsConfig字段通过superRefine内嵌JSON.parse校验并在解析失败时提取错误位置信息Chrome/V8 的at position N、Firefox 的line N column M生成带坐标的友好报错见 provider.ts。三、配置解析健壮性中文引号规范化与 MCP 字段保留这是 v3.6.1 技术含金量最高的部分针对的是中文用户在 TOML 编辑器里踩的两个真实坑。3.1 IME 全角引号导致 TOML 解析失败问题中文输入法在行内输入时常把引号打成全角/弯引号“ ” ‘ ’ 等这些字符不是合法的 TOML 定界符直接导致解析报错。修复新增 textNormalization.ts 工具函数在 TOML 解析前自动归一化引号export const normalizeQuotes (text: string): string { if (!text) return text; return ( text // 双引号族 → .replace(/[“”„‟]/g, ) // 单引号族 → .replace(/[‘’]/g, ) ); };实现上有两个值得注意的设计细节保守替换边界源码注释明确说明“不替换书名号/角引号《》、「」等避免误伤内容语义”——引号归一化只处理会破坏 TOML 语法的引号族在解析入口处统一生效tomlUtils.ts 中的validateToml与 tomlUtils.ts 中的tomlToMcpServer都在parseToml之前先调用normalizeTomlText当前实现等价于normalizeQuotes为后续扩展如空白、行尾归一化预留了接口。同时Textarea 组件禁用了浏览器自动纠正autocorrect从输入侧减少全角引号的来源。3.2 Codex MCP TOML 编辑时自定义字段被静默丢弃问题编辑 Codex MCP 的 TOML 配置时未知扩展字段如timeout_ms、retry_count会被静默丢弃。修复在normalizeServerConfig中使用 spread 操作符保留所有字段。当前实现见 tomlUtils.ts函数先声明knownFields集合记录已处理的已知字段stdio 的type/command/args/env/cwdhttp/sse 的type/url/headers然后遍历配置对象的所有键凡不在knownFields中的字段一律原样写回结果对象// 保留所有未知字段如 timeout_ms 等扩展字段 for (const key of Object.keys(config)) { if (!knownFields.has(key)) { server[key] config[key]; } }序列化侧的mcpServerToToml同样先{ ...server }复制全部字段再走stringifyToml保证扩展字段在“解析 → 编辑 → 序列化”往返后不丢失见 tomlUtils.ts。这一设计让 cc-switch 对 MCP 协议未来的字段扩展保持向前兼容。此外tomlToMcpServer对 TOML 结构做了三级容错识别见 tomlUtils.ts直接服务器配置 →[mcp_servers.id]推荐格式 →[mcp.servers.id]错误格式均能提取出第一个服务器配置识别失败才抛出明确错误。四、合作伙伴集成PackyCodev3.6.1 新增官方合作伙伴PackyCode改动落在各应用的供应商预设中添加到 Claude 和 Codex 供应商预设、支持 10% 折扣优惠促销信息通过 i18n key 集成、新增 Logo 和合作伙伴标识packycode.png。从当前源码确认预设定义位于 claudeProviderPresets.ts 与 codexProviderPresets.ts其中partnerPromotionKey: packycode字段驱动促销文案的多语言渲染icon: packycode驱动卡片图标后续版本Gemini、Claude Desktop 等也沿用了同一预设结构。五、用户体验优化拖拽排序与托盘菜单同步5.1 拖拽排序后托盘菜单实时同步#179修复前拖拽调整供应商顺序后系统托盘菜单的顺序不会更新UI 与托盘出现不一致。修复方案是在排序完成后自动调用updateTrayMenu。当前实现见 useDragSort.tshandleDragEnd先把新顺序写回后端providersApi.updateSortOrder失效 React Query 缓存若目标是路由类应用isProxyAppId还会失效failoverQueue查询因为故障转移顺序就是从排序派生的最后才调用providersApi.updateTrayMenu()同步托盘菜单。5.2 错误隔离托盘失败不阻塞主流程同一段代码体现了 v3.6.1“稳定性改进”的核心思想——错误隔离托盘菜单更新被包在独立的try/catch中见 useDragSort.ts注释写明“托盘菜单更新失败不影响排序成功”失败仅记录日志、不抛出。即“主操作成功但托盘更新失败时给出警告而非整体失败”。5.3 其他 UX 改进与稳定性修复错误通知增强切换供应商失败时显示可复制的错误信息移除误导性占位符删除模型输入框的示例文本避免用户误以为要照抄Base URL 自动填充所有非官方供应商类别自动填充 Base URL 输入框安全模式匹配后端将unwrap()替换为安全的 pattern matching托盘菜单事件处理使用match模式避免 panic 导致应用崩溃导入配置分类从默认配置导入时自动把category设置为custom避免导入配置被误认为官方预设提供更清晰的配置来源标识用量脚本面板白屏崩溃修复根因是FormLabel组件内部调用useFormField()hook 需要FormFieldContext而该面板没有提供此 context导致整个应用崩溃修复方式是替换为不依赖 FormField 的独立Label组件。六、Bug 修复清单汇总修复项根因修复手段用量脚本面板白屏FormLabel依赖缺失的FormFieldContext改用独立Label组件中文输入法引号解析失败IME 全角引号非法进入 TOML新增textNormalization工具解析前归一化拖拽排序托盘不同步 (#179)排序完成后未刷新托盘排序后自动调用updateTrayMenu贡献者 ZyphrZeroMCP 自定义字段丢失规范化时丢弃未知字段spread 保留全部字段normalizeServerConfig保留扩展字段托盘更新失败影响主流程错误未隔离托盘更新与主操作解耦失败降级为警告潜在 panic 崩溃使用unwrap()替换为安全 pattern matching七、安装方式v3.6.1macOS通过 Homebrew 安装推荐brew tap farion1231/ccswitch brew install --cask cc-switch或手动下载发布资产CC-Switch-v3.6.1-macOS.zip。注意由于作者没有苹果开发者账号首次打开可能出现“未知开发者”警告。请前往“系统设置” → “隐私与安全性” → 点击“仍要打开”。Windows安装包CC-Switch-v3.6.1-Windows.msi便携版CC-Switch-v3.6.1-Windows-Portable.zipLinuxAppImageCC-Switch-v3.6.1-Linux.AppImageDebianCC-Switch-v3.6.1-Linux.deb完整变更记录与多语言发布说明见 CHANGELOG.md 及 v3.6.1 英文版。附录v3.6.0 完整功能回顾v3.6.1 基于 v3.6.02025-11-07为便于了解完整功能集此处继承发布说明中的回顾要点供应商管理与编辑模式供应商复制一键复制现有供应商配置创建变体复制插入位置修复为原供应商旁边手动排序拖拽重排供应商带视觉推送效果动画编辑模式可显示/隐藏拖拽手柄多端点配置聚合类供应商支持多个 API 端点非官方供应商自动显示端点字段。自定义配置目录云同步自定义 cc-switch 配置存储目录指向 Dropbox、OneDrive、iCloud Drive、坚果云等云同步文件夹即可实现跨设备配置自动同步通过 Tauri Store 独立管理隔离性和可靠性更好。配置目录切换WSL 支持切换 Claude/Codex 配置目录如 WSL 环境时自动同步当前供应商到新目录统一的postChangeSync.ts后置同步工具优雅处理错误而不阻塞主流程配置导入后自动同步“完全成功”与“部分成功”状态区分提供精确反馈。Claude 配置数据结构增强模型配置从双键系统升级到四键系统匹配官方最新数据结构新增ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_MODEL替换旧版ANTHROPIC_SMALL_FAST_MODEL后端在首次读写时自动规范化旧配置并带智能回退链UI 从 2 个模型输入字段扩展到 4 个具有智能默认值支持ANTHROPIC_API_KEY除ANTHROPIC_AUTH_TOKEN外模板变量系统如 KAT-Coder 的ENDPOINT_ID端点候选列表用于速度测试供应商卡片自定义图标和颜色。架构重构后端Rust五阶段统一错误处理AppError 国际化错误消息→ 命令层按领域拆分commands/{provider,mcp,config,settings,plugin,misc}.rs→ 集成测试和事务机制配置快照 失败回滚→ 提取 Service 层services/{provider,mcp,config,speedtest}.rs→ 并发优化RwLock替代Mutex作用域 guard 避免死锁。前端React TypeScript四阶段测试基础设施vitest MSW testing-library/react→ 提取自定义 hooksuseProviderActions、useMcpActions、useSettings、useImportExport等→ 组件拆分和业务逻辑提取 → 代码清理与格式化统一。所有 Tauri 命令参数统一为 camelCaseTauri 2 规范AppType重命名为AppId并用FromStrtrait 集中解析app参数。内部优化与依赖移除 v1 配置自动迁移与副本文件扫描逻辑提升启动性能v2 格式配置完全兼容。注意从 v3.1.0 或更早版本升级的用户请先升级到 v3.2.x 或 v3.5.x 完成一次性迁移再升级到 v3.6.0依赖更新Tauri 2.8.x、TailwindCSS 4.x、TanStack Query v5.90.x、React 18.2.x、TypeScript 5.3.x。小结v3.6.1 是一个典型的“健壮性版本”用量查询凭证解耦让查询链路与供应商链路可以独立配置textNormalization与normalizeServerConfig两个看似细小的改动分别解决了中文 IME 用户 TOML 解析失败和 MCP 扩展字段丢失这两类真实世界的数据丢失问题而拖拽排序与托盘菜单的错误隔离则把“局部失败”与“整体失败”明确区分开。这些改动共同保证了 cc-switch 在多语言输入法环境、自定义 MCP 协议字段和高频切换场景下的稳定运行。【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 cc-switch v3.6.1 深度解析：用量查询凭证解耦、TOML 解析健壮性与 MCP 字段保留机制
cc-switch v3.6.1 深度解析用量查询凭证解耦、TOML 解析健壮性与 MCP 字段保留机制【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch本文基于 cc-switch 官方发布说明 v3.6.1 中文版 展开系统梳理该版本围绕“用量查询凭证解耦”“表单验证基础设施”“中文 IME 引号规范化”“MCP 自定义字段保留”“托盘菜单同步”等主题的全部改动并结合仓库源码逐条印证其实现细节。读完本文你将理解 cc-switch 在配置解析层如何防御 IME 输入导致的 TOML 解析失败MCP 服务器配置是如何做到向前兼容扩展字段的以及用量查询系统为何要与供应商配置解耦。版本概览v3.6.1 发布于 2025-11-10是建立在 v3.6.0 之上的稳定性提升与用户体验优化版本。官方定位非常明确聚焦用户体验优化与配置解析健壮性修复多个关键 Bug并增强用量查询系统。技术统计如下引自发布说明提交数: 17 commits 代码变更: 31 个文件 - 新增: 1,163 行 - 删除: 811 行 - 净增长: 352 行 贡献者: Jason (16), ZyphrZero (1)按模块分类UI/用户界面 3 commits、用量查询系统 3 commits、配置解析 2 commits、表单验证 1 commit、其他改进 8 commits。一、用量查询系统增强凭证与供应商配置解耦v3.6.1 用量查询系统最大的架构性变化是凭证解耦用量查询可以使用独立的 API Key 和 Base URL不再依赖供应商配置。这意味着支持不同的查询端点和认证方式例如用量查询走聚合平台的 OpenAPI而实际模型调用走另一条链路表单会根据模板类型自动显示对应的凭证输入框表单统一使用 shadcn/ui 输入组件样式与整个应用保持一致并使用 shadcn/ui Switch 替代原生 checkbox。三种凭证模板模板类型所需凭证字段典型场景GeneralAPI Key Base URL通用 OpenAI/Anthropic 风格兼容端点NewAPIBase URL Access Token User IDNewAPI 类中转/聚合面板需要用户级 token 查询用量Custom完全自定义用户自行编写 JavaScript 查询脚本并注入任意参数配套地本版本在表单中添加了密码显示切换能力API Key、Access Token 支持查看/隐藏切换并在 UI 上将用量开关升级为 shadcn/ui Switch 组件对应实现位于 switch.tsx。用量查询脚本的编辑与测试入口对应 UsageScriptModal.tsxv3.6.0 已提供“测试脚本 API”执行前验证 JavaScript 用量查询脚本与“自动刷新间隔”支持自定义查询间隔v3.6.1 在此基础上补齐了凭证层的独立性。二、表单验证基础设施通用 Schema 与 MCP 条件字段验证v3.6.1 新增了表单验证基础设施目标是减少重复代码通用 Schema 库新增 JSON/TOML 通用验证器。发布说明中列出的三个验证器为jsonConfigSchema通用 JSON 对象验证器tomlConfigSchema通用 TOML 格式验证器mcpJsonConfigSchemaMCP 专用 JSON 验证器MCP 条件字段验证严格的类型检查——stdio类型强制要求command字段http类型强制要求url字段。从当前仓库源码结构看MCP 条件字段验证的落地实现集中在 useMcpValidation.tsvalidateTomlConfig先调用validateToml做语法级校验再调用tomlToMcpServer做结构级校验——stdio类型缺command返回“需要 command”错误http/sse类型缺url返回“需要 url”错误JSON 侧的validateJsonConfig还额外拒绝包含mcpServers键的输入要求只提交单个服务器对象见 useMcpValidation.ts。供应商表单侧则使用 zod 构建providerSchema其settingsConfig字段通过superRefine内嵌JSON.parse校验并在解析失败时提取错误位置信息Chrome/V8 的at position N、Firefox 的line N column M生成带坐标的友好报错见 provider.ts。三、配置解析健壮性中文引号规范化与 MCP 字段保留这是 v3.6.1 技术含金量最高的部分针对的是中文用户在 TOML 编辑器里踩的两个真实坑。3.1 IME 全角引号导致 TOML 解析失败问题中文输入法在行内输入时常把引号打成全角/弯引号“ ” ‘ ’ 等这些字符不是合法的 TOML 定界符直接导致解析报错。修复新增 textNormalization.ts 工具函数在 TOML 解析前自动归一化引号export const normalizeQuotes (text: string): string { if (!text) return text; return ( text // 双引号族 → .replace(/[“”„‟]/g, ) // 单引号族 → .replace(/[‘’]/g, ) ); };实现上有两个值得注意的设计细节保守替换边界源码注释明确说明“不替换书名号/角引号《》、「」等避免误伤内容语义”——引号归一化只处理会破坏 TOML 语法的引号族在解析入口处统一生效tomlUtils.ts 中的validateToml与 tomlUtils.ts 中的tomlToMcpServer都在parseToml之前先调用normalizeTomlText当前实现等价于normalizeQuotes为后续扩展如空白、行尾归一化预留了接口。同时Textarea 组件禁用了浏览器自动纠正autocorrect从输入侧减少全角引号的来源。3.2 Codex MCP TOML 编辑时自定义字段被静默丢弃问题编辑 Codex MCP 的 TOML 配置时未知扩展字段如timeout_ms、retry_count会被静默丢弃。修复在normalizeServerConfig中使用 spread 操作符保留所有字段。当前实现见 tomlUtils.ts函数先声明knownFields集合记录已处理的已知字段stdio 的type/command/args/env/cwdhttp/sse 的type/url/headers然后遍历配置对象的所有键凡不在knownFields中的字段一律原样写回结果对象// 保留所有未知字段如 timeout_ms 等扩展字段 for (const key of Object.keys(config)) { if (!knownFields.has(key)) { server[key] config[key]; } }序列化侧的mcpServerToToml同样先{ ...server }复制全部字段再走stringifyToml保证扩展字段在“解析 → 编辑 → 序列化”往返后不丢失见 tomlUtils.ts。这一设计让 cc-switch 对 MCP 协议未来的字段扩展保持向前兼容。此外tomlToMcpServer对 TOML 结构做了三级容错识别见 tomlUtils.ts直接服务器配置 →[mcp_servers.id]推荐格式 →[mcp.servers.id]错误格式均能提取出第一个服务器配置识别失败才抛出明确错误。四、合作伙伴集成PackyCodev3.6.1 新增官方合作伙伴PackyCode改动落在各应用的供应商预设中添加到 Claude 和 Codex 供应商预设、支持 10% 折扣优惠促销信息通过 i18n key 集成、新增 Logo 和合作伙伴标识packycode.png。从当前源码确认预设定义位于 claudeProviderPresets.ts 与 codexProviderPresets.ts其中partnerPromotionKey: packycode字段驱动促销文案的多语言渲染icon: packycode驱动卡片图标后续版本Gemini、Claude Desktop 等也沿用了同一预设结构。五、用户体验优化拖拽排序与托盘菜单同步5.1 拖拽排序后托盘菜单实时同步#179修复前拖拽调整供应商顺序后系统托盘菜单的顺序不会更新UI 与托盘出现不一致。修复方案是在排序完成后自动调用updateTrayMenu。当前实现见 useDragSort.tshandleDragEnd先把新顺序写回后端providersApi.updateSortOrder失效 React Query 缓存若目标是路由类应用isProxyAppId还会失效failoverQueue查询因为故障转移顺序就是从排序派生的最后才调用providersApi.updateTrayMenu()同步托盘菜单。5.2 错误隔离托盘失败不阻塞主流程同一段代码体现了 v3.6.1“稳定性改进”的核心思想——错误隔离托盘菜单更新被包在独立的try/catch中见 useDragSort.ts注释写明“托盘菜单更新失败不影响排序成功”失败仅记录日志、不抛出。即“主操作成功但托盘更新失败时给出警告而非整体失败”。5.3 其他 UX 改进与稳定性修复错误通知增强切换供应商失败时显示可复制的错误信息移除误导性占位符删除模型输入框的示例文本避免用户误以为要照抄Base URL 自动填充所有非官方供应商类别自动填充 Base URL 输入框安全模式匹配后端将unwrap()替换为安全的 pattern matching托盘菜单事件处理使用match模式避免 panic 导致应用崩溃导入配置分类从默认配置导入时自动把category设置为custom避免导入配置被误认为官方预设提供更清晰的配置来源标识用量脚本面板白屏崩溃修复根因是FormLabel组件内部调用useFormField()hook 需要FormFieldContext而该面板没有提供此 context导致整个应用崩溃修复方式是替换为不依赖 FormField 的独立Label组件。六、Bug 修复清单汇总修复项根因修复手段用量脚本面板白屏FormLabel依赖缺失的FormFieldContext改用独立Label组件中文输入法引号解析失败IME 全角引号非法进入 TOML新增textNormalization工具解析前归一化拖拽排序托盘不同步 (#179)排序完成后未刷新托盘排序后自动调用updateTrayMenu贡献者 ZyphrZeroMCP 自定义字段丢失规范化时丢弃未知字段spread 保留全部字段normalizeServerConfig保留扩展字段托盘更新失败影响主流程错误未隔离托盘更新与主操作解耦失败降级为警告潜在 panic 崩溃使用unwrap()替换为安全 pattern matching七、安装方式v3.6.1macOS通过 Homebrew 安装推荐brew tap farion1231/ccswitch brew install --cask cc-switch或手动下载发布资产CC-Switch-v3.6.1-macOS.zip。注意由于作者没有苹果开发者账号首次打开可能出现“未知开发者”警告。请前往“系统设置” → “隐私与安全性” → 点击“仍要打开”。Windows安装包CC-Switch-v3.6.1-Windows.msi便携版CC-Switch-v3.6.1-Windows-Portable.zipLinuxAppImageCC-Switch-v3.6.1-Linux.AppImageDebianCC-Switch-v3.6.1-Linux.deb完整变更记录与多语言发布说明见 CHANGELOG.md 及 v3.6.1 英文版。附录v3.6.0 完整功能回顾v3.6.1 基于 v3.6.02025-11-07为便于了解完整功能集此处继承发布说明中的回顾要点供应商管理与编辑模式供应商复制一键复制现有供应商配置创建变体复制插入位置修复为原供应商旁边手动排序拖拽重排供应商带视觉推送效果动画编辑模式可显示/隐藏拖拽手柄多端点配置聚合类供应商支持多个 API 端点非官方供应商自动显示端点字段。自定义配置目录云同步自定义 cc-switch 配置存储目录指向 Dropbox、OneDrive、iCloud Drive、坚果云等云同步文件夹即可实现跨设备配置自动同步通过 Tauri Store 独立管理隔离性和可靠性更好。配置目录切换WSL 支持切换 Claude/Codex 配置目录如 WSL 环境时自动同步当前供应商到新目录统一的postChangeSync.ts后置同步工具优雅处理错误而不阻塞主流程配置导入后自动同步“完全成功”与“部分成功”状态区分提供精确反馈。Claude 配置数据结构增强模型配置从双键系统升级到四键系统匹配官方最新数据结构新增ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_MODEL替换旧版ANTHROPIC_SMALL_FAST_MODEL后端在首次读写时自动规范化旧配置并带智能回退链UI 从 2 个模型输入字段扩展到 4 个具有智能默认值支持ANTHROPIC_API_KEY除ANTHROPIC_AUTH_TOKEN外模板变量系统如 KAT-Coder 的ENDPOINT_ID端点候选列表用于速度测试供应商卡片自定义图标和颜色。架构重构后端Rust五阶段统一错误处理AppError 国际化错误消息→ 命令层按领域拆分commands/{provider,mcp,config,settings,plugin,misc}.rs→ 集成测试和事务机制配置快照 失败回滚→ 提取 Service 层services/{provider,mcp,config,speedtest}.rs→ 并发优化RwLock替代Mutex作用域 guard 避免死锁。前端React TypeScript四阶段测试基础设施vitest MSW testing-library/react→ 提取自定义 hooksuseProviderActions、useMcpActions、useSettings、useImportExport等→ 组件拆分和业务逻辑提取 → 代码清理与格式化统一。所有 Tauri 命令参数统一为 camelCaseTauri 2 规范AppType重命名为AppId并用FromStrtrait 集中解析app参数。内部优化与依赖移除 v1 配置自动迁移与副本文件扫描逻辑提升启动性能v2 格式配置完全兼容。注意从 v3.1.0 或更早版本升级的用户请先升级到 v3.2.x 或 v3.5.x 完成一次性迁移再升级到 v3.6.0依赖更新Tauri 2.8.x、TailwindCSS 4.x、TanStack Query v5.90.x、React 18.2.x、TypeScript 5.3.x。小结v3.6.1 是一个典型的“健壮性版本”用量查询凭证解耦让查询链路与供应商链路可以独立配置textNormalization与normalizeServerConfig两个看似细小的改动分别解决了中文 IME 用户 TOML 解析失败和 MCP 扩展字段丢失这两类真实世界的数据丢失问题而拖拽排序与托盘菜单的错误隔离则把“局部失败”与“整体失败”明确区分开。这些改动共同保证了 cc-switch 在多语言输入法环境、自定义 MCP 协议字段和高频切换场景下的稳定运行。【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考