修改 meta.json 规则, 涉及version 、group 字段.

2026-06-17 10:03:51 +08:00
parent fc81584878
commit 364efbc1c1
8 changed files with 599 additions and 136 deletions
@@ -25,3 +25,18 @@ rollback myapp
 # 删除模块
 remove myapp
 ```
+
+## 发布规则
+
+项目 `meta.json` 支持 `group` 字段：
+
+- 默认值为 `/modules`。
+- 空字符串等同于 `/`。
+- 可配置为 `/docker`、`/tmpls` 等一级路径，也可配置为 `/docker/net` 等子路径。
+- 远程仓库整体上传路径为 `group/id`，其中 `id` 是项目唯一标识。
+
+项目 `meta.json` 只使用 `version` 字段，不再使用 `versions`：
+
+- `version` 有值时，按该版本上传；上传前检查远程 `group/id/version` 是否存在，已存在则报错。
+- `version` 为空时，先读取远程 `group/id/metadata.json` 中的 `version`，将尾数 +1 后上传。
+- 远程没有版本信息时，初始版本号为 `1.0`。