MicroDuck 0.17.6：查更新報錯後，怎樣核對與恢復

繁體版於 2026 年 10 月 31 日上線。以下另列原資料修訂日，舊版紀錄不因本地化變成新發布。原資料修訂： 2026年10月17日

先看報錯，不要把查不到更新當成已是最新版

官方 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 範圍。