Windows 支援版本
Windows 版 zqagent 分三種形態：CLI 單檔案、桌面應用、npm 安裝。三者對系統的要求不同， 下表是完整支援矩陣。
支援矩陣
| Windows 版本 | CLI 單檔案 | 桌面應用 | npm 安裝 |
|---|---|---|---|
| Windows 11 | ✅ | ✅ | ✅ |
| Windows 10 1709 及以上 | ✅ | ✅ | ✅ |
| Windows 10 Enterprise LTSC 2019 / 2021 | ✅ | ✅ | ✅ |
| Windows 10 Enterprise LTSC 2015 / 2016 | ✅ | ✅ | ✅ |
| Windows 10 1507 – 1703（普通版） | ✅ | ❌ | ✅ |
| Windows 8.1 / Server 2012 R2 | ❌ 不保證 | ❌ | ⚠️ 未驗證 |
| Windows 8 / Server 2012 | ❌ | ❌ | ❌ |
| Windows 7 / Server 2008 R2 | ❌ | ❌ | ❌ |
| Windows Server 2016 / 2019 / 2022 | ✅ | ⚠️ 需桌面體驗 | ✅ |
| 32 位（x86）Windows | ❌ 不提供產物 | ❌ | ⚠️ 未驗證 |
只有 64 位（x64）與 ARM64 兩種產物。 32 位 Windows 請改用其它機器。
桌面版在 Windows 10 上的門檻是 1709
決定能否裝桌面版的不是 Windows 版本號本身，而是 WebView2 執行時：它支援 Windows 10 SAC 1709 及更高版本，以及 Enterprise LTSC 2015 / 2016 / 2019 / 2021。 所以 LTSC 2015（1507 基線）與 LTSC 2016（1607 基線）雖然版本號早於 1709，仍可安裝桌面版； 而同樣版本號的普通版（1511 / 1607 / 1703）不行。瀏覽器的 UA 無法區分 LTSC 與普通版， 所以網站對這兩個版本不會主動推薦桌面版，需要你自行按本表判斷。
Windows 10 已於 2025-10-14 結束支援
Windows 10（Home / Pro）自該日期起不再獲得微軟安全更新，22H2 是最後一個版本。 技術執行不受影響，但如果用於處理敏感資料，建議升級到 Windows 11。 Enterprise / IoT LTSC 版本按各自的長期服務週期繼續獲得更新。
為什麼 Windows 7 / 8 / 8.1 不行
這不是「安裝包缺個執行庫」的問題，而是缺少作業系統 API：
- CLI 單檔案內嵌的是 Node.js 22 執行時，它靜態匯入了
GetSystemTimePreciseAsFileTime（Windows 8 起提供）， 執行時還會查詢WaitOnAddress等 Win8 才有的同步原語。 在 Windows 7 上，程式在真正開始執行前就會被系統載入器拒絕： 「無法定位程式輸入點」。 - 內嵌的 ripgrep 依賴
api-ms-win-core-synch-l1-2-0.dll，同樣是 Windows 8 起才有。 - 桌面應用除了 Node 執行時，還要 WebView2 執行時，而 WebView2（跟隨 Microsoft Edge） 自 Edge 109（2023-01）起已停止支援 Windows 7 / 8 / 8.1 與 Server 2008 R2 / 2012 / 2012 R2。
因此安裝 Visual C++ 執行庫（UCRT / VC++ Redistributable）無法解決： Node 官方二進位制把 C 執行庫靜態連結進了執行檔，根本不載入 UCRT； 缺的是 kernel32 裡的系統函式，任何執行庫都補不上。
老機器怎麼辦
把 zqagent 裝到另一臺滿足要求的電腦（或伺服器）上，然後用老機器的瀏覽器訪問它的控制台：
http://<新主機的 IP>:8787這樣老機器只承擔瀏覽器角色，不需要執行任何 zqagent 元件。
桌面應用的額外要求
| 依賴 | 要求 |
|---|---|
| WebView2 執行時 | Windows 10 1709+ / Windows Server 2016+；Win11 已內建 |
| Node 執行時 | 桌面版自帶，無需單獨安裝 |
| 系統架構 | x64 或 ARM64 |
Windows Server 需要在「伺服器管理器」中安裝**桌面體驗（Desktop Experience）**功能後才有完整的圖形介面。