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: 更新日期 + 新增叠加层模式章节
This commit is contained in:
2026-06-05 21:03:14 +08:00
parent a8ace232a4
commit 72ec1a5459
15 changed files with 192 additions and 164 deletions

View File

@@ -1,48 +1,47 @@
// ============================================================
// SettingsPage — 设置页面(路由命中 /settings 时以居中 Modal 叠加展示
// SettingsPage — 设置页面(Modal 居中叠加,事件驱动显隐
//
// 核心设计:
// - 独立于 <Routes> 之外,通过 useLocation 判断是否渲染
// - 命中 /settings → Modal 居中弹出,首页内容保持在背景不动
// - 关闭 Modal → navigate(-1),仅可通过 X 按钮关闭
// - destroyOnClose → 关闭即销毁 DOM不堆内存
// - 通过 open/onClose props 控制显隐,不使用路由(避免主页面被卸载)
// - Modal 居中弹出 + 遮罩层,首页内容始终保持挂载不动
// - destroyOnHidden → 关闭即销毁 DOM不堆内存
// - 仅可通过标题栏 X 按钮关闭mask 不可关闭、ESC 禁用)
//
// 对应 QT 原版:设置窗口为独立窗口叠加在主窗口之上,主窗口不销毁
// ============================================================
import {Modal} from 'antd';
import {SettingOutlined} from '@ant-design/icons';
import {useLocation, useNavigate} from 'react-router-dom';
import {useAppContext} from '@/contexts/app-context';
import {ThemeSetting} from './ThemeSetting';
import {StoragePathSetting} from './StoragePathSetting';
import {SystemInfoSetting} from './SystemInfoSetting';
import {UpdateSetting} from './UpdateSetting';
import { Modal } from 'antd';
import { SettingOutlined } from '@ant-design/icons';
import { useAppContext } from '@/contexts/app-context';
import { ThemeSetting } from './ThemeSetting';
import { StoragePathSetting } from './StoragePathSetting';
import { SystemInfoSetting } from './SystemInfoSetting';
import { UpdateSetting } from './UpdateSetting';
export function SettingsPage() {
const location = useLocation();
const navigate = useNavigate();
const {edition} = useAppContext();
const open = location.pathname === '/settings';
interface SettingsPageProps {
open: boolean;
onClose: () => void;
}
export function SettingsPage({ open, onClose }: SettingsPageProps) {
const { edition } = useAppContext();
return (
<Modal
open={open}
width={480}
onCancel={() => navigate(-1)}
onCancel={onClose}
destroyOnHidden={true}
mask={
{
closable: false
}
}
mask={{ closable: false }}
keyboard={false}
footer={null}
title={
<span className="flex items-center gap-2">
<SettingOutlined />
</span>
<SettingOutlined />
</span>
}
styles={{body: {padding: 0, maxHeight: '70vh', overflow: 'auto'}}}
styles={{ body: { padding: 0, maxHeight: '70vh', overflow: 'auto' } }}
>
<div className="flex flex-col gap-4 p-4">
<ThemeSetting />