安裝
在 macOS、Windows 和 Linux 上安裝 QubKey 桌面 - 擴充功能和同步所需。
QubKey 是一個本機桌面應用程序，構成了生態系統的核心。下載適合您的作業系統的安裝程式並按照以下步驟操作。
QubKey 生態系統包括桌面應用程式（必要 - 保險庫、加密、管理）和 瀏覽器擴充功能（可選 - 透過本機訊息傳遞自動填入）。 可選的跨您自己的裝置同步可以補充本地優先模型（雲端資料夾、手動複製 .rkvey 檔案）。必須先安裝桌面應用程式 - 擴充功能取決於它。
安裝順序
程式 QubKey 桌面應用程式
首先安裝本機應用程式：它管理.rkvey保險庫、所有加密技術（Argon2id、AEAD）和秘密管理。沒有它，增強就無法相容。
瀏覽器擴充功能 （可選）
安裝桌面應用程式並建立託管庫後，從 瀏覽器增強功能 下載 Chrome 或 Firefox 增強功能（與您的作業系統一致的 macOS 或 Windows 軟體包），設定 Native Messaging，然後連接該增強功能。
可選同步*（可選）*
內建多裝置同步（QubKey 雲端或自架伺服器，在「設定」中啟用）或手動複製/同步加密的 .rkvey 檔案（雲端資料夾、USB隨身碟）。
系統需求
Operating system
macOS (Apple Silicon) 和 Windows 10/11 (NSIS/MSI) 可供下載。 Linux 正在積極開發中 — 請參閱發行說明和網站下載頁面。
RAM
最低 4 GB — 建議 8 GB。 Argon2id 每次解鎖使用 64 MB； RAM 不足可能會減慢金庫的開啟速度。
Disk space
200 MB 用於應用程式
WebView
WebView2 (Windows) 或 WebKit — 透過 Tauri 捆綁在 macOS/Linux 上
＃＃ 下載
macOS
Apple Silicon (arm64) .dmg — Mac App Store 以外。驗證下載頁面上的 SHA-256 雜湊值。
視窗
適用於 Windows 10/11（x64 或 x86）的 NSIS/MSI 安裝程式 — 請參閱可用軟體套件的專用頁面。
Linux
正在積極開發中——尚未發布 Linux 下載。
平台安裝
從 macOS 頁面 下載 Apple Silicon (arm64) .dmg
驗證發佈的SHA-256指紋，開啟.dmg，放置QubKey拖曳至/Applications
首次啟動時：以鼠標右鍵點選→如果Gatekeeper警告（Mac App Store以外的應用程式顯示），則開啟
如果 macOS 提示，則取得磁碟和資料夾存取權限
檢查 Windows Pages 是否有可用的 NSIS/MSI 安裝程式（x64 或 x86）
雙擊安裝程式並依照精靈操作（選擇安裝資料夾）
如果出現提示，請接受WebView2安裝（Tauri UI 需要）
從「開始」功能表啟動 QubKey — 如果 Windows 提示則允許檔案存取
Linux
Linux版本正在積極開發中。網站尚未提供AppImage、.deb 或 .rpm 軟體包 - 請關注下載頁面以獲取公告。
完整性驗證
安裝後
故障排除
Missing WebView2 (Windows)
Tauri 需要 WebView2 來顯示 UI。如果安裝程式未提供，請從 microsoft.com/edge/webview2 下載它。
Gatekeeper blocks (macOS)
對於非公證版本：右鍵單擊 → 開啟。或：xattr -cr /Applications/QubKey.app 取消隔離。
Missing dependencies (Linux)
Tauri 需要 webkit2gtk。 Debian/Ubuntu：sudo apt install libwebkit2gtk-4.1-0 libayatana-appindicator3-1