YoungestSongMo 72ec1a5459 fix: 修复主题切换后首页状态重置 + 首页 UX 优化 + 文档同步 ...

## 根因
  设置页 `navigate('/settings')` 导致 React Router `/*` 的 index
  路由不匹配，HomePage 被卸载重挂载，所有 useState 回到默认值。

  ## 修复（6 文件）
  - event-bus.ts: 新增 OPEN_SETTINGS 事件
  - nav-config.ts: 设置按钮 action: 'navigate' → 'button'，去路由化
  - NavBar.tsx: button case 中 emit(OPEN_SETTINGS)
  - SettingsPage.tsx: 去路由化，改为 Modal 居中叠加 + open/onClose props，
    使用 antd 6.x 正确 API destroyOnHidden（非废弃的 destroyOnClose），
    mask={{ closable: false }} + keyboard={false} 仅允许 X 按钮关闭
  - router/index.tsx: 移除 SettingsPage 渲染
  - App.tsx: 添加 SettingsPage Modal，事件驱动（与 LoginPage 模式一致）

  ## UX 优化（2 文件）
  - HomeContent.tsx: 右侧分隔条移除多余 marginLeft，左右视觉对称
  - BannerCarousel.tsx: 新增关闭按钮，session 级别 useState 隐藏，
    不做 localStorage 持久化，确保每次启动重新展示

  ## 架构原则
  确立 QT 多窗口模型 → Web 映射：叠加层走 Modal/Drawer + 事件总线，
  主页面不卸载；真正的视图切换才用 React Router。

  ## 文档同步
  - TODO.md: 移除已完成项详细记录，精简为未完成待办
  - WORKLOG.md: 追加 2026-06-07 完整工作日志
  - PROJECT.md: 更新路由/叠加层架构说明
  - CHANGELOG.md: 追加 v0.0.13 条目
  - ARCHITECTURE.md: 更新日期 + 新增叠加层模式章节

2026-06-07 05:21:47 +08:00

4.3 KiB

Raw Blame History

View Raw