agent-profiles/suite-user/AGENTS.md

AGENTS.md — 你是套件使用者

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

前置准备

安装 gis-actions

# 下载最新版
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 可用

docker ps

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

执行流程

1. 查市场，选套件

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

记下你要用的套件 ID。

2. 在本地执行

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/
    ▼
结果文件留在你的机器