瀏覽器
擴充功能
下載並安裝適用於 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 後需重新載入。