64 lines
1.2 KiB
Markdown
64 lines
1.2 KiB
Markdown
# 套件发布指南
|
|
|
|
## 前置条件
|
|
|
|
- 一个 API Key（从 https://auth.mercator.cn 获取）
|
|
- 套件目录包含 `workflow.yaml` 和 `scripts/`
|
|
|
|
## 一、使用 CLI 发布（推荐）
|
|
|
|
```bash
|
|
# 安装 CLI
|
|
pip install https://git.mercator.cn/SuiteHub/agentgis-cli/raw/branch/main/dist/agentgis_cli-0.1.0-py3-none-any.whl
|
|
|
|
# 配置 API Key
|
|
agc config set api-key mk_xxxxxxxxxxxxx
|
|
|
|
# 发布
|
|
agc publish ./my-suite
|
|
```
|
|
|
|
## 二、手动发布
|
|
|
|
### 1. 打包
|
|
|
|
```bash
|
|
cd my-suite
|
|
tar czf scripts.tar.gz workflow.yaml scripts/
|
|
```
|
|
|
|
### 2. 上传到包存储
|
|
|
|
```bash
|
|
curl -X PUT \
|
|
-H "Authorization: Bearer mk_xxxx" \
|
|
-F "file=@scripts.tar.gz" \
|
|
https://suites.mercator.cn/api/v1/publish/upload
|
|
```
|
|
|
|
### 3. 注册套件
|
|
|
|
```bash
|
|
curl -X POST https://suites.mercator.cn/api/v1/suites \
|
|
-H "Authorization: Bearer mk_xxxx" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{
|
|
"name": "my-suite",
|
|
"description": "我的套件",
|
|
"version": "1.0.0",
|
|
"workflow": { ... },
|
|
"package_url": "https://..."
|
|
}'
|
|
```
|
|
|
|
## 合规检测
|
|
|
|
发布时自动检测：
|
|
|
|
- `workflow.yaml` 格式是否正确
|
|
- 参数声明是否完整
|
|
- 脚本文件是否存在
|
|
- 参数类型是否匹配
|
|
|
|
不通过则发布失败，返回具体错误信息。
|