fix: 诚实描述 gis-actions 安装现状(待发布)

This commit is contained in:
2026-07-09 15:15:54 +00:00
parent a0300a2474
commit b48b68dcad
@@ -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 容器中处理,不上传到云端。