安装

当前预览版中，GitHub Release 是主要二进制来源。npm 与 Homebrew 是便利渠道，源码构建用于开发或源码审查。

GitHub Release 二进制

从当前预览 release 下载 macOS Apple Silicon 或 Intel 产物，然后确认二进制可以运行。

open https://github.com/OpenKeyring/oak-keyring/releases/tag/v0.8.0-preview.1 ok --version

预览版二进制未签名，也未 notarized。macOS Gatekeeper 首次运行时可能需要你显式批准。

npm wrapper

npm package 是围绕 bundled Oak Keyring binary 的便利包装器。

npm install -g @openkeyring/ok ok --version

Homebrew

通过 Homebrew tap 安装。Homebrew 6.0.0 及以上版本要求在加载非官方 tap 的 formula 前先显式信任；macOS 与 Linux 均适用。

brew tap openkeyring/oak-keyring brew trust --formula openkeyring/oak-keyring/ok brew install ok

如果跳过 brew trust，安装会报错 "Refusing to load formula ... from untrusted tap"。也可以用 brew install openkeyring/oak-keyring/ok 一步到位，只信任 ok formula。

Source build

当你需要检查或修改项目时，从源码构建。如果源码构建需要 Google Drive 同步，请在构建前显式配置 OAuth2 值。

git clone https://github.com/OpenKeyring/oak-keyring.git cd oak-keyring cp .env.example .env # 设置 OAK_GOOGLE_CLIENT_ID 和 OAK_GOOGLE_CLIENT_SECRET。 cargo build --release ./target/release/ok --version