AIRI 怎么检查自动更新:更新通道选择、手动检查更新与 Updater 查看更新源
【免费下载链接】airi💖🧸 Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-sama's altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi
在 AIRI 桌面版上,你可能需要三件事:确认当前是不是最新版本、给自动更新换一个更新通道(例如尝试 beta 构建),或者在更新失败、更新源不对时查清楚更新器到底连的是什么源。本文基于项目文档与桌面端「关于」页面的实现,给出这三步的连续操作路径,适用对象是 AIRI 桌面端(Windows / macOS / Linux);本文不覆盖网页端。日常升级的主入口是「关于」窗口;「系统 → 开发者」里的 Updater 工具用于排查更新失败、更新源错误或特定平台的安装问题(见桌面端开发者工具文档)。
打开「关于」窗口
「关于」窗口是选择更新通道和手动检查更新的入口:
- 找到系统托盘中的 AIRI 图标。Windows 上可能需要先点击任务栏「显示隐藏的图标(⌃)」展开;macOS 上图标可能藏在刘海后面,需要先在系统设置的菜单栏选项中腾出空间。
- 右键 AIRI 小图标,选择「关于」。
根据说明书,「关于」窗口可以查看版本号、更新 AIRI 并选择更新通道。窗口同时显示当前版本号,以及分支、commit 与构建时间等构建信息。
在「关于」窗口选择更新通道
当前版本下方是更新通道(update lane)下拉框,可选项为auto、latest、stable、alpha、beta、nightly、canary,其中latest的标签是 "Latest (any release)"(选项定义见关于页源码)。未显式设置过通道时,页面默认回落到auto。
选中某个通道后,设置会被保存,并且页面会自动触发一次更新检查(见 about.vue 中setUpdateChannelPreference末尾的checkForUpdates()),不需要再手动点检查。
两个例外:
- Steam 渠道分发的构建会隐藏通道下拉框,更新由商店管理(源码中
VITE_DISTRIBUTION === 'steam'时不渲染该下拉框); - 页面处于正在检查/下载更新(
isBusy)期间,通道下拉框不可操作。
手动检查并安装更新
在「关于」窗口的更新区域,点击检查更新按钮。按钮文案随状态变化:正常状态为「检查更新」,检查中显示「正在检查」,已是最新时显示「已是最新版」,出错时为「重试检查」,被禁用的构建则显示对应提示(实际文案以应用语言设置为准,状态机见 about.vue)。检查结果按以下状态流转:
- 已是最新:页面显示「当前版本已是最新」类提示,任务结束。
- 有新版本:页面显示
当前版本 → 目标版本,并提供「下载」按钮。如果该更新带 release notes,点击「下载」会先弹出更新说明对话框,阅读后确认才真正开始下载,也可以取消。 - 下载中:显示进度条、百分比和下载速度(MB/s)。
- 已下载:出现二次确认按钮(点两下才真正执行),确认后退出并安装新版。
需要注意的三种特殊情况:
- Windows 受保护目录:若 AIRI 安装在受保护的 Windows 目录(例如为所有用户安装的场景),页面会显示琥珀色提示 “Update install may require a UAC admin prompt.” 并给出安装路径;安装时可能需要通过管理员授权。
- 降级:如果所选通道提供的构建比当前版本更旧,页面会显示黄色警告,安装该更新会降级 AIRI——先确认这是你想要的,再执行。
- 检查出错:页面显示错误信息,可以重试检查,也可以通过「反馈」提交 bug 报告;报告会自动填入当前版本、更新状态与错误信息,提交时复制到剪贴板,便于粘贴到 issue 中。
用 Updater 工具查看更新源与状态
当更新失败、更新源不符合预期,或出现特定平台的安装问题时,转到开发者工具:
- 打开设置界面——在主窗口点「展开 ⌃」选「打开设置」,或右键托盘图标选「设置」。
- 进入「设置 → 系统 → 开发者」,打开 Updater 页面。
Updater 展示当前版本、平台、架构、更新通道、更新源、日志位置和更新状态,也可以手动检查、下载和安装更新。排查时的判断方式就是逐项核对:更新通道是否与「关于」窗口里选的一致、更新源是否是你预期指向的来源、更新状态停在哪个环节,需要日志佐证时再按页面给出的日志位置去取日志。
两点限制来自文档原文:
- 日常升级优先使用「关于」窗口,不要默认走开发者工具;
- 在开发者工具中覆盖更新源前,请确认自己了解该来源的可信性和影响范围。
另外,该开发者页面整体提醒过:不要把包含 API Key、聊天内容、屏幕画面或 WebSocket 数据的截图直接公开,分享更新日志或状态截图前也先自查。
判断是否完成
- 「关于」窗口显示已是最新 → 当前通道下没有可用更新;
- 「关于」窗口走到「已下载」并二次确认重启安装 → 新版本装完;
- 若走的是 Updater 排查路径:更新通道、更新源与日志内容符合预期 → 更新链路正常,此前的问题属于特定触发条件而非配置错误。
通道选项、状态流转与特殊提示的具体实现可继续在 about.vue 中核对;Updater 工具与其他开发者页面的完整说明见桌面端开发者工具。
【免费下载链接】airi💖🧸 Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-sama's altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考