Skip to main content
Vibex 为桌面端、Android 和自托管服务端提供现成的发布产物。普通使用者不需要安装 Rust、Node.js 或 pnpm：桌面端安装包是自包含的。 所有产物都在同一个页面：

下载最新版本

打开 GitHub Releases 的 latest 页面，选择与你平台匹配的产物。
Vibex 仍在候选阶段：除稳定版外，也可能发布形如 -rc.N 或 -preview.N 的预发布版本。latest 页面会解析到当前最新的一个；需要指定版本时改用 全部发布列表。

​
桌面端

Linux 的 .deb 依赖 libvulkan1、libxcb1、libxcb-xkb1、libxkbcommon0、libxkbcommon-x11-0、libdbus-1-3、libfontconfig1，以及一个 appindicator 库（libayatana-appindicator3-1 或 libappindicator3-1）。发行版包管理器通常会自动解决这些依赖。
macOS 与 Windows 的安装包目前没有代码签名。
  • macOS 首次打开会被 Gatekeeper 拦截：在 访达 里按住 Control 点击应用图标，选择打开，再确认一次；或执行 xattr -d com.apple.quarantine /Applications/Vibex*.app。
  • Windows 会弹出 SmartScreen 提示：选择更多信息 → 仍要运行。
这些提示来自缺少签名证书，不代表安装包有问题。每个产物旁边都提供了 .sha256 校验文件，SHA256SUMS 汇总了全部校验值。

​
发布通道

桌面端安装包带有编译期确定的通道标识，通道之间可以并存安装，互不干扰： 每个通道有独立的 SQLite 数据库和配置。切换通道不会迁移数据；如果你在 RC 里配置好了 Agent 和供应商，装 Stable 之后需要重新配置一次。通道由安装包决定，不能在应用内切换。

​
升级

桌面端内置签名自动更新。在 设置 → 关于 → 软件更新 中：
  • 应用启动约 30 秒后自动检查一次，之后 RC / 预览通道每 2 小时、Stable 通道每 6 小时检查一次。
  • 更新清单经过 Ed25519 签名校验，产物再做 SHA-256 校验，校验失败不会安装。
  • 安装方式取决于包格式：AppImage 会原地自我替换；.deb、macOS .app 和 NSIS 会拉起系统安装器，完成后需要重启应用。
只有同通道的版本会被接受：RC 安装包只看 -rc.* 版本。如果自动更新不可用，手动下载新安装包覆盖安装即可。

​
Android

Android 客户端从 GitHub Releases 侧载安装：
  1. 下载 vibex-<版本>-android-arm64.apk。
  2. 在系统设置中允许来自该来源的安装。
  3. 打开 APK 完成安装（应用 ID 为 ai.vibex.mobile）。
候选版本之间不能覆盖升级。未配置发布密钥时，每次 RC 发布使用一次性的 CI 签名密钥，因此不同 RC 的签名不同。跨版本升级需要先卸载旧版，再安装新版；卸载会清除本地保存的配对凭据，需要重新配对。

​
iOS

iOS 目前没有可分发给最终用户的构建。 发布产物只有未签名的模拟器应用包（ios-simulator.app.zip）和 VibexFFI.xcframework，两者都需要 macOS 与 Xcode 才能运行或集成。真机安装、TestFlight 和 App Store 分发尚未提供。
如果你要在模拟器里试用，需要 macOS、Xcode、XcodeGen，以及 aarch64-apple-ios 和 aarch64-apple-ios-sim 两个 Rust target，然后从源码构建：

​
自托管

跨网络使用、或不想把会话数据留在某台常开的个人电脑上时，可以自建服务端：
  • 自托管无头运行时 —— vibex-server 是与你桌面端能力相同的权威运行时，适合放在服务器或家用常开机器上。
  • 自托管 Relay —— 只转发端到端加密帧的中继，不做业务授权，也不保存业务数据。
两者都发布了多架构容器镜像（linux/amd64、linux/arm64）。

​
从源码构建

需要改代码、或你的平台没有现成产物时，见从源码构建。

​
卸载

卸载程序不会删除数据目录。要彻底清除，请先阅读隐私与恢复，再手动删除对应通道的数据目录。