Files
curios/docs/versioning.md
T
render 720e19d142 chore(catalog): reset Curio alpha release line
Clear stale published versions, register the corrected reverse-DNS Curio IDs, add Sing-box Manager, and document the 0.0.1-alpha.x prerelease convention.
2026-09-23 09:44:27 +08:00

16 lines
1.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 版本与 Release
每个插件独立维护 `curio.json` 的版本,并以 `v<version>` tag 发布对应源码快照。`package.json`、原生项目与 Manifest 中的版本必须一致。
本地开发沿用各项目当前的固定版本,不因代码修改、构建或本地安装递增;同版本的本地构建由产物标识区分。只有明确准备新的开发预发布或正式版本时才变更版本。
正式发布前,版本统一使用 `0.0.1-alpha.x`,其中 `x` 是从 1 开始递增的整数;对应 Tag 为 `v0.0.1-alpha.x`,Gitea Release 必须标记为 **Pre-release**。只有准备发布新的开发预览版时才递增 `x`。打包、上传或更新软件源不表示进入正式发布阶段;仅在维护者明确决定正式发布后,才采用正式版本号。
该约定适用于新的开发预发布。已经发布的旧 Tag、Release 和附件保持不可变,不重命名或覆盖,以免破坏已有索引和下载链接。
安装包存放在该插件仓库的 Gitea Release 附件中。附件按插件 ID、版本、平台命名,不使用 `latest` 之类可变下载地址。`trove-release.json` 记录本次发布的所有产物;源索引由收录 workflow 生成。
相同插件 ID、版本、平台的已发布内容不能覆盖,修复应发布新版本。一个插件在源索引中对应一个条目,版本位于其 `versions` 数组内。
详细流程见 [官方软件源的维护与发布](development.md)。