# 版本与 Release

每个插件独立维护 `curio.json` 的版本，并以 `v<version>` tag 发布对应源码快照。`package.json`、原生项目与 Manifest 中的版本必须一致。

本地开发沿用各项目的固定版本，不因代码修改、构建或本地安装递增；同版本的本地构建由产物标识区分。只有用户明确要求发布新版本或调整版本号时才变更版本。

正式发布前，版本使用 `0.0.0-dev-x`，对应 Tag 为 `v0.0.0-dev-x`，Gitea Release 必须标记为 **Pre-release**。打包、上传或更新软件源不表示进入正式发布阶段；仅在维护者明确决定正式发布后，才采用正式版本号。

安装包存放在该插件仓库的 Gitea Release 附件中。附件按插件 ID、版本、平台命名，不使用 `latest` 之类可变下载地址。`trove-release.json` 记录本次发布的所有产物；源索引由收录 workflow 生成。

相同插件 ID、版本、平台的已发布内容不能覆盖，修复应发布新版本。一个插件在源索引中对应一个条目，版本位于其 `versions` 数组内。

详细流程见 [官方软件源的维护与发布](development.md)。