伙伴

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

伙伴和 Agent

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

你的主伙伴

每个 Avibe 都自带一个主伙伴，在你改名之前叫歪比。它是你的第一联系人，能看到这台机器上的一切：每个项目、会话、Agent 和伙伴。和它商量事情、一起做决定；需要动手的活由它发起并跟进。它排在伙伴头像条的第一位，首页的输入框就是发给它的，桌面应用里的歪比小窗连的也是它。 主伙伴的显示名称可以改，头像条、它的对话和桌面小窗的气泡都会显示新名字。它的头像始终是歪比的形象，它也不能被移出。它的 Agent 是一个名为 main 的内置 Agent，不会出现在任何选择 Agent 的地方；内置的 vibey Agent 仍是普通 Agent，用于项目里的对话。

伙伴怎么把事做成

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

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

找到你的伙伴

在 Workbench 侧边栏里，伙伴头像条位于 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 提供同样的操作：设为伙伴。 也可以直接在主伙伴的对话里说，比如：帮我加一个负责安全的伙伴。 除主伙伴外，最多可以有五位伙伴。满五位时，头像条上没有添加；Agents 页上的添加伙伴和设为伙伴不可用，并显示原因和数量。移出一位伙伴，就空出一个位置。 代号由 2 到 24 个小写字母、数字或连字符组成，以字母开头，不以连字符结尾；main、memory、ops 已保留。显示名称随时可以改，代号在伙伴创建后就不再变：伙伴的对话（ses_<代号>）、目录、提及和命令行都用它。

和伙伴对话

从头像条打开一个伙伴。对话页顶部只有返回、它的头像和名字，以及 …；… 里是编辑资料和隐藏细节。没有改名、归档和分叉，因为这段对话永不结束。新伙伴的空对话里，是伙伴在向你自我介绍，并附上你给它写的职责。消息框右下角的模型按钮只显示模型和推理强度；它的菜单只改这两项（模型支持时还有速度），不会改伙伴本身。 隐藏细节默认开启，伙伴的对话读起来就像在和一个人聊天：不显示执行过程、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 里，不要放进记忆。

对话变长后，前面的部分会被压缩，和所有 Vibey Session 一样（Vibey 如何记忆）。伙伴以后还需要的内容，写进自己的目录才能留住。

编辑和移出

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

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

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

命令行

用 --bot 发消息的一方，和所有 vibe agent run 的发送方一样得到回音（Harness）：伙伴会汇报；如果它没有写回就空闲下来，Avibe 会发一条已读回执，附上它的最后一条回复；没有完成的运行会立即告知。不需要另外请求回调：--callback 仍然接受，但不起作用。不需要回应时加 --no-reply。修改伙伴的职责、模型或指令，用 vibe agent update。 命令行是伙伴的 Agent 唯一还能当作 Agent 使用的地方，这样某个 Agent 被设为伙伴后，保存的 Task、Watch 和脚本照常工作：--agent 会开一个这个 Agent 的新 Session，不会写进伙伴的对话。→ 命令参考

目前的边界

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