Skip to content

更新与回滚 ​

Bot 和所有软件一样会更新:修 bug、加新功能。动手之前,先做两件事:

  1. 备份你的配置和数据。 把 Neo-MoFox 目录下的 config/ 和 data/ 复制一份到别处——更新本身不会动它们,但留个后底总是安心。怎么备份见 维护:备份、迁移与日志。
  2. 看一眼更新说明。 去 GitHub Releases 或官方 QQ 群公告看看这次更新改了什么、有没有需要注意的事项,心里有数再动手。

更新会停机吗

会,但很短。启动器更新实例时会自动先停掉正在运行的 Bot 主程序和平台适配器,更新完成后再把它们恢复运行;手动更新则需要你自己先停再更新。整个过程通常一两分钟。

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

更新 Neo-MoFox 主程序(本质是 git 拉取当前分支最新代码):

  1. 打开启动器,进入实例列表,点「管理」进入实例管理页(首页也有「管理全部」入口)。
  2. 切到「更新」分区。面板顶部有两个标签:Neo-MoFox(主程序)和平台(适配器)。
  3. 选 Neo-MoFox 标签,点「检查更新」看看当前分支落后远程多少提交。
  4. 点「检查并更新」。启动器会拉取当前分支的最新代码,并自动同步 Python 依赖(uv sync),不用你操心。

图片:实例管理页的「更新」分区

更新平台适配器(NapCat / SnowLuma):

  1. 还是在「更新」分区,切到「平台」标签。
  2. 启动器会列出该适配器在 GitHub Release 上的可用版本。
  3. 选一个版本(或直接「更新到最新」),启动器会自动下载安装。你的适配器 config 目录(比如 WebSocket 连接配置)会自动保留,不会丢。

这两个平台暂时无法通过启动器更新

SnowLuma 与 NapCat 的上游仓库已归档,Release 渠道不可用,这里的版本列表可能拉不到内容或下载失败。需要换版本时,请自己准备对应版本的文件,替换掉平台路径指向的目录;平台种类与路径在实例的 更多 → 修改实例信息 里调整,见启动器部署的第六步。

图片:平台适配器的版本列表

启动器自己怎么更新:打开 设置 → 关于,点「检查更新」。有新版本时会显示版本号和更新说明,点击即可跳转到启动器的 GitHub Releases 页面,下载新的安装包覆盖安装就行。

更新失败怎么办

更新失败时,更新面板会直接显示失败原因。打开实例管理页的「终端」分区看看日志输出:最常见的原因是网络连不上 GitHub(可以去设置里换镜像源重试),或者是本地代码有改动和远程冲突。在日志里搜 ERROR 或「失败」能快速定位是哪一步出了问题。

回滚 ​

新版用着不对劲?每个方式都有自己的退路:

启动器新鲜安装实例时使用浅克隆,初始获取 20 条提交;更新页默认列出本地可用的最近 20 条历史。先找到一个此前确认可用的提交,再按下面的步骤回退:

  1. 实例管理页 → 「更新」分区 → Neo-MoFox 标签。
  2. 在右侧 提交历史 里确认提交号、说明与时间。当前版本标着「当前」,不能再点回退;找到目标旧提交,点该行的 回退。
  3. 等待回退与 Python 依赖同步完成,再查看当前版本是否变成选定的提交,并测试 Bot 是否恢复正常。

启动器实际更新界面的提交历史:当前提交有标记,其他提交行右侧有「回退」按钮;提交号和说明为演示数据

回退后怎样恢复跟随最新代码? 回退会把主程序检出到具体提交,当前分支可能显示为 HEAD。此时先在左侧 分支切换 中选择原来的 main 或 dev,点 切换。启动器会切回该分支、拉取最新代码并同步依赖;完成后再检查版本与运行状态。

回退后的实际管理界面:当前分支显示 HEAD,左侧分支选择框可以重新选择 main 或 dev 并点击「切换」;图中为演示状态

图中的实例与提交是演示值,请按自己实例的历史选择,不要照抄示例提交号。恢复到分支后,日常更新继续使用 检查并更新。

平台适配器(NapCat / SnowLuma)的上游仓库已归档,启动器内的版本列表与回退暂时不可用,需要换版本时自行替换平台目录中的文件。

TIP

想回到列表之外的提交,需要先确认本地仓库已有对应历史;浅克隆不一定能直接找到任意旧提交。熟悉 Git 的用户可按本页「手动命令行」标签里的方法处理,开始前先备份配置与数据。

更新后自检清单 ​

更新完别急着走,花一分钟做三个检查:

  • 日志无报错:看一眼启动日志,搜 ERROR 和 Traceback,没有红色报错为佳(日志在哪看)。
  • 群里戳一下:去 Bot 在的群里发条消息,确认它能正常回话。
  • WebUI 打得开:浏览器访问 http://localhost:8000,管理面板能正常加载。

三个都过了,这次更新就算圆满。有问题就按回滚退回旧版本,然后去仓库提 issue。

贡献者

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

页面历史

Released under the GPL-3.0 License.