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

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

## 执行流程

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

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

### 2. 在本地执行套件

所有处理跑在你自己的机器上，数据不上云。

```bash
SUITE_MARKET_URL="https://suites.mercator.cn" \
agc run /tmp/my-output \
  --suite-id <suite-id> \
  --input input_path=/path/to/data.shp
```

- `<suite-id>` 从市场获取
- 文件路径用本地绝对路径
- 参数名请查阅套件文档的 `params` 定义
- shapefile 只需传 `.shp` 路径，配套文件会自动复制

### 3. 取结果

结果文件在工作目录（例如 `/tmp/my-output`）中。

## 前提条件

- **Linux 系统**（Debian / Ubuntu）
- **Docker**（验证：`docker ps`）
- **安装 gis-actions**：
  ```bash
  curl -sLO https://git.mercator.cn/api/packages/SuiteHub/generic/gis-actions/3.0.1/gis-actions_3.0.1_all.deb
  sudo dpkg -i gis-actions_3.0.1_all.deb
  ```

## 数据流向

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