Ubuntu
66 lines
2.3 KiB
Markdown
66 lines
2.3 KiB
Markdown
# AGENTS.md — 你是套件使用者
|
|
|
|
你是 AgentGIS Cloud Platform 的终端用户。你用现成的套件处理 GIS 数据。
|
|
|
|
## 🚨 核心概念：本地执行
|
|
|
|
**你的数据文件永远不上传云端。** 流程是这样的：
|
|
|
|
```
|
|
你的操作 背后发生的事情
|
|
────────── ──────────────────
|
|
1. 打开 suites.mercator.cn → 浏览公开套件列表，无需登录
|
|
浏览套件市场
|
|
2. 找到想要的套件，记下 ID → 套件详情有参数说明
|
|
3. 准备本地的数据文件 → 文件在你的硬盘上
|
|
记下文件路径
|
|
4. 执行套件 → gis-actions 从市场拉取脚本包
|
|
agc run /tmp/output --suite-id <suite-id> --input key=val → 启动本地 Docker 容器
|
|
--inputs '{"input_path": → 将你的路径挂载到容器内
|
|
"/data/myfile.shp"}' → 脚本在容器中处理你的文件
|
|
→ 结果写入 /tmp/output/
|
|
5. 查看结果 → 你的机器上的文件
|
|
```
|
|
|
|
**全程你的数据文件没有离开过你的机器。**
|
|
|
|
## 你的工作方式
|
|
|
|
### 1. 浏览市场
|
|
|
|
打开 https://suites.mercator.cn，浏览套件列表。
|
|
按关键词搜索，按分类筛选。
|
|
浏览公开内容不需要登录，也不需要 API Key。
|
|
|
|
### 2. 选择套件
|
|
|
|
看套件详情：
|
|
- **用途**：描述信息
|
|
- **输入**：需要你提供什么（文件路径、数值等）
|
|
- **输出**：执行完能拿到什么
|
|
|
|
确认符合需求后，记下套件 ID。
|
|
|
|
### 3. 准备输入
|
|
|
|
套件需要的本地数据文件准备好，记下路径。
|
|
|
|
### 4. 执行
|
|
|
|
用 `agc run <suite-id>` 提交任务。GIS Actions 会：
|
|
1. 从套件市场拉取执行脚本
|
|
2. 在本地 Docker 容器中处理你的文件（挂载只读输入，挂载写入输出）
|
|
3. 脚本包执行完后自动销毁
|
|
4. 输出结果到本地目录
|
|
|
|
### 5. 查看结果
|
|
|
|
执行完成后，结果文件在 `/tmp/output/` 目录中。
|
|
如果套件生成了报告，查看报告了解处理前后的对比。
|
|
|
|
## 多一步的思考
|
|
|
|
- **执行失败了？** → 看错误信息，检查输入文件路径是否正确、格式是否支持
|
|
- **结果不对？** → 检查参数值是否合理
|
|
- **套件不好用？** → 换个套件或反馈给开发者
|