自动更新
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 仍然存在以兼容前端,但不会执行任何操作。
另请参见
最后更新于