一、升级 Node.js必须先做OpenCode 要求 Node.js 18你当前的 v10.24.0 跑不起来 。安装 nvm国内镜像绕过 GitHub创建 nvm 目录并手动下载核心文件绕过 git clonemkdir -p ~/.nvm cd ~/.nvmwget https://gitee.com/mirrors/nvm/raw/v0.39.7/nvm.sh -O nvm.shwget https://gitee.com/mirrors/nvm/raw/v0.39.7/nvm-exec -O nvm-execwget https://gitee.com/mirrors/nvm/raw/v0.39.7/bash_completion -O bash_completionchmod x nvm-exec配置 shellcat ~/.bashrc ‘EOF’export NVM_DIR“H O M E / . n v m [ − s HOME/.nvm [ -s HOME/.nvm[−sNVM_DIR/nvm.sh” ] . “N V M D I R / n v m . s h [ − s NVM_DIR/nvm.sh [ -s NVMDIR/nvm.sh[−sNVM_DIR/bash_completion” ] . “$NVM_DIR/bash_completion”EOFsource ~/.bashrc2. 安装 Node.js 18国内镜像关键指向国内镜像否则 nvm install 会卡死export NVM_NODEJS_ORG_MIRRORhttps://npmmirror.com/mirrors/nodeecho ‘export NVM_NODEJS_ORG_MIRRORhttps://npmmirror.com/mirrors/node’ ~/.bashrcsource ~/.bashrc安装 Node 18nvm install 18nvm alias default 18验证node -v # v18.x.xnpm -v # 9.x.x 或 10.x.x 如果 nvm install 18 还是卡用离线方案从 https://npmmirror.com/mirrors/node/v18.20.4/node-v18.20.4-linux-x64.tar.xz 手动下载解压到 ~/.nvm/versions/node/v18.20.4/。二、安装 OpenCode方式一npm 全局安装推荐设置 npm 国内镜像npm config set registry https://registry.npmmirror.com全局安装npm install -g opencode-ai验证opencode --version方式二一键脚本需要能访问 opencode.aicurl -fsSL https://opencode.ai/install | bash启动 OpenCode在项目目录启动终端 TUIopencode或启动 Web 界面远程/容器环境有用opencode web --hostname 0.0.0.0 --port 4242三、添加自定义 Skill核心OpenCode 的 Skill 是放在特定目录下的 SKILL.md 文件OpenCode 会自动发现并加载 。Skill 的存放位置OpenCode 会搜索以下目录 作用域路径项目级仅当前项目项目根/.opencode/skills/skill名/SKILL.md全局所有项目~/.config/opencode/skills/skill名/SKILL.mdClaude 兼容项目级项目根/.claude/skills/skill名/SKILL.mdClaude 兼容全局~/.claude/skills/skill名/SKILL.md 建议个人常用 skill 放全局 ~/.config/opencode/skills/项目专属 skill 放项目内的 .opencode/skills/SKILL.md 的格式规范每个 Skill 是一个目录里面至少有一个 SKILL.md 文件 skill-name/├── SKILL.md # 必需核心定义文件├── scripts/ # 可选可执行脚本Python/Bash├── references/ # 可选参考文档└── assets/ # 可选模板、图片等资源SKILL.md 的开头必须是 YAML frontmatter目前 OpenCode 仅识别这些字段 name: skill-name # 必填1-64 字符小写字母数字连字符必须和目录名一致description: 描述文本 # 必填1-1024 字符要写清楚做什么、什么时候用、举几个例子license: MIT # 可选compatibility: opencode # 可选metadata: # 可选key: valuename 的命名规则正则1(-[a-z0-9])*$只能小写字母、数字、连字符不能以 - 开头或结尾不能有连续的 –必须与包含 SKILL.md 的目录名一致a-z0-9 ↩︎
