权威运行时(runtime)
权威运行时是唯一持有真实状态的东西:Agent 进程、会话时间线、工作区文件、Git 仓库、终端、供应商凭据和本地数据库。所有客户端都只是它的投影视图。 Vibex 里存在两种权威运行时形态,它们共用同一套内核,能力一致:
桌面工作台和移动端都是客户端。桌面端默认使用自己的内嵌运行时;你也可以把它切换成连接某个远程运行时,此时它和手机一样只是客户端。切换入口在标题栏的 运行时 按钮。
项目(project)
项目是你在 Vibex 里注册的一个文件夹:有名字、有图标、在侧栏里长期存在。侧栏的 项目 列表就是它,右键菜单里有改名、定制图标、删除等操作。 一个项目下面可以有多个工作区。工作区(workspace)
工作区是”以某种方式使用这个项目”。目前有两种模式:
同一个项目下可以同时存在一个
Local 工作区和一个或多个 Worktree 工作区。这就是为什么可以一边在主分支上干活,一边让 Agent 在隔离目录里试另一个方案。
会话总是属于某一个具体的工作区。切换工作区不会把未提交改动带过去。
详见工作区。
会话(session)
会话是一次开发任务的完整记录:你的输入、Agent 的输出、工具调用、审批和错误,按时间顺序保存为时间线。会话归属于它创建时所在的工作区。 侧栏的 新建会话 创建新会话。会话可以重命名、置顶、分叉、批量删除,也可以从其它 Agent 的历史里导入。 详见Agent 会话。Agent 与供应商配置
这两个概念是分开的:- Agent 是执行任务的程序,例如 Claude Code、Codex、ZCode、OpenCode,或任何兼容 ACP 的可执行文件。Agent 决定”谁来做”。
- 供应商配置(UI 里叫 模型供应商配置)是 Agent 调用模型服务所需的连接信息:地址、凭据、可用模型、思考深度。它决定”用哪个模型、走哪条线路”。
作用域
部分资源可以设定作用范围。可用取值通常是 global、user、project 或 workspace,范围越小越不容易误伤其它项目。MCP 服务器当前只提供 用户 和 工作区 两种。通道(channel)
发布通道决定产品身份和数据目录:预览、RC、Stable。三者可以并存安装,各自使用独立的数据库,互不影响。通道由安装包决定,不能在应用内切换。配对(pairing)
配对是给一台设备授予访问某个权威运行时的权限。两种常见路径:- 桌面 → 手机:桌面端生成二维码,手机扫码并核对校验码。
- 服务器 → 桌面 / 手机:
vibex-server打印一次性配对码和连接串,客户端填入。
read_only、approve_only、full_control。级别在发起端决定,客户端无法自行提权。
详见远程访问与移动端。