Refresh settings page in realtime

2026-04-07 18:43:26 +08:00
parent 07ecce3d0d
commit d1e5a1ac5e
7 changed files with 204 additions and 1 deletions
--- a/docs/superpowers/specs/2026-04-07-settings-page-realtime-design.md
+++ b/docs/superpowers/specs/2026-04-07-settings-page-realtime-design.md
@@ -0,0 +1,21 @@
+# 设置页实时刷新 Design
+
+## 目标
+
+让 Web 设置页 `/me/settings` 在用户设置被其他窗口或设备修改后自动刷新。
+
+## 范围
+
+本轮只处理设置页：
+
+- 新增 `settings.updated` SSE 事件
+- `updateUserSettings` 写入成功后发布 `settings.updated`
+- `/me/settings` 页面通过 `RealtimeRefresh` 监听 `settings.updated`
+
+不处理 `devices/add`、`me/security` 和根重定向页；这些页面没有同等价值的实时刷新需求。
+
+## 验证
+
+- 页面接线测试确认设置页渲染 `RealtimeRefresh` 并监听 `settings.updated`
+- 状态事件测试确认 `updateUserSettings` 会发布 `settings.updated`
+- 跑相关 realtime 测试、`npm run lint`、`npm run build`