尧图网站建设 
CC Switch v3.12.1 版本技术解析StepFun 预设、OpenClaw authHeader 与同步稳定性修复【免费下载链接】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.1 官方发布说明docs/release-notes/v3.12.1-zh.md展开结合仓库源码逐一印证本版本的四项核心技术变更StepFun阶跃星辰供应商预设的完整配置结构、OpenClaw 模型高级选项中输入类型input type与authHeader认证头的实现方式以及 WebDAV 同步中provider_health外键约束失败的修复原理。读完本文你可以准确理解该补丁版本19 commits | 56 files changed | 1,429 / -396 lines发布于 2026-03-12解决了哪些问题并掌握新版本带来的供应商配置能力。版本概览CC Switch v3.12.1 是一个以稳定性改进和 Bug 修复为主的补丁版本同时携带少量功能性增强。发布说明中列出的重点内容可归纳为六个方向通用配置弹窗修复解决了通用配置弹窗无限重复打开的循环问题并新增草稿编辑支持WebDAV 同步可靠性修复了 WebDAV 同步恢复provider_health表时的外键约束失败StepFun 预设新增 StepFun阶跃星辰供应商预设包含 step-3.5-flash 模型OpenClaw 增强新增模型高级选项的输入类型input type选择和authHeader字段支持供应商特定的认证头Gemini 模型升级供应商预设中的默认 Gemini 模型从 2.5-pro 升级到 3.1-pro新赞助商欢迎 Micu API、XCodeAPI、SiliconFlow硅基流动、CTok 四位伙伴加入赞助。下文按“新功能 → 变更 → Bug 修复 → 下载安装”的顺序逐项结合源码给出佐证与深入说明。新功能StepFun阶跃星辰供应商预设本版本在多个支持的应用中新增了 StepFun 预设条目#1369。从源码可以看到预设定义集中位于 src/config/openclawProviderPresets.ts分别提供了面向国内站platform.stepfun.com和面向国际站platform.stepfun.ai的两套预设StepFun与StepFun en。以国内站预设为例其核心配置为{ baseUrl: https://api.stepfun.com/step_plan/v1, apiKey: , api: openai-completions, models: [ { id: step-3.5-flash-2603, name: Step 3.5 Flash 2603, contextWindow: 262144 }, { id: step-3.5-flash, name: Step 3.5 Flash, contextWindow: 262144 } ] }几个值得注意的实现细节预设将 API 协议类型固定为openai-completions即 StepFun 的 Step Plan 端点走 OpenAI 兼容的 completions 接口用户只需填入以step-开头的 API Key 即可接入两个模型均声明了 262144256K的上下文窗口其中step-3.5-flash-2603是带日期后缀的版本化模型 ID预设还通过suggestedDefaults建议默认主模型为stepfun/step-3.5-flash-2603并在modelCatalog中注册StepFun、StepFun Flash两个别名保证模型选择器中的显示名称可读。同一预设文件src/config/openclawProviderPresets.ts中紧随其后的StepFun en预设结构完全一致仅将 Base URL 切换为https://api.stepfun.ai/step_plan/v1、模型前缀改为stepfun-en/体现了 CC Switch “一个供应商、多区域站点”的预设组织惯例。OpenClaw 增强输入类型选择与 authHeader 认证头本版本对 OpenClaw 的配置能力做了两处增强#1368 及相关重构使 OpenClaw 供应商配置更贴近上游 schema。模型高级选项的输入类型input type在 OpenClaw 供应商表单的模型高级选项中新增了输入类型选择。从 src/components/providers/forms/OpenClawFormFields.tsx 可以看到其实现模型展开后提供text与image两个复选框对应写入模型配置中的input数组字段{([text, image] as const).map((type) ( Checkbox checked{(model.input ?? [text]).includes(type)} onCheckedChange{(checked) { const current model.input ?? [text]; const next checked ? [...new Set([...current, type])] : current.filter((value) value ! type); handleModelChange(index, input, next); }} / ))}从源码结构看input的默认值约定为[text]未显式勾选时模型只声明支持文本输入勾选image后数组变为[text, image]用于向 OpenClaw 声明该模型具备多模态图像输入能力。这一细粒度控制对“同一供应商下部分模型支持图像、部分不支持”的场景尤为有用。OpenClawProviderConfig 新增 authHeader 字段发布说明提到在OpenClawProviderConfig中新增了可选的authHeader布尔字段支持供应商特定的认证头。该字段定义于 src/types.ts// OpenClaw 供应商配置settings_config 结构 // 对应 OpenClaw 的 models.providers.provider-id 配置 export interface OpenClawProviderConfig { baseUrl?: string; // API 端点 apiKey?: string; // API 密钥 api?: string; // API 协议类型如 openai-completions、anthropic models?: OpenClawModel[]; // 可用模型列表 headers?: Recordstring, string; // 自定义请求头如 User-Agent authHeader?: boolean; // 供应商自定义认证开关如 Longcat }authHeader的语义是部分供应商要求将 API Key 放入供应商自定义的认证请求头而不是标准的Authorization: Bearer方案。启用该开关后生成的 OpenClawmodels.providers.provider-id配置会声明使用供应商特定的认证头。同一次提交还重构了表单状态以复用共享类型保证前端表单状态与上述 TypeScript 契约保持一致。赞助商伙伴本版本新增四位赞助伙伴Micu API含推广链接、XCodeAPI、SiliconFlow硅基流动含推广链接、CTok。赞助信息展示于应用内的伙伴入口对应的品牌素材位于 assets/partners/logos/ 目录如 silicon_zh.jpg。变更UCloud 更名为 Compshare优云智算原 UCloud 供应商更名为Compshare优云智算并完成了中/英/日三种语言的完整国际化。在 src/config/openclawProviderPresets.ts 中可以看到Compshare及Compshare Coding Plan两个预设条目后者用于订阅制 Coding Plan 场景同时 Compshare 赞助商的注册链接更新为指向 coding-plan 页面。Gemini 默认模型升级供应商预设中的默认 Gemini 模型从2.5-pro升级到3.1-pro。该调整影响各应用中 Gemini 预设条目的默认主模型建议值用户在新建供应商时会直接看到升级后的模型 ID。Bug 修复通用配置与 UI通用配置弹窗循环修复修复了通用配置弹窗无限重复打开的循环问题并新增草稿编辑支持防止编辑过程中数据丢失。这属于典型的“状态更新触发弹窗重开、重开又触发状态更新”的反馈环草稿机制让表单在会话内持有中间状态从源头切断了循环Windows 工具栏紧凑模式修复 Windows 下因左侧溢出导致工具栏紧凑模式不触发的问题#1375会话搜索索引一致性修复会话删除后搜索索引未与查询数据同步、导致列表显示过期数据的问题。同步与数据WebDAV 恢复 provider_health 的外键失败发布说明中“修复 WebDAV 同步恢复provider_health表时的外键约束失败”指向数据库同步层。从源码结构看provider_health供应商健康状态服务于代理自动故障切换被明确归类为可安全重建的临时表ephemeral tablessrc-tauri/src/database/backup.rs 在导出/导入清单中列出该表并注释说明“Excludes ephemeral tables like provider_health that can safely rebuild at runtime”相关测试断言“同步导入应清除可重建的本地 provider_health 状态”且恢复流程会先重建provider_health数据含INSERT INTO provider_health语句以保证其外键引用的provider_id先于健康记录就位。此前备份恢复时若顺序或引用不对齐就会触发外键约束失败本版本修复了该同步路径使 WebDAV 恢复不再因健康表而中断。供应商与预设Longcat 预设补齐为 Longcat 供应商预设补充缺失的authHeader: true#1377。在 src/config/openclawProviderPresets.ts 中可以看到 Longcat 预设现已显式声明该字段——这正是上文authHeader新字段的首个落地使用方OpenClaw 工具权限对齐对齐 OpenClaw 工具权限配置与上游 schema#1355确保生成的tools节点字段与上游 OpenClaw 版本兼容X-Code API URL 修正从www.x-code.cn改为x-code.cc。i18n 与本地化修复 Stream Check Toast 的 i18n 插值 key 与翻译占位符不匹配的问题修复代理启动 Toast 未正确插值地址和端口的问题#1399此前启动提示会显示未替换的占位符而非真实的监听地址与端口将 OpenCode API 格式标签从 “OpenAI” 改为 “OpenAI Responses”更准确地反映实际使用的 API 格式。以上插值类问题均涉及 src/i18n/locales/ 下的多语言词条zh / en / ja / zh-TW 四套与组件中t(key, params)调用的参数名对齐。下载与安装访问项目 Releases 页面下载对应平台的 v3.12.1 安装包。系统要求系统最低版本架构WindowsWindows 10 及以上x64macOSmacOS 10.15 (Catalina) 及以上Intel (x64) / Apple Silicon (arm64)Linux见下表x64Windows文件说明CC-Switch-v3.12.1-Windows.msi推荐- MSI 安装包支持自动更新CC-Switch-v3.12.1-Windows-Portable.zip便携版解压即用不写入注册表macOS文件说明CC-Switch-v3.12.1-macOS.zip推荐- 解压后拖入 Applications 即可Universal BinaryCC-Switch-v3.12.1-macOS.tar.gz用于 Homebrew 安装和自动更新注意由于作者没有苹果开发者账号首次打开可能出现“未知开发者”警告。请先关闭应用然后前往“系统设置” → “隐私与安全性” → 点击“仍要打开”之后即可正常打开。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.1 作为 3.12.x 系列中的稳定性补丁价值体现在三个层面一是配置契约的完善——OpenClawProviderConfig.authHeader新字段与 Longcat 预设的补齐让供应商自定义认证头有了类型化支撑二是预设生态的扩展——StepFun 双站点预设含 256K 上下文的 step-3.5-flash 系列与 Gemini 默认模型升级至 3.1-pro降低了多供应商接入成本三是数据同步的加固——WebDAV 恢复路径中provider_health外键约束问题的修复配合“临时表可安全重建”的数据库设计保证了云同步场景下本地健康状态服务于代理故障切换的可靠性。对于在 OpenClaw 上接入 Longcat 等自定义认证头供应商、或依赖 WebDAV 多机同步的用户升级到此版本可以获得直接收益。相关源码可进一步查阅预设配置 src/config/openclawProviderPresets.ts、类型契约 src/types.ts、表单实现 src/components/providers/forms/OpenClawFormFields.tsx、数据库同步 src-tauri/src/database/backup.rs。【免费下载链接】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.1 版本技术解析：StepFun 预设、OpenClaw authHeader 与同步稳定性修复
CC Switch v3.12.1 版本技术解析StepFun 预设、OpenClaw authHeader 与同步稳定性修复【免费下载链接】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.1 官方发布说明docs/release-notes/v3.12.1-zh.md展开结合仓库源码逐一印证本版本的四项核心技术变更StepFun阶跃星辰供应商预设的完整配置结构、OpenClaw 模型高级选项中输入类型input type与authHeader认证头的实现方式以及 WebDAV 同步中provider_health外键约束失败的修复原理。读完本文你可以准确理解该补丁版本19 commits | 56 files changed | 1,429 / -396 lines发布于 2026-03-12解决了哪些问题并掌握新版本带来的供应商配置能力。版本概览CC Switch v3.12.1 是一个以稳定性改进和 Bug 修复为主的补丁版本同时携带少量功能性增强。发布说明中列出的重点内容可归纳为六个方向通用配置弹窗修复解决了通用配置弹窗无限重复打开的循环问题并新增草稿编辑支持WebDAV 同步可靠性修复了 WebDAV 同步恢复provider_health表时的外键约束失败StepFun 预设新增 StepFun阶跃星辰供应商预设包含 step-3.5-flash 模型OpenClaw 增强新增模型高级选项的输入类型input type选择和authHeader字段支持供应商特定的认证头Gemini 模型升级供应商预设中的默认 Gemini 模型从 2.5-pro 升级到 3.1-pro新赞助商欢迎 Micu API、XCodeAPI、SiliconFlow硅基流动、CTok 四位伙伴加入赞助。下文按“新功能 → 变更 → Bug 修复 → 下载安装”的顺序逐项结合源码给出佐证与深入说明。新功能StepFun阶跃星辰供应商预设本版本在多个支持的应用中新增了 StepFun 预设条目#1369。从源码可以看到预设定义集中位于 src/config/openclawProviderPresets.ts分别提供了面向国内站platform.stepfun.com和面向国际站platform.stepfun.ai的两套预设StepFun与StepFun en。以国内站预设为例其核心配置为{ baseUrl: https://api.stepfun.com/step_plan/v1, apiKey: , api: openai-completions, models: [ { id: step-3.5-flash-2603, name: Step 3.5 Flash 2603, contextWindow: 262144 }, { id: step-3.5-flash, name: Step 3.5 Flash, contextWindow: 262144 } ] }几个值得注意的实现细节预设将 API 协议类型固定为openai-completions即 StepFun 的 Step Plan 端点走 OpenAI 兼容的 completions 接口用户只需填入以step-开头的 API Key 即可接入两个模型均声明了 262144256K的上下文窗口其中step-3.5-flash-2603是带日期后缀的版本化模型 ID预设还通过suggestedDefaults建议默认主模型为stepfun/step-3.5-flash-2603并在modelCatalog中注册StepFun、StepFun Flash两个别名保证模型选择器中的显示名称可读。同一预设文件src/config/openclawProviderPresets.ts中紧随其后的StepFun en预设结构完全一致仅将 Base URL 切换为https://api.stepfun.ai/step_plan/v1、模型前缀改为stepfun-en/体现了 CC Switch “一个供应商、多区域站点”的预设组织惯例。OpenClaw 增强输入类型选择与 authHeader 认证头本版本对 OpenClaw 的配置能力做了两处增强#1368 及相关重构使 OpenClaw 供应商配置更贴近上游 schema。模型高级选项的输入类型input type在 OpenClaw 供应商表单的模型高级选项中新增了输入类型选择。从 src/components/providers/forms/OpenClawFormFields.tsx 可以看到其实现模型展开后提供text与image两个复选框对应写入模型配置中的input数组字段{([text, image] as const).map((type) ( Checkbox checked{(model.input ?? [text]).includes(type)} onCheckedChange{(checked) { const current model.input ?? [text]; const next checked ? [...new Set([...current, type])] : current.filter((value) value ! type); handleModelChange(index, input, next); }} / ))}从源码结构看input的默认值约定为[text]未显式勾选时模型只声明支持文本输入勾选image后数组变为[text, image]用于向 OpenClaw 声明该模型具备多模态图像输入能力。这一细粒度控制对“同一供应商下部分模型支持图像、部分不支持”的场景尤为有用。OpenClawProviderConfig 新增 authHeader 字段发布说明提到在OpenClawProviderConfig中新增了可选的authHeader布尔字段支持供应商特定的认证头。该字段定义于 src/types.ts// OpenClaw 供应商配置settings_config 结构 // 对应 OpenClaw 的 models.providers.provider-id 配置 export interface OpenClawProviderConfig { baseUrl?: string; // API 端点 apiKey?: string; // API 密钥 api?: string; // API 协议类型如 openai-completions、anthropic models?: OpenClawModel[]; // 可用模型列表 headers?: Recordstring, string; // 自定义请求头如 User-Agent authHeader?: boolean; // 供应商自定义认证开关如 Longcat }authHeader的语义是部分供应商要求将 API Key 放入供应商自定义的认证请求头而不是标准的Authorization: Bearer方案。启用该开关后生成的 OpenClawmodels.providers.provider-id配置会声明使用供应商特定的认证头。同一次提交还重构了表单状态以复用共享类型保证前端表单状态与上述 TypeScript 契约保持一致。赞助商伙伴本版本新增四位赞助伙伴Micu API含推广链接、XCodeAPI、SiliconFlow硅基流动含推广链接、CTok。赞助信息展示于应用内的伙伴入口对应的品牌素材位于 assets/partners/logos/ 目录如 silicon_zh.jpg。变更UCloud 更名为 Compshare优云智算原 UCloud 供应商更名为Compshare优云智算并完成了中/英/日三种语言的完整国际化。在 src/config/openclawProviderPresets.ts 中可以看到Compshare及Compshare Coding Plan两个预设条目后者用于订阅制 Coding Plan 场景同时 Compshare 赞助商的注册链接更新为指向 coding-plan 页面。Gemini 默认模型升级供应商预设中的默认 Gemini 模型从2.5-pro升级到3.1-pro。该调整影响各应用中 Gemini 预设条目的默认主模型建议值用户在新建供应商时会直接看到升级后的模型 ID。Bug 修复通用配置与 UI通用配置弹窗循环修复修复了通用配置弹窗无限重复打开的循环问题并新增草稿编辑支持防止编辑过程中数据丢失。这属于典型的“状态更新触发弹窗重开、重开又触发状态更新”的反馈环草稿机制让表单在会话内持有中间状态从源头切断了循环Windows 工具栏紧凑模式修复 Windows 下因左侧溢出导致工具栏紧凑模式不触发的问题#1375会话搜索索引一致性修复会话删除后搜索索引未与查询数据同步、导致列表显示过期数据的问题。同步与数据WebDAV 恢复 provider_health 的外键失败发布说明中“修复 WebDAV 同步恢复provider_health表时的外键约束失败”指向数据库同步层。从源码结构看provider_health供应商健康状态服务于代理自动故障切换被明确归类为可安全重建的临时表ephemeral tablessrc-tauri/src/database/backup.rs 在导出/导入清单中列出该表并注释说明“Excludes ephemeral tables like provider_health that can safely rebuild at runtime”相关测试断言“同步导入应清除可重建的本地 provider_health 状态”且恢复流程会先重建provider_health数据含INSERT INTO provider_health语句以保证其外键引用的provider_id先于健康记录就位。此前备份恢复时若顺序或引用不对齐就会触发外键约束失败本版本修复了该同步路径使 WebDAV 恢复不再因健康表而中断。供应商与预设Longcat 预设补齐为 Longcat 供应商预设补充缺失的authHeader: true#1377。在 src/config/openclawProviderPresets.ts 中可以看到 Longcat 预设现已显式声明该字段——这正是上文authHeader新字段的首个落地使用方OpenClaw 工具权限对齐对齐 OpenClaw 工具权限配置与上游 schema#1355确保生成的tools节点字段与上游 OpenClaw 版本兼容X-Code API URL 修正从www.x-code.cn改为x-code.cc。i18n 与本地化修复 Stream Check Toast 的 i18n 插值 key 与翻译占位符不匹配的问题修复代理启动 Toast 未正确插值地址和端口的问题#1399此前启动提示会显示未替换的占位符而非真实的监听地址与端口将 OpenCode API 格式标签从 “OpenAI” 改为 “OpenAI Responses”更准确地反映实际使用的 API 格式。以上插值类问题均涉及 src/i18n/locales/ 下的多语言词条zh / en / ja / zh-TW 四套与组件中t(key, params)调用的参数名对齐。下载与安装访问项目 Releases 页面下载对应平台的 v3.12.1 安装包。系统要求系统最低版本架构WindowsWindows 10 及以上x64macOSmacOS 10.15 (Catalina) 及以上Intel (x64) / Apple Silicon (arm64)Linux见下表x64Windows文件说明CC-Switch-v3.12.1-Windows.msi推荐- MSI 安装包支持自动更新CC-Switch-v3.12.1-Windows-Portable.zip便携版解压即用不写入注册表macOS文件说明CC-Switch-v3.12.1-macOS.zip推荐- 解压后拖入 Applications 即可Universal BinaryCC-Switch-v3.12.1-macOS.tar.gz用于 Homebrew 安装和自动更新注意由于作者没有苹果开发者账号首次打开可能出现“未知开发者”警告。请先关闭应用然后前往“系统设置” → “隐私与安全性” → 点击“仍要打开”之后即可正常打开。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.1 作为 3.12.x 系列中的稳定性补丁价值体现在三个层面一是配置契约的完善——OpenClawProviderConfig.authHeader新字段与 Longcat 预设的补齐让供应商自定义认证头有了类型化支撑二是预设生态的扩展——StepFun 双站点预设含 256K 上下文的 step-3.5-flash 系列与 Gemini 默认模型升级至 3.1-pro降低了多供应商接入成本三是数据同步的加固——WebDAV 恢复路径中provider_health外键约束问题的修复配合“临时表可安全重建”的数据库设计保证了云同步场景下本地健康状态服务于代理故障切换的可靠性。对于在 OpenClaw 上接入 Longcat 等自定义认证头供应商、或依赖 WebDAV 多机同步的用户升级到此版本可以获得直接收益。相关源码可进一步查阅预设配置 src/config/openclawProviderPresets.ts、类型契约 src/types.ts、表单实现 src/components/providers/forms/OpenClawFormFields.tsx、数据库同步 src-tauri/src/database/backup.rs。【免费下载链接】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），仅供参考