CC Switch 配置导入/同步不生效
Quick fix
升级 CC Switch 到 v3.16.1+,并检查 WebDAV/云同步与配置写入路径是否被正确同步。
Symptom
Section titled “Symptom”cc-swtich管理的本地自定义技能在技能更新后没有更新,导致无法通过云同步更新另外一台机器的自定义技能该问题涉及 CC Switch 的配置导入、同步与持久化链路。部分场景是 UI 或配置写入后没有同步到目标应用的配置文件,例如 Hermes 只更新 model: 块而 providers: 块为空;部分场景是云同步、WebDAV、SQL 导入导出或本地技能更新后未刷新。已关闭 issue 显示 v3.16.0 / v3.16.1 修复了 Windows 环境检测、Codex 配置/接管切换、模型目录刷新、工具/插件恢复和部分 provider 格式转换问题;但 WebDAV 同步、SQL 导入性能、本地 skill 云同步更新、删除会话后 jobs 目录未清理等问题在提供的 issue 中仍未完全解决。
升级 CC Switch 到 v3.16.1 或更新版本,然后重新验证配置切换、供应商保存和环境检测。
如果是 Hermes 供应商切换后 ~/.hermes/config.yaml 缺少 providers: 配置,临时手动从 CC Switch 数据库复制供应商配置到 config.yaml。
~/.hermes/config.yaml providers:# 从 CC Switch 当前供应商配置复制 api_key / base_url 等字段如果使用 OneDrive、坚果云或 WebDAV 同步 cc-switch.db,确认同步目录只包含需要同步的配置数据;若出现 cc-switch-<hostname>.db,说明多设备写入同一 SQLite 文件触发网盘冲突副本。
如果 SQL 导入长时间卡在“导入中”,升级到 v3.19.2 或更新版本后重试;该版本将导出改为批量写入,并把恢复合并进单个事务。
如果本地自定义 skill 更新后 CC Switch 未同步,重新导入该 skill;当前 issue 未给出已确认的自动刷新修复。
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 23 个真实 issue
- #502多设备 onedrive 同步数据出现多个 cc-switch.db
- #1335现在的sqlite设计会拖垮坚果云/OneDrive
- #1436WebDav异常
- #1925skill导入现有的,没有做防抖,点击2次会导入重复的skill
- #1990云同步时使用tailscale做的内网穿透报502错误
- #2100SQL导出导入问题
- #2134[Bug] UI freeze in Sessions Management when handling large number of sessions or long content
- #2244Claude编辑供应商页面中,模型一键设置按钮点击后,haiku模型和sonnet模型的输入框中没有根据选择的主模型进行同步模型id
- #2558配置文件同步不及时
- #2870出现非常多的500的请求,不知道从何而来
- #3107重新从ZIP安装导入本地skill,无法导入
- #3130最近频繁出现ccswitch卡死需要强制退出情况,更多是在轻量模式切换的时候
- #3375设置的关于页面本地环境检查问题
- #3712Claude Desktop 不支持深度链接添加配置
- #4198claude desktop win无法注入3p配置或使用供应商切换
- #4284在CC Switch切换时,Hermes提供者未与config.yaml同步
- #4749路由模式下安装插件没有同步到供应商配置文件
- #4854[BUG] 删除 agents 模式会话后,claude agents view 仍显示已删除的会话条目
- #5154作者吃赞助能理解,越加越多也理解,gpt5.6的价格能不能更新一下?
- #5621WebDAV 同步完全不可用:NAS 对已存在目录 MKCOL 返回 400,逐层建目录中止连累上传/下载
- #5700删除 Claude 会话后 ~/.claude/jobs/ 目录未同步清理
- #5880cc-swtich管理的本地自定义技能无法通过webdav云同步更新
- #6141应用通用配置时,供应商配置数组字段被整体覆盖 "permissions.deny" 原有条目丢失
- 为什么升级后 Hermes 本地环境检查仍然失败?
- 有用户反馈更新后仍出现 hermes 检测版本问题,例如 uv trampoline failed to spawn Python child process Caused by: entity not found (os error 2)。需要继续检查 hermes 可执行文件路径、Python/uv 环境是否可用。
- 把 cc-switch.db 放到 OneDrive 或坚果云为什么会出问题?
- cc-switch.db 会保存运行期数据,切换 provider、请求日志或健康检测都会频繁改写 SQLite 文件,导致云盘频繁上传、同步延迟,并可能生成 cc-switch-<hostname>.db 冲突副本。
- WebDAV 同步报 MKCOL 失败怎么办?
- 如果是 502 Bad Gateway,先检查内网穿透、反向代理或 WebDAV 服务可达性;如果是 NAS 对已存在目录返回 400 Bad Request,issue 中分析认为需要 CC Switch 将 400 纳入已存在目录的容错逻辑,当前未确认修复。
- 删除 Claude Code 会话后 Agents 面板为什么还显示?
- cc-switch 删除会话时可能只删除 transcript 文件,没有同步清理 ~/.claude/jobs/ 下的会话索引或任务数据,导致 Claude Code Agents View 仍显示幽灵条目。
这是一个非官方社区 wiki,与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。