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 2012）， 内嵌 Node.js 12 运行时，可在 Server 2012 / Server 2008 R2 / Windows 7 SP1 上运行， 但工具集是标准版的子集。 | 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）**功能后才有完整的图形界面。