agent-profiles/suite-developer/TOOLS.md

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

安装

gis-actions（CLI + 执行引擎）

curl -sLO https://git.mercator.cn/api/packages/SuiteHub/generic/gis-actions/3.0.1/gis-actions_3.0.1_all.deb
sudo dpkg -i gis-actions_3.0.1_all.deb

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

---

CLI 用法

# 执行套件
agc run <work_dir> --suite-id <suite-id> --input key=value
agc run <work_dir> --package-url <url> --input key=value

# 查市场（开发前先做这个）
curl -s https://suites.mercator.cn/api/v1/suites | python3 -m json.tool

API 端点

用途	端点
浏览套件	GET https://suites.mercator.cn/api/v1/suites
套件详情	GET https://suites.mercator.cn/api/v1/suites/{id}
API 文档	https://suites.mercator.cn/docs
发布套件	POST https://suites.mercator.cn/api/v1/publish（详见发布指南）

套件结构

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

workflow.yaml 格式

name: 我的套件
description: 套件描述
version: 1.0.0
author: 作者
tags: [标签1, 标签2]

params:
  input_path:
    type: string
    required: true
    desc: 输入文件路径

base_image: gis-base:latest

steps:
  - id: step1
    name: 步骤名称
    script_id: run
    params:
      input: $params.input_path

基础镜像

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

• 镜像名：gis-base:latest
• 来源：安装 gis-actions 时自动从 Gitea Packages 下载加载

知识库

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

文档

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