---
title: "配置"
description: "设置、按键表、把配置复制到另一台机器、从 config.toml 升级、内置 CLI 如何保持最新、主题，以及状态保存在哪里。"
canonical: "https://agent-manager.dev/zh-cn/docs/config/"
last-updated: "2026-11-02"
section: "Documentation"
language: "zh-CN"
source: "agent-manager"
---

# 配置

所有可以修改的选项都在设置（`s`）里：按键、`o` 打开的编辑器、主题以及其他各行。离开设置时修改会被保存，并在那一刻生效。只有你修改过的行会被写入，所以其间另一个管理器或 CLI 做出的修改会被保留。每个 CLI 的启动命令、恢复和分叉命令、MCP 注册以及状态规则都内置在二进制文件中，所以一次升级就会把它们全部更新到最新版本。

管理器把每项选择保存在 `state.db` 中，这是位于操作系统用户配置目录下的一个 SQLite 文件：

| 平台 | 目录 |
| --- | --- |
| Linux | `~/.config/agent-manager/`，设置了 `$XDG_CONFIG_HOME` 时则位于其下。 |
| macOS | `~/Library/Application Support/agent-manager/` |
| Windows | `%AppData%\agent-manager\` |

`editor` 行决定 `o` 用哪个命令打开目录。`←→` 依次切换 `auto`、在你的 `PATH` 上找到的每个 GUI 编辑器、`$VISUAL` 和 `$EDITOR` 指定的编辑器，以及 `custom`，在 custom 上按 `↵` 会打开一个输入框，填写你自己的命令。`auto` 依次解析为 `$AGENT_MANAGER_EDITOR`、`PATH` 上的 GUI 编辑器、`$VISUAL` / `$EDITOR`。在 Linux 上，如果你设置了 `$BROWSER`，链接会用它打开，多个值用冒号分隔，`%s` 代表 URL，否则退回到 `xdg-open`。macOS 把链接交给 `open`。面板每两秒轮询一次，用于更新状态、预览和统计数据。

## 从 shell 修改设置

`agent-manager settings` 无需打开管理器就能读取和修改同样的设置。`settings list` 打印每个键及其当前值和可选值。`settings get` 打印一个键的值，没有保存时打印默认值，`settings set` 写入一个值。超出该键可选范围的值会被拒绝，拒绝信息会列出可选值。

```bash
agent-manager settings set theme "tokyo night"
agent-manager settings set notifications off
agent-manager settings get list_density
```

运行中的管理器会立即应用 `notifications`、`coordination` 和 `notify_command`。其余设置会在下次打开设置时显示，并从那时起生效。`notify_command` 没有对应的设置行。[状态](/zh-cn/docs/status/#notifications)一页介绍了它。

## 已保存的提示词

设置中的 `saved prompts` 行保存你反复使用的命名指令。`n` 新建一条，`enter` 编辑，`d` 删除。`tab` 在名称和正文之间切换，`ctrl+s` 保存，`esc` 退出。名称必须唯一，最多 60 个字符，不能包含括号，正文最多 64 KiB。同一个列表供以下各处使用：`n` 表单、快速提示模式、聚焦的会话、`spawn --saved`、`send --saved`，以及 `saved` 参数（用于 `create_session` 和 `send_session`）。[快速提示](/zh-cn/docs/prompt/#saved)一页说明了每条提示词会去往哪里。

```bash
agent-manager prompts list
agent-manager prompts add reviewer "Review the parser changes"
agent-manager prompts rm reviewer
```

修改或删除一条提示词，不会影响已经启动的会话。列表在条目下方画一条虚线，然后是 `agents save these with agent-manager prompts add`。没有已保存的提示词时，它会在这行上方显示 `No saved prompts.`

## 把配置复制到另一台机器

`agent-manager export` 把配置写成一个 JSON 对象，`agent-manager import` 把该文件合并进这台机器。这里的配置指设置、按键绑定、编辑器、已保存的提示词、分组和 SSH 连接。它不包括会话、任务、收件箱消息、审查、worktree、智能体历史、环境配置和 SSH 密钥。

不带分区参数时，两个命令都覆盖全部四个部分：设置、已保存的提示词、分组和连接。`--settings`、`--presets`、`--groups` 和 `--connections` 把文件限制在这些部分。已保存的提示词就是 presets 部分。路径对导出默认为标准输出，对导入默认为标准输入。`-` 与此相同。文件路径只在尚不存在时创建，模式为 0600，写入失败会删除它。

```bash
agent-manager export settings.json
agent-manager export --settings --presets -
agent-manager import settings.json
```

文件不会被打码。它可能包含令牌、URL 或其他机密，导出时会在标准错误上说明这一点。导入只接受一个 JSON 对象，并拒绝它不认识的字段。匹配的键和名称会被更新，其余条目保留。然后它会请你重启正在运行的管理器，以便加载导入的配置，并在这台机器上使用之前检查路径和命令。

## 从 config.toml 升级

v0.40.0 之前的版本会读取该目录中的 `config.toml`。升级后第一次启动时，会把其中的 `editor` 行以及 `[keybindings.session]` 和 `[keybindings.list]` 表迁移到设置中，所以你改过的每个按键都留在原位。迁移只发生一次。此后设置是管理器唯一读取的地方，这个文件可以由你自行删除。如果管理器无法读取该文件，会在消息（`M`）中指出该文件及原因，按键则从默认值开始。

轮询间隔固定为两秒，所以该文件中的 `poll_interval` 行不起作用。`[tools.<name>]` 块同样不起作用，因为每个 CLI 的命令和状态规则都内置在二进制文件中。

## CLI

Claude Code、OpenCode、Codex、Grok Build、Gemini CLI、Antigravity CLI、Pi、Command Code、Hermes Agent、Muse Code、Oh My Pi 和 Cursor CLI 均已内置，另外还有 `T` 打开的 shell。每个 CLI 的启动命令、恢复和分叉命令、MCP 注册、状态规则，以及会话的模型、推理强度和 profile 在启动时使用的参数，都随二进制文件发布。Hermes、Antigravity、Oh My Pi 和 Cursor CLI 不支持分叉，Pi 和 Oh My Pi 没有 MCP 注册。设置（`s`）中有一个 `CLIs` 行，用来选择 `n` 表单和快速提示模式提供哪些 CLI，它的最后一项 `request CLI support` 会为列表之外的 CLI 打开一个预先填好的 issue。[支持的智能体](/zh-cn/docs/agents/)一页列出了每个 CLI 获得的支持。

Agent Manager 支持每个 CLI 的当前版本。CLI 也可以声明它仍能配合使用的最低版本。如果你的版本更旧，启动、恢复或打开其模型列表时会弹出一个对话框，列出你的版本、所需的版本，以及用来更新它的官方安装程序。`i` 运行该安装程序，`c` 复制它。位于 `/nix/store` 下的 CLI 没有安装程序，对话框会提示你按原来的安装方式更新。Pi 需要 0.84.3 或更高版本。Antigravity CLI 需要 agy 1.3.4 或更高版本，这是在不指定推理强度时接受模型基础 id 的第一个版本。其他 CLI 目前还没有最低版本要求。

## 状态显示不对时

规则由我们来修，修好了所有人受益。用会话 id 替换 `SESSION_ID`，像轮询器那样读取面板，然后附上这段文本和 CLI 的版本[提交一个 issue](https://github.com/wainmann/agent-manager/issues/new/choose)：

```bash
tmux -L agentmgr capture-pane -p -t am_SESSION_ID
```

## 按键绑定

设置中的 `keybindings` 行打开一个包含两张表的选择器：管理器在会话内部保留的按键，以及它自己列表的按键。每个操作可以绑定一个或多个按键，也可以关闭。在同一张表内，一个按键只对应一个操作。

`↵` 绑定你接下来按下的键，`a` 为操作添加第二个按键，`d` 关闭该操作，`r` 先列出将要变动的内容并询问你，然后把所有操作恢复为出厂按键。某张表无法使用的按键会在那里被拒绝并说明原因。离开选择器时，会保存你修改过的每张表，并立即启用这些按键。只有你改过的按键才会被保存，所以保持出厂默认的操作，会在新版本修改默认值时跟着更新。

会话操作有 `detach`（默认 `ctrl+q` 和 `ctrl+\`）、`review`（默认 `ctrl+r`）、`editor`（默认 `f3`）、`saved_prompt`（默认 `f4`）和 `tmux_prefix`（默认关闭）。会话按键只能是 `ctrl+` 加字母、`alt+` 加字母或数字，或者 `f1` 到 `f12`，因为单个字符会把这个键从智能体那里抢走。`detach` 始终至少保留一个按键。`tmux_prefix` 为受管理的会话设置独立的 tmux 前缀键，可以是一个或两个按键，这样你自己的 tmux.conf 用作前缀的那个键就能腾出来作为会话按键，比如用作 `detach`。

列表操作有 `up`、`down`、`open`、`attach`、`step_in`、`step_out`、`reorder_up`、`reorder_down`、`new_session`、`terminal`、`new_group`、`fork`、`prompt`、`copy_reply`、`review`、`mark_idle`、`rename`、`move`、`editor`、`restart`、`kill`、`kill_all`、`revive`、`revive_all`、`archive`、`cancel_end`、`restore`、`delete`、`search`、`filter`、`archived`、`empty_groups`、`fold_all`、`resize`、`settings`、`messages`、`help`、`quit` 和 `new_connection`。列表按键可以是普通字符、按键名（如 `space` 或 `pgup`）、`shift+` 加方向键或 tab，或者上面提到的修饰键形式。`esc` 和 `ctrl+c` 保持不变。`esc` 在任何地方都是取消。`ctrl+c` 即使在 `quit` 被关闭时也会退出管理器，在聚焦的会话中则会发送给智能体。`settings` 始终至少保留一个按键。

同样的按键表也作用于全屏进入（attach）和聚焦模式，从 `agent-manager` CLI 或由智能体通过 MCP 服务器创建的会话同样使用它们。底栏、`?` 按键表和会话底栏都读取这些表，所以改过的按键会在它的新位置被标出。

## 主题

`s` 打开设置，在其中用 `↑↓` 或滚轮在字段之间移动，`←→` 修改当前字段。单击某一行会移动到该行，再次单击会修改或执行它。`save and close` 和其他底栏按键一样：`esc` 执行它，在没有自身操作的行上 `enter` 也会执行它，单击它同样如此。内置十八套配色。十一套深色：classic、solarized dark、catppuccin mocha、tokyo night、gruvbox dark、nord、dracula、rosé pine、monochrome、kanagawa wave 和 onedark。七套浅色：solarized light、catppuccin latte、tokyo night day、gruvbox light、rosé pine dawn、paper 和 kanagawa lotus。

名称旁的色块条预览该配色，并且在选择器中切换时主题会立即应用，所以整个界面都是实时预览。管理器还会把终端自身的文字和背景颜色设为该配色的颜色，让窗口和界面之间没有接缝，并在退出时恢复。智能体面板在主题自己的背景和文字颜色上渲染，面板也会把这两种颜色告诉其中的智能体，这样会自动检测配色的智能体就会和管理器落在同一边（深色或浅色）。

**theme follows OS**（主题跟随系统）在启动时根据环境的浅色/深色偏好确定配色：在 macOS 和 Linux 桌面上读取操作系统设置，在其他环境（包括 SSH）中读取终端自身的背景。已经处于检测结果那一边的主题保持不变，只有不匹配时才会切换。同时有浅色和深色版本的配色会切换到另一半，所以 catppuccin mocha 会变成 latte，反之亦然，其他配色则切换到 classic 或 solarized light。你手动选择的主题会单独保存，所以关闭这个开关后会回到它。

**background**（背景）决定用什么填充界面后面的单元格。`theme` 是默认值，用配色的颜色绘制这些单元格，所以在忽略颜色请求的终端上也能保持一致。`terminal` 让它们保留终端自身的颜色，适合半透明或模糊背景的窗口。

### 符号

**symbols** 在 **Advanced**（默认）和 **Compatible** 之间切换，后者是为无法显示几何符号的字体准备的纯 ASCII 标记。Compatible 涵盖状态标记、加载动画、收件箱、拖动手柄、分组折叠、终端行、worktree 和分叉标记、提示词和回复前缀、搜索、对话框标题、通知、待执行的归档和结束，以及 diff 结果。切换该行时会预览这些标记，选择会立即生效。不会检测字体。Compatible 把按键提示画成 `enter` 和 `backspace` 这两个词，把边框和分隔线画成普通线条，并把本应停在半格上的仪表进位成整格。箭头和智能体输出保持不变。[状态](/zh-cn/docs/status/)一页列出了两套标记。

![设置界面，带有主题选择器，主题名称旁是一条配色色块。](/assets/screenshot-settings.webp)

_图 5s · 设置_

## 从右到左的文字

希伯来语和阿拉伯语的行按它们所占的单元格绘制，在每个宿主上都一样。自带双向排版的终端，例如 iTerm2 的从右到左支持或 WezTerm 的 `bidi_enabled`，会自行重新排列这些行；关闭该支持，即可按 Agent Manager 绘制的列来阅读界面。

## 状态数据

设置、排序、分组、归档、会话布局和分栏比例都保存在 `state.db` 中，下次运行时会恢复。
