fix: 快速入门 — 版本号+URL+去 API Key 要求

This commit is contained in:
2026-07-13 16:42:45 +00:00
parent deb44715c6
commit 633466fb1b
+11 -45
View File
@@ -3,63 +3,29 @@
## 第一步:安装 gis-actions
```bash
curl -sLO https://git.mercator.cn/api/packages/SuiteHub/generic/gis-actions/3.0.2/gis-actions_3.0.2_all.deb
sudo dpkg -i gis-actions_3.0.2_all.deb
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
```
前提条件:Linux 系统 + Docker。
前提条件:Linux 系统 + Docker。首次执行时会自动下载 gis-base 镜像。
## 第二步:获取 API Key
访问 https://auth.mercator.cn,创建 API Key`mk_` 开头)。
## 第二步:浏览套件
```bash
export AGENTGIS_API_KEY=mk_xxxxxxxxxxxxx
```
## 第三步:浏览套件
```bash
# 列出所有套件
curl -s https://suites.mercator.cn/api/v1/suites | python3 -m json.tool
# 搜索套件
curl -s "https://suites.mercator.cn/api/v1/suites/search?q=缓冲区"
```
## 第四步:查看参数
记下你要用的套件 ID。
## 第三步:执行套件
```bash
curl -s https://suites.mercator.cn/api/v1/suites/<suite-id> | jq '.params_schema'
```
返回示例:
```json
{
"type": "object",
"required": ["buffer_distance"],
"properties": {
"buffer_distance": {
"type": "number",
"default": 0.5,
"description": "缓冲区距离(度)"
}
}
}
```
## 第五步:执行套件
```bash
agc run /tmp/output --suite-id <suite-id> --input buffer_distance=0.5
SUITE_MARKET_URL="https://suites.mercator.cn" \
agc run /tmp/output --suite-id <suite-id> --input key=value
```
执行在本地 Docker 容器中完成,数据不上传云端。
## 第步:查看结果
## 第步:查看结果
执行完成后,结果文件写入 `/tmp/output/` 目录
## 数据安全
**数据永不离开本地。** 你的文件始终在你的机器上处理。
执行完成后,结果文件在工作目录(如 `/tmp/output/_step_outputs/`)中