dsh-version-update

配置（cordis entry config）

• registry（默认 https://registry.npmjs.org）— 读取与安装共用的 registry 基地址，必须是绝对 http(s) URL。若该地址在网络层失败，读取会落到内置镜像并记住它：随后的安装按实际读到版本的那个 registry 执行，不会回去问刚刚超时的地址。
• mirrorRegistry（默认 https://registry.npmmirror.com，淘宝镜像）— 备用源地址。面板上选「淘宝镜像」或点「用淘宝镜像重试」时使用它；auto 不受影响。
• requireSnapshot（默认 true）— 要求安装前必须成功写下快照。开启时快照失败会直接终止安装（FatalPreparationError），npm 根本不会启动，因为"没有回滚点的安装"正是会破坏原版本的那一类。关掉它换回旧行为：快照失败只记日志、照常安装。
• allowRestart（默认 true）— 关闭则不提供重启路由。
• releaseNotes（默认 true）— 是否读取并展示 GitHub 发布说明。
• snapshotKeep（默认 5，1–10）— 快照保留数量。
• snapshotMaxBytes（默认 0 = 不限容量）— 快照载荷总字节配额（不含元数据和符号链接目标）。创建成功后先按数量清理损坏/过旧快照，再按创建时间从旧到新删除可用快照以满足容量限制；始终保留刚创建的快照，即使单个快照已超出配额。旧格式快照缺少体积记录时会现场测量。
• recoverOnFailedRestart（默认 false）— 重启失败时由助手做快照恢复式救援。
• dataDir（默认空 = ~/.dsh-version-update）— 状态目录（policy/history/snapshots） relocatable，便于便携部署。

运行时行为（模式、跟踪、窗口、计划）一律走面板 → /policy，不进 entry config。