跳轉到主要內容
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）。

​
從原始碼構建

需要改程式碼、或你的平台沒有現成產物時，見從原始碼構建。

​
解除安裝

解除安裝程式不會刪除資料目錄。要徹底清除，請先閱讀隱私與恢復，再手動刪除對應通道的資料目錄。