> ## 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.

# Vibey

> Avibe 自己的 Agent：内置、始终开启，从 Model Hub 拿到模型后，就能在浏览器 Workbench 或任意聊天软件里直接用。

# Vibey

Vibey（歪比）是 Avibe 自己的官方 Agent。它内置在 Avibe 里、就在 Avibe 里运行，不用另外安装：给 [Model Hub](/zh/concepts/model-hub) 加一个模型来源、再给 Vibey 选好模型，它就能开工。它始终开启，在 Agent 列表里排第一，从 [Workbench](/zh/concepts/workbench) 和每个已接入的聊天软件——Slack、Discord、Telegram、微信、Lark / 飞书——都能找到它。

Vibey 能自己把活干了，也能替你运转整个平台：安排任务、等待条件、做页面，把一件事的不同部分交给 Claude Code、Codex 或 OpenCode——它们照常以原本的样子在旁边运行。

## Vibey 擅长什么

### 运转平台

Vibey 从里面就懂 Avibe。每一轮 Vibey 都带着每个 Agent 都有的那份 Avibe 指引和 Skills 目录，并通过命令工具运行 `vibe` 命令来行动：

* **Harness：** 立即运行另一个 Agent、保存定时任务、用 Watch 等一个条件、查看运行历史。→ [Harness](/zh/concepts/harness)
* **Show Pages：** 做一个实时页面——仪表盘、图、报告——手机上也能打开。→ [Show Pages](/zh/concepts/show-pages)
* **Vaults 和 Skills：** 按名称使用凭证，加载你装好的 Skills。→ [Vaults](/zh/concepts/vaults) · [Skills](/zh/concepts/skills)
* **Computer Use：** 在 macOS 上的 Avibe 桌面 App 里打开 Computer Use 后，Vibey 可以通过 `vibe computer` 观察和操作桌面应用，和其他 Agent 的方式一样。

设置向导的一句话概括了这个思路：*由 Vibey 统筹，Claude Code、Codex、OpenCode 接力完成。* 让 Vibey 规划一次改动，Claude Code 来写、Codex 来审、OpenCode 来测，最后由 Vibey 把结果汇报给你。

### 写代码

| 工具 | 做什么 |
| - | - |
| `read` | 读文本文件，每次最多 2,000 行或 50 KB，用 offset 接着读；也能读图片（JPEG、PNG、GIF、WebP）。 |
| `write` | 新建或覆盖一个文件。 |
| `edit` | 按精确文本替换文件内容：一次调用里可以有多处互不相交的修改，也可以用 `replaceAll` 替换全部匹配。 |
| `bash` / `powershell` | 在会话的工作目录里运行命令：macOS 和 Linux 上是 `bash`，Windows 上是 PowerShell。 |

如果你的 PATH 里没有 `rg`，Avibe 会把一个托管的 ripgrep 加进 Agent 命令使用的 PATH。

**项目说明文件。** 每个 Turn 开始时，Vibey 会加载你的说明文件：先读 `~/.avibe/AGENTS.md`，对所有项目生效；再从文件系统根目录一路到工作目录，读每一层的 `AGENTS.md`（或 `CLAUDE.md`）。`AGENTS.override.md` 会替代所在目录的 `AGENTS.md`；两个文件冲突时，越具体的越优先。改了文件，下一个 Turn 就生效。这些文件合计上限 64 KiB，超出时 Vibey 会知道哪个文件被截断或没有加载。工作目录以下的子目录里的文件不会预先加载：Vibey 知道子目录里可能有更具体的说明文件，在处理那里的文件之前会先去读。`~/.avibe/AGENTS.md` 可以在 Agents 页的**全局提示词**里编辑。

### 并行工作

同一次回复里互不依赖的调用——读文件、搜索、彼此独立的命令——会同时运行；编辑和写入则按顺序一个一个来。

运行超过 120 秒的命令，或者 Vibey 有意放到后台的命令，会转成一个 Avibe Watch 继续跑，结束时 Vibey 会收到一条后续消息。`vibe watch list` 可以看到它；删除这个 Watch 就会结束命令。

## 模型

Vibey 的所有模型都通过 Model Hub 获得。它没有直连模式，也没有自己的 CLI 登录。

* **来源。** Vibey 使用网关持有的来源：API Key，以及登录为网关来源的订阅。由自己的 CLI 原生使用的订阅（比如 Claude Code 自己的登录）不会供给 Vibey。
* **它的型号列表。** 第一个这样的来源出现时，Avibe 会一次性把你的内置 Claude Code、Codex、OpenCode Agent 在用、且这些来源提供的型号填进 Vibey 的列表。一个都不符合时，Vibey 会选你的来源列出的第一个、models.dev 描述为支持文本输入和工具调用的型号。只有列出的型号都不符合时，列表才为空，由你来选。
* **选择型号。** 在设置向导里，Vibey 的卡片会显示**还没有模型，选一个即可开始**，并列出你的来源提供的型号和**全部模型…**。之后可以在**模型 > 供应商与路由**里对 Vibey 使用**管理模型**，或者在它任意型号列表末尾点**添加模型**。推理强度按 Model Hub 里为该型号配置的档位来。
* **协议。** Vibey 通过网关用各家原生 API 调用模型——Anthropic Messages、OpenAI Chat Completions 和 Responses、Google Gemini——所以路由、故障切换和恢复，和其他网关后端完全一样。
* **网关保持开启。** 只要 Vibey 还有型号，模型网关就不能关闭：**Vibey 的模型通过模型网关运行，请先移除这些模型再关闭网关。** 如果网关还是处于关闭状态，Vibey 的回合会停下并提示：**模型网关已关闭，Vibey 没有可用的模型。请在「模型」页开启网关并选择模型。** Model Hub 默认开启。如果实例的运维人员停用了它，Vibey 就无法运行，新安装的首个默认 Agent 会改为一个可用的 CLI 助手。

