在 Windows 上安裝

支援 x64 與 arm64。

需求

項目	需求
版本	Windows 10 1809 以上、Windows 11
架構	x64 或 arm64
記憶體	最低 4GB

安裝

從 Releases 下載對應架構的安裝檔並執行。

開機自動啟動

工作排程器（建議）：

1. 開啟工作排程器 → 建立工作
2. 觸發程序：登入時
3. 動作：啟動程式 → HUAN Device 的執行檔路徑
4. 設定 → 勾選「如果工作失敗，每隔一分鐘重新啟動」

啟動資料夾（較簡單）：

按 Win + R，輸入 shell:startup，把 HUAN Device 的捷徑放進去。

關閉螢幕休眠

powercfg /change monitor-timeout-ac 0
powercfg /change standby-timeout-ac 0

Kiosk 模式

Windows 的指派存取（Assigned Access）可以把裝置鎖在單一應用程式上：

設定 → 帳戶 → 其他使用者 → 設定 Kiosk

溫度

Windows 上無法透過一般 API 取得 CPU 溫度，裝置回報 null，後台顯示「—」。

這是刻意的：不會為了讓所有平台的欄位都有值而編一個數字出來。

憑證儲存

裝置憑證使用 Electron 的 safeStorage，在 Windows 上由 DPAPI 加密，綁定到目前的使用者帳戶。

ARM64

Windows on ARM 的支援取決於 Electron 對該版本的支援狀況。打包 workflow 會嘗試建置 arm64 版本；建置失敗時 x64 版本可以透過模擬執行，但效能較差。

疑難排解

播放器啟動後閃退：檢查顯示卡驅動程式。舊的驅動程式可能讓 Chromium 的 GPU 行程崩潰。

影片播放卡頓：確認硬體加速已啟用，並更新顯示卡驅動程式。

連不上 Server：檢查 Windows 防火牆有沒有擋下對外連線，以及公司網路的 Proxy 設定。