F1-2: 迁移 claude-design 原型壳层到 eip4-web

新增 src/shell/(AppShell/Topbar/SideMenu/TabBar/GlobalSearch/SettingsDrawer/theme.css)
和 src/components/ui/(Icon/Dialog/Drawer/Toast/Pagination),
src/api/menu.ts 含 GET /api/menu + 404 降级;
App.tsx 路由改为 AppShell <Outlet> 包裹,登录/待办/amis 渲染三页功能保持不变。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-06-11 20:07:23 +08:00
parent 82e01f893a
commit 0e5d42debc
15 changed files with 1513 additions and 18 deletions

209
src/shell/AppShell.tsx Normal file
View File

@@ -0,0 +1,209 @@
// AppShell — 登录后整体布局:左侧栏 + 顶栏 + Tab 条 + 内容区
// 替代原 AppLayout.tsx;多 Tab 状态存 localStorage 恢复。
//
// 【Tab 设计取舍说明】
// 内容区直接由 react-router <Outlet> 渲染当前路由,切 Tab = navigate(),
// 不做 keep-alive(切 Tab 重新挂载组件)。
// 原因:keep-alive 需要将所有 Tab 内容同时挂载在 DOM 中,对 amis 渲染宿主
// 会产生大量隐藏实例,内存/副作用难以控制。当前阶段优先保证正确性,
// keep-alive 作为后续优化项。
import { useCallback, useEffect, useState } from 'react';
import { Outlet, useLocation, useNavigate } from 'react-router-dom';
import { getProfile } from '../auth/token';
import { collectLeaves, fetchMenu } from '../api/menu';
import type { MenuLeaf } from '../api/menu';
import { ToastHost } from '../components/ui/Toast';
import { Topbar } from './Topbar';
import { SideMenu } from './SideMenu';
import { TabBar } from './TabBar';
import type { Tab } from './TabBar';
import { SettingsDrawer, initTheme } from './SettingsDrawer';
const TABS_KEY = 'eip4-tabs';
const ACTIVE_KEY = 'eip4-active-tab';
// 初始 Tab:「待办」作为保底 Tab,不可关闭
const TODO_TAB: Tab = { key: '/todo', title: '待办' };
function loadTabs(): Tab[] {
try {
const raw = localStorage.getItem(TABS_KEY);
if (raw) {
const parsed = JSON.parse(raw) as Tab[];
if (Array.isArray(parsed) && parsed.length) return parsed;
}
} catch {
// 忽略
}
return [TODO_TAB];
}
function loadActiveKey(tabs: Tab[]): string {
try {
const a = localStorage.getItem(ACTIVE_KEY);
if (a && tabs.some((t) => t.key === a)) return a;
} catch {
// 忽略
}
return tabs[0].key;
}
// 初始化主题(刷新后恢复 localStorage 中的设置)
initTheme();
export function AppShell() {
const navigate = useNavigate();
const location = useLocation();
const [tabs, setTabs] = useState<Tab[]>(loadTabs);
const [activeKey, setActiveKey] = useState<string>(() => loadActiveKey(loadTabs()));
const [collapsed, setCollapsed] = useState(false);
const [showSettings, setShowSettings] = useState(false);
const [leaves, setLeaves] = useState<MenuLeaf[]>([]);
const profile = getProfile();
// 同步 activeKey 跟随浏览器地址(直接输入 URL / 后退前进)
useEffect(() => {
const path = location.pathname;
// 若当前路径不在 tab 列表中则不自动新增(由菜单点击触发)
if (tabs.some((t) => t.key === path)) {
setActiveKey(path);
}
}, [location.pathname, tabs]);
// 持久化 tabs
useEffect(() => {
try {
localStorage.setItem(TABS_KEY, JSON.stringify(tabs));
} catch {
// 忽略
}
}, [tabs]);
// 持久化 activeKey
useEffect(() => {
try {
localStorage.setItem(ACTIVE_KEY, activeKey);
} catch {
// 忽略
}
}, [activeKey]);
// 加载菜单叶子供全局搜索使用(404/失败时 leaves 为空,搜索框显示空结果)
useEffect(() => {
fetchMenu()
.then((data) => {
const all: MenuLeaf[] = [];
for (const root of data.roots ?? []) {
all.push(...collectLeaves(root.children ?? [], [root.name]));
}
setLeaves(all);
})
.catch(() => {
// 忽略,搜索降级为空结果
});
}, []);
// 打开/激活一个 Tab
const openTab = useCallback(
(key: string, title: string) => {
setTabs((prev) => {
if (prev.some((t) => t.key === key)) return prev;
return [...prev, { key, title }];
});
setActiveKey(key);
navigate(key);
},
[navigate],
);
// 从菜单点击触发(templateId → /page/:templateId)
const handleMenuOpen = useCallback(
(templateId: string) => {
if (templateId === '__todo__') {
openTab('/todo', '待办');
return;
}
openTab(`/page/${templateId}`, templateId);
},
[openTab],
);
// 全局搜索点击(叶子 templateId)
const handleSearchOpen = useCallback(
(templateId: string) => {
// 用菜单 leaves 找到真实 title
const leaf = leaves.find((l) => l.templateId === templateId);
openTab(`/page/${templateId}`, leaf?.name ?? templateId);
},
[openTab, leaves],
);
// 切换 Tab(只切换路由,不增删)
const handleActive = useCallback(
(key: string) => {
setActiveKey(key);
navigate(key);
},
[navigate],
);
// 关闭 Tab
const handleClose = useCallback(
(key: string) => {
setTabs((prev) => {
const next = prev.filter((t) => t.key !== key);
// 至少保留「待办」tab
const safe = next.length ? next : [TODO_TAB];
// 若关闭的是当前激活 tab,激活相邻 tab(优先右侧)
if (key === activeKey) {
const idx = prev.findIndex((t) => t.key === key);
const nextActive = safe[Math.min(idx, safe.length - 1)].key;
setActiveKey(nextActive);
navigate(nextActive);
}
return safe;
});
},
[activeKey, navigate],
);
return (
<div className="app">
<Topbar
leaves={leaves}
profile={profile}
onOpenTodo={() => handleActive('/todo')}
onOpenTemplate={handleSearchOpen}
onOpenSettings={() => setShowSettings(true)}
/>
<div className="app-main">
<SideMenu
collapsed={collapsed}
activePath={activeKey}
onOpen={handleMenuOpen}
onToggle={() => setCollapsed((c) => !c)}
/>
<div className="app-work">
<TabBar
tabs={tabs}
activeKey={activeKey}
onActive={handleActive}
onClose={handleClose}
/>
<div className="app-pages">
{/* react-router Outlet 渲染当前路由内容 */}
<Outlet />
</div>
</div>
</div>
<ToastHost />
{showSettings ? <SettingsDrawer onClose={() => setShowSettings(false)} /> : null}
</div>
);
}