docs: add Windows install and dual-platform execution model

This commit is contained in:
2026-07-20 08:50:55 +00:00
parent cde9821b40
commit a3c5196996
+20 -1
View File
@@ -13,6 +13,8 @@
## 安装
### Linux
```bash
curl -sLO https://packages.mercator.cn/public/gis-actions/latest.deb
sudo dpkg -i gis-actions_latest.deb
@@ -20,6 +22,15 @@ sudo dpkg -i gis-actions_latest.deb
要求:Docker Engine 已安装。
### Windows
1. 下载 [latest-windows.zip](https://packages.mercator.cn/public/gis-actions/latest-windows.zip)
2. 解压到 `%LOCALAPPDATA%\\AgentGIS\\gis-actions\\`
3. 将路径加入 `PATH`
4. 验证:`agc --help`
要求:ArcMap 10.8arcpy 脚本需要)
## 配置 API Key
所有操作前需先配置 API Key(在套件市场个人中心生成):
@@ -54,13 +65,21 @@ agc run /tmp/output --suite-id <suite-id> --input key=value --watch # 实时
### gis-actions 工作原理
GIS Actions 在本地执行:
**Linux 版(Docker 容器执行):**
1. 从套件市场获取脚本包地址
2. 下载加密脚本包到本地(首次下载后自动缓存)
3. 启动 Docker 容器(gis-base 镜像,内置解密密钥 + decrypt_runner
4. 容器内将加密脚本解密到 /dev/shm(内存)后执行
5. 结果写入工作目录,脚本包和临时数据自动清理
**Windows 版(本机 subprocess 执行):**
1. 从套件市场获取脚本包地址
2. 下载并解密到临时目录
3. 根据步骤的 runtime 选择执行器:
- python3 -> agc 内置 Python
- arcpy -> 调用系统 arcpyArcMap Python 2.7
4. 结果写入工作目录,临时文件自动清理
## 排查问题
```bash