安装与首次启动

系统要求

• 操作系统：macOS（Apple Silicon 优先支持）
• 硬件：建议 8 GB 以上内存
• 网络：需要能访问所选模型供应商的 API（模型请求从你的 Mac 直接发出）
• 账号：无需注册 VibeSpace 账号，使用自有模型 API Key 即可

下载与安装

1. 从官网下载 VibeSpace_0.14.0_aarch64.dmg 安装镜像。
2. 打开 DMG，将 VibeSpace.app 拖入「应用程序」文件夹。
3. 首次打开时，如果 macOS 提示无法验证开发者（当前版本处于内测阶段、尚未公证），请右键点击应用 → 打开，再在弹窗中选择「打开」。

提示：VibeSpace 当前处于邀请制内测阶段，安装包未经过 Apple 公证。正式发布版本将包含签名与公证。

首次启动

第 1 步：配置模型供应商

进入 设置 → LLM 供应商：

1. 从列表中选择一家供应商（DeepSeek、GLM、Kimi、MiniMax、通义千问、豆包、OpenAI、Claude、Gemini、OpenRouter，或任意 OpenAI 兼容端点）；
2. 粘贴该供应商的 API Key；
3. 点击「测试连接」确认可用，然后拉取模型列表并选择默认模型。

API Key 会以加密形式保存在本机，不会进入日志，也不会发送到 VibeSpace 的任何服务器。详见模型供应商（BYOK）。

第 2 步：授权工作区

新建任务时，第一次会要求你选择一个文件夹作为工作区。VibeSpace 的所有文件读写与命令执行都限制在这个文件夹内；通过 macOS 安全书签记住授权，后续任务无需重复选择。

第 3 步：发起第一个任务

在「新建任务」输入框里用自然语言描述目标，点击发送即可。建议从一篇第一个任务教程开始。

从源码构建（开发者）

# 依赖：Node >= 22、pnpm >= 10、Rust toolchain
git clone <仓库地址> && cd VibeSpace
pnpm install
pnpm dev      # 构建模块包与 sidecar，并启动 Tauri 开发模式
pnpm build    # 生成 debug 版 .app

产品由三部分组成：Tauri 桌面应用（React/TS 前端 + Rust 控制面）、独立 Rust Agent Runtime sidecar（vibespace-runtime，通过 stdio 协议与主进程通信）、以及内置模块包（VibeWorking）。

卸载

1. 把「应用程序」中的 VibeSpace.app 移到废纸篓；
2. 如需清除本地数据，删除 ~/.vibespace/ 文件夹（内含任务记录、设置与技能，删除前建议先导出，见数据与隐私）。

常见安装问题

• 「已损坏，无法打开」或「无法验证开发者」：内测版本未公证所致。在「系统设置 → 隐私与安全性」中允许打开，或右键应用选择「打开」。
• 测试连接失败：检查 API Key 是否有效、网络是否可直达供应商端点；如需代理，见设置中的网络代理。