diff --git a/apps/frontend/index.html b/apps/frontend/index.html
index 12817a76..3c50798d 100644
--- a/apps/frontend/index.html
+++ b/apps/frontend/index.html
@@ -12,6 +12,22 @@
运营后台管理中心
+
diff --git a/apps/frontend/src/hooks/useThemeMode.tsx b/apps/frontend/src/hooks/useThemeMode.tsx
new file mode 100644
index 00000000..a3e53af9
--- /dev/null
+++ b/apps/frontend/src/hooks/useThemeMode.tsx
@@ -0,0 +1,86 @@
+import { createContext, useContext, useEffect, useMemo, useState, type ReactNode } from 'react'
+
+import {
+ applyThemeToDom,
+ getStoredThemePreference,
+ getSystemTheme,
+ resolveEffectiveTheme,
+ setStoredThemePreference,
+ type ResolvedTheme,
+ type ThemePreference,
+} from '@/utils/theme-mode'
+
+export interface ThemeContextValue {
+ preference: ThemePreference
+ resolvedTheme: ResolvedTheme
+ isDark: boolean
+ setPreference: (pref: ThemePreference) => void
+}
+
+const ThemeContext = createContext(null)
+
+export function ThemeProvider({ children }: { children: ReactNode }) {
+ const [preference, setPreferenceState] = useState(() =>
+ getStoredThemePreference(),
+ )
+ const [systemTheme, setSystemTheme] = useState(() => getSystemTheme())
+
+ useEffect(() => {
+ if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') {
+ return
+ }
+ const media = window.matchMedia('(prefers-color-scheme: dark)')
+ const handleChange = (e: MediaQueryListEvent | MediaQueryList) => {
+ setSystemTheme(e.matches ? 'dark' : 'light')
+ }
+
+ // 初次主动同步一次,避免渲染初始差
+ setSystemTheme(media.matches ? 'dark' : 'light')
+
+ if (typeof media.addEventListener === 'function') {
+ media.addEventListener('change', handleChange)
+ return () => media.removeEventListener('change', handleChange)
+ }
+ // 兼容 Safari 旧版
+ media.addListener(handleChange)
+ return () => media.removeListener(handleChange)
+ }, [])
+
+ const resolvedTheme = resolveEffectiveTheme(preference, systemTheme)
+ const isDark = resolvedTheme === 'dark'
+
+ useEffect(() => {
+ applyThemeToDom(resolvedTheme)
+ }, [resolvedTheme])
+
+ const setPreference = (newPref: ThemePreference) => {
+ setStoredThemePreference(newPref)
+ setPreferenceState(newPref)
+ }
+
+ const value = useMemo(
+ () => ({
+ preference,
+ resolvedTheme,
+ isDark,
+ setPreference,
+ }),
+ [preference, resolvedTheme, isDark],
+ )
+
+ return {children}
+}
+
+export function useThemeMode(): ThemeContextValue {
+ const context = useContext(ThemeContext)
+ if (!context) {
+ const fallbackTheme = resolveEffectiveTheme('system')
+ return {
+ preference: 'system',
+ resolvedTheme: fallbackTheme,
+ isDark: fallbackTheme === 'dark',
+ setPreference: () => {},
+ }
+ }
+ return context
+}
diff --git a/apps/frontend/src/layouts/AdminLayout.tsx b/apps/frontend/src/layouts/AdminLayout.tsx
index 63cf4060..46635e88 100644
--- a/apps/frontend/src/layouts/AdminLayout.tsx
+++ b/apps/frontend/src/layouts/AdminLayout.tsx
@@ -6,16 +6,19 @@ import {
BranchesOutlined,
BugOutlined,
DashboardOutlined,
+ DesktopOutlined,
FileSearchOutlined,
LogoutOutlined,
LineChartOutlined,
MenuFoldOutlined,
MenuUnfoldOutlined,
+ MoonOutlined,
OrderedListOutlined,
RobotOutlined,
SafetyCertificateOutlined,
SettingOutlined,
SoundOutlined,
+ SunOutlined,
TeamOutlined,
ThunderboltOutlined,
TrophyOutlined,
@@ -69,6 +72,8 @@ import {
shouldPrependAdminWorkOrder,
} from '@/utils/admin-realtime-work-orders'
import { useRealtimeEvents, type RealtimeEvent } from '@/hooks/useRealtimeEvents'
+import { useThemeMode } from '@/hooks/useThemeMode'
+import type { ThemePreference } from '@/utils/theme-mode'
import {
hasRemainingTimerDelay,
MAX_TIMER_DELAY_MS,
@@ -93,6 +98,24 @@ export default function AdminLayout() {
const [soundEnabled, setSoundEnabled] = useState(
() => window.localStorage.getItem(NOTIFICATION_SOUND_KEY) === '1',
)
+ const {
+ preference: themePref,
+ resolvedTheme,
+ isDark,
+ setPreference: setThemePref,
+ } = useThemeMode()
+
+ const themeTooltip = useMemo(() => {
+ if (themePref === 'system') {
+ return `外观模式:跟随系统 (${isDark ? '深色' : '浅色'})`
+ }
+ return themePref === 'dark' ? '外观模式:深色模式' : '外观模式:浅色模式'
+ }, [themePref, isDark])
+
+ const themeIcon = useMemo(() => {
+ if (themePref === 'system') return
+ return isDark ? :
+ }, [themePref, isDark])
const adminSessionQuery = useQuery({
queryKey: ['admin-session'],
@@ -480,6 +503,22 @@ export default function AdminLayout() {
+ , label: '跟随系统' },
+ { key: 'light', icon: , label: '浅色模式' },
+ { key: 'dark', icon: , label: '深色模式' },
+ ],
+ onClick: ({ key }) => setThemePref(key as ThemePreference),
+ }}
+ placement="bottomRight"
+ >
+
+
+
+