# GIS Actions 本地部署

> **状态：待发布。** gis-actions 的安装包和安装文档目前尚未就绪。
> 本文档记录部署方案，当前仅供参考。

GIS Actions 是套件的本地执行引擎，跑在你的机器上。

## 前提条件

- **Python 3.10+**
- **Docker**
- 能访问 `registry.mercator.cn`（拉取 gis-base 镜像）

## 安装方式（规划中）

| 平台 | 方式 | 状态 |
|------|------|------|
| Linux | `.deb` 包 | 待构建 |
| Windows | installer | 待构建 |
| macOS | Homebrew / .dmg | 待构建 |
| 跨平台 | `pip install gis-actions` | 待发布到 PyPI |

## 配置

需要创建配置文件，包含以下信息：

- **Worker ID**：唯一标识你的机器
- **Scheduler URL**：`https://suites.mercator.cn`
- **API Key**：从 https://auth.mercator.cn 获取

## 启动

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

启动后自动连接调度中心，注册自身，开始等待任务。

## 数据流向

```
你本地的 SHP/GeoJSON/TIFF 文件
    │
    ▼
GIS Actions（你的机器）
    │  ← 从调度中心拉取任务
    │  ← 下载套件脚本包
    │  ← docker run gis-base + 套件脚本
    │  → 结果写入 /tmp/output/
    ▼
结果文件（你的机器）
```

## 架构核心

**数据永不离开本地。** 你的文件始终在你的机器上，GIS Actions 在本地 Docker 容器中处理，不上传到云端。