74 lines
1.6 KiB
Markdown
74 lines
1.6 KiB
Markdown
# 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/
|
|
▼
|
|
结果文件留在你的机器
|
|
```
|