⚠️ [Upgrade Notice] Dashboard v2.0.0 — Restart Required / v2.0.0 升级须知：更新后需重启框架

Status: Notice | Applies to: Upgrade 1.x → v2.0.0 | Published: 2026-09-21

状态： 公告 | 适用： 1.x → v2.0.0 升级 | 发布日期： 2026-09-21

---

一、Why / 为什么必须重启

Dashboard v2.0.0 restructured the frontend into modular directories and introduced an "auto-reload after update" mechanism. This means:

Dashboard v2.0.0 对前端做了结构性重构（单文件拆分为模块化 js/ css/ 目录），并新增"升级后自动重载"机制。但这意味着：

1. After updating, the old backend keeps running — the new logic (including auto-reload) lives in the new code on disk, while the in-memory Dashboard is still the old version, which cannot reload itself.
   更新完成后，内存中运行的仍是旧版后端 —— v2.0 的新逻辑（含自动重载）存在于磁盘上的新代码里，而旧版 Dashboard 无法执行它，也无法从面板重载自己；
2. Dashboard itself is the entry point for reloading other modules — after updating itself, the old panel has no working self-reload path.
   Dashboard 本身是重载其它模块的入口 —— 更新它自己之后，旧版面板里没有任何可用的自重载手段；
3. Browser: a normal refresh may still hit the cached single-file dash.js / dash.css (removed and split into new directories in v2.0), producing mixed old/new states.
   浏览器端：普通刷新可能仍命中旧缓存的 dash.js / dash.css（v2.0 已移除并拆分为新目录），出现新旧混合的异常状态。

二、Correct Upgrade Steps / 正确升级步骤

1. Upgrade ErisPulse-Dashboard via Store / Package Management.
   通过 模块商店 / 包管理 完成 ErisPulse-Dashboard 升级；
2. Restart the framework — or unload and reload the Dashboard module at the framework level.
   重启框架 —— 或在框架层卸载并重新加载 Dashboard 模块；
3. Hard refresh the browser (Ctrl + F5 / Cmd + Shift + R), or clear the site cache.
   浏览器 强制刷新（Ctrl + F5 / Cmd + Shift + R），或清除站点缓存；
4. Done — the "Connection Details" panel shows a healthy WS connection and the v2.0 UI is live.
   完成 —— "连接详情"面板 WS 连接正常、界面即为 v2.0 新版。

三、Data Safety / 数据安全

None of the operations above cause any data loss — configuration, storage KV, event history and audit logs are all persisted and restored automatically on restart.

以上任何操作（面板重载 / 重启框架 / 硬重启）均不会导致数据丢失 —— 配置、存储键值、事件与审计历史均已持久化，重启后自动恢复。

四、After v2.0.0 / 后续版本

Upgrades from v2.0.0 onwards will auto-reload the module and refresh the page once the update completes — no manual steps required.

从 v2.0.0 起，后续升级将在完成后自动重载模块并刷新页面，无需任何手动操作。