QoderWake Skill版本不兼容会导致Quest模式技能不识别、无报错、界面卡加载，根本原因是manifest.json中qoderwake_core_version与核心主版本号（如v0.3.7）严格不匹配且校验静默失败；需通过qoderwake --version查主版本，手动修改manifest或下载匹配Skill包，并强制删除skill_registry.db刷新缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake Skill版本不兼容会导致Quest模式中技能完全不识别、无报错提示、界面卡在加载状态，根本原因是Skill包内manifest.json声明的qoderwake_core_version与当前运行时核心版本严格不匹配，且校验逻辑在初始化阶段即静默失败。
校验当前QoderWake核心版本号
第一步：打开终端，进入QoderWake安装根目录（Windows为C:\Program Files\QoderWake，macOS为/Applications/QoderWake.app/Contents/MacOS，Linux为/opt/qoderwake）。
第二步：执行命令 qoderwake --version，输出形如 v0.3.7-core-2104a 的字符串，其中 【v0.3.7】 是必须对齐的主版本号，后续后缀不可用于匹配。
第三步：若命令返回“command not found”，说明未正确配置PATH或二进制损坏，需先执行手动覆盖安装流程。
定位并替换Skill包中的版本声明
方法一：直接修改本地Skill包（适用于已下载但未生效的离线Skill）
1. 进入Skill存放目录：~/.qoder/skills/your-skill-name/（Windows为%USERPROFILE%\.qoder\skills\your-skill-name\）。
2. 用文本编辑器打开 manifest.json，找到 "qoderwake_core_version" 字段值，将其改为与上一步查得的主版本号完全一致（例如从 "v0.3.5" 改为 "v0.3.7"）。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3. 保存文件，重启QoderWake——这一步必须重启，热重载不触发manifest重解析。
方法二：重新下载匹配版本的Skill包（推荐用于线上更新失败场景）
访问Qoder官方Skill仓库页面 https://www.php.cn/link/c411f53ca8d87f3cbf838547544252a2，在筛选栏选择“Compatible with QoderWake v0.3.7”，仅下载标有绿色✅图标的Skill包。
【注意】 不要下载标有“Beta”或“Preview”标签的Skill，它们强制要求v0.4.0+内核，与当前环境不兼容。
强制刷新Skill注册缓存
1. 关闭QoderWake所有进程（Windows任务管理器结束qoderwake.exe；macOS活动监视器强制退出；Linux执行 pkill -f qoderwake）。
2. 删除缓存注册表文件：
Windows：del %LOCALAPPDATA%\QoderWake\skill_registry.db
macOS：rm ~/Library/Application\ Support/QoderWake/skill_registry.db
Linux：rm ~/.config/qoderwake/skill_registry.db
3. 重新启动QoderWake，等待约45秒，控制台日志出现 [SkillLoader] Registered 3 skills, all compatible 即表示刷新成功。
