一、环境安装

1.1 安装 Node.js

如果本机没有安装 Node.js，请从 Node.js 官网下载二进制文件直接安装，建议选择 LTS 版本，版本 >= 18。 也建议使用 https://github.com/Schniz/fnm / https://github.com/nvm-sh/nvm / volta 等 node 版本管理工具来管理 Node.js 版本，这些工具能处理权限问题和简单的调整 Nodejs 的版本。

1.2 安装 @vectorx/xhs-cloud-cli

使用npm

npm i -g @vectorx/xhs-cloud-cli

使用 Yarn 1.x

yarn global add @vectorx/xhs-cloud-cli

使用pnpm

pnpm add -g @vectorx/xhs-cloud-cli

1.3 测试安装是否成功

如果安装过程没有错误提示，一般就是安装成功了。下面，我们可以继续输入命令：

rcb -h // 查看所支持的所有命令

如果看到输出版本号，说明已经安装成功。

二、使用本地 cli 进行服务

2.1 本地模版创建

运行时 agent new 子命令，获取帮助

rcb agent new -h

查看支持的参数：

创建模板工程：

rcb agent new -p weather-agent -d ./playground

等待模板工程创建成功，参考提示安装依赖 ( pnpm install ) 即可

2.2 本地调试 agent

运行「 agent 子命令」可获取帮助：

rcb agent dev -h

进入 agent 开发目录（如已经位于 agent 开发根目录，可跳过此步骤)，运行时 dev 命令：

cd ./playground
rcb agent dev --open true ( 添加 --open 参数，将自动打开调试模拟器) 

看到下列输出，则表示 agent 调试服务、模拟器调试服务，均正常运行 此时，可以看到浏览器自动唤起 agent 调试模拟器（图二）

2.3 本地部署 agent (WIP )

三、云开发终端登录

3.1 终端登录

rcb login

运行 「login 子命令」可获取帮助：

rcb login -h

查看具体命令使用方式

3.2 秘钥获取

先登录开放平台控制台，获取「代码上传秘钥」(包含 SecretId + SecretKey)

使用本地保存的进行终端登录

登录 「开放平台控制台」获取秘钥:

rcb login --secretId <secretId> --secretKey <secretKey>

查看具体命令使用方式

登录成功，cli 会自动管理秘钥

使用「login 子命令」查看当前登录信息

 rcb login get

显示登录 token（加密）及过期时间

3.3 终端登出

在同一系统开发，基于多开平账号，可进行账号切换，切换账号需要先退出当前登录态：

运行下列命令进行登出

  rcb logout

退出成功终端会显示登出信息