浏览器
扩展
下载并安装适用于 macOS 或 Windows 的 Chrome / Firefox QubKey 浏览器扩展。使用前请先在与平台匹配的桌面应用中配置 Native Messaging。
可下载的安装包
选择操作系统
请选择与 QubKey 桌面应用匹配的包。macOS 与 Windows 版本略有不同，不可互换。
版本 1.0.0 — 在上方选择 macOS 或 Windows，然后下载对应平台的 Chrome (.zip) 或 Firefox (.xpi) 包。
Chrome .zip 的 SHA-256（安装前请验证下载）
91e6df76ae5cefd3e925d88bb6f25f1cb761023d9edfd83eed9fe0d306bcdffe
Firefox .xpi 的 SHA-256（安装前请验证下载）
af7606d8543dbb6142ba9c395e3241908ddbc5c1ffcf56ee673416c0c87837afChrome： .zip 只是压缩包：解压到根目录含 manifest.json 的文件夹；在 chrome://extensions 启用开发者模式并选择「加载已解压的扩展程序」。Chrome 不会通过双击 zip 安装。
Firefox： .xpi 用于提交 AMO 或特定本地安装。Firefox 正式版通常需要 Mozilla 签名的构建（addons.mozilla.org）。
前提条件
扩展通过 Native Messaging 与 QubKey 桌面应用通信。请按照桌面项目中的 Native Messaging 文档配置原生宿主（JSON 清单、二进制文件、路径）。
请通过Download & installation guide安装并打开 macOS（Apple Silicon）版 QubKey 桌面应用。测试时请保持 vault 已解锁。
在 macOS 上，将 com.passmanager.native.json 安装到 ~/Library/Application Support/Google/Chrome/NativeMessagingHosts/（Firefox、Edge、Opera 为对应文件夹）。path 指向 QubKey.app 内的 native helper。
手动加载后，将浏览器中显示的扩展 ID 按文档说明复制到 com.passmanager.native.json 宿主清单中。
Google Chrome 与基于 Chromium 的浏览器
在 macOS 上，Chrome、Brave 等 Chromium 浏览器步骤相同。Mac 版 Microsoft Edge 使用 edge://extensions 加载同一解压文件夹。
测试安装（开发者模式）
- 在上方下载 macOS 版 passmanager-chrome-1.0.0.zip，在 Finder 中双击解压到固定文件夹（如 PassManager-Chrome-1.0.0/），根目录需含 manifest.json。
- 打开 chrome://extensions/（Microsoft Edge 为 edge://extensions/）。
- 开启开发者模式（右上角）。
- 点击「加载已解压的扩展程序」并选择解压后的文件夹。
- 记下扩展 ID 以配置 Native Messaging。
- 打开 QubKey、解锁 vault，并确认扩展选项页显示“已连接”状态。
Mozilla Firefox
已签名扩展（推荐）
在 addons.mozilla.org（AMO）发布后，用户可像普通扩展一样一键安装，无需 about:debugging。配置 API 访问后，.xpi 即为提交 AMO 的包（或构建产物）。
本地 .xpi（开发 / 测试）
macOS：about:addons → 齿轮菜单 → 从文件安装附加组件，选择 passmanager-firefox-1.0.0.xpi。仅适用于 Firefox Nightly/Developer Edition 或关闭签名验证时。
临时解压加载（高级测试）
macOS 测试：将 passmanager-firefox-1.0.0.xpi 重命名为 .zip 并解压，然后 about:debugging → 此 Firefox → 临时载入附加组件，选择 manifest.json。每次重启 Firefox 后需重新加载。