歡迎使用 UKey 硬體錢包。為確保您的數位資產管理環境符合安全要求，並確保 UKey 硬體設備與終端之間通訊穩定，請在部署用戶端前確認以下官方環境相容性要求。
1. 桌面版運作環境
UKey Wallet 桌面版客戶端原生支援多個平台。請確認您的作業系統符合以下最低版本要求：
作業系統 | 最低系統需求 | 推薦系統需求 | 架構說明 |
macOS | 10.15 Catalina | 13 Ventura 以上 | 原生相容於 Intel 和 Apple Silicon (M1/M2/M3) 晶片 |
Windows | Windows 10（版本 1809） | Windows 11 | 建議使用標準 x86/x64 架構處理器 |
Linux | Ubuntu 18.04 / Debian 10 / Fedora 32 / RHEL 8 | Ubuntu 22.04 LTS 以上 | 相容主流發行版 |
2. 行動裝置運作環境
作業系統 | 最低系統需求 | 推薦系統需求 |
iOS / iPadOS | iOS 15.5 | iOS 17 以上 |
Android | Android 7.0 | Android 13 以上 |
UKey 官方安全政策聲明：
為防止底層系統權限被濫用並導致關鍵資料（例如私鑰快取）洩露，UKey Wallet 會進行嚴格的運行環境偵測。本應用程式禁止在已越獄的 iOS 裝置或已 root 的 Android 裝置上執行。嘗試強制運行可能會觸發安全鎖定機制，或導致應用程式異常終止。
3. 瀏覽器擴充與 WebUSB 硬體通訊支援
透過網頁或瀏覽器擴充與 DApp 互動時，UKey 硬體需要依賴瀏覽器的 WebUSB API 建立安全的 HTTPS 直連資料通道。由於各大瀏覽器廠商對底層 API 的支援策略不同，請參考下列相容性矩陣：
3.1 官方推薦並支援的瀏覽器（Chromium 核心）
Google Chrome：完全支援（版本 61 以上）
Microsoft Edge：完全支援（版本 79 以上）
官方建議：請務必將瀏覽器更新至最新版本，以獲得最新安全性修補程式。
3.2 不支援的瀏覽器（無法呼叫硬體 API）
由於核心限制，以下瀏覽器無法辨識並連接 UKey 硬體裝置。請避免使用它們進行硬體互動：
Firefox
Safari
Opera
Samsung Internet
QQ Browser
Internet Explorer (IE)
UC Browser（⚠️ 已知風險：在 UC Browser 環境中呼叫硬體介面可能導致瀏覽器進程異常崩潰。 ）
3.3 行動裝置 Web 互動限制
Android 環境：在 Android 上使用 Chromium 核心瀏覽器（例如行動裝置 Chrome/Edge）可以正常進行 WebUSB 硬體通訊。
iOS 環境（受限）：受 Apple 官方底層安全策略限制，iOS 平台上的所有 Web 瀏覽器（包括 Chrome 和 iOS 版 Edge）均不支援 WebUSB 介面。需要管理資產和簽署交易的 iOS 使用者必須直接使用官方 UKey App。請勿嘗試透過 iOS 行動裝置瀏覽器連接硬體。
4. 實體介面與設備通訊規範
為確保硬體設備能夠穩定、安全地向客戶端傳輸加密簽章指令，請確認以下實體連線條件：
有線連接：請使用裝置隨附的原廠 USB-A 或 USB-C 線，並直接連接到電腦主機板連接埠。不建議使用第三方低品質 USB 集線器或擴充塢，以避免因電源電壓不穩定或訊號衰減造成資料丟包。
行動裝置通訊：
直接有線連接：Android 手機必須在系統設定中啟用 OTG 資料傳輸功能。
無線連線：請確認行動裝置已啟用藍牙，並已向 UKey App 授予必要的藍牙通訊權限。
5. 系統資源預留
為確保客戶端順利部署、本地加密資料安全存儲，以及未來 UKey 硬體的 OTA 韌體更新順利進行，建議終端設備至少預留 500 MB 可用磁碟空間。