MicroDuck 0.17.6：查更新报错后，怎样核对与恢复

先看报错，不要把查不到更新当成已是最新版

官方 0.17.5 于 2026 年 10 月 17 日 10:15 UTC 发布，0.17.6为 10:43 UTC。两者都不是 prerelease，但公告明确：直接构建、没有先走 staging 提升，只经 CI 更新引擎检查，尚未做机器人实机验收。本站没有连接机器人或执行升级。

robotctl version
robotctl update status
robotctl update check daemon
robotctl update log
robotctl update show

check 只查是否有可用更新；log 列出历史尝试，show 读取最近一次详情。先记实际运行的 updaterd 版本、组件/通道和错误阶段。查源失败不是“已经最新”。即使服务器发布了修复，旧机正在运行的更新器也不会自动获得新实现。

0.17.5 与 0.17.6 分别修了什么

原始故障 #421记录发布 API 返回 response too large。0.17.4 及更早的实现每页取 100 个 release；0.17.5 改成每页 20 个、最多 25 页。0.17.6 则从当前通道的 tag 按语义版本号降序找已发布正式版，最多试五个候选，跳过无可用 release、草稿和预发布。固定实现。

HTTP 元数据上限仍是 1,048,576 字节（1 MiB），不是系统镜像大小，也不是提高了下载额度。当前公开 release 数已少于昨晚，所以上游清理后旧机也可能暂时查通；必须对照自己看到的错误，不能断言所有旧机现在都坏了。限制定义、设计说明。

旧机卡在查源时，先核指定版本入口

我们同时读了 0.17.4 CLI和旧版源解析：它们已有 --version / --dry-run，指定版本直接找对应 tag 的 release，不必先读整个发布列表。此路径只避开发布列表错误，不会修复 DNS 或 TLS；有源码依据，本站未实机复现。其他旧镜像或第三方复刻不能直接套用，先读本机帮助：

robotctl update apply --help

仅在官方兼容机体、当前版本低于 0.17.6、确实打算安装本版，并已支撑机体、稳定供电和留足暂存空间时，可先做以下预演：

sudo robotctl update apply daemon --version 0.17.6 --dry-run

这条命令会下载和写暂存文件，并非只读。 它校验签名、哈希和兼容性，解包、检查服务缺失，之后在预安装钩子和切换当前版本之前退出；不验证重启、步态、摄像头等实机效果。失败就保留错误，不用跳过签名或改投 dev/staging 来绕过。固定引擎停止位置。

决定安装后，回读运行版与恢复目标

预演通过且选择在该兼容板上安装时，才去掉 --dry-run：

sudo robotctl update apply daemon --version 0.17.6

指定版本表达主动选择，也可能允许降级；未来已运行更高版本时不要照抄本页。升级电脑端 duckctl 不会替机器人升级 updaterd。安装后检查：

robotctl version
robotctl update status
robotctl health
robotctl update log
robotctl update show

出错先看运行版和日志，系统可能已自动回退。只有本机有合适的旧版且确需恢复时才手动回退；独立策略集不会随之回退：

sudo robotctl update rollback daemon
robotctl version
robotctl health

本轮官方策略、参考模型、仿真和 RL 版本未变。main 后续的开机配置脚本修复及 0.17.7 开发标签不属于本页 0.17.6；0.17.4 历史说明继续保留当时 Beta 名称与 Vet Book 范围。