# 更新与后台运行

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

来源：https://vonvon.cc/docs/updates/
更新时间：2026-11-04

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

**1**检查更新**2**下载并验证**3**手动重启**4**核对版本

流程示意：下载验证后仍需点击「重启升级」；重新打开后再核对实际版本。

## 更新这台电脑的桌面端

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

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

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

## 更新独立服务端或外部 Core

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

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

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

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

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

若那台设备的服务端来自桌面应用，更新方式取决于那台设备。受支持的远程 Mac 可以从服务端卡发起“更新那台电脑上的 Vonvon Bot”；确认后由那台 Mac 的桌面端下载并重启，期间连接会暂时断开。那台 Mac 的桌面端必须开着。Windows 自带服务端请到那台 Windows 电脑上打开 Vonvon Bot，按[桌面端步骤](https://vonvon.cc/docs/updates/#desktop)更新。

若页面提示“那台设备不支持远程更新”或“桌面端没开”，按提示到那台设备上操作。远程连接和版本不一致的处理见[远程设备使用](https://vonvon.cc/docs/remote/#use)及[远程连接排错](https://vonvon.cc/docs/remote/#trouble)。

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

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

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

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

## 更新没完成时

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