跳到主要内容

从 CLI 1.x 升级到 2.0

注意

飞书原始文档当前已删除,无法继续按远端正文刷新。本页暂作为历史快照保留,后续应决定是迁移到归档目录,还是由新的升级文档替代。

从老 CLI 1.x 升级

信息

适用于:本机已安装 Lovrabet CLI 1.x,且有使用旧 CLI 的老项目。如果是全新安装,请查看 全新安装

2.1 安装CLI

# 全局安装(推荐)
npm install -g @lovrabet/rabetbase-cli

# 验证安装
rabetbase --version

2.2 删除旧的Lovrabet cli 1.x

# 交互式删除
npm uninstall -g @lovrabet/cli

2.2 老项目自动升级

信息

老项目升级有两种方式

  1. 自动升级 - 推荐
  2. 手动升级 - 自动升级失败时可手动操作

在每个老项目目录下运行一条命令即可完成迁移:

rabetbase project upgrade

该命令自动执行以下 6 步迁移:

步骤操作
1.lovrabet.json.rabetbase.json
2删除 .lovrabet/ 目录
3删除旧 IDE skill 文件
4清理 MCP 配置(旧 @lovrabet/dataset-mcp-server 条目)
5移除旧 skill lovrabet/lovrabet-skill
6安装新 skill lovrabet/rabetbase

2.3 老项目手动升级

Step 1. 删除旧的 lovrabet-skill

Rabetbase CLI 2.0 包含了 1.x 的所有功能,不再需要旧 Skill。

# 交互式删除
npx skills remove

# 或直接删除(如果当时按 lovrabet 名称安装)
npx skills remove lovrabet

Step 2. 停用 lovrabet-dataset MCP

⚠️ 如果本地已配置旧 MCP server,会与新的 CLI/Skill 体系并存导致入口重复,建议停用。 Claude Code:

claude mcp remove lovrabet-dataset

Cursor或者其他IDE: 进入 MCP 配置界面,删除或禁用名为 lovrabet-dataset 的 server 条目。 配置文件方式: 直接删除对应配置块:

{
"mcpServers": {
"lovrabet-dataset": { ... } // ← 删除此段
}
}

Step 3. 安装新 Skill
npx skills add lovrabet/rabetbase --global

注意:手动迁移后,.rabetbase.json 中的配置项名称已统一(如 appcode),请确认与旧格式兼容。

Checklist(从 1.x 升级)

机器(每台做一次)

  • 升级 CLI:rabetbase update
  • 删除旧 Skill:npx skills remove lovrabet
  • 停用旧 MCP:claude mcp remove lovrabet-dataset(或在 IDE 手动删除)
  • 安装新 Skill:npx skills add lovrabet/rabetbase --global
  • 重新认证:rabetbase auth login 项目(每个项目做一次)
  • 自动升级:rabetbase project upgrade

验证

rabetbase doctor
rabetbase --version