Windows 対応バージョン
Windows 版 zqagent には CLI 単体ファイル、デスクトップアプリ、npm インストール の 3 形態があります。必要要件はそれぞれ異なり、 下表が完全な対応マトリクスです。
対応マトリクス
| 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 の 2 種類のみです。 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 と通常版を区別できないため、 サイトはこの 2 バージョンにデスクトップ版を勧めません。本表でご自身で判断してください。
Windows 10 は 2025-10-14 にサポート終了
Windows 10（Home / Pro）はこの日以降、Microsoft のセキュリティ更新を受け取れません。22H2 が最後のバージョンです。 技術的な動作には影響しませんが、機密データを扱う場合は Windows 11 へのアップグレードを推奨します。 Enterprise / IoT LTSC はそれぞれの長期サービス期間に従って更新が続きます。
Windows 7 / 8 / 8.1 が使えない理由
これは「インストーラーにランタイムが足りない」問題ではなく、OS の 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 のシステム関数で、どのランタイムでも補えません。
古いマシンの場合
要件を満たす別の PC（またはサーバー）に zqagent をインストールし、古いマシンのブラウザからそのコンソールにアクセスします：
http://<新しいホストの IP>:8787これなら古いマシンはブラウザの役割だけで、zqagent のコンポーネントを動かす必要はありません。
デスクトップアプリの追加要件
| 依存 | 要件 |
|---|---|
| WebView2 ランタイム | Windows 10 1709+ / Windows Server 2016+。Win11 は内蔵 |
| Node ランタイム | デスクトップ版に同梱。別途インストール不要 |
| システムアーキテクチャ | x64 または ARM64 |
Windows Server では「サーバーマネージャー」で デスクトップエクスペリエンス 機能をインストールすると、完全な GUI が使えます。