# GIS Actions 本地部署

## 状态：待发布

GIS Actions（本地执行器）的安装包尚未就绪。以下是部署所需的信息。

## 是什么

GIS Actions 是一个后台进程，从调度中心拉取任务，在本地 Docker 中执行套件。

## 运行条件

| 条件 | 说明 |
|------|------|
| Python 3.10+ | 标准库即可，无第三方依赖 |
| Docker | 用于隔离执行套件（验证：`docker ps`）|
| 网络 | 能访问 `suites.mercator.cn` 和 `registry.mercator.cn` |
| 代码 | 4 个 Python 文件 + 配置文件 |

## 配置

```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 从 https://auth.mercator.cn 获取。

## 启动

```bash
python3 worker.py --config worker.json
```

## 数据流向

```
你的本地文件（SHP/GeoJSON/TIFF）
    │
    ▼
GIS Actions（你的机器）
    │  ← 轮询调度中心
    │  ← 下载套件脚本包
    │  ← docker run --rm gis-base + 套件
    │  → 结果写入 /tmp/output/
    │  → 脚本包自动清理
    ▼
结果文件（你的机器）
```

## 架构原则

**数据永不离开本地。** 你的文件始终在你的机器上，不上传到云端。