fix: 套件发布指南 — 简化,移除无效 UI 和 upload 端点描述

This commit is contained in:
2026-07-13 16:44:11 +00:00
parent a5b1911733
commit dcc1af2771
@@ -5,15 +5,7 @@
- 一个 API Key(从 https://auth.mercator.cn 获取)
- 套件目录包含 `workflow.yaml``scripts/`
## 一、通过 Web UI 发布
登录 https://suites.mercator.cn → 进入套件详情页 → 点击「发布」。
系统会自动打包 `workflow.yaml` + `scripts/` + `templates/``<slug>-<version>.tar.gz` 并上传到 Gitea Packages。
## 二、通过 API 发布
### 1. 直接发布(推荐)
## 通过 API 发布
```bash
curl -X POST https://suites.mercator.cn/api/v1/publish \
@@ -28,46 +20,11 @@ curl -X POST https://suites.mercator.cn/api/v1/publish \
}'
```
### 2. 上传包文件发布
先手动打包:
```bash
cd my-suite
# 打包为 <slug>-<version>.tar.gzslug 为套件名的 ASCII 转换)
tar czf my-suite-1.0.0.tar.gz workflow.yaml scripts/
```
上传:
```bash
curl -X POST https://suites.mercator.cn/api/v1/publish/upload \
-H "Authorization: Bearer mk_xxxx" \
-F "file=@my-suite-1.0.0.tar.gz" \
-F "name=my-suite" \
-F "version=1.0.0"
```
## 三、发布流程说明
## 发布流程
```
1. 提交 workflow.yaml + scripts/ 内容
2. 系统自动校验
- workflow.yaml 格式是否正确
- 参数声明是否完整
- 脚本文件是否存在
- 参数类型是否匹配
3. 校验通过 → 打包为 <slug>-<version>.tar.gz → 上传到 Gitea Packages
4. 在数据库中注册套件记录,package_url 指向包地址
2. 系统自动校验格式
3. 校验通过 → 打包上传到 Gitea Packages
4. 在数据库中注册套件记录
```
## 合规检测
发布时自动检测:
- `workflow.yaml` 格式是否正确
- 参数声明是否完整
- 脚本文件是否存在
- 参数类型是否匹配
不通过则发布失败,返回具体错误信息。