macOS 安装教程
先确认你的 Mac 是哪种芯片，再照对应步骤装，5 分钟搞定。
第一步 · 先确认你的 Mac 是哪种芯片
点击屏幕左上角苹果标志 → 「关于本机」，看「芯片」一栏，对照下表选版本：
| 芯片显示 | 用哪个版本 |
|---|---|
| Apple M1 / M2 / M3 / M4 | M 芯片版（arm64，含智能悬浮窗） |
| Intel Core i3 / i5 / i7… （或显示「处理器」） | 通用版（pkg 安装包，不含悬浮窗） |
只有 M 芯片版带智能悬浮窗。Intel 与通用机型用 pkg 安装包，其余功能一样完整。
M 芯片版（arm64）安装步骤
最常见下载 OnePass-Mac-arm64.zip（约 150MB），按下面五步走。
下载压缩包
点页面下方的按钮下载，文件会出现在「下载」文件夹。
解压
双击 zip 文件，Mac 会自动解压出 OnePass.app（一个蓝色应用图标）。
解压后看到的应该是一个 OnePass.app。如果只有一个 4-5MB 的单个文件，说明下载不完整或下错文件，删掉重新下载。
拖入「应用程序」
把 OnePass.app 从「下载」文件夹拖到访达左侧栏的「应用程序」里。
打开（关键一步）
直接双击会提示「无法打开 OnePass，因为无法验证开发者」——这是软件未购买苹果开发者证书的正常现象。
正确做法：右键点击 OnePass.app → 点「打开」→ 弹窗里再点「打开」，就正常启动了。
只需第一次这样操作，之后双击即可正常打开。
还是打不开？用这行命令
打开「终端」（启动台 → 其他 → 终端），粘贴执行：
xattr -cr /Applications/OnePass.app
执行后没有任何提示 = 成功。再双击 OnePass.app 就能打开了。
通用版（Intel / pkg 安装包）安装步骤
下载 OnePass-Mac.pkg（约 27MB），适用于 Intel 与通用机型。
下载安装包
点页面下方的按钮下载 pkg 文件。
双击安装
双击 pkg 文件。若提示「无法验证开发者」：右键安装包 → 打开 → 再点「打开」，然后输入 Mac 登录密码，会自动安装到「应用程序」。
首次启动
会弹出「允许 OnePass 查找本地网络设备」：点「允许」或「不允许」都可以，不影响正常使用。
常见问题
双击提示「无法验证开发者」
右键 → 打开 → 弹窗里再点一次「打开」。见 M 芯片版第 4 步。
提示「应用程序已损坏，无法打开」
这是系统对未签名软件的误报。终端执行 xattr -cr /Applications/OnePass.app 即可解决。
打开后白屏 / 没反应
按 Cmd + Q 退出后重新打开；如果还不行，重启一次 Mac 再试。
提示「请升级客户端」
装的是旧版本。删掉后从本页重新下载最新的包即可。
解压后只有一个 4MB 的 onepass 文件
这是下载不完整或来源不对。删掉文件，从本页重新下载。
以后怎么更新版本？
先退出 OnePass（Cmd + Q）→ 重新下载新包 → 拖入「应用程序」覆盖 → 右键「打开」。积分不受影响。