跳到主要内容

安装指南

本指南介绍如何安装 OpenSpec CLI。

系统要求​

在安装 OpenSpec 之前，请确保你的系统满足以下要求：

  • Node.js: 20.19.0 或更高版本
  • npm: 通常与 Node.js 一起安装

检查 Node.js 版本​

node --version
# 应该显示 v20.19.0 或更高版本

如果需要升级 Node.js，可以使用 nvm：

nvm install 20
nvm use 20

安装 OpenSpec​

全局安装（推荐）​

npm install -g @fission-ai/openspec@latest

本地安装​

npm install @fission-ai/openspec

验证安装​

安装完成后，验证 OpenSpec 是否正确安装：

openspec --version
# 应该显示版本号，例如：v1.0.0

升级 OpenSpec​

要升级到最新版本：

npm install -g @fission-ai/openspec@latest

卸载 OpenSpec​

要卸载 OpenSpec：

npm uninstall -g @fission-ai/openspec

故障排除​

问题：command not found: openspec​

解决方案:

  • 确保 npm 全局 bin 目录在你的 PATH 中
  • 运行 npm config get prefix 查看全局安装位置
  • 将该目录添加到你的 PATH

问题：EACCES: permission denied​

解决方案:

问题：版本不匹配​

解决方案:

  • 清除 npm 缓存：npm cache clean --force
  • 重新安装：npm install -g @fission-ai/openspec@latest

下一步​

安装完成后，按照 快速开始 指南初始化你的第一个项目。