> ## 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.bot 的作用。

# 本地优先架构

Avibe 运行在你的机器上。

你的代码库、工作目录、agent CLI、agent 进程、日志和本地配置都留在本地。「本地优先」是一种架构立场，不是一个开关，见 [设计哲学](/zh/concepts/philosophy)。

## 数据流

```text theme={null}
你
  -> 聊天 App
  -> 你机器上的 Avibe
  -> Claude Code / OpenCode / Codex
  -> Avibe
  -> 聊天 App
  -> 你
```

Avibe 是让 AI 同事住进聊天里的本地 runtime，同时把真正的 agent 工作留在你的机器上。它不会在你和你选择的 agent 之间再加一个隐藏的 LLM loop。

## 为什么这很重要

* 不需要托管 coding VM。
* 正常聊天控制不需要公开入站端口。
* agent 看到的是你在终端里会看到的同一份本地项目状态。
* token 开销接近零，因为 Avibe 不会在你选择的 agent 前面再扮演第二个推理 agent。

## 哪些东西会离开你的机器

把边界说清楚：唯一离开的，是你选的 agent 发给它 AI 提供商的内容——为这个任务准备的 prompt 和上下文，发往 Anthropic、OpenAI 或你配置的那一家。你静态的代码、你的密钥、你的日志、agent 进程，都不会离开。用到 avibe.bot 时，它只经手控制面的握手和隧道，从不碰你的数据。

## avibe.bot 用来做什么

`avibe.bot` 是用于安全远程 Web UI 访问的托管控制平面。

当你运行：

```bash theme={null}
vibe remote
```

Avibe 会帮你把本地 Web UI 和一个通过认证的远程 URL 配对。浏览器流量通过 tunnel 到达你的本地机器；数据和 agent runtime 仍然留在本地。访问是 **fail-closed** 的——鉴权、路由、host 校验默认拒绝——所以配错只会把你自己挡在外面，而不是把机器暴露出去。