## 平台

Avibe 能跑的地方，Vibey 都能跑：macOS、Linux 和原生 Windows。原生 Windows 支持是这个版本新增的，目前只在 CI 里测试过，还没有在大量真实 Windows 机器上验证；在 Windows 上仍然推荐使用 WSL。

* 在 macOS 和 Linux（包括 WSL）上，命令在 `bash` 里运行。
* 在原生 Windows 上，PATH 里有 `pwsh` 时命令在 PowerShell 7 里运行，否则在 Windows 10 和 11 自带的 Windows PowerShell 5.1 里运行。Vibey 知道自己用的是哪一个；Windows PowerShell 5.1 没有 `&&` 和 `||`。

## 在 Avibe 中配置

1. 添加一个模型来源，并给 Vibey 选一个型号。新安装时在[设置向导](/zh/get-started/setup-wizard)里完成，只要 Vibey 有了型号，单靠它就能完成设置；升级上来的实例已经完成过设置，就在**模型 > 供应商与路由**里添加来源，再对 Vibey 使用**管理模型**。
2. 在 Workbench 里和 Vibey 开一个会话，或者把一个或多个聊天 channel 路由给它。
3. 需要的话，在 Vibey 后端上再建几个 Agent，各自有自己的提示词和型号。

新安装且开启了 Model Hub 的 Avibe，新对话默认交给 Vibey。升级上来的实例保留原来的默认 Agent，之后可以在 Agents 页用**设为默认**，或者用 `vibe agent default vibey` 把 Vibey 设为默认（如果内置 Agent 按下文所说改名成了 `vibey-2`，就用 `vibey-2`）。Vibey 跑不起来时，会在回复里说明缺了什么，而不会把你的消息转给别的 Agent：在 Workbench 里，管理员会看到**打开「模型」页**，其他人会被提示请 Avibe 管理员处理；在聊天应用里，`/setup vibey` 会说明 Vibey 的模型从哪来。内置 Vibey Agent 的型号、推理强度、提示词和描述都可以修改，只有启用开关锁定为开启。如果你原来就有一个叫 `vibey` 的 Agent，它会保留这个名字，内置 Agent 则命名为 `vibey-2`。

## 会话、复刻与停止

* **上下文。** Vibey 自己管理上下文：对话变长时，它会在不打扰你的情况下把前面的内容压缩。没有 `/compact`。如果还是放不下，Vibey 会停下，请你用 `/new` 开一个新会话。
* **复刻。** Workbench 里的**复刻会话**，或者 `vibe agent run --fork-session <session-id> --message "..."`，会从 Vibey 自己的对话记录开一个新会话，内容截至源会话最近一个已结束的回合；仍在进行的回合不会带过去。复刻之前启动的命令、Watch 和定时任务都留在源会话。
* **停止。** **停止**按钮或聊天里的 `/stop` 会结束当前回合，以及仍在前台运行的命令。已经交给 Watch 的命令会继续跑，直到结束或你删除这个 Watch。Vibey 工作时你发的消息，会在它当前这批工具调用结束后被读到。
* **重启。** 如果 Avibe 在回合进行中重启，这一回合会以中断结束，不会自动继续；你的下一条消息会带着完整上下文接着来。正在运行的命令会作为 Watch 继续跑。

## 限制

Vibey 还是第一版：

* **能力：** 没有 MCP 客户端（Avibe 的能力通过 `vibe` 命令接入）；没有网页抓取、网页搜索或 LSP 工具；没有逐次操作的审批，也没有沙箱——Vibey 以你的用户身份直接运行工具，不会先征求确认。
* **命令：** 没有输入，也没有终端，所以会提问的程序和全屏程序用不了。暂停或删除命令所在的 Watch 会结束这条命令，`/new` 也会暂停它；这种 Watch 不能恢复或编辑。在 macOS 和 Linux 上，脱离到独立会话的进程（比如用 `setsid` 启动的）不会被跟踪。命令继承 Avibe 服务的环境变量，包括那里设置的 `OPENAI_API_KEY` 之类的服务商变量；网关自己的令牌从不在其中。
* **输出：** 没有实时流式输出——文字和命令输出在每一步完成时出现——也没有自己的斜杠命令。Avibe 的聊天命令，比如 `/new` 和 `/stop`，照常可用。
* **复刻：** 只能从最近一个已结束的回合复刻，不能从更早的位置开始；复刻后的第一个回合没有服务商的提示词缓存。
* **文件和图片：** `edit` 不处理超过 10 MiB 或 200,000 行的文件，也不处理超过 10,000 处的 `replaceAll` 匹配。图片不会被缩放或转换：超过约 3.4 MB 的图片文件会被略过，不支持 BMP，图片能力未知的型号会收到一段文字占位。Vibey 看过的图片和它的上下文临时文件保存在 `~/.avibe` 下、只有你的用户可读，删除会话时不会一起删除。
* **型号：** 不知道型号上限时，Vibey 按 128,000 token 上下文和 8,192 token 输出来算。Gemini 型号经由网关转换运行：跨工具调用的推理连续性不会保留，没有结束原因的流会让回合失败，被安全过滤拦下的提示可能要等到 10 分钟无响应上限才失败，含 `:` 的型号 ID 会被拒绝。

## 冒烟测试

```text theme={null}
Read the current project root and summarize the repository in three bullets.
```


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