跳转到内容
For the complete documentation index, see llms.txt. This page is also available as Markdown.

自动更新

OpenHuman 如何自我更新:一个已签名的清单、有限次数的下载重试,以及一次同时覆盖应用及其核心的更新。

OpenHuman 会一步更新整个应用。核心模块直接链接到桌面外壳中,因此没有单独的核心更新。更新外壳会同时升级两者。

你所看到的

当有更新的构建可用时,应用会在后台下载。下载准备就绪后会出现提示,并依次进入 可安装, 安装中 和 重启中。如果你已是最新版本,你会看到 已是最新版本。如果失败,则会显示失败,而不是无限重试。

在安装之前,应用会在与其他地方相同的重启锁下关闭进程内核心。这样替换包时就不会与仍持有文件句柄的核心发生竞争,从而使 .app 在 macOS 上的替换保持干净。

更新来源

只有一个端点,即每次发布时都会发布的清单:

https://github.com/tinyhumansai/openhuman/releases/latest/download/latest.json

每个构件都经过签名,公钥已编译进应用中。签名无法验证的构建会被拒绝。这里没有需要信任的更新服务器,也没有第二个渠道。

重试

一次下载有三次尝试:首次尝试加上两次重试,每次间隔为尝试次数乘以两秒。

只有暂时性的网络故障才会重试。签名失败、文件系统错误以及“没有适用于此目标的构件”都不会重试。再次下载无法修复错误的签名,而对失败的验证循环重试会浪费带宽,并可能掩盖篡改。该策略位于 crates/openhuman-app/src/app_update.rs,其中 classify 和 is_transient_updater_err 决定。

定期检查

核心会运行该计划,其设置位于 [update] 中,放在 config.toml:

键
默认值
功能

enabled

true

设置为时会关闭定期检查 false.

interval_minutes

60

检查频率。最小值为 10 分钟。

restart_strategy

self_replace

self_replace 在暂存后原地重启。 supervisor 负责暂存更新,并将重启交给管理该进程的机制。

rpc_mutations_enabled

true

带有 bearer 身份验证的 RPC 客户端是否可以调用会修改状态的更新方法。

使用 supervisor 适用于无头或容器化的核心,此时由其他组件负责进程生命周期,更新不应重启它。

无头和自托管核心

你自己运行的核心(openhuman-core serve)会通过 更新 命名空间检查并暂存更新,而不是通过桌面提示。因此 rpc_mutations_enabled 是一个单独的开关。旧的桌面命令 check_core_update 和 apply_core_update 仍然存在以兼容前端,但不会执行任何操作。

另请参见

最后更新于