跳转至

发布流程

统一分支模型

OO 插件与客户端项目使用同一套渐进式发布流程,但分支名称只表示开发阶段,不能代替验收结论:

  • 已有稳定版的项目:日常开发与修复进入 Beta。完成测试、安全、兼容性以及所需平台验收后,才合并进 Stable,并按正式发布规则创建一次对应的稳定版 Release。合并完成后保留 Beta,继续承接下一轮开发。
  • 尚无首次稳定版的项目:继续使用 Alpha。只有首次稳定门禁全部通过后,才能建立或合入 Stable;之后的常规开发再转入 Beta。不得仅因分支改名就把 Alpha 或候选构建描述为稳定版。
  • 前瞻兼容工作:Dev 只用于未来 Minecraft、Java、平台或渲染兼容探索。成熟并完成对应验收后先进入当前开发线(Alpha 或 Beta),不得绕过开发线直接进入 Stable。

该流程不是长期维护两条并行的 Stable 开发线,也不要求收到政策更新后立即批量合并、删除分支或发布。冻结项目只同步必要文档,归档项目保持归档;已有 Release 内容和资产不覆盖。

Meowopia Wiki 是文档站,不套用插件二进制的 Alpha / Beta / Stable 分支模型。Wiki 继续通过文档审查、严格构建和 Pages 部署流程交付。

公开稳定版门禁

每个 OO 产品只有同时满足以下公开条件,Wiki 才会标记为 stable / released:

  • 功能范围、支持平台与已知限制明确;
  • 产品测试、生命周期、线程与 Paper/Folia 兼容门禁通过;
  • 用户配置具备中英说明和统一支持联系方式;
  • 闭源许可证、第三方 NOTICE、升级与回滚说明完成;
  • 正式二进制经过维护者核验,并提供公开下载页和校验值;
  • 完成声明的平台启动矩阵,或明确列出尚未验收的平台。

本 Wiki 只公开产品状态、安装、配置、支持、公开 API 用法、正式下载页和正式二进制校验值。非公开工程材料、开发期验证数据与敏感实现均不得进入公开页面。

  1. 冻结本次文档范围,确认未覆盖共享未提交改动。
  2. 核验版本、公开 Capability、命令、测试结论与正式二进制 SHA-256。
  3. 运行 UTF-8、断链、旧命名扫描和 python -m mkdocs build --clean --strict。
  4. 审查 diff,明确 implemented、published、code-prepared、planned、blocked。
  5. 由维护者批准后再提交、推送和发布 Pages;严格构建不会自动授权发布。

禁止伪造 badge、release、artifact、测试或提交身份。本仓库不从文档 CI 自动创建 GitHub Release。

Release body policy

Server-plugin stable releases contain only a concise bilingual 更新日志 / Changelog and, when required, 已知问题 / Known issues. They do not include Minecraft, Paper/Folia, or Java test-environment sections and do not include build-validation logs.

The only exception is the OOEngine Client Mod. Its release must additionally state prerequisite plugins, compatible OOConsole versions, and applicable/tested Minecraft and Java environments.