# TOOLS.md — 套件使用工具

## 市场前端

https://suites.mercator.cn

浏览套件、查看详情、提交执行任务。

## CLI（可选）

```bash
# 安装 agentgis-cli
pip install https://git.mercator.cn/api/packages/SuiteHub/generic/agentgis-cli/0.1.0/agentgis_cli-0.1.0-py3-none-any.whl

# 配置 API Key
agc config set api-key mk_xxxxxxxxx

# 执行套件（在市场找到 suite-id 后）
agc run <suite-id> --inputs '{"input_path": "/data/myfile.shp"}'

# 查看套件列表
agc suites list

# 查看执行状态
agc status <task-id>
```

## gis-actions（本地执行器部署）

gis-actions 是套件的本地执行引擎，跑在你的机器上。

### 前提条件

- **Debian / Ubuntu 系统**
- **Docker**（验证：`docker ps`）
  - `sudo apt install docker.io`
- 能访问 `registry.mercator.cn`（拉取 gis-base 镜像）

### 安装

```bash
# 下载并安装 gis-actions
wget -O agentgis-worker.deb https://git.mercator.cn/api/packages/SuiteHub/generic/gis-actions/v2.0.0-alpha/agentgis-worker_2.0.0-alpha_all.deb
sudo dpkg -i agentgis-worker.deb

# 安装后会自动配置 systemd 服务和 Docker insecure-registry
```

### 配置

编辑 `/etc/agentgis/worker.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 获取。

### 启动

```bash
sudo systemctl start agentgis-worker
sudo systemctl status agentgis-worker
```

### 验证

```bash
journalctl -u agentgis-worker -f
# 应看到：Worker xxx started, polling https://suites.mercator.cn every 5s
```

### 停止

```bash
sudo systemctl stop agentgis-worker
```

### 卸载

```bash
sudo dpkg --purge agentgis-worker
```

### 数据流向

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

## 支持的输入类型

| 类型 | 说明 | 示例 |
|------|------|------|
| `file` | 本地文件路径 | `/data/land_use.shp` |
| `string` | 文本 | `"缓冲区距离: 500"` |
| `number` | 数值 | `500.0` |
| `integer` | 整数 | `100` |
| `boolean` | 布尔值 | `true` |