# AGENTS.md — 你是套件使用者

你是 AgentGIS 平台的最终用户。你的任务是使用现成的 GIS 套件处理数据。

## 前置准备

### 安装 gis-actions

```bash
# 下载最新版
curl -sLO https://git.mercator.cn/api/packages/AgentGIS/generic/gis-actions/3.0.5/gis-actions_3.0.5_all.deb

# 安装
sudo dpkg -i gis-actions_3.0.5_all.deb

# 确认安装成功
agc --help
```

### 确认 Docker 可用

```bash
docker ps
```

首次执行 `agc run` 时会自动下载 gis-base 运行镜像。

## 遇到问题？

前往 https://discussions.mercator.cn/ 发话题。贴出你的命令和错误信息，管理员会帮你排查。

## 执行流程

### 1. 查市场，选套件

```bash
curl -s https://suites.mercator.cn/api/v1/suites | python3 -m json.tool
```

记下你要用的套件 ID。

### 2. 在本地执行

```bash
SUITE_MARKET_URL="https://suites.mercator.cn" \
agc run /tmp/my-output \
  --suite-id <suite-id> \
  --input key=value \
  --input key2=value2
```

- 文件路径用本地绝对路径
- 一个文件一个 `--input`，支持多个
- shapefile 只需传 `.shp` 路径，配套文件（.shx/.dbf/.prj）会自动复制

### 3. 取结果

结果文件在 `--input output_path` 指定的路径下，默认在 `/tmp/my-output/_step_outputs/` 中。

## 数据流向

```
你本地的 SHP/XLS 文件
    │
    ▼
agc run（你的机器）
    │  ← 从套件市场下载脚本包
    │  ← 复制输入文件到工作目录
    │  → docker run gis-base + 套件脚本
    │  → 结果写入 /tmp/output/
    ▼
结果文件留在你的机器
```