cc-switch Skills 管理异常（重复、无法识别、删除后恢复、状态不一致）
Quick fix
多数 Skills 问题已在后续版本修复：升级到 v3.18.0 可解决默认仓库删除后恢复；升级到 v3.13.0 可改善已安装 Skill 识别与去重。
Symptom
Section titled “Symptom”Skills 仓库状态在重启、删除和检查失败后不一致该集群包含多个与 cc-switch Skills 管理相关的问题，而不是单一错误。主要机制包括：1) 启动时的默认仓库初始化逻辑会将内置默认仓库与现有仓库比对并补齐“缺失”项，导致用户删除的默认仓库在重启后重新出现；该问题已在 v3.18.0 修复，默认仓库列表只在数据库首次初始化时写入一次，并持久化“已初始化”标记。2) 旧版本的 Skill 扫描、去重、目录结构和识别逻辑存在缺陷，例如 anthropics/skills 只识别部分技能、下载的 skill 出现嵌套 skills 目录、无法识别其他渠道安装的 skill，以及 CC-Switch 读取不到已安装 skill；维护者说明 v3.13.0 升级了多源扫描、跨目录去重、SKILL.md 元数据保留和 SHA-256 内容哈希检测。3) 在较新版本中仍有仓库状态生命周期问题：重启后重新下载全部启用仓库、网络或仓库请求失败时可能误报“所有技能已是最新版本”；维护者表示这些子问题尚未随发布版本修复，分别由 PR #4660 和 #4659 跟踪。另有功能请求和 UI/缓存/同步问题，不属于同一根因。
如果问题是“删除的默认 Skills 仓库在重启后重新出现”，升级 cc-switch 到 v3.18.0 或更高版本。该版本修复了启动时自动补齐默认仓库的问题。
如果问题是“已安装 Skill 无法被 CC-Switch 识别、重复显示或元数据不正确”，升级 cc-switch 到 v3.13.0 或更高版本。该版本改进了多源扫描、跨目录去重、从 SKILL.md 保留元数据以及基于 SHA-256 的内容哈希检测。
如果 Skills 页面显示“暂无可用技能”且默认仓库无法加载，先检查网络。维护者说明 skills 是直接访问 GitHub 下载的；有用户询问如何配置代理，但 issue 中未给出确认的代理配置方法。
如果遇到“重启后仍重新下载全部仓库”或“断网检查更新却显示所有技能已是最新版本”，截至当前 issue 记录，这两个问题尚未随发布版本修复，关注 PR #4660 和 #4659 的合并与后续发布。
如果从 Windows 迁移 SQL 文件到 macOS 后 skill 无法使用，维护者说明 SQL 文件只包含供应商信息；应使用 WebDAV 功能同步 Skill，而不是仅迁移 SQL 文件。
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 18 个真实 issue
- #271Skills 页面显示暂无可用技能
- #284anthropics/skills 提示只识别到 3 个技能
- #323[Bug] Skills 页面筛选下拉菜单与卡片边框重叠
- #324CC Switch v3.8.0 Claude Skills 管理 有重复的 Skills
- #357[BUG]ccswitch中下载的来源于“anthropics/skills”仓库的技能会嵌套skills目录，造成两层目录，似乎会对技能调用造成影响
- #439cc switch无法管理claude skills
- #701Skills 目录缓存
- #968skill的跳转url地址不对
- #980无法自动识别别的渠道安装好的skill
- #1091增加 Skill 频繁修改时的实时同步机制，避免数据不一致问题
- #1273Skills: 预配置仓库删除后重复出现
- #1791从 win 电脑迁移sql文件到 mac 上后，skill 无法使用，显示 skill 不存在与 SSOT
- #1800无法识别已经安装的 skill
- #1876[Feature]: Allow syncing configs without skills — respect Git-managed skill directories
- #1879[Feature] Skills 管理页面增加本地已导入 Skills 的搜索功能
- #2382审计 get_all_installed 所有调用点是否需要先调用 reconcile_stale_entries
- #4248Bug: Skills 仓库状态在重启、删除和检查失败后不一致
- #4384Request: add syf2211/ruledoctor to default skill repositories
- 删除默认 Skills 仓库后为什么重启又出现？
- 旧版本启动时会用内置默认仓库列表补齐“缺失”的默认仓库，因此手动删除后会被重新写回。该问题已在 v3.18.0 修复，默认仓库只在首次初始化时写入一次。
- 为什么我已安装的 Skill 很多，但 CC-Switch 读取不出来？
- 维护者说明该问题已在 v3.13.0 修复，该版本升级了 Skill 扫描逻辑，包括多源扫描、跨目录去重、SKILL.md 元数据保留和 SHA-256 内容哈希检测。
- Skills 页面显示“暂无可用技能”怎么办？
- 有维护者说明这是网络问题，skills 是直接访问 GitHub 下载的。issue 中未给出确认的代理配置方法。
- 从第三方平台或 .agent 目录安装的 skill 无法识别怎么办？
- issue #980 中维护者曾表示已修复并会在下版本更新，但后续用户反馈在 v3.12.3 仍然存在。建议升级到 v3.13.0 或更高版本验证；若仍存在需继续反馈。
- 能不能只同步配置，不同步 Skills？
- issue #1876 提出过该功能请求，原因是 WebDAV 会同步 ~/.claude/skills/，可能覆盖 Git 管理的 skill 目录。该 issue 因无活动被关闭，未记录已实现。
- Skills 很多时能否搜索或过滤？
- issue #1879 请求在 Skills 管理页面增加搜索框。维护者回复功能已开发完成并合并到主分支，会在下一个版本发布后可用。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。