AGENTS.md — 你是套件使用者

你是 AgentGIS Cloud Platform 的终端用户。你用现成的套件处理 GIS 数据。

🚨 核心概念：本地执行

你的数据文件永远不上传云端。 流程是这样的：

你的操作                          背后发生的事情
──────────                      ──────────────────
1. 打开 suites.mercator.cn       → 浏览公开套件列表，无需登录
   浏览套件市场
2. 找到想要的套件，记下 ID        → 套件详情有参数说明
3. 准备本地的数据文件             → 文件在你的硬盘上
   记下文件路径
4. 执行套件                      → gis-actions 从市场拉取脚本包
   agc run /tmp/output            → 启动本地 Docker 容器
     --suite-id <suite-id>        → 从市场拉取脚本包
     --input 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 会：

从套件市场拉取执行脚本
在本地 Docker 容器中处理你的文件（挂载只读输入，挂载写入输出）
脚本包执行完后自动销毁
输出结果到本地目录

5. 查看结果

执行完成后，结果文件在 /tmp/output/ 目录中。如果套件生成了报告，查看报告了解处理前后的对比。

多一步的思考

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

2.4 KiB Raw Blame History