部署与维护
更新与后台运行
检查、下载并安装更新,理解关闭窗口、退出与后台服务的区别。
Vonvon Bot 桌面端和独立安装的服务端有不同的更新入口。先在左上角确认正在查看哪台设备,再核对这台设备的安装方式和版本。更新会重启相关应用或服务,正在进行的对话会被中断;尽量在任务空闲时操作。
更新这台电脑的桌面端
在 Mac 或 Windows 桌面端打开「设置 → 应用与启动 → 软件更新」,点「检查更新」。看到“有可用更新”以及新版本号后,再点「下载更新」。下载期间可以继续使用;页面显示“已下载并验证”后,才点第二次按钮「重启升级」。
- 点击「检查更新」,对照当前版本和可用版本。只有看到新版本,才进入下载步骤。
- 点击「下载更新」,等进度完成并显示“已下载并验证”。此时更新还没有生效。
- 结束正在进行的重要对话,点击「重启升级」。应用会退出、安装并重新打开。
- 重新打开后回到「应用与启动」,核对顶部显示的版本已经变成目标版本,再确认 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 没回的检查步骤处理。
- 远程设备断开:更新期间会短暂断连。等设备重新上线后刷新;若一直离线,先检查那台设备的运行状态和远程连接。