From b48b68dcad5707f8eee37f3e18965badf6a32309 Mon Sep 17 00:00:00 2001
From: Huawei <huawei@mercator.cn>
Date: Thu, 9 Jul 2026 15:15:54 +0000
Subject: [PATCH] =?UTF-8?q?fix:=20=E8=AF=9A=E5=AE=9E=E6=8F=8F=E8=BF=B0=20g?=
 =?UTF-8?q?is-actions=20=E5=AE=89=E8=A3=85=E7=8E=B0=E7=8A=B6=EF=BC=88?=
 =?UTF-8?q?=E5=BE=85=E5=8F=91=E5=B8=83=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../系统使用手册/GIS-Actions-本地部署.md      | 73 ++++++-------------
 1 file changed, 21 insertions(+), 52 deletions(-)

diff --git a/suites-help/系统使用手册/GIS-Actions-本地部署.md b/suites-help/系统使用手册/GIS-Actions-本地部署.md
index 0350903..c432b03 100644
--- a/suites-help/系统使用手册/GIS-Actions-本地部署.md
+++ b/suites-help/系统使用手册/GIS-Actions-本地部署.md
@@ -1,76 +1,41 @@
 # GIS Actions 本地部署
 
+> **状态：待发布。** gis-actions 的安装包和安装文档目前尚未就绪。
+> 本文档记录部署方案，当前仅供参考。
+
 GIS Actions 是套件的本地执行引擎，跑在你的机器上。
 
 ## 前提条件
 
-- **Python 3.10+**（验证：`python3 --version`）
-- **Docker**（验证：`docker ps`）
-  - Linux：`apt install docker.io` 或 `yum install docker`
-  - Windows/Mac：安装 Docker Desktop
+- **Python 3.10+**
+- **Docker**
 - 能访问 `registry.mercator.cn`（拉取 gis-base 镜像）
 
-## 安装
+## 安装方式（规划中）
 
-目前 gis-actions 以源码形式提供，从 git 仓库获取：
-
-```bash
-git clone https://git.mercator.cn/AgentGIS/gis-actions.git
-cd gis-actions
-```
-
-Linux 用户也可使用 .deb 包（见 `packaging/deb/` 目录）。
+| 平台 | 方式 | 状态 |
+|------|------|------|
+| Linux | `.deb` 包 | 待构建 |
+| Windows | installer | 待构建 |
+| macOS | Homebrew / .dmg | 待构建 |
+| 跨平台 | `pip install gis-actions` | 待发布到 PyPI |
 
 ## 配置
 
-创建 `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": "mk_xxxxxxxxxxxxxxxxxxxx"
-  }
-}
-```
-
-API Key 从 [https://auth.mercator.cn](https://auth.mercator.cn) 获取。
+- **Worker ID**：唯一标识你的机器
+- **Scheduler URL**：`https://suites.mercator.cn`
+- **API Key**：从 https://auth.mercator.cn 获取
 
 ## 启动
 
 ```bash
-python3 -m gis_actions --config config.json
+python3 worker.py --config config.json
 ```
 
 启动后自动连接调度中心，注册自身，开始等待任务。
 
-## 验证
-
-日志中应看到：
-
-```
-Worker xxx started, polling https://suites.mercator.cn every 5s
-Worker registered successfully
-```
-
-## 进程管理
-
-- **Linux**：建议使用 systemd 或 supervisor 托管，开机自启
-- **Windows**：建议注册为 Windows Service
-- **macOS**：建议使用 launchd
-
-## 停止
-
-按 `Ctrl+C` 停止。脚本包自动清理，不留痕迹。
-
 ## 数据流向
 
 ```
@@ -85,3 +50,7 @@ GIS Actions（你的机器）
     ▼
 结果文件（你的机器）
 ```
+
+## 架构核心
+
+**数据永不离开本地。** 你的文件始终在你的机器上，GIS Actions 在本地 Docker 容器中处理，不上传到云端。
\ No newline at end of file