# 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/` 目录中。
如果套件生成了报告，查看报告了解处理前后的对比。

## 多一步的思考

- **执行失败了？** → 看错误信息，检查输入文件路径是否正确、格式是否支持
- **结果不对？** → 检查参数值是否合理
- **套件不好用？** → 换个套件或反馈给开发者