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

## 安装 CLI

```bash
pip install agentgis-cli
```

（当前可从 Git 仓库安装，未来上 PyPI 后一行命令即可）

## 配置

```bash
agc config set api-key mk_xxxxxxxxxxxxx
```

API Key 从 [auth.mercator.cn](https://auth.mercator.cn) 获取。

## 日常命令

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

# 发布套件（自动处理打包→上传→注册）
agc publish ./my-analysis

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

# 查看市场上已有的技能和套件
agc skills list
agc suites list
```

## API 端点（直接调用时）

| 用途 | 端点 |
|------|------|
| 注册 Skill | `POST https://suites.mercator.cn/api/v1/skills` |
| 注册 Suite | `POST https://suites.mercator.cn/api/v1/suites` |
| 提交执行 | `POST https://suites.mercator.cn/api/v1/task` |
| API 文档 | `https://suites.mercator.cn/docs` |

## 套件结构

```
my-suite/
├── workflow.yaml      # 步骤定义（核心）
└── scripts/
    └── run.py         # 执行入口
```

## 基础镜像

所有套件在 `registry.mercator.cn/agentgis/gis-base:latest` 中执行。
包含：Python 3, GDAL, Shapely, GeoPandas, numpy

## 参考示例

- `SuiteHub/hello-world-suite` — 最小模板（查看代码了解 workflow.yaml 写法）
- `SuiteHub/math-add` — 算术相加示例
- `SuiteHub/buffer-analysis` — GIS 缓冲区分析

## 文档

所有文档在 AgentGIS/docs 仓库的 `03-workflow/` 目录：
- `workflow-spec.md` — workflow.yaml 完整规范
- `script-dev-guide.md` — 脚本开发指南
- `skill-dev-guide.md` — 技能开发指南
- `suite-dev-guide.md` — 套件开发指南
- `suite-publishing-guide.md` — 发布指南