ZIP 文件中未找到技能（需包含 SKILL.md 文件） - cc-switch

Quick fix

升级 cc-switch 至 v3.16.2 或更高版本，并在导入同名 Skill 前手动删除旧目录，以解决路径解析与冲突提示错误。

Symptom

报错原文复制

ZIP 文件中未找到技能（需包含 SKILL.md 文件）

Cause

该问题集群涉及 cc-switch 在 Skill 管理与更新中的多个缺陷。首先，当导入已存在的同名 Skill 时，后端会静默跳过冲突并返回空数组，导致前端错误地提示「ZIP 文件中未找到技能（需包含 SKILL.md 文件）」。其次，在 Windows 系统中，由于反斜杠路径分隔符未被规范化为正斜杠，安装在子目录中的 Skill 会在检查更新时被静默跳过。此外，v3.10.3 版本在 Windows 上存在 Home 环境变量读取回归，导致升级后配置列表为空。

Fix

1. 1

   将 cc-switch 升级至 v3.16.2 或更高版本，以修复 Windows 路径分隔符导致的 Skill 更新失败以及 v3.10.3 的配置丢失问题。

2. 2

   如果遇到导入同名 Skill 报错，请手动删除已存在的同名 Skill 目录（通常位于 ~/.cc-switch/skills/<技能名>）后再重新导入。

3. 3

   如果升级后配置列表为空，请在设置中重新指定配置目录并重启程序，或覆盖安装 v3.10.2 降级。

Affected Versions

Toolcc-switch

Version3.10.3 - 3.16.1 (受影响范围)

PlatformsWindowsmacOS

Source Issues

本页汇总自 3 个真实 issue

• #872[Bug] Windows 11 升级到 v3.10.3 后所有配置无法显示（降级到 v3.10.2 恢复正常）
• #2389windows 系统中 Skill 自动更新不work
• #3749导入同名 skill 时错误提示不准确：实为「同名 skill 已存在」，却报「ZIP 文件中未找到技能（需包含 SKILL.md 文件）」

FAQ

升级到 v3.10.3 后所有配置无法显示怎么办？

这是 Windows 下 Home 环境变量读取导致的回归问题。您可以降级到 v3.10.2，或者升级到 v3.11.0 及以上版本。也可以在最新版中重新设置一下配置目录并重启。

Windows 系统中通过仓库安装的 Skill 无法自动更新？

由于 Windows 路径反斜杠未规范化，子目录 Skill 被更新检查跳过。请升级至 v3.16.2 修复此问题。

相关问题

codex cli 失败：CC Switch将 cc-switch 升级至 v3.16.3 或更高版本即可修复本地环境检测与升级链路的阻塞问题。2 issues merged在Codex界面，官方订阅无法查询用量 - Codex开启本地路由映射以统计特定模型用量，第三方API需适配查询脚本，Claude官方及Free账号暂不支持查询。8 issues merged点击更新后卡住强制退出并重新打开软件，或手动更新至 v3.16.3 及以上版本以修复更新死锁问题。3 issues merged