v1.3.5 | Apologies

[yuzeguitarist]

---

Release Notes v1.3.5

TL;DR

• 下载校验失败时自动恢复
  下载后遇到大小或哈希不匹配时，Deck 现在会先尝试恢复和重新确认，而不是直接报出致命错误。
  When a downloaded package fails size or hash validation, Deck now attempts recovery and reconfirmation before surfacing a fatal error.

• 更新信息会在安装中动态刷新
  如果安装过程中可用更新已经发生变化，更新弹窗会自动切换到最新信息，避免继续安装过期快照。
  If the available update changes during installation, the update prompt now refreshes to the latest info instead of continuing with a stale snapshot.

• 边缘缓存导致的误判更少
  针对旧缓存和边缘节点未同步完成的情况，Deck 会刷新元数据、追加 cache-bust 下载并自动重试一次。
  Deck now refreshes metadata, adds cache-busting to retry downloads, and automatically retries once when stale cache or edge-node lag is suspected.

优化 / Improvements

• 恢复流程更贴近真实场景
  下载校验异常后，Deck 会重新拉取最新元数据并根据实际情况决定后续处理路径，让升级流程更稳健。
  After a validation mismatch, Deck re-fetches the latest metadata and chooses the next step based on the current update state for a more resilient upgrade flow.

• 错误提示更易理解
  这类下载异常现在会显示更贴近场景的提示，不再只剩下笼统的“大小不一致”原始报错。
  Download validation failures now show clearer, scenario-specific messaging instead of only a generic "size mismatch" style error.

变更 / Changes

• 版本变化需要重新确认
  如果恢复过程中发现远端版本已经变化，Deck 会更新本地记录，并提示你基于最新版本重新确认安装。
  If recovery detects that the remote version has changed, Deck updates the local record and asks you to confirm installation again against the latest version.

• 同版本资源变更会切换到新包
  如果版本号未变但安装资源已更新，Deck 会刷新到新的安装包信息，并要求重新确认后继续。
  If the version stays the same but the underlying asset changes, Deck refreshes to the new package information and requires reconfirmation before continuing.

修复 / Fixes

• 边缘节点延迟导致的校验误报
  当元数据没有变化时，Deck 会将其视为边缘节点同步延迟，短暂等待后自动重试下载一次。
  When metadata is unchanged, Deck now treats the mismatch as likely edge propagation delay and automatically waits briefly before retrying the download once.

• 旧缓存包导致的重复下载失败
  重试下载现在会附带 cache-bust URL，尽量绕开陈旧缓存，减少反复命中旧安装包的问题。
  Retry downloads now use cache-busting URLs to avoid stale caches and reduce repeated failures caused by outdated packages.

• 更新弹窗持有旧快照的问题
  如果安装途中发现可用更新已经变更，当前更新弹窗会切换到新的更新信息，而不是继续沿用旧快照。
  If the available update changes mid-install, the current update prompt now switches to the new update info instead of holding onto the old snapshot.

升级建议 / Upgrade Notes

• 建议直接升级
  此更新主要提升更新下载与确认流程的稳定性，尤其能减少缓存或同步延迟造成的误报与卡死体验。
  This release mainly improves the reliability of the update download and confirmation flow, especially for failures caused by cache staleness or propagation lag.

---

---

This discussion was created from the release v1.3.5 | Apologies.