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

安装

gis-actions（CLI + 执行引擎）

curl -sLO https://git.mercator.cn/api/packages/AgentGIS/generic/gis-actions/3.0.5/gis-actions_3.0.5_all.deb
sudo dpkg -i gis-actions_3.0.5_all.deb

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

包命名规则

套件发布到 Gitea Packages 时，包名由套件名称自动生成 slug：

例："土地整治竣工结算"  →  land-remediation-settlement
    "Hello World"       →  hello-world
    "Buffer Analysis"   →  buffer-analysis

slug 规则：转小写 → 非字母数字替换为连字符 → 合并连续连字符 → 去掉首尾连字符。

基础镜像

所有套件在 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 仓库中。

2.3 KiB Raw Blame History Unescape Escape