# 快速入门

安装 CLI、运行会话，并合并你的第一个变更请求。

Canonical page: https://beeuni.ai/docs/zh/quickstart

本页面将带你从一个全新的终端开始，直到合并一个变更请求（CR）。
下面的每条命令都可以直接复制粘贴执行。

<a id="install-the-cli"></a>

### 安装 CLI

运行安装脚本。它会为你的操作系统下载 `beeuni` 二进制文件。

```sh
curl -fsSL https://beeuni.ai/install | bash
```

Beeuni 支持 macOS 和 Linux。目前还没有 Windows 二进制文件。

### 登录
```sh
beeuni login
```

这会打开浏览器供你登录。登录后，`beeuni login` 会为你选择账户和默认的 [项目](/docs/zh/project)。

<a id="create-or-clone-a-project"></a>

### 创建或克隆项目

新账户还没有项目，因此 `beeuni login` 没有可供选择的项目。运行带名称的 `beeuni init`，创建你的第一个项目。该命令会在你的计算机上生成项目目录。

```sh
beeuni init my-app
cd my-app
beeuni ship
```

`beeuni ship` 首次运行时会在 Beeuni Cloud 中创建项目，然后推送你的代码。之后可随时再次运行 `beeuni ship`，同步本地更改。

如果要处理 Beeuni Cloud 中已经存在的项目，请改为克隆它：

```sh
beeuni projects clone <project-id>
```

使用 `beeuni projects ls` 查找 `<project-id>`。

### 运行会话
```sh
beeuni sessions new --prompt "Build the login page"
```

这会启动一个[会话](/docs/zh/work/sessions)。智能体会在自己的沙盒和分支中工作，因此你的项目暂时不会受到影响。

连接到会话以查看进度并回复：

```sh
beeuni sessions chat
```

### 审查并合并变更请求
智能体完成工作后，会提交一个变更请求，其中包含摘要和准确的差异内容。

```sh
beeuni cr ls
```

这会列出项目中处于打开状态的 CR。审查智能体提交的 CR，然后将其合并，使工作进入默认分支：

```sh
beeuni cr merge 1
```

将 `1` 替换为 `beeuni cr ls` 中的 CR 编号。在你合并之前，任何内容都不会进入项目的默认分支。

<a id="next-steps"></a>

## 后续步骤

- [了解各部分如何协作](/docs/zh/work)
解释项目、会话和变更请求。
- [CLI 命令参考](/docs/zh/cli)
介绍每条命令、标志和子命令。
- [CLI 开发循环](/docs/zh/cli)
从终端关联代码仓库、交付代码并管理会话。