Skip to content

更新通道:main 与 dev ​

Neo-MoFox 有两个更新通道,装的时候选一个跟着走:

  • main(稳定版):经过完整测试后发布的版本,更新节奏慢一些,但更稳,适合大多数人。
  • dev(开发版):开发分支的最新代码,新功能、新修复第一时间就有,但也可能带着还没被发现的新 bug。

版本号长这样:1.3.0-alpha.0、1.2.0-rc.2。格式是「主版本.次版本.修订号-预发布标识」,预发布标识从 alpha(内测)到 beta(公测)再到 rc(发布候选),一路打磨,最后去掉后缀成为正式版。仓库的 tag 也按这个规律走,比如 1.1.0-alpha.2 → 1.1.0-beta → 1.1.0-rc。

TIP

dev 验证过的功能和修复会合入 main,所以 dev 可以理解成「预览版」:你先尝鲜,稳了再进稳定版。

按你的部署方式选择下面的标签页操作:

安装新实例时:安装向导里就有「更新通道」下拉框,两个选项——稳定版 (main) / 开发版 (dev)。选哪个,实例就克隆哪个分支。

图片:安装向导中的更新通道选择

已有实例换通道:不用重装,直接切分支:

  1. 实例管理页 → 「更新」分区 → Neo-MoFox 标签。
  2. 找到「分支切换」,在下拉框里选 main 或 dev。
  3. 点「切换」。启动器会拉取目标分支的最新代码(本地有改动会先自动暂存),并自动同步 Python 依赖。本质是 git fetch + checkout + pull + uv sync 一条龙。

图片:实例更新分区的分支切换

切通道前先备份

  • dev → main 的数据不会自动回退。 抢先体验期间产生的新格式数据(比如新版数据库里的新字段记录)切回 main 后不会被「翻译」回去,它们就保持着 dev 写入时的样子。
  • 配置文件是向后兼容的,反过来不行。 main 上启动时会自动补齐缺失的配置项并保留你的值;但 dev 新增的配置字段在 main 上不认识,通常会被忽略(配置文件里对应的行也会被清掉),个别严格校验的配置节不排除报错的可能。
  • 所以切通道前,把 config/ 和 data/ 备份一份,见 维护:备份、迁移与日志。

两边怎么选 ​

你的情况建议
挂机群聊,稳定第一,不想折腾main
第一次部署,刚入坑main
想第一时间体验新功能,能接受偶尔出 bugdev
帮开发者测试新特性、反馈问题dev

TIP

dev 上出了 bug 别慌:先按更新与回滚退回旧版本或切回 main(记得先备份),然后去 GitHub 仓库提 issue。

贡献者

The avatar of contributor named as ikun-1145141 ikun-1145141
The avatar of contributor named as minecraft1024a minecraft1024a

页面历史

Released under the GPL-3.0 License.