Skip to content

Setup Guide CN

Jump to bottom
Jazzen Chen edited this page May 24, 2026 · 12 revisions

安装指南

这份指南覆盖打包版安装和本地开发启动。

安装桌面应用

  1. 从 GitHub Releases 下载最新版本。
  2. 打开桌面应用。
  3. 完成首次引导。
  4. 启用你已经在使用的 Agent CLI。
  5. 只有需要模型路由时才添加 Provider Profile。
  6. 在 Launch 里选择 terminal、workspace、session 后启动 Agent。

当前安装包

平台 包
macOS Apple Silicon VibeAround_0.6.5_arm64.dmg
Windows x64 Setup EXE、MSI、免安装 ZIP
Linux x64 AppImage、deb

macOS Intel 当前需要从源码构建。发布的 macOS 包是 Apple Silicon。

Agent CLI 前置条件

先安装你要使用的 Agent CLI。

Agent 常见命令
Claude Code claude
Codex CLI codex
Pi pi
Gemini CLI gemini
OpenCode opencode
Cursor CLI cursor-agent 或 Cursor 本地 CLI 配置
Kiro CLI 本地 Kiro CLI 配置
Qwen Code qwen

当 Agent 支持全局配置时，VibeAround 会帮你注入 MCP endpoint 和 skills。

第一次启动

  1. 打开 Launch。
  2. 在左侧 agent 竖条中选择 Agent。
  3. 选择 Profile。使用 Direct 表示走 Agent 原生登录态。
  4. 选择 Terminal。
  5. 选择 Workspace。
  6. 选择 New session，或者在 Agent 支持时选择已有 Session 来 resume。
  7. 点击 Launch。

添加 Provider Profile

在 Profile 网格里点击 New profile。Profile 可以包含：

  • provider 名称和凭证
  • 支持的 API 类型
  • 模型列表和可选 context-window metadata
  • 用户手填的自定义模型名称
  • 从 Agent API 形态到 Provider API 形态的 bridge route
  • DeepSeek reasoning 等 provider 特殊选项
  • API bridge 流量的 proxy opt-in

详情见 Model Profiles 与 Agent Launch。

Web Dashboard

打包版会在本机提供：

http://127.0.0.1:12358/va/

可以使用 Web Chat、Web Terminal、Previews 和 Session 视图。公网 tunnel 访问需要 pairing。

本地开发

cd src
bun install
bun run prebuild
bun run dev

环境要求：

  • Rust 1.82+
  • Bun 1.3+
  • 推荐 Node.js 24 LTS
  • macOS 需要 Xcode Command Line Tools
  • Linux 需要 WebKitGTK/Tauri 依赖

常用脚本：

bun run desktop-ui:dev
bun run web:dev
bun run server:dev
bun run desktop:build

Clone this wiki locally