维护、版本与更新

一句话

这一页讲「关于」里的版本与更新、「维护」里的运行日志与清除缓存，以及网络相关设置实际在哪里。给想知道自己装的是哪个版本、想手动检查更新、或排错时想看日志的用户看。

在哪打开

版本与更新在 设置 → 关于；日志与清除缓存在 设置 → 维护。设置页搜索框输入「更新」「版本」「日志」可直接跳到对应分区。

主要动作

• 检查更新：设置 → 关于 →「检查更新」。检查期间按钮显示「检查中…」，结束时用提示告知结果：已是最新版本、更新检查当前已由服务端关闭、或检查失败。单次检查 20 秒超时，超时按失败上报。
• 开关自动更新：设置 → 关于 →「自动更新」开关。开启后，发现新版本会自动下载，完成后提示重启安装。
• 查看版本：设置 → 关于 第一行「榕树」下面显示「版本 {version}」。
• 查看用户协议：设置 → 关于 →「查看」，弹窗里可随时回看协议全文。
• 查看运行日志：设置 → 维护 →「查看日志」，日志含主进程与渲染层日志，可搜索与筛选。
• 清除缓存：设置 → 维护 →「清除缓存」，提示「缓存已清除（协议将在下次启动时重新显示）」。

字段 / 状态说明

名称	含义	什么时候用
版本 {version}	当前安装的版本号	报问题、核对是否最新
检查更新 / 检查中…	手动触发一次更新检查	想立刻确认有没有新版
当前版本已不受支持，请升级到最新版	本机版本低于运营设定的最低支持版本	出现时说明必须升级
更新检查已由服务端关闭	运营关闭了更新检查，此时检查按钮不可点	点了没反应时先看这一行
自动更新（开关）	发现新版本后是否自动下载	想自己控制下载时机时关掉
运行日志	主进程与渲染层日志（含错误与请求详情）	发布失败、报错时排查
清除缓存	仅清除用户协议缓存，数据不受影响	想重新看到协议页

与其它功能的关系

「关于」里的更新信息来自两端：本机侧是「自动更新」开关与当前版本号，服务端侧是「是否启用更新检查」「是否强制升级」「更新源地址」等运营配置。客户端启动后每天在后台检查一次更新源。前台可见的下载进度与「重启安装」由窗口底部的更新横幅呈现。「维护」里的「删除数据」与「数据管理」是同一件事的两个入口，见「数据管理」页。

限制与注意

• 关于页里没有代理设置：应用不提供应用内代理开关，检查更新走系统网络。名字像「网络设置」的那一处在 设置 → API 与 MCP，管的是本机对外提供的接口服务（监听地址、端口），与更新无关。
• 强制升级时「自动更新」开关不可点。
• 关掉「自动更新」只影响常规升级；被判为低于最低支持版本时仍会强制下载。
• 检查更新只在打包版本可用，开发模式下会提示「自动更新仅在打包版本中可用」。
• 更新源一旦在运行期被设定，清空配置也不会退回打包内置源，需要重启应用。
• macOS 上自动更新装不上（未做 Apple 公证），「关于」里仍可手动检查，但安装要走官网重装。

常见问题

Q：点了「检查更新」没有任何提示？ A：手动检查的三种终态都会有提示：已是最新版本、更新检查当前已由服务端关闭、检查失败。若按钮一直停在「检查中…」，多半是网络原因导致检查超过 20 秒。

Q：想走代理或换更新源怎么办？ A：应用内没有代理设置。更新源由运营配置或环境变量决定，个人用户可考虑在系统层面设置代理。

Q：「自动更新」关了还会自己升级吗？ A：常规升级不会；但版本被判为低于最低支持版本时仍会强制下载并提示升级。