docs(release): require dev versions before formal release

This commit is contained in:
2026-09-14 17:38:11 +08:00
parent 0f81c3edc3
commit d1f6c0594c
2 changed files with 5 additions and 1 deletions
+2
View File
@@ -18,6 +18,8 @@
插件仓库根目录的 `release.json` 声明仓库、插件 ID。每个仓库只发布一个插件,tag 为 `v<curio.json version>`。
正式发布前统一使用 `v0.0.0-dev-x`,并将 Release 标记为 **Pre-release**;具体约定见[版本与 Release](versioning.md)。
Release 先以草稿创建,上传每个平台的 `.curio` 和 `trove-release.json` 后再发布。描述文件包含仓库、tag、源码 commit、插件 Manifest 摘要,以及附件名、平台、大小和 SHA-256。插件图标以小型图片 Data URL 收录,私有图片也无需额外鉴权。
本机手动生成发布目录,上传全部附件并发布 Release 后,插件的 Linux workflow 使用 `CATALOG_TOKEN` 调用源仓库的 `sync-release.yml`,传入 `repository` 与 `tag`。收录只接受登记仓库及其所属插件 ID,并下载附件校验大小和 SHA-256。
+3 -1
View File
@@ -1,6 +1,8 @@
# 版本与 Release
每个正式插件独立维护 `curio.json` 的版本,并以 `v<version>` tag 发布对应源码快照。原生项目中的版本必须与 Manifest 一致。
每个插件独立维护 `curio.json` 的版本,并以 `v<version>` tag 发布对应源码快照。`package.json`、原生项目与 Manifest 中的版本必须一致。
正式发布前,所有版本统一使用 `0.0.0-dev-x`,对应 Tag 为 `v0.0.0-dev-x`。`x` 从 1 开始递增,例如 `v0.0.0-dev-1`、`v0.0.0-dev-2`;Gitea Release 必须标记为 **Pre-release**。打包、上传或更新软件源不表示进入正式发布阶段;仅在维护者明确决定正式发布后,才采用正式版本号。
安装包存放在该插件仓库的 Gitea Release 附件中。附件按插件 ID、版本、平台命名,不使用 `latest` 之类可变下载地址。`trove-release.json` 记录本次发布的所有产物;源索引由收录 workflow 生成。