更新通道: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)。选哪个,实例就克隆哪个分支。

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

切通道前先备份
- dev → main 的数据不会自动回退。 抢先体验期间产生的新格式数据(比如新版数据库里的新字段记录)切回 main 后不会被「翻译」回去,它们就保持着 dev 写入时的样子。
- 配置文件是向后兼容的,反过来不行。 main 上启动时会自动补齐缺失的配置项并保留你的值;但 dev 新增的配置字段在 main 上不认识,通常会被忽略(配置文件里对应的行也会被清掉),个别严格校验的配置节不排除报错的可能。
- 所以切通道前,把
config/和data/备份一份,见 维护:备份、迁移与日志。
两边怎么选
| 你的情况 | 建议 |
|---|---|
| 挂机群聊,稳定第一,不想折腾 | main |
| 第一次部署,刚入坑 | main |
| 想第一时间体验新功能,能接受偶尔出 bug | dev |
| 帮开发者测试新特性、反馈问题 | dev |
