docs: add Windows execution model

2026-07-20 08:50:59 +00:00
parent 4e779bf7f1
commit e7b961e535
1 changed files with 43 additions and 1 deletions
@@ -5,7 +5,9 @@

 ---

-## 执行架构
+## 双平台执行架构
+
+### Linux（Docker 容器）

 ```
 用户本地机器
@@ -88,3 +90,43 @@
 - 样例数据需要小而典型，建议 < 5MB
 - workflow.yaml 的参数默认值指向 demo-data/ 中的文件路径
 - 无 demo-data/ 的套件不会出现在 Playground 中，只能本地执行
+
+
+---
+
+### Windows（本机 subprocess）
+
+```
+用户 Windows 机器
+-------------------------------------------------------+
+|                                                        |
+|  agc.exe（Windows 版）                                  |
+|  +-------------------------------------------+         |
+|  |                                            |         |
+|  |  读取 workflow.yaml                        |         |
+|  |  - runtime: docker -> 报错不兼容           |         |
+|  |  - runtime: python3 -> subprocess(agc)     |         |
+|  |  - runtime: arcpy   -> subprocess(arcpy)   |         |
+|  |                                            |         |
+|  |  解密到 tmp -> 执行 -> 清理                |         |
+|  +-------------------------------------------+         |
+|                                                        |
+|  用户数据文件 -> 步骤处理 -> 结果文件                   |
+|                                              |         |
+|                                          拿走使用       |
+-------------------------------------------------------+
+
+            | 从市场拉脚本包
+            |
+   suites.mercator.cn（套件市场）
+```
+
+### 平台选择
+
+| 场景 | 推荐平台 | 执行器 |
+|------|----------|--------|
+| GIS 数据处理 | Linux | Docker + gis-base |
+| ArcGIS 符号转换 | Windows | subprocess + arcpy |
+| 纯 Python 工作流 | 通用 | subprocess + python3 |
+| 需要容器隔离 | Linux | Docker |
+| 需要 ArcMap 许可 | Windows | arcpy |