跳转到主要内容
Vibex 为桌面端、Android、iOS 和自托管服务端提供现成的发布产物。普通使用者不需要安装 Rust、Node.js 或 pnpm：桌面端安装包是自包含的，TUI 也随桌面安装包一起发布。 所有产物都在同一个页面：

下载最新版本

打开 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）。
Android 客户端没有应用商店，更新也走同一份发布清单：
  • 客户端只跟随 Stable 通道；预发布安装仍会知道它之后对应的稳定版。
  • 应用会校验发布清单签名和 APK 的 SHA-256，然后把已暂存的文件交给系统安装器；Android 再校验签名密钥连续性。
  • 可以在应用内下载并安装，也可以打开浏览器里的签名下载链接。
  • 如果新 APK 的签名密钥与已安装版本不同，系统会拒绝覆盖安装。RC / 预览在未配置仓库密钥时使用一次性 CI 密钥，因此 不同 RC 之间可能需要先卸载再安装；卸载会清除本地配对凭据。
Stable 发布必须配置固定的 Android 发布密钥。没有配置时发布流水线会失败，而不是悄悄生成一个无法覆盖升级的包。

​
iOS

iOS 发布产物包括：
  • vibex-<版本>-ios-unsigned.ipa：完整的 arm64 真机构建，未签名。
  • vibex-<版本>-ios-simulator.app.zip：未签名模拟器构建。
  • vibex-<版本>-ios-xcframework.zip：供集成使用。
iOS 拒绝运行未签名的代码，所以真机 IPA 需要安装者用自己的 Apple ID 重新签名。免费 Apple ID 的签名有效期为 7 天，到期后需要重新签名。 常见安装方式： 从 Unsigned iOS install guide 可以看到完整的重签名步骤和校验方法。
重签名会替换整个签名，不能证明二进制是谁构建的。只安装来自可信来源的 IPA。

​
TUI

Vibex TUI 随桌面安装包一起发布，不需要单独下载： 在项目目录里运行 vibex 即可。详见 Vibex TUI。

​
自托管

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

​
从源码构建

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

​
卸载

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