> ## Documentation Index
> Fetch the complete documentation index at: https://docs.avibe.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# 伙伴

> 你的 Avibe 里的常驻成员：有名字和职责，有一段永不结束的对话和自己的记忆。它把活交给 Session，并跟进到底。主伙伴是内置的。

**伙伴**（Bot）是你的 Avibe 里的常驻成员。它有名字、头像和职责，有一段永不结束的对话，还有一个保存自己记忆的目录。Agent 是你为一件事运行的；伙伴是你一直在跟它说话的，它把活交给 Session，并跟进到底。

![Workbench 侧边栏里的伙伴头像条：歪比、有两条未读回复的安全负责人，以及正在工作的发布经理。悬停在发布经理上，显示它的代号、职责和正在做的事。歪比的对话里，它把登录检查交给了安全负责人。](https://mintcdn.com/cyhzhusunin/lu7mVk7rnutofb68/assets/screenshots/zh/bots-strip.png?fit=max\&auto=format\&n=lu7mVk7rnutofb68\&q=85\&s=d0e89813afd4f8ec45d43b28fbac2684)

产品界面，示例项目数据。

## 伙伴和 Agent

| | 伙伴 | Agent |
| - | - | - |
| 是什么 | 有名字、头像和职责的常驻成员 | 可复用的角色：后端、模型和指令 |
| 对话 | 一段永久对话 | 每次运行都是一个新 Session |
| 记忆 | 对话一直延续，并有自己的目录 | 每次从零开始 |
| 干活 | 和你商量，把活交给 Session；一次处理一轮，你的消息优先送到 | 自己动手；多次运行可以并行 |
| 后端 | [Vibey](https://docs.avibe.bot/zh/agents/vibey.md)，可以用任何 [Model Hub](https://docs.avibe.bot/zh/concepts/model-hub.md) 模型 | Vibey、Claude Code、Codex 或 OpenCode |

需要它的记忆、需要它持续负责、或者需要它判断时，找伙伴。独立的一件事或者需要并行时，运行 Agent。

每个伙伴都运行在一个属于它自己的 Agent 上，这个 Agent 归伙伴所有。所有选择 Agent 的地方都不会列出它：对话模型菜单里的 Agent 列表、新建会话、项目的 Agent、频道路由、默认 Agent 都不会。Avibe 也会拒绝把会话、项目、频道或默认 Agent 换到它上面。要找它，就选这个伙伴。伙伴被移出后，它的 Agent 才重新成为普通 Agent。

## 你的主伙伴

每个 Avibe 都自带一个主伙伴，在你改名之前叫歪比。它是你的第一联系人，能看到这台机器上的一切：每个项目、会话、Agent 和伙伴。和它商量事情、一起做决定；需要动手的活由它发起并跟进。它排在伙伴头像条的第一位，[首页](https://docs.avibe.bot/zh/concepts/workbench.md#首页)的输入框就是发给它的，[桌面应用](https://docs.avibe.bot/zh/get-started/install.md#桌面应用)里的歪比小窗连的也是它。

主伙伴的显示名称可以改，头像条、它的对话和桌面小窗的气泡都会显示新名字。它的头像始终是歪比的形象，它也不能被移出。它的 Agent 是一个名为 `main` 的内置 Agent，不会出现在任何选择 Agent 的地方；内置的 `vibey` Agent 仍是普通 Agent，用于项目里的对话。

## 伙伴怎么把事做成

伙伴和你商量、和你一起做决定，并维护自己的记忆。其余的事它都交出去：需要查清楚的（比如搜索网页、读网页或代码），需要动手做的，都交给一个 Session，然后把每件事跟进到底。

* **在哪儿做**：属于某个项目的活，交给这个项目里的 Session。对于长期的项目，主伙伴会按设定安排一个牵头 Session，负责协调那里的工作。伙伴自己的对话不属于任何项目。
* **谁来做**：伙伴可以接着已经在做这件事的 Session，给另一位伙伴发消息，或者新开任意 Agent 的 Session（包括 Claude Code、Codex 和 OpenCode），并给它选合适的模型。
* **怎么跟进**：Session 会向伙伴汇报。如果它没有写回就空闲下来，Avibe 会给伙伴发一条已读回执，附上它的最后一条回复；运行失败会立即告知。事情要等某个时间或某件事发生时，伙伴会设好 Task 或 Watch。→ [Harness](https://docs.avibe.bot/zh/concepts/harness.md)
* **新的伙伴**：某个方面需要和你保持长期关系时，主伙伴可以建议为它添加一位伙伴，由你决定。

## 找到你的伙伴

在 [Workbench](https://docs.avibe.bot/zh/concepts/workbench.md) 侧边栏里，**伙伴**头像条位于 Avibe 品牌下方。收件箱是品牌行右端的图标。

* 主伙伴始终排第一。其他伙伴按你最近一次给它发消息的时间排列，最新的在前；还没发过消息的伙伴排在后面，按添加的先后。没有手动排序。指针停在头像条上、或者它的菜单打开时，顺序保持不动，之后再更新。
* 你正在看的伙伴，头像外有一圈亮起的描边；数字是它的未读回复数；跳动的小点表示它正在工作。
* 悬停在头像上，可以看到伙伴的全名、代号、职责，以及最近一条消息或正在做的事。点击头像或卡片，进入它的对话。
* 伙伴多到放不下时，头像条可以横向滚动，**添加**固定在最右端。
* 伙伴的对话也会出现在收件箱里，带「伙伴」标签，并计入未读总数。

在手机上，**工作台**标签页显示同样的头像条，底部标签栏的中间就是你的主伙伴：点一下打开它的对话。在伙伴的对话里，点顶部的名字可以切换到别的伙伴。

### 按住头像说话

在头像条上按住任意一个头像（包括主伙伴），不用打开对话就能对这位伙伴说话。用法和按住输入框一样：用鼠标时按住直到圆环走满，松开发送，移出头像或按 **Esc** 取消；用手指时按住，松开发送，上滑取消。你说的话会进入这位伙伴的对话，带语音标记，你留在原来的页面；提示里的**查看**可以打开那段对话。在手机上，按住标签栏中间的主伙伴也一样。

## 添加伙伴

点头像条末尾的**添加**，或者 Agents 页伙伴区里的**添加伙伴**。对话框有两个标签页。

**新建**会创建一个伙伴和它的 Agent：

1. 填写**名称**，任何语言都可以。
2. 选一个**头像**：一个 emoji 加底色，或者上传一张不超过 10 MB 的 PNG、JPG 或 WebP 图片，自动裁成圆形。emoji 网格先列出常见职责各一个；**更多表情**里是全部 emoji，可以用中英文搜索，也能选肤色。选之前，头像是名字的第一个字，配一个由名字决定的颜色。
3. 写下**它负责什么**。职责会写进它的设定；之后可以在**编辑资料**或 Agents 页里修改。
4. 填好名称后，Avibe 会生成**代号**。纯 ASCII 的名字直接变成代号（`Researcher` 变成 `researcher`）；其他名字由主伙伴的模型起一个简短的英文代号，5 秒内没有模型回答时改用音译。添加之前，你可以修改代号。
5. 在**高级**里，伙伴默认跟随主伙伴的模型和推理强度，也可以另选。

**从已有 Agent 设为伙伴**会把你的某个 Vibey Agent 设为伙伴。这里列出已启用、还不是伙伴的 Vibey Agent；内置的 `vibey` Agent 不在其中，默认 Agent 要先换掉默认身份才能设为伙伴。代号沿用 Agent 名。在 Agents 页上，可以设为伙伴的 Agent 提供同样的操作：**设为伙伴**。

![添加伙伴对话框：名称市场研究员，显微镜头像，生成的代号 @research，它的职责，以及高级里跟随歪比的模型](https://mintcdn.com/cyhzhusunin/lu7mVk7rnutofb68/assets/screenshots/zh/bots-add.png?fit=max\&auto=format\&n=lu7mVk7rnutofb68\&q=85\&s=a8660dc426476fc03c79f8bc6ce49931)

产品界面，示例项目数据。

也可以直接在主伙伴的对话里说，比如：*帮我加一个负责安全的伙伴。*

除主伙伴外，最多可以有五位伙伴。满五位时，头像条上没有**添加**；Agents 页上的**添加伙伴**和**设为伙伴**不可用，并显示原因和数量。移出一位伙伴，就空出一个位置。

代号由 2 到 24 个小写字母、数字或连字符组成，以字母开头，不以连字符结尾；`main`、`memory`、`ops` 已保留。显示名称随时可以改，代号在伙伴创建后就不再变：伙伴的对话（`ses_<代号>`）、目录、提及和命令行都用它。

## 和伙伴对话

从头像条打开一个伙伴。对话页顶部只有返回、它的头像和名字，以及 **…**；**…** 里是**编辑资料**和**隐藏细节**。没有改名、归档和分叉，因为这段对话永不结束。新伙伴的空对话里，是伙伴在向你自我介绍，并附上你给它写的职责。消息框右下角的模型按钮只显示模型和推理强度；它的菜单只改这两项（模型支持时还有速度），不会改伙伴本身。

![安全负责人的对话：页头有返回按钮、它的头像和名字，… 菜单展开，里面是编辑资料和已开启的隐藏细节。用户的提问后面是伙伴的汇报，模型按钮显示 gpt-6-astra 和高。](https://mintcdn.com/cyhzhusunin/lu7mVk7rnutofb68/assets/screenshots/zh/bots-conversation.png?fit=max\&auto=format\&n=lu7mVk7rnutofb68\&q=85\&s=0344eba1fb7a8669d80a1189abecff04)

产品界面，示例项目数据。

**隐藏细节**默认开启，伙伴的对话读起来就像在和一个人聊天：不显示执行过程、Harness 消息和后台任务横幅，伙伴干活时显示思考气泡。伙伴自己的回复始终显示，包括它对跟进中的事情的汇报。关掉后会显示 Harness 消息和后台任务；执行过程则和任何会话一样，在设置里开启**显示 Agent 执行过程**时才显示。这个开关保存在伙伴上，所有设备看到的都一样。

伙伴一次处理一轮，你的消息优先送到。伙伴空闲时，马上开始处理你的消息；正在干活时，会把它插进当前这一轮。插不进时，你的消息显示**还没送达**，这一轮结束后就会送到；点**不发了**可以撤回。其他 Agent 和伙伴发来的消息排在你的后面。

### 提及伙伴和 Agent

在 Workbench 的消息框里输入 `@`，会出现一个列表：伙伴在前，带头像，Agent 在后。伙伴的 Agent 不在 Agent 里。你选的对象决定了含义：

* **伙伴**会在它自己的对话里收到这条消息：它会记住，并按顺序处理。
* **Agent** 会开一个新 Session：不记得以前的运行，可以并行。

`#` 仍然用来引用 Session。伙伴的对话不出现在 `#` 的列表里；要指向伙伴，用 `@`。

提及显示伙伴当前的名字和头像。消息文本里，提及存为 `@<bot:代号>` 或 `@<agent:名字>`，所以给伙伴改名不会改动以前的消息。有伙伴之前写下的提及 `@<名字>`，仍然指 Agent。

## 记忆

伙伴的目录就是它的记忆：`~/.avibe/bots/<代号>/`。

* 它一开始是一个空的 Git 仓库。伙伴有值得保存的东西时，会在这里创建 `AGENTS.md`，用它做其他文件的索引。
* 按设定，伙伴会在 `matters/` 下为跟进的每件事建一个文件夹，按日期和主题命名，记下目标、和你说定的事、在做这件事的 Session，以及进展；还会在 `projects/` 下为它参与的每个项目写一份笔记。Avibe 不会预先创建这些，由伙伴自己整理。
* 和任何 Vibey Session 一样，伙伴会加载从文件系统根目录到它的目录沿途的指令文件。所以它自己的 `AGENTS.md` 每一轮都在它的指令里；你写的 `~/.avibe/bots/AGENTS.md` 会被所有伙伴读到。
* Avibe 会在每一轮之前提交这个目录，记下你或其他人做的改动；在每一轮之后再提交一次，记下伙伴自己的改动。历史不会被压缩，任何改动都可以用 Git 追溯或撤销。
* 伙伴是谁，由它的 Agent 定义决定，这归你管；伙伴不能靠修改记忆来重新定义自己。密钥放在 [Vaults](https://docs.avibe.bot/zh/concepts/vaults.md) 里，不要放进记忆。

对话变长后，前面的部分会被压缩，和所有 Vibey Session 一样（[Vibey 如何记忆](https://docs.avibe.bot/zh/agents/vibey-memory.md)）。伙伴以后还需要的内容，写进自己的目录才能留住。

## 编辑和移出

在头像条上右键点一个伙伴：

* **编辑资料**修改伙伴的显示名称、头像和职责。主伙伴只能修改显示名称。
* **移出伙伴**会先确认一次，再把它从头像条上拿掉。它的对话和记忆都会保留，只是不再显示；它的 Agent 回到 Agents 列表，在那里点**设为伙伴**就能接回来。主伙伴不能移出。

伙伴和 Agent 都在 Agents 页上配置。页面先是**伙伴**区，按头像、名字和职责排列，末尾是**添加伙伴**；后面是 Agents，排成一个列表，伙伴的 Agent 不在其中。在这里打开一个伙伴，可以进入它的对话、编辑资料、修改模型、推理强度和指令，或者移出伙伴。伙伴始终启用、代号不变，不能删除，也不能设为默认 Agent，所以这些操作不会出现。

![Agents 页：伙伴区里有歪比、安全负责人、发布经理和添加伙伴，下面是 Agents 列表。旁边打开的是安全负责人，有进入对话、编辑资料、它的模型和推理强度、代号 @security，以及移出伙伴。](https://mintcdn.com/cyhzhusunin/lu7mVk7rnutofb68/assets/screenshots/zh/bots-agents.png?fit=max\&auto=format\&n=lu7mVk7rnutofb68\&q=85\&s=3987299956481542b6f9e5f7b067a64f)

产品界面，示例项目数据。

## 命令行

| 命令 | 作用 |
| - | - |
| `vibe bot list` / `show <代号>` | 按头像条的顺序列出伙伴，或显示一个 |
| `vibe bot create --name "…" [--handle …] [--role "…"]` | 新建一个 Vibey Agent 并设为伙伴；`--model`、`--reasoning-effort`，以及 `--emoji` 加 `--hue` 都是可选的 |
| `vibe bot set <agent> --name "…"` | 把已有的 Vibey Agent 设为伙伴 |
| `vibe bot update <代号>` | 修改显示名称或 emoji 头像（`--emoji` 加 `--hue`，或 `--clear-avatar`） |
| `vibe bot remove <代号>` | 移出伙伴，保留 Agent、对话和目录 |
| `vibe agent run --bot <代号> --message "…"` | 给伙伴的永久对话发消息，排在它之前的消息后面；命令立即返回 |

用 `--bot` 发消息的一方，和所有 `vibe agent run` 的发送方一样得到回音（[Harness](https://docs.avibe.bot/zh/concepts/harness.md)）：伙伴会汇报；如果它没有写回就空闲下来，Avibe 会发一条已读回执，附上它的最后一条回复；没有完成的运行会立即告知。不需要另外请求回调：`--callback` 仍然接受，但不起作用。不需要回应时加 `--no-reply`。修改伙伴的职责、模型或指令，用 `vibe agent update`。

命令行是伙伴的 Agent 唯一还能当作 Agent 使用的地方，这样某个 Agent 被设为伙伴后，保存的 Task、Watch 和脚本照常工作：`--agent` 会开一个这个 Agent 的新 Session，不会写进伙伴的对话。→ [命令参考](https://docs.avibe.bot/zh/reference/commands.md)

## 目前的边界

* 伙伴属于实例的 Owner。Organization 实例里的其他成员看不到伙伴，也打不开它们的对话。
* 伙伴可以从 Workbench（浏览器、手机或桌面应用里）、桌面小窗（主伙伴）和 `vibe agent run --bot` 联系到。聊天软件里的私聊还不能绑定到伙伴。
* 除主伙伴外，最多可以有五位伙伴。
* 目前没有任何机制会替你写 `~/.avibe/bots/AGENTS.md`；里面只有你或你的伙伴放进去的内容。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.