---
title: "首次设置"
description: "首次启动时选择智能体、布局、密度和主题，浏览主要按键，并可以导入 CLI 已经保存的对话。"
canonical: "https://agent-manager.dev/zh-cn/docs/setup/"
last-updated: "2026-11-01"
section: "Documentation"
language: "zh-CN"
source: "agent-manager"
---

# 首次设置

还没有存过版本号的第一次启动会打开设置向导，而不是列表。它选择你使用的智能体、布局、密度和主题，浏览按键，也可以把 CLI 已经保存的对话带进来。仍然不需要写配置文件，也不需要启动守护进程。

## 什么时候打开

之后的启动直接打开列表。更新后的第一次启动仍会打开 what's-new 通知。设置（`s`）里有一行 `first-run setup`，标注为 walk through it again，随时可以再次打开同一个向导。

`enter` 向前。在欢迎步它开始设置，在最后一步，导入已经准备好时，它会导入并开始。`backspace` 或 `shift+tab` 在第一步之后返回。`esc` 离开前会先询问。到目前为止的选择会保留，同一行设置可以再把向导打开。每一步都可以点击，滚轮也可用。

## 这些选择

有四步会在你选择时立刻保存，写进以后仍可修改的同一批设置行。后面的导览不保存任何内容。

| 步骤 | 你选择的内容 |
| --- | --- |
| Agents | 新建会话表单和快速提示模式提供哪些 CLI。`PATH` 上找到的智能体一开始是勾选的，直到你改动某一项。至少保留一个勾选。 |
| Layout | `Split` 让列表旁边保留实时视图。`Full screen` 把整个屏幕交给列表。 |
| Density | `Compact` 每个智能体一行。`Comfortable` 把状态放在单独一行。 |
| Theme | `Follow the OS`（`space` 切换）以及各套配色。选中一套配色会关闭跟随系统。移动时整个屏幕会预览该配色。 |

## 按键导览

接下来的步骤按当前绑定显示按键，并演示它们。按键表里未绑定的键不会出现在对应行上。当 `←→` 进入和退出这对按键关闭，或这些键未绑定时，导览改为用 `enter` 聚焦会话，并用 detach 键返回。

| 步骤 | 它展示的内容 |
| --- | --- |
| Quick prompt | 在分组上输入任务并启动智能体。它也会指出新建会话表单和新建分组。 |
| Sessions | 回复选中的智能体，聚焦后直接输入，再回到列表。 |
| Review | 打开智能体的 diff，给某一行写评论，再把评论发回去。 |
| Orchestrate | 一个智能体可以再打开更多智能体，把它们分到分组里，并让它们保持同步。导览演示的请求是让一个智能体重建 checkout，并把它分给多个智能体。 |
| Places | 设置里有每一项选择，包括这个向导。消息里有新闻和提示。`?` 是全部按键，并且可以搜索。 |

## 过去的对话

最后一步是可选的。它请一个智能体读取这台机器上 CLI 已经保存的对话，并把每一条加进列表，以便接着做。它不改动那些 CLI，也会跳过列表里已经有的对话。

勾选要读取的 CLI。时间窗口从 7 天开始，`←→` 在 7、14 和 30 之间切换。执行导入的 CLI 必须既被勾选又已安装。`PATH` 上没有智能体 CLI 时，这一步会说明目前没有可以带进来的内容。这一步的 `enter` 只在执行者已经准备好时才会导入并开始。否则它会请你勾选一个 CLI，或按 `esc` 离开。

每条对话都用 `agent-manager spawn` 变成一个会话，目录是它被保存的目录，对话 id 是原来的 id，名称是 kebab-case。提示词和 worktree 都不设置，所以不会给智能体发送任务，对话也留在它被保存的目录里。

```bash
agent-manager spawn --tool <cli> --directory <dir> --resume <id> --name <name>
```

[会话](/zh-cn/docs/sessions/#resume)说明了 `--resume` 的规则。

## 再次运行

打开设置，在 `first-run setup` 上按 `enter`。已经保存的选择还在你留下的地方。用 `esc` 离开也会保留它们。