# 版本与 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)。