diff --git a/docs/development.md b/docs/development.md
index 989724f..aeb36b8 100644
--- a/docs/development.md
+++ b/docs/development.md
@@ -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。
diff --git a/docs/versioning.md b/docs/versioning.md
index 7d793c8..08487fc 100644
--- a/docs/versioning.md
+++ b/docs/versioning.md
@@ -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 生成。