MengBotDocs
故障排除

桌面端更新

从卡住的下载或重启中恢复,并了解支持的更新路径。

MengBot 会在后台检查更新,并在窗口底部的卡片中提供下载。下载的应用方式取决于你安装的版本。

构建版本按钮的作用
macOS、Windows、Linux AppImage重启以更新 — 应用会替换自身并重新打开。AppImage 始终会重写到你启动时使用的路径,因此你的启动器、符号链接或程序坞固定项会继续有效。
Ubuntu .deb(以及 rpm/pacman)安装 — MengBot 会下载并验证软件包,复制安装命令,并打开终端供你粘贴。应用本身从不安装系统软件包,因此从不会要求你输入管理员密码。

Ubuntu 软件包需要从发布仓库手动安装,因此应用会直接给出确切的命令行,而不是猜测包管理器:

sudo apt-get install -y '/home/you/.cache/mengbot-updater/pending/MengBot-<version>-amd64.deb'

安装完成后重新打开 MengBot,即可运行新版本。

下载一直转圈

让应用保持打开足够长的时间以完成一次完整尝试,然后退出并重新打开。失败的差分更新应回退到完整软件包。如果同一版本仍然卡住,请从官方发布页面下载当前安装程序,并覆盖安装到现有副本上。

在 macOS 上,正在准备更新是下载完成后的一个独立步骤。macOS 必须先暂存更新,重启以更新才会变为可用。下载完成并不意味着此准备工作已完成。

如果更新失败,其错误会保持可见,而不会被后台更新检查替换。如果重启耗时超出预期,请先完全退出应用再重试;反复点击重启无法加快速度。

重启以更新没有反应

完全退出 MengBot 并重新启动。如果版本没有变化,请手动安装最新版本。你的对话和设置位于应用程序包之外,替换应用不会将其删除。

运行更新程序的是已安装的版本,而不是正在下载的版本。如果你是从更新程序卡住的旧版本升级,可能需要手动安装一次新版本才能获得修复。请勿删除你的 MengBot 数据目录。

报告更新失败

打开 应用设置 → 通用 → 诊断 → 导出诊断…。请包含你的操作系统、当前安装的版本、目标版本,以及失败发生在下载、准备还是重启阶段。较新的版本会在服务器日志和桌面日志之外,附带一份有大小限制且已脱敏的更新程序日志。在私下与支持团队分享之前,请先检查导出的文件。

没有打开终端

无论哪种情况,安装命令都已复制到你的剪贴板。请自行打开终端并粘贴。如果剪贴板已被覆盖,软件包已经下载完成,你可以运行:

sudo apt-get install -y ~/.cache/mengbot-updater/pending/MengBot-*-amd64.deb

请使用 apt-get,而不是 dpkg -i — 只有 apt-get 会解析依赖关系,而在 Ubuntu 24.04 上,我们的依赖通过虚拟包满足,仅靠 dpkg 无法跟踪。

验证已安装的版本

打开 应用设置 并检查显示的版本。合并到 main 的提交在发布工作流发布新版本之前,不会出现在桌面应用中。

使用官方制品

请勿安装通过聊天转发的或上传到无关仓库的更新文件。请使用 MengBot 发布仓库及其校验和。

On this page