Qoder怎么安装Skill？

Qoder 日前明确了其 Skill 扩展功能的安装条件与流程，提供了自然语言一键安装、Marketplace 图形化安装和 npx 命令行安装三种方式，并针对国内网络环境下的常见问题给出了解决方案。用户需确保基础环境满足 Node.js v18.19.0 及以上、npm 9.0.0 及以上版本，否则可能遇到解析失败或启动异常。

基础环境要求

在安装任何 Skill 之前，用户需在终端中依次运行以下命令确认环境：

• node -v
  ：输出需为 v18.19.0 或更高版本。低于此版本将导致 SKILL.md 解析失败、Quest Mode 无法启动。

• npm -v
  ：输出值必须 ≥ 9.0.0。若不满足，执行 npm install -g npm@latest 升级即可，无需卸载重装。

Windows 用户若使用 WSL2 安装 CLI，必须在 WSL 内单独验证这两个版本，宿主机的 Node 不影响但也不起作用。

三种安装方式

自然语言一键安装（推荐新手）

在 Qoder IDE 智能会话框或 Quest 界面中，用户可直接输入类似“帮我安装 Excel合并 Skill 到当前项目”的指令，或粘贴 skills.sh 上的仓库地址（如 https://github.com/qoder-skills/excel-merge），AI 会自动完成检索、下载、解压、放置和加载全流程。该方式自动判断作用域：含“当前项目”字眼则放入项目级目录 .qoder/skills/，否则默认走用户级 ~/.qoder/skills/。

Marketplace 图形化安装（适合免命令行场景）

用户启动 Qoder 桌面端后，点击左侧导航栏的「Marketplace」，在搜索框输入关键词（如“支付宝支付集成”），找到对应 Skill 卡片后点击 Install 按钮。系统会自动校验环境兼容性、下载依赖、写入配置，完成后即可在对话中用自然语言调用，例如“为电商站添加支付宝手机网站支付入口”。

npx 命令行安装（适合批量部署或 CI 流程）

在项目根目录下执行 npx skillsadd excel-merge（不加 -g），技能将被安装至当前项目的 .qoder/skills/excel-merge/SKILL.md 目录。若需全局生效，追加 -g 参数：npx skillsadd excel-merge -g，安装路径变为 ~/.qoder/skills/excel-merge/SKILL.md。注意：npx 安装时当前目录必须是项目根目录或用户主目录，否则路径错位会导致 Qoder 完全无法识别该 Skill。

验证安装是否成功

用户可通过以下两种方式验证：

• 在 Qoder IDE 智能会话框中输入 /，查看弹出列表是否包含刚安装的 Skill 名称（如 /excel-merge）。
• 直接运行 qodercli list-skills 命令，终端将列出所有已加载的 Skill 及其作用域（global/project）。

若列表为空或名称缺失，检查 .qoder/skills/ 目录下是否存在对应子文件夹，且该文件夹内含有合法的 SKILL.md 文件——文件名大小写必须全小写，不能是 skill.md 或 SKILL.MD。

本文信息基于原始资料记录时的状态，Qoder 版本、各安装方式的具体实现可能继续变化，实际情况以 Qoder 官方最新公开信息为准。