Rovo Dev CLI Windows 安装与使用指南

Rovo Dev CLI Windows 安装与使用指南（修订版）

前提条件与准备工作

1. Atlassian 账号注册

• 访问注册页面 ：Atlassian AI Innovation 注册

这里我使用的是 Google 账号登录

2. 安装必备软件

• Git （必需组件）
  Git for Windows 官方下载
• Visual Studio Code （推荐终端环境）
  VSCode 官方下载

3. 管理员启用 Rovo Dev Agents

• 需组织管理员在 Atlassian 站点启用该功能
• 申请链接 ：Rovo Dev Agents 访问申请

首次登录需要输入站点名称

---

安装与配置步骤

步骤 1：安装 ACLI

# 下载 Windows 版 ACLI
Invoke-WebRequest -Uri "https://atlassian.com/go/acli-install-windows" -OutFile "acli.exe"

# 移动至可执行路径（建议）
Move-Item -Path .\acli.exe -Destination $env:USERPROFILE\AppData\Local\Microsoft\WindowsApps\

步骤 2：创建 API 令牌

1. 登录 Atlassian 令牌管理
2. 访问时可能需要邮箱验证码验证（邮箱8位数验证码）
3. 点击左侧蓝色按钮 ：Create API token
   （注意：不要选择右侧的"Create API token with scopes"，因为我们不需要设置权限范围）
4. 输入令牌名称（如"Rovo-CLI"）
5. 立即复制并保存生成的令牌（页面关闭后无法再次查看）

步骤 3：认证登录

在 VSCode 终端 中执行：

# 使用 .\acli.exe 调用（Windows必须添加前缀）
.\acli.exe rovodev auth login

按提示输入：

1. Atlassian 账号邮箱（即注册邮箱）
2. API 令牌（右键粘贴，避免使用Ctrl+V）

之所以使用VSCode 终端 执行，详情请见问题3：Windows 命令执行异常

步骤 4：启动 Rovo Dev

.\acli.exe rovodev run

---

关键问题解决方案

问题1：Rovo Dev Agents 未启用

错误现象：

╭─ Rovo Dev Agents is not installed on your site ─╮
│ To use Rovo Dev CLI...                          │
╰─────────────────────────────────────────────────╯

解决方案：

1. 确认已完成访问申请
2. 联系组织管理员启用服务
3. 设置生效可能需要1-3个工作日

问题2：Windows 命令执行异常

经过多次尝试，
正确执行方式：

# 必须使用 .\ 前缀调用 exe 文件，官方建议的acli直接执行命令在windows中不生效
.\acli.exe [command]

问题4：API 令牌粘贴异常

推荐操作：

1. 在 VSCode 终端中操作
2. 复制令牌字符串后
3. 在提示输入位置右键点击粘贴
4. 在cmd、powershell、vscode中使用Ctrl+V黏贴有问题（经过测试，在cmd、powershell中使用右键黏贴失效，而在cmd、powershell、vscode终端中使用ctrl+v，会导致复制的内容黏贴两次，比如a->aa，唯一可行的是在vscode中使用右键黏贴）

---

验证安装成功

正常启动后显示：

███████  ██████  ██    ██  ██████      ██████  ███████ ██    ██
██   ██ ██    ██ ██    ██ ██    ██     ██   ██ ██      ██    ██
██████  ██    ██ ██    ██ ██    ██     ██   ██ █████   ██    ██
██   ██ ██    ██  ██  ██  ██    ██     ██   ██ ██       ██  ██
██   ██  ██████    ████    ██████      ██████  ███████   ████

Welcome to Rovo Dev (beta)...
>

---

技术支持资源

1. 官方公告博客
2. 社区讨论与支持论坛