import type React from "react"
// 导入 Next.js 的元数据类型定义
import type { Metadata } from "next"
// 导入全局样式文件
import "./globals.css"
// 导入思源黑体（Noto Sans SC）本地字体
import "@fontsource/noto-sans-sc/400.css"
import "@fontsource/noto-sans-sc/500.css"
import "@fontsource/noto-sans-sc/700.css"
// 导入颜色主题
import "@/styles/themes/bubblegum.css"
import "@/styles/themes/quantum-rose.css"
import "@/styles/themes/clean-slate.css"
import "@/styles/themes/cosmic-night.css"
import "@/styles/themes/vercel.css"
import "@/styles/themes/vercel-dark.css"
import "@/styles/themes/violet-bloom.css"
import "@/styles/themes/cyberpunk-1.css"
import { Suspense } from "react"
import Script from "next/script"
import { QueryProvider } from "@/components/providers/query-provider"
import { ThemeProvider } from "@/components/providers/theme-provider"
// Google Fonts 在中国大陆无法访问，直接使用 fallback 字体
// 导入公共布局组件
import { RoutePrefetch } from "@/components/route-prefetch"
import { RouteProgress } from "@/components/route-progress"
import { AuthLayout } from "@/components/auth/auth-layout"
// 定义页面的元数据信息,用于 SEO 优化
export const metadata: Metadata = {
title: "星环 (Xingrin) - 攻击面管理平台 | ASM",
description: "星环 - 攻击面管理平台 (ASM)，提供自动化资产发现、漏洞扫描、子域名枚举、端口扫描等功能。支持分布式扫描、Nuclei 集成、定时任务。",
keywords: ["ASM", "攻击面管理", "漏洞扫描", "资产发现", "Bug Bounty", "渗透测试", "Nuclei", "子域名枚举", "安全工具", "EASM", "安全"],
generator: "Xingrin ASM Platform",
authors: [{ name: "yyhuni" }],
openGraph: {
title: "星环 (Xingrin) - 攻击面管理平台",
description: "攻击面管理平台 (ASM)，提供自动化资产发现与漏洞扫描",
type: "website",
locale: "zh_CN",
},
robots: {
index: true,
follow: true,
},
}
// 使用思源黑体 + 系统字体回退，完全本地加载
const fontConfig = {
className: "font-sans",
style: {
fontFamily: "'Noto Sans SC', system-ui, -apple-system, PingFang SC, Hiragino Sans GB, Microsoft YaHei, sans-serif"
}
}
/**
* 根布局组件
* 这是整个应用的最外层布局,所有页面都会被包裹在这个组件中
* @param children - 子组件内容,即各个页面的实际内容
*/
export default function RootLayout({
children,
}: Readonly<{
children: React.ReactNode
}>) {
return (
// 设置 HTML 根元素,语言为中文
// suppressHydrationWarning 避免主题切换时的 hydration 警告
{/* 加载外部脚本 - 使用 beforeInteractive 策略确保在页面交互前加载 */}
{/* 路由加载进度条 - 放在最外层 */}
{/* ThemeProvider 提供主题切换功能,跟随系统自动切换亮暗色 */}
{/* 使用 QueryProvider 提供 React Query 功能 */}
{/* 路由预加载：在后台预加载常用页面的 JS/CSS 资源 */}
{/* AuthLayout 处理认证和侧边栏显示 */}
{children}
)
}