A local-first multi-agent app development platform, built on PenguinHarness
title: 更新 Adelie description: 查看正在运行的版本,并更新桌面应用、CLI 安装或 Docker 部署。
查看正在运行的 Adelie 版本,并按你的安装方式完成更新。
- 想确认当前版本? 见查看当前版本。
- 在浏览器里更新? 见通过 Web App 更新。
- 用的是桌面应用? 见更新桌面应用。
- 装的是 CLI? 见更新 CLI 安装。
- 在 Docker 里运行? 见更新 Docker 部署。
- 不想检查更新? 见关闭更新检查。
查看当前版本
在 Web App 里:
- 新对话页的版本行会显示正在运行的版本,形如
vX.Y.Z · 最近更新日期 7月26日。日期由发布流程在构建时写入,所以不联网也能显示。开发构建,以及引入日期写入之前的发布版(v0.1.2 及更早)没有日期。检查发现更新的发布版时,这一行会接着写上最新版本 vX.Y.Z;已经是最新则不重复写。 - 在侧边栏的用户菜单里,紧贴设置下方的更新行会在右侧以浅色显示当前运行的版本。
在终端里:
penguin -v与penguin version相同,输出当前构建的单行标识;penguin version --json输出完整的构建信息。见 penguin version。penguin update --check报告已安装的版本和最新版本,不做任何改动。
通过 Web App 更新
更新的交互和常见的应用更新器一样,集中在一个弹窗里完成。
打开更新弹窗
有两个入口可以打开更新弹窗:
- 侧边栏用户菜单里紧贴设置下方的更新行。这一行会显示更新到了哪一步:检查更新、检查中…、新版本 vX 可用、正在下载 vX 42% 或重启以更新到 vX。无论显示哪种状态,点击都会打开弹窗。
- 新对话页版本行上的小上标。有新版本时显示有新版本可用,下载中显示正在下载更新,下载就绪后显示重启以更新。
执行更新
- 打开更新弹窗。如果还不知道有没有新版本,弹窗会先检查一次。应用每次加载页面时也会向 GitHub 查询一次,而从弹窗发起的检查会绕过缓存的结果。
- 有新版本时,弹窗会列出它,并附上更新说明链接。在你继续之前,不会下载任何内容。
- 点击下载并更新,进度条会跟随下载进度。
- 如果想继续做别的事,点击放到后台。弹窗会关闭,但不会取消任何操作:更新行继续显示下载百分比;新版本就绪后,用户按钮上会出现圆点,并弹出一条提示。
- 点击重启并更新,完成更新。
[!NOTE] 非管理员可以查看更新说明,但不能执行更新。
下载失败时,弹窗会显示更新命令自己的输出,并提供重试。无法自更新的安装方式,例如源码检出、无法识别的目录布局或 Windows,会在弹窗里说明原因。
服务端上的更新过程
- 下载就是在后台运行
penguin update,进度条读取的是安装器自己的进度。数据目录不受影响。 - 服务由
penguin web或penguin server托管时,重启是真实发生的:服务会以新版本重新运行,页面自动刷新。 - 用其他方式启动的服务,弹窗会提示你手动重启。
更新桌面应用
在桌面应用里,同一个弹窗驱动的是应用自带的更新器。这只发生在应用自己的窗口里,服务端的版本不会在那里出现。
应用会按自己的节奏检查新版本,但从不自行下载。查到的新版本会显示为用户按钮上的圆点,并出现在更新行里。安装步骤如下:
- 打开更新弹窗。
- 点击下载并更新。显示的百分比就是更新器的真实进度。
- 点击重启并更新。应用会重启,并运行已下载的新版本。
应用的原生菜单项 Check for Updates… 也会在原生对话框里提供同样的「先下载、再重启」两步。
[!NOTE] 用密码登录同一台桌面模式服务端的浏览器,完全看不到更新入口:它既读不到那台机器的更新器状态,也无法重启应用窗口,更不能在那台服务端上运行 CLI 自更新。
有两种形态的应用无法替换自身,弹窗会说明这一点:一种是由系统包管理器管理的 Linux 安装(.deb),需要通过包管理器更新;另一种是开发运行。安装包的说明见桌面应用页面。
应用自带的 penguin 命令
桌面应用安装的 penguin 命令与应用来自同一次构建,所以更新应用时命令也会随之更新。用这个命令运行 penguin update 不会改动任何东西:它会说明这个命令会随应用更新一起替换,并提示你到应用菜单里检查更新。
更新 CLI 安装
penguin update 会按当初的安装方式原地升级:
penguin update --check # report versions only
penguin update # upgrade to the latest release, after confirming
| 安装方式 | penguin update 的做法 |
|---|---|
压缩包安装(install.sh) |
重新运行官方安装脚本 |
| npm/pnpm/yarn/bun 全局安装 | 执行对应包管理器的全局安装 |
| 源码检出 | 拒绝执行,请用 git pull 更新并重新构建 |
--release <tag> 可以指定某个发布版,-y 跳过确认。数据目录始终保持不变。
[!NOTE] 在 Windows 上,
penguin update不会原地升级,而是告诉你应该运行什么。用 Windows 安装器装的,重新运行安装器即可升级。
重新运行安装脚本同样可以升级,文件以原子方式替换。全部选项和下载来源规则见 penguin update,安装器的说明见安装参考。
更新 Docker 部署
拉取新的镜像 tag,然后重建容器。数据目录在数据卷上,会原样保留:
docker compose pull && docker compose up -d
不支持在容器内部更新,详见升级容器。
关闭更新检查
设置 ADELIE_UPDATE_CHECK=off 可以关闭自动的版本检查。它只关掉这一项:模型请求、已启用的远程控制连接、Key 授权和代理测试照常联网。关闭后,更新弹窗会显示更新检查已关闭(ADELIE_UPDATE_CHECK=off)。见配置参考。