From b6d18f92bee715d1db8050d9e14ad0cc1249c4e0 Mon Sep 17 00:00:00 2001
From: Huawei <huawei@mercator.cn>
Date: Thu, 9 Jul 2026 08:02:33 +0000
Subject: [PATCH] =?UTF-8?q?feat:=20=E8=A1=A5=E5=85=85=20GIS=20Actions=20?=
 =?UTF-8?q?=E9=83=A8=E7=BD=B2=E6=AD=A5=E9=AA=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 suite-user/TOOLS.md | 67 +++++++++++++++++++++++++++++++++++++++------
 1 file changed, 58 insertions(+), 9 deletions(-)

diff --git a/suite-user/TOOLS.md b/suite-user/TOOLS.md
index 75b8cfc..f047977 100644
--- a/suite-user/TOOLS.md
+++ b/suite-user/TOOLS.md
@@ -28,14 +28,48 @@ agc suites list
 agc status <task-id>
 ```
 
-## gis-actions（本地执行器）
+## gis-actions（本地执行器部署）
 
-gis-actions 运行在你的机器上，是套件的本地执行引擎。
+gis-actions 是套件的本地执行引擎，跑在你的机器上。
 
-### 安装前提
+### 前提条件
 
-- Python 3
-- Docker
+- **Python 3.10+**（验证：`python3 --version`）
+- **Docker**（验证：`docker ps`）
+  - Linux：`apt install docker.io` 或 `yum install docker`
+  - Windows/Mac：安装 Docker Desktop
+- 能访问 `registry.mercator.cn`（拉取 gis-base 镜像）
+
+### 安装
+
+```bash
+# 下载 gis-actions 包
+# 或从源码安装
+pip install gis-actions
+```
+
+### 配置
+
+创建 `config.json`：
+
+```json
+{
+  "worker": {
+    "id": "my-machine-001",
+    "capabilities": ["gis-operations"]
+  },
+  "scheduler": {
+    "url": "https://suites.mercator.cn",
+    "poll_interval": 5,
+    "heartbeat_interval": 30
+  },
+  "auth": {
+    "api_key": "你的 API Key"
+  }
+}
+```
+
+API Key 从 https://auth.mercator.cn 获取。
 
 ### 启动
 
@@ -43,7 +77,20 @@ gis-actions 运行在你的机器上，是套件的本地执行引擎。
 python3 -m gis_actions --config config.json
 ```
 
-启动后自动连接调度中心，等待执行任务。
+启动后自动连接调度中心，注册自身，开始等待任务。
+保持终端开着，或使用进程管理工具（systemd / supervisor）后台运行。
+
+### 验证是否运行成功
+
+```bash
+# 查看日志输出，应看到：
+# Worker xxx started, polling https://suites.mercator.cn every 5s
+# Worker registered successfully
+```
+
+### 停止
+
+Ctrl+C 停止。脚本包自动清理，不留痕迹。
 
 ### 数据流向
 
@@ -52,10 +99,12 @@ python3 -m gis_actions --config config.json
     │
     ▼
 gis-actions（你的机器）
-    │  docker run gis-base
-    │  套件脚本处理文件
+    │  ← 从调度中心拉取任务
+    │  ← 下载套件脚本包
+    │  ← docker run gis-base + 套件脚本
+    │  → 结果写入 /tmp/output/
     ▼
-结果文件（你的机器 /tmp/output/）
+结果文件（你的机器）
 ```
 
 ## 支持的输入类型