文档部署与维护

部署与维护

更新与后台运行

检查、下载并安装更新,理解关闭窗口、退出与后台服务的区别。

使用指南5 分钟
更新于 2026-11-04

Vonvon Bot 桌面端和独立安装的服务端有不同的更新入口。先在左上角确认正在查看哪台设备,再核对这台设备的安装方式和版本。更新会重启相关应用或服务,正在进行的对话会被中断;尽量在任务空闲时操作。

1检查更新2下载并验证3手动重启4核对版本
流程示意:下载验证后仍需点击「重启升级」;重新打开后再核对实际版本。

更新这台电脑的桌面端

在 Mac 或 Windows 桌面端打开「设置 → 应用与启动 → 软件更新」,点「检查更新」。看到“有可用更新”以及新版本号后,再点「下载更新」。下载期间可以继续使用;页面显示“已下载并验证”后,才点第二次按钮「重启升级」。

  1. 点击「检查更新」,对照当前版本和可用版本。只有看到新版本,才进入下载步骤。
  2. 点击「下载更新」,等进度完成并显示“已下载并验证”。此时更新还没有生效。
  3. 结束正在进行的重要对话,点击「重启升级」。应用会退出、安装并重新打开。
  4. 重新打开后回到「应用与启动」,核对顶部显示的版本已经变成目标版本,再确认 Bot 和飞书连接恢复。

桌面包自带的服务端随桌面端一起更新,不需要再单独更新一次。仅点击「检查更新」不会安装;下载后也不会在你点击「重启升级」之前自动重启。如果提示“上次安装未生效”,可在页面点「重试」,或从官网下载页手动重新安装。

更新独立服务端或外部 Core

Linux 服务器、独立安装的服务端和全局 npm 安装的 Core,可从相应设备的更新卡检查。桌面端切到那台设备,打开「设置 → 应用与启动」,在“设备名的服务端”卡点「检查更新」;有新版本时点「更新设备名」,然后观察更新进度。当前电脑上的外部 Core 在「应用与启动 → 高级运行设置 → 外部 Core / CLI」中检查和更新。

更新服务端会重启后台服务,正在进行的对话会中断。页面显示完成后,核对服务端卡的当前版本;再到诊断的排错步骤检查 Bot 是否恢复。若状态显示失败或已切回旧版,先读错误文字和后台日志,再处理连接或安装问题;不要仅凭按钮已经点过就认为升级成功。

在安装了 vonvon 命令的设备终端,也可先运行 vonvon update --check 只检查,再运行 vonvon update 更新服务端。终端会报告进度与结果;“已更新到”目标版本,或显示已是最新,才是这一步的完成标志。命令适用平台及更多只读检查见命令行使用。

Linux 的双源选择由 0.9.2 的安装脚本和服务端更新器提供。已有 0.9.1 的安装脚本及包内更新器仍只使用国内源;需要先升级到包含双源更新器的新版本,之后的更新才会自动选择可用下载源。

远程设备的服务端由桌面端自带时

若那台设备的服务端来自桌面应用,更新方式取决于那台设备。受支持的远程 Mac 可以从服务端卡发起“更新那台电脑上的 Vonvon Bot”;确认后由那台 Mac 的桌面端下载并重启,期间连接会暂时断开。那台 Mac 的桌面端必须开着。Windows 自带服务端请到那台 Windows 电脑上打开 Vonvon Bot,按桌面端步骤更新。

若页面提示“那台设备不支持远程更新”或“桌面端没开”,按提示到那台设备上操作。远程连接和版本不一致的处理见远程设备使用及远程连接排错。

关闭窗口、退出与后台运行

关闭桌面窗口不会停止 Bot:Mac 会隐藏窗口和 Dock 图标,可从状态栏图标恢复;Windows 会留在系统托盘,可从托盘恢复。需要让 Bot 不再工作,可在「Bot」详情的设置中关闭「启用 Bot」;停用会结束这位 Bot 正在运行的任务。若停用后仍显示「尚未停止」,它可能还会回复消息,请到「应用与启动」重启后台再核对状态。

选择「退出」会停止桌面端自带的后台服务和所有 Bot。若桌面端接续的是另外独立安装并注册的服务端,退出桌面应用只会断开管理窗口,Bot 仍由该服务运行;退出当前电脑的桌面端也不会停止远程设备上的 Bot。需要重新加载已保存的 Bot 设置,可在「应用与启动 → 启动选项」点「重启后台」,这会中断正在进行的对话。

Mac 桌面端在「启动选项」提供「登录电脑时启动」,打开后可在登录电脑后自动运行 Bot;手动退出桌面应用仍会停止其自带后台。Windows 桌面端在本版没有登录自启开关,需要让应用保持运行。Linux 独立服务端的登录或开机启动由服务安装方式决定,参见命令行使用。

更新没完成时

  • 查不到更新源:检查网络,稍后重试;桌面端可用页面上的「手动下载」或官网下载页安装。
  • 下载完成但版本没变:确认是否已点「重启升级」。若显示“上次安装未生效”,按页面提示重试或手动安装。
  • 重启后 Bot 没恢复:到「设置 → 诊断」查看后台、Bot 连接与最近崩溃,再按Bot 没回的检查步骤处理。
  • 远程设备断开:更新期间会短暂断连。等设备重新上线后刷新;若一直离线,先检查那台设备的运行状态和远程连接。