跳至主要內容

Rovo Dev CLI 入门与进阶指南

约 1917 字大约 6 分钟...

Rovo Dev CLI 是由 Atlassian 公司（Jira 和 Trello 的母公司）推出的一款强大的 AI 编程助手，它直接集成在你的命令行终端中。你可以用它来编写代码、调试程序、管理项目，全程无需离开终端窗口，从而让你的工作流更加专注和高效。本指南将带你一步步完成安装、配置，并掌握从入门到进阶的核心用法。

第一步：一分钟快速安装

Atlassian CLI (acli) 支持 Windows, macOS 和 Linux。请根据你的操作系统选择对应的安装方式。

Windows 用户

  1. 打开 PowerShell：点击“开始”菜单，输入“PowerShell”，然后选择并打开它。
  2. 下载工具：根据你电脑的处理器架构，复制并粘贴下面对应的命令。绝大多数现代 PC 都使用 x86-64 架构。

    • 适用于绝大多数 Windows 电脑 (x86-64 架构):

      Invoke-WebRequest -Uri "https://acli.atlassian.com/windows/latest/acli_windows_amd64/acli.exe" -OutFile acli.exe

    • 适用于 ARM 架构的 Windows 设备 (如部分 Surface Pro 型号):

      Invoke-WebRequest -Uri "https://acli.atlassian.com/windows/latest/acli_windows_arm64/acli.exe" -OutFile acli.exe

macOS 用户

使用 Homebrew 是最简单的方式：

brew install atlassian-cli

Linux 用户

你可以下载二进制文件并手动安装：

# 下载适用于 amd64 架构的二进制文件
curl -LO https://acli.atlassian.com/linux/latest/acli_linux_amd64/acli

# 赋予执行权限
chmod +x acli

# (可选) 移动到系统路径以便全局调用
sudo mv acli /usr/local/bin/

验证安装

安装完成后，在终端窗口中运行以下命令。如果你能看到一长串帮助信息，就说明一切顺利。

acli --help

第二步：配置全局可用 (Windows 用户)

为了能从电脑的任何位置方便地调用 acli 命令，Windows 用户需要将其所在的文件夹路径添加到系统的 PATH 环境变量中。

  1. 为工具创建一个固定的“家”：新建一个不容易误删的文件夹，例如 C:\tools\acli，然后将刚刚下载的 acli.exe 文件移动进去。
  2. 打开环境变量设置：在 Windows 搜索栏中，输入“编辑系统环境变量”并打开它。
  3. 在弹出的窗口中，点击“环境变量...”按钮。
  4. 在上半部分的“用户变量”区域，找到名为 Path 的变量，选中它，然后点击“编辑...”。
  5. 点击“新建”，然后输入你存放 acli.exe 的文件夹路径（例如 C:\tools\acli）。
  6. 在所有打开的窗口上点击“确定”以保存更改。
  7. 至关重要的一步：关闭当前的 PowerShell 窗口，然后重新打开一个全新的。这一步是为了让 Windows 加载你刚刚的设置。现在，你可以在任何文件夹下输入 acli --version，命令应该可以成功执行了。

第三步：连接你的 Atlassian 账户

在开始使用 AI 功能前，你需要通过一个安全的 API 令牌将工具与你的 Atlassian 账户关联起来。

  1. 生成一个 API 令牌：
    • 访问你的 Atlassian 账户 API 令牌页面：https://id.atlassian.com/manage-profile/security/api-tokens。
    • 如果需要，请先登录。
    • 点击“创建 API 令牌”。
    • 给它起一个容易记住的名字，比如“我的 Rovo CLI”，然后点击“创建”。
    • 重要提示：点击“复制”并把这个令牌保存在一个安全的地方（比如密码管理器）。这个令牌只会出现一次，关闭窗口后你将无法再次查看它。
  2. 在终端中登录：

    • 回到你的终端窗口，运行以下命令：

      acli rovodev auth login

    • 工具会提示你输入 Atlassian 账户的邮箱地址，然后粘贴你刚刚复制的 API 令牌。

现在，你已经成功登录，一切准备就绪！

第四步：开始与你的 AI 助手对话

要开始你的第一个交互式会话，只需运行这个简单的命令：

acli rovodev run

你的终端会变成一个聊天界面，你可以用自然的中文向它提问、让它写代码片段、帮你调试程序，以及完成更多编程任务。

第五步：掌握核心用法

除了基础的交互式对话，Rovo Dev CLI 还提供了丰富的进阶功能来提升效率。

非交互模式

如果你想快速执行单个任务并立即看到结果，可以在 run 命令后直接跟上你的指令。

# 让 AI 为指定文件生成单元测试
acli rovodev run "为 @./src/utils.js 编写单元测试"

引用文件和目录

使用 @ 符号可以轻松地将文件或整个目录作为上下文提供给 AI，让它基于具体代码进行工作。

# 交互模式中，让 AI 解释一个文件
> 解释 @./src/main.js 的功能

# 交互模式中，让 AI 总结一个目录
> 总结 @./src/components/ 目录下所有组件的用途

常用的斜杠命令

在交互模式 (acli rovodev run) 中，你可以使用以下命令来管理会话：

  • /usage：查看你当天已使用的 Token 数量。
  • /clear：清空当前对话的消息历史，开始一个全新的对话。
  • /sessions：列出最近的会话，方便你切换或恢复到之前的对话。
  • /prune：在保留核心上下文的同时，压缩对话历史，以节省 Token 消耗。

第六步：管理 AI 的记忆

Rovo Dev CLI 有一个本地记忆系统，可以帮助它记住关于你项目的特定信息。你可以通过在项目中的任何文件中添加特殊注释来管理这些记忆。

  • 添加记忆: 在任何代码或文本文件中，使用 # 开头的注释来添加一条笔记。

    // # 这个项目使用 React 18 和 TypeScript
// # 运行 `npm run dev` 来启动开发服务器

  • 移除记忆: 使用 #! 开头的注释来移除一条笔记。

    // #! 这个项目使用 React 18 和 TypeScript

当你与 AI 对话时，它会自动加载这些记忆，从而提供更贴合你项目实际情况的回答。

第七步：了解你的每日免费额度

Rovo Dev CLI 的使用基于“Token”系统。一个 Token 可以理解为一个文本单位（比如一个词或一小段代码）。你提出的问题和 AI 生成的回答都会消耗 Token。

每日免费额度，具体取决于你的 Jira 订阅方案：

  • 付费用户额度 (每日 2000 万 Token): 如果你的 Atlassian 站点拥有 Jira 的 Standard (标准版)、Premium (高级版) 或 Enterprise (企业版) 方案，你将获得每日 2000 万 Token 的免费额度。
  • 免费版用户额度 (每日 500 万 Token): 所有其他用户，包括使用 Jira 免费版的用户，每日的免费额度为 500 万 Token。

关键信息：

  • 你的 Token 额度会在每天的午夜 UTC 时间重置。
  • 将你的 Jira 方案升级到 Standard 或更高级别，可以将每日额度从 500 万提升至 2000 万。请注意，这些方案的免费试用版不享受额度提升。
  • 你可以在交互模式中随时输入 /usage 命令来查看当天已使用的 Token 数量。

参考资料

最近更新