安装
在 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