From cde9821b4008d8927b3cac638741731a7dc64e8c Mon Sep 17 00:00:00 2001
From: Huawei <huawei@mercator.cn>
Date: Mon, 20 Jul 2026 08:50:54 +0000
Subject: [PATCH] docs: add Windows install and dual-platform usage

---
 suite-user/TOOLS.md | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/suite-user/TOOLS.md b/suite-user/TOOLS.md
index 4fbb5e0..8386bc0 100644
--- a/suite-user/TOOLS.md
+++ b/suite-user/TOOLS.md
@@ -8,6 +8,8 @@ https://suites.mercator.cn
 
 ## 安装
 
+### Linux
+
 安装 `gis-actions` 包即可获得全部功能（CLI + 执行引擎），一次安装：
 
 ```bash
@@ -28,15 +30,26 @@ sudo dpkg -i latest.deb
 - **报 Bug** — 使用 `bug` 标签
 - **提建议** — 使用 `feature` 或 `suggestion` 标签
 
+### Windows
+
+1. 下载 [latest-windows.zip](https://packages.mercator.cn/public/gis-actions/latest-windows.zip)
+2. 解压到 `%LOCALAPPDATA%\\AgentGIS\\gis-actions\\`
+3. 将 `%LOCALAPPDATA%\\AgentGIS\\gis-actions\\` 加入 `PATH`
+4. 验证：`agc --help`
+
+> Windows 版支持 **arcpy**（需要 ArcMap 10.8）和 **python3** 两种 runtime。
+> 不依赖 Docker，直接在本地进程执行。
+
 ## 前提条件
 
 - **Linux 系统**（Debian / Ubuntu）
-- **Docker**（验证：`docker ps`）
+- **Docker**（验证：`docker ps`，仅 Linux 版需要）
 - **API Key** — 登录 https://auth.mercator.cn 获取，后续 `agc config set api_key <你的API Key>` 使用
 
 ### gis-base 基础镜像
 
-所有套件运行在 `gis-base` 镜像中（含 Python 3, GDAL, Shapely, GeoPandas, numpy, openpyxl, xlrd）。
+Linux 版所有套件运行在 `gis-base` 镜像中（含 Python 3, GDAL, Shapely, GeoPandas, numpy, openpyxl, xlrd）。
+Windows 版使用本地 Python 环境（arcpy 或 python3），不需要 Docker。
 
 首次安装 gis-actions 时会自动下载镜像。也可提前手动准备：