agent-profiles/suite-developer/TOOLS.md

TOOLS.md — 套件开发工具与资源

安装

agentgis-cli（命令行工具）

pip install https://git.mercator.cn/api/packages/SuiteHub/generic/agentgis-cli/0.1.0/agentgis_cli-0.1.0-py3-none-any.whl

# 查看版本
agc --version

# 配置 API Key
agc config set api-key mk_xxxxxxxxxxx

agentgis-sdk（Python 开发包）

pip install https://git.mercator.cn/api/packages/SuiteHub/generic/agentgis-sdk/0.1.0/agentgis_sdk-0.1.0-py3-none-any.whl

gis-actions（本地执行器，可选）

开发者如需本地测试套件执行：

# 安装 gis-actions 软件包
# Debian/Ubuntu:
wget -O agentgis-worker.deb https://git.mercator.cn/api/packages/SuiteHub/generic/gis-actions/v2.0.0-alpha/agentgis-worker_2.0.0-alpha_all.deb
sudo dpkg -i agentgis-worker.deb
# 配置后启动
sudo systemctl start agentgis-worker

---

CLI 用法

# 🔍 查市场（写代码前先做这个）
agc suites search <关键词>     # 搜索已有套件
agc suites list               # 列出所有套件

# 初始化新套件
agc init ./my-analysis

# 测试执行
agc run <suite-id> --inputs '{"expression": "1+1"}'

# 发布到市场
agc publish ./my-analysis

API 端点

用途	端点
发布 Suite	POST https://suites.mercator.cn/api/v1/suites
执行任务	POST https://suites.mercator.cn/api/v1/task
数据类型列表	GET https://suites.mercator.cn/api/v1/data-types
业务类型列表	GET https://suites.mercator.cn/api/v1/business-types
API 文档	https://suites.mercator.cn/docs

套件结构

my-suite/
├── workflow.yaml      # 步骤定义（必填）
└── scripts/
    └── run.py         # 执行入口脚本

基础镜像

所有套件在 gis-base 镜像中执行，包含：Python 3, GDAL, Shapely, GeoPandas, numpy

知识库

文件	内容
knowledge/script-data-types.md	脚本数据类型分类规范
knowledge/script-dependencies.md	脚本依赖管理规范
knowledge/data-execution-model.md	数据执行模型（本地执行设计）

文档

公开文档在 SuiteHub/agent-profiles 仓库中。