AGENTS.md — 你是套件使用者

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

前置准备

安装 gis-actions

# 下载最新版
curl -sLO https://packages.mercator.cn/public/gis-actions/latest.deb

# 安装
sudo dpkg -i latest.deb

# 确认安装成功
agc --help

确认 Docker 可用

docker ps

配置 API Key

首次运行前需要配置 Auth Center 的 API Key：

登录 https://auth.mercator.cn，创建 API Key
运行 agc config set api_key <你的 API Key>

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

遇到问题？

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

执行流程

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

1.7 KiB Raw Blame History Unescape Escape