CC Switch v3.12.3 发版解析Copilot 反向代理、Reasoning Effort 映射与 SQLite 双后端实现【免费下载链接】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.12.3 的官方发布说明v3.12.3-ja.md同系列还有 中文版 与 英文版系统梳理该版本的核心变更GitHub Copilot 反向代理与认证中心、Reasoning Effort 自动映射、Tool Search 环境变量化、Skill 备份/恢复生命周期、OpenCode SQLite 后端等并结合开源仓库中的 Rust 前端源码与单元测试逐项说明这些功能在实现层的真实行为与边界条件帮助你在启用这些能力前准确理解其原理与风险。版本概览CC Switch v3.12.3发布于 2026-03-24更新规模为36 个 commits、107 个文件变更、9,124 / -802 行代码。该版本的核心目标包括新增 GitHub Copilot 反向代理与 Copilot Auth Center使 Copilot 令牌可以访问 Claude/OpenAI APImacOS 构建引入 Apple 代码签名与公证消除「开发元を確認できません」警告并提供 DMG 安装包代理层自动将 Claude 的 thinking budget 映射为 OpenAI 兼容的reasoning_effort参数Tool Search 从二进制补丁方式迁移到 Claude 2.1.76 原生ENABLE_TOOL_SEARCH环境变量OpenCode 会话存储从 JSON 扩展为 SQLite 双后端同时包含 Skill 备份/恢复、代理 gzip 压缩、o 系列模型兼容性修复等一批工程改进。GitHub Copilot 反向代理与 Copilot Auth Center本版本最大的功能是 GitHub Copilot 反向代理使用 Copilot 访问令牌从 Claude Code、Codex 等客户端经由 CC Switch 代理转发 API 请求访问 Claude API 与 OpenAI API。实现层面仓库src-tauri/src/proxy/providers/下可以看到对应的模块化拆分copilot_auth.rs负责令牌获取与管理支持 GitHub 设备流程device flow取令牌、令牌有效期管理与自动刷新copilot_model_map.rs负责 Copilot 侧模型名的映射copilot_optimizer.rs针对 Copilot 服务端的请求优化处理。从源码结构看Copilot 请求需要处理「请求指纹」fingerprint与特定头部本版本的 Bug 修复章节也专门提到修复了「Copilot 反向代理的请求指纹生成缺陷导致的认证错误」说明指纹构造是这一链路中认证成败的关键环节。前端则新增 Copilot Auth Center可直接查看令牌状态并触发重新认证无需进入代理面板配置。⚠️风险免责原文档明确声明Copilot 反向代理通过逆向工程方式访问非官方 API可能违反 GitHub 服务条款与附加产品条款已有用户报告收到「脚本化交互/异常过度使用」警告邮件继续使用者可能被临时或永久停用 Copilot 访问。启用此功能即视为用户自行承担全部风险CC Switch 对由此导致的账户限制、警告或服务停用不承担责任。生产环境启用前请务必自行评估合规风险。Reasoning Effort 自动映射Claude thinking 预算 → OpenAI effort当 Claude Code 这类客户端通过 CC Switch 代理访问 OpenAI o 系列或 GPT-5 模型时Anthropic 请求体里的 thinking 配置无法被 OpenAI 直接理解。本版本在代理转换层实现了自动映射核心实现位于 transform.rs 中的resolve_reasoning_effort函数约 L83-L124采用两级解析策略优先级 1显式output_config.effort若请求体带有output_config.effort直接映射并尊重用户意图请求值映射结果说明low/medium/high同名透传1:1 映射maxxhighOpenAI 的xhigh即最大推理强度其他未知值不注入保守处理避免向严格后端发送未知字段优先级 2thinking.typebudget_tokens回退阈值thinking 配置映射结果type: adaptivexhighadaptive 即最大推理强度type: enabledbudget 4000lowtype: enabled4000 ≤ budget 16000mediumtype: enabledbudget ≥ 16000hightype: enabled但无 budgethigh保守默认disabled或缺失 thinking 字段不注入模型白名单由supports_reasoning_effort同文件 L71-L81判定o 系列o1、o3、o4-mini 等、GPT-5gpt-5、gpt-5.x、gpt-5-codex等、以及 xAI Grok Build 模型grok-4.5、grok-build-*gpt-4o、claude-sonnet-4-6等不支持的模型不会注入该字段。这一能力覆盖 Chat Completions 与 Responses API 两条路径并配有完整的单元测试如test_output_config_max_maps_to_reasoning_effort_xhigh、test_thinking_budget_fallback_*等位于 transform.rs 的测试模块。Tool Search从二进制补丁迁移到环境变量本版本将 Claude CLI 的 Tool Search 开关机制整体迁移废弃以往对 CLI 二进制的补丁方式改用 Claude 2.1.76 原生支持的环境变量ENABLE_TOOL_SEARCH。迁移后不再需要在每次 CLI 升级后重新打补丁。该开关在 UI 上暴露于通用配置Common Config编辑器与 Teammates 模式、高强度思考等开关位于同一行实现见 CommonConfigEditor.tsx前端表单与 claudeProviderPresets.ts预设定义持久化与写入逻辑位于后端 services/provider/mod.rs。相关测试见 CommonConfigEditor.test.tsx。Skill 备份 / 恢复生命周期本版本为 Skill技能文件补齐了完整的备份/恢复闭环防止卸载导致数据丢失自动备份卸载 Skill 前先将全部 skill 文件与元数据备份至~/.cc-switch/skill-backups/每个备份包含meta.json旧备份自动剪枝最多保留 20 份备份路径会返回前端并在成功提示中展示。列表/恢复/删除新增管理命令可列出所有可用备份含元数据、恢复备份将文件复制回 SSOT、保存 DB 记录、同步到当前应用失败时自动回滚、删除备份需确认对话框。安全加固从源码 skill.rs 可见meta.json中的directory字段被视为不可信输入——备份可能来自手工放置或不可信来源代码对 join 进文件系统路径的字段做了校验并有专门测试如restore must reject a traversal directory from meta.json拒绝目录穿越traversal路径防止备份恢复成为任意文件读写面。前端配套为ConfirmDialog增加了可配置的zIndex属性以支持嵌套对话框堆叠保证恢复/删除确认层能正确压在备份列表对话框之上。OpenCode SQLite 双后端OpenCode 的会话存储由单一 JSON 扩展为 JSON SQLite 双后端双后端扫描同时扫描两种存储会话 ID 冲突时以 SQLite 为准原子删除与路径校验SQLite 侧的会话删除为原子操作并校验会话文件路径向后兼容JSON 后端继续保留存量数据不受影响。这一设计允许使用 OpenCode 新版 SQLite 会话存储的用户与旧版 JSON 用户在同一应用中混合管理会话。Codex 1M 上下文窗口开关设置编辑器新增一键开关直接改写 Codex 的config.toml勾选后写入model_context_window 1000000同时自动设置model_auto_compact_token_limit 900000自动压缩阈值略低于窗口上限取消勾选时两个字段均被干净移除不残留空值。后端读取逻辑见 codex_config.rs当config.toml未显式设置model_context_window时目录构建回退到 128,000显式设置 1,000,000 后模型目录的上下文窗口默认值会跟随该值该文件内含build_simplified_catalog_respects_explicit_model_context_window等测试用例。自动升级禁用开关Claude 通用配置编辑器新增DISABLE_AUTOUPDATER环境变量复选框实现同样位于 CommonConfigEditor.tsx启用后写入DISABLE_AUTOUPDATER1阻止 Claude Code 自动升级便于锁定 CLI 版本以匹配已调好的补丁/配置环境与 Teammates、Tool Search、高强度思考开关同排展示。macOS 代码签名与公证v3.12.3 的 macOS 构建完成 Apple Developer ID 签名 Apple 公证服务公证CI/CD 流水线集成了签名/公证步骤首次启动不再出现「开发元を確認できません」警告可直接安装使用新增 DMG 安装包支持拖拽安装文档层面同步更新README含日文/中文版本、安装指南EN/ZH/JA、FAQ 页面中的xattr规避方法与旧警告说明全部移除替换为「已完成 Apple 代码签名与公证」的统一表述。代理 Gzip 压缩非流式代理请求现自动协商 gzip 压缩以降低带宽消耗。实现细节见 content_encoding.rs非流式路径reqwest 自动协商 gzip响应透传解压流式路径为避免 SSE 流被截断时产生解压错误保守保持Accept-Encoding: identity不做压缩堆叠编码支持解压模块支持 HTTP 规范允许的多编码堆叠如gzip, zstd需按反向顺序逐层解压并有对应测试decompress_body_stacked_gzip_then_zstd_decodes_in_reverse解压炸弹防护decompress_body_with_limit在流式解压过程中强制执行体积上限测试decompress_body_with_limit_aborts_gzip_bomb_mid_stream验证了伪随机数据被截断流触发中途中止防止恶意压缩 payload 耗尽内存。o 系列模型兼容性修复代理转发对 OpenAI o 系列模型的 token 参数处理被修正Chat Completions 路径o1/o3/o4-mini 模型改用max_completion_tokens替代max_tokens。对应源码在 transform.rs 的anthropic_to_openai_with_reasoning_contentL186-L194is_openai_o_series(model)为真时改写字段名其余模型保持max_tokensResponses API 路径保持正确的max_output_tokens字段防止错误注入max_completion_tokens此前会导致 o 系列在 Responses 协议下报参数错误。其他变更与 Bug 修复变更摘选Skills 缓存策略优化改进缓存过期管理与失效策略减少不必要的缓存重建缩短启动时间模型预设更新Claude 4.6 上下文窗口尺寸更新、MiniMax 预设升级至 M2.7、小米 MiMo 预设模型 ID 与参数更新AddProviderDialog 简化移除冗余 OAuth 标签页对话框从 3 标签精简为 2 标签应用专属 通用提供商表单高级选项折叠Claude 表单的模型映射、API 格式等高级字段在未填写时默认折叠预设写入后自动展开手动清空则不自动折叠OpenCode 模型变体位置调整变体从 options 内部移至预设顶层提升可发现性#1317Skills 导入流程重构以显式ImportSkillSelection取代基于文件系统的隐式应用推断防止同一 skill 目录位于多个应用路径时误启用多个应用sync_to_app新增调整逻辑清理失效/孤立符号链接MCPsync_all_enabled可从实时配置移除已禁用服务器模式迁移保留遗留应用映射快照避免有损重建。Bug 修复完整清单修复项说明WebDAV 密码丢失修复保存无关配置时 WebDAV 密码被静默清空的问题工具消息解析修复代理工具消息解析缺陷消除特定工具调用模式下的报错暗色模式显示修复暗色模式下部分 UI 组件显示异常Copilot 请求指纹修复 Copilot 反向代理指纹生成缺陷导致的认证错误提供商表单重复提交防止快速连续点击导致的重复提交#1352Ghostty 会话恢复修复 Ghostty 终端中 Claude 会话恢复失败#1506Skill ZIP 导入扩展名ZIP 导入对话框支持.skill文件扩展名#1240、#1455Skill ZIP 目标应用ZIP 安装的 skill 不再固定默认 Claude改为使用当前激活应用OpenClaw 卡片高亮修复 OpenClaw 当前激活的提供商卡片不高亮#1419响应式布局存在 TOC 标题时的响应式设计改进#1491Skills 导入白屏ImportSkillsDialog 补充缺失的 TooltipProvider防止打开时运行时崩溃面板底部空白各内容面板硬编码的h-[calc(100vh-8rem)]统一替换为flex-1 min-h-0消除跨平台底部间隙文档中英日三语用户手册新增模型 ID 规范化规则说明前缀移除、后缀截断、→-替换#1591。下载与安装系统要求系统最低版本架构WindowsWindows 10 及以上x64macOSmacOS 12 (Monterey) 及以上Intel (x64) / Apple Silicon (arm64)Linux见下表x64Windows文件说明CC-Switch-v3.12.3-Windows.msi推荐 — MSI 安装器支持自动更新CC-Switch-v3.12.3-Windows-Portable.zip便携版解压即用不写注册表macOS文件说明CC-Switch-v3.12.3-macOS.dmg推荐 — DMG 安装器拖拽安装CC-Switch-v3.12.3-macOS.zip解压后拖入 ApplicationsUniversal BinaryCC-Switch-v3.12.3-macOS.tar.gzHomebrew 安装与自动更新用macOS 版本已完成 Apple 代码签名与公证可直接安装使用。HomebrewmacOSbrew tap farion1231/ccswitch brew install --cask cc-switch升级brew upgrade --cask cc-switchLinux发行版推荐格式安装方式Ubuntu / Debian / Linux Mint / Pop!_OS.debsudo dpkg -i CC-Switch-*.deb或sudo apt install ./CC-Switch-*.debFedora / RHEL / CentOS / Rocky Linux.rpmsudo rpm -i CC-Switch-*.rpm或sudo dnf install ./CC-Switch-*.rpmopenSUSE.rpmsudo zypper install ./CC-Switch-*.rpmArch Linux / Manjaro.AppImage赋予执行权限直接运行或使用 AUR其他发行版 / 未知.AppImagechmod x CC-Switch-*.AppImage ./CC-Switch-*.AppImage小结v3.12.3 是 CC Switch 能力面显著扩大的一个版本Copilot 反向代理把「一个令牌访问多家 API」的玩法落地到产品并明确标注了合规风险Reasoning Effort 映射与 o 系列 token 参数修复显著提升了 Claude 客户端经代理访问 OpenAI 推理模型时的参数保真度Skill 备份生命周期与 OpenCode SQLite 双后端则补齐了数据管理与存储演进两块短板。如果你依赖代理转发到 OpenAI 系模型建议重点阅读上文关于reasoning_effort阈值映射与max_completion_tokens字段选择的说明以便在调试模型行为差异时准确定位参数链路。【免费下载链接】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.12.3 发版解析：Copilot 反向代理、Reasoning Effort 映射与 SQLite 双后端实现
CC Switch v3.12.3 发版解析Copilot 反向代理、Reasoning Effort 映射与 SQLite 双后端实现【免费下载链接】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.12.3 的官方发布说明v3.12.3-ja.md同系列还有 中文版 与 英文版系统梳理该版本的核心变更GitHub Copilot 反向代理与认证中心、Reasoning Effort 自动映射、Tool Search 环境变量化、Skill 备份/恢复生命周期、OpenCode SQLite 后端等并结合开源仓库中的 Rust 前端源码与单元测试逐项说明这些功能在实现层的真实行为与边界条件帮助你在启用这些能力前准确理解其原理与风险。版本概览CC Switch v3.12.3发布于 2026-03-24更新规模为36 个 commits、107 个文件变更、9,124 / -802 行代码。该版本的核心目标包括新增 GitHub Copilot 反向代理与 Copilot Auth Center使 Copilot 令牌可以访问 Claude/OpenAI APImacOS 构建引入 Apple 代码签名与公证消除「开发元を確認できません」警告并提供 DMG 安装包代理层自动将 Claude 的 thinking budget 映射为 OpenAI 兼容的reasoning_effort参数Tool Search 从二进制补丁方式迁移到 Claude 2.1.76 原生ENABLE_TOOL_SEARCH环境变量OpenCode 会话存储从 JSON 扩展为 SQLite 双后端同时包含 Skill 备份/恢复、代理 gzip 压缩、o 系列模型兼容性修复等一批工程改进。GitHub Copilot 反向代理与 Copilot Auth Center本版本最大的功能是 GitHub Copilot 反向代理使用 Copilot 访问令牌从 Claude Code、Codex 等客户端经由 CC Switch 代理转发 API 请求访问 Claude API 与 OpenAI API。实现层面仓库src-tauri/src/proxy/providers/下可以看到对应的模块化拆分copilot_auth.rs负责令牌获取与管理支持 GitHub 设备流程device flow取令牌、令牌有效期管理与自动刷新copilot_model_map.rs负责 Copilot 侧模型名的映射copilot_optimizer.rs针对 Copilot 服务端的请求优化处理。从源码结构看Copilot 请求需要处理「请求指纹」fingerprint与特定头部本版本的 Bug 修复章节也专门提到修复了「Copilot 反向代理的请求指纹生成缺陷导致的认证错误」说明指纹构造是这一链路中认证成败的关键环节。前端则新增 Copilot Auth Center可直接查看令牌状态并触发重新认证无需进入代理面板配置。⚠️风险免责原文档明确声明Copilot 反向代理通过逆向工程方式访问非官方 API可能违反 GitHub 服务条款与附加产品条款已有用户报告收到「脚本化交互/异常过度使用」警告邮件继续使用者可能被临时或永久停用 Copilot 访问。启用此功能即视为用户自行承担全部风险CC Switch 对由此导致的账户限制、警告或服务停用不承担责任。生产环境启用前请务必自行评估合规风险。Reasoning Effort 自动映射Claude thinking 预算 → OpenAI effort当 Claude Code 这类客户端通过 CC Switch 代理访问 OpenAI o 系列或 GPT-5 模型时Anthropic 请求体里的 thinking 配置无法被 OpenAI 直接理解。本版本在代理转换层实现了自动映射核心实现位于 transform.rs 中的resolve_reasoning_effort函数约 L83-L124采用两级解析策略优先级 1显式output_config.effort若请求体带有output_config.effort直接映射并尊重用户意图请求值映射结果说明low/medium/high同名透传1:1 映射maxxhighOpenAI 的xhigh即最大推理强度其他未知值不注入保守处理避免向严格后端发送未知字段优先级 2thinking.typebudget_tokens回退阈值thinking 配置映射结果type: adaptivexhighadaptive 即最大推理强度type: enabledbudget 4000lowtype: enabled4000 ≤ budget 16000mediumtype: enabledbudget ≥ 16000hightype: enabled但无 budgethigh保守默认disabled或缺失 thinking 字段不注入模型白名单由supports_reasoning_effort同文件 L71-L81判定o 系列o1、o3、o4-mini 等、GPT-5gpt-5、gpt-5.x、gpt-5-codex等、以及 xAI Grok Build 模型grok-4.5、grok-build-*gpt-4o、claude-sonnet-4-6等不支持的模型不会注入该字段。这一能力覆盖 Chat Completions 与 Responses API 两条路径并配有完整的单元测试如test_output_config_max_maps_to_reasoning_effort_xhigh、test_thinking_budget_fallback_*等位于 transform.rs 的测试模块。Tool Search从二进制补丁迁移到环境变量本版本将 Claude CLI 的 Tool Search 开关机制整体迁移废弃以往对 CLI 二进制的补丁方式改用 Claude 2.1.76 原生支持的环境变量ENABLE_TOOL_SEARCH。迁移后不再需要在每次 CLI 升级后重新打补丁。该开关在 UI 上暴露于通用配置Common Config编辑器与 Teammates 模式、高强度思考等开关位于同一行实现见 CommonConfigEditor.tsx前端表单与 claudeProviderPresets.ts预设定义持久化与写入逻辑位于后端 services/provider/mod.rs。相关测试见 CommonConfigEditor.test.tsx。Skill 备份 / 恢复生命周期本版本为 Skill技能文件补齐了完整的备份/恢复闭环防止卸载导致数据丢失自动备份卸载 Skill 前先将全部 skill 文件与元数据备份至~/.cc-switch/skill-backups/每个备份包含meta.json旧备份自动剪枝最多保留 20 份备份路径会返回前端并在成功提示中展示。列表/恢复/删除新增管理命令可列出所有可用备份含元数据、恢复备份将文件复制回 SSOT、保存 DB 记录、同步到当前应用失败时自动回滚、删除备份需确认对话框。安全加固从源码 skill.rs 可见meta.json中的directory字段被视为不可信输入——备份可能来自手工放置或不可信来源代码对 join 进文件系统路径的字段做了校验并有专门测试如restore must reject a traversal directory from meta.json拒绝目录穿越traversal路径防止备份恢复成为任意文件读写面。前端配套为ConfirmDialog增加了可配置的zIndex属性以支持嵌套对话框堆叠保证恢复/删除确认层能正确压在备份列表对话框之上。OpenCode SQLite 双后端OpenCode 的会话存储由单一 JSON 扩展为 JSON SQLite 双后端双后端扫描同时扫描两种存储会话 ID 冲突时以 SQLite 为准原子删除与路径校验SQLite 侧的会话删除为原子操作并校验会话文件路径向后兼容JSON 后端继续保留存量数据不受影响。这一设计允许使用 OpenCode 新版 SQLite 会话存储的用户与旧版 JSON 用户在同一应用中混合管理会话。Codex 1M 上下文窗口开关设置编辑器新增一键开关直接改写 Codex 的config.toml勾选后写入model_context_window 1000000同时自动设置model_auto_compact_token_limit 900000自动压缩阈值略低于窗口上限取消勾选时两个字段均被干净移除不残留空值。后端读取逻辑见 codex_config.rs当config.toml未显式设置model_context_window时目录构建回退到 128,000显式设置 1,000,000 后模型目录的上下文窗口默认值会跟随该值该文件内含build_simplified_catalog_respects_explicit_model_context_window等测试用例。自动升级禁用开关Claude 通用配置编辑器新增DISABLE_AUTOUPDATER环境变量复选框实现同样位于 CommonConfigEditor.tsx启用后写入DISABLE_AUTOUPDATER1阻止 Claude Code 自动升级便于锁定 CLI 版本以匹配已调好的补丁/配置环境与 Teammates、Tool Search、高强度思考开关同排展示。macOS 代码签名与公证v3.12.3 的 macOS 构建完成 Apple Developer ID 签名 Apple 公证服务公证CI/CD 流水线集成了签名/公证步骤首次启动不再出现「开发元を確認できません」警告可直接安装使用新增 DMG 安装包支持拖拽安装文档层面同步更新README含日文/中文版本、安装指南EN/ZH/JA、FAQ 页面中的xattr规避方法与旧警告说明全部移除替换为「已完成 Apple 代码签名与公证」的统一表述。代理 Gzip 压缩非流式代理请求现自动协商 gzip 压缩以降低带宽消耗。实现细节见 content_encoding.rs非流式路径reqwest 自动协商 gzip响应透传解压流式路径为避免 SSE 流被截断时产生解压错误保守保持Accept-Encoding: identity不做压缩堆叠编码支持解压模块支持 HTTP 规范允许的多编码堆叠如gzip, zstd需按反向顺序逐层解压并有对应测试decompress_body_stacked_gzip_then_zstd_decodes_in_reverse解压炸弹防护decompress_body_with_limit在流式解压过程中强制执行体积上限测试decompress_body_with_limit_aborts_gzip_bomb_mid_stream验证了伪随机数据被截断流触发中途中止防止恶意压缩 payload 耗尽内存。o 系列模型兼容性修复代理转发对 OpenAI o 系列模型的 token 参数处理被修正Chat Completions 路径o1/o3/o4-mini 模型改用max_completion_tokens替代max_tokens。对应源码在 transform.rs 的anthropic_to_openai_with_reasoning_contentL186-L194is_openai_o_series(model)为真时改写字段名其余模型保持max_tokensResponses API 路径保持正确的max_output_tokens字段防止错误注入max_completion_tokens此前会导致 o 系列在 Responses 协议下报参数错误。其他变更与 Bug 修复变更摘选Skills 缓存策略优化改进缓存过期管理与失效策略减少不必要的缓存重建缩短启动时间模型预设更新Claude 4.6 上下文窗口尺寸更新、MiniMax 预设升级至 M2.7、小米 MiMo 预设模型 ID 与参数更新AddProviderDialog 简化移除冗余 OAuth 标签页对话框从 3 标签精简为 2 标签应用专属 通用提供商表单高级选项折叠Claude 表单的模型映射、API 格式等高级字段在未填写时默认折叠预设写入后自动展开手动清空则不自动折叠OpenCode 模型变体位置调整变体从 options 内部移至预设顶层提升可发现性#1317Skills 导入流程重构以显式ImportSkillSelection取代基于文件系统的隐式应用推断防止同一 skill 目录位于多个应用路径时误启用多个应用sync_to_app新增调整逻辑清理失效/孤立符号链接MCPsync_all_enabled可从实时配置移除已禁用服务器模式迁移保留遗留应用映射快照避免有损重建。Bug 修复完整清单修复项说明WebDAV 密码丢失修复保存无关配置时 WebDAV 密码被静默清空的问题工具消息解析修复代理工具消息解析缺陷消除特定工具调用模式下的报错暗色模式显示修复暗色模式下部分 UI 组件显示异常Copilot 请求指纹修复 Copilot 反向代理指纹生成缺陷导致的认证错误提供商表单重复提交防止快速连续点击导致的重复提交#1352Ghostty 会话恢复修复 Ghostty 终端中 Claude 会话恢复失败#1506Skill ZIP 导入扩展名ZIP 导入对话框支持.skill文件扩展名#1240、#1455Skill ZIP 目标应用ZIP 安装的 skill 不再固定默认 Claude改为使用当前激活应用OpenClaw 卡片高亮修复 OpenClaw 当前激活的提供商卡片不高亮#1419响应式布局存在 TOC 标题时的响应式设计改进#1491Skills 导入白屏ImportSkillsDialog 补充缺失的 TooltipProvider防止打开时运行时崩溃面板底部空白各内容面板硬编码的h-[calc(100vh-8rem)]统一替换为flex-1 min-h-0消除跨平台底部间隙文档中英日三语用户手册新增模型 ID 规范化规则说明前缀移除、后缀截断、→-替换#1591。下载与安装系统要求系统最低版本架构WindowsWindows 10 及以上x64macOSmacOS 12 (Monterey) 及以上Intel (x64) / Apple Silicon (arm64)Linux见下表x64Windows文件说明CC-Switch-v3.12.3-Windows.msi推荐 — MSI 安装器支持自动更新CC-Switch-v3.12.3-Windows-Portable.zip便携版解压即用不写注册表macOS文件说明CC-Switch-v3.12.3-macOS.dmg推荐 — DMG 安装器拖拽安装CC-Switch-v3.12.3-macOS.zip解压后拖入 ApplicationsUniversal BinaryCC-Switch-v3.12.3-macOS.tar.gzHomebrew 安装与自动更新用macOS 版本已完成 Apple 代码签名与公证可直接安装使用。HomebrewmacOSbrew tap farion1231/ccswitch brew install --cask cc-switch升级brew upgrade --cask cc-switchLinux发行版推荐格式安装方式Ubuntu / Debian / Linux Mint / Pop!_OS.debsudo dpkg -i CC-Switch-*.deb或sudo apt install ./CC-Switch-*.debFedora / RHEL / CentOS / Rocky Linux.rpmsudo rpm -i CC-Switch-*.rpm或sudo dnf install ./CC-Switch-*.rpmopenSUSE.rpmsudo zypper install ./CC-Switch-*.rpmArch Linux / Manjaro.AppImage赋予执行权限直接运行或使用 AUR其他发行版 / 未知.AppImagechmod x CC-Switch-*.AppImage ./CC-Switch-*.AppImage小结v3.12.3 是 CC Switch 能力面显著扩大的一个版本Copilot 反向代理把「一个令牌访问多家 API」的玩法落地到产品并明确标注了合规风险Reasoning Effort 映射与 o 系列 token 参数修复显著提升了 Claude 客户端经代理访问 OpenAI 推理模型时的参数保真度Skill 备份生命周期与 OpenCode SQLite 双后端则补齐了数据管理与存储演进两块短板。如果你依赖代理转发到 OpenAI 系模型建议重点阅读上文关于reasoning_effort阈值映射与max_completion_tokens字段选择的说明以便在调试模型行为差异时准确定位参数链路。【免费下载链接】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），仅供参考