核心框架
| 技术 | 版本（package.json） | 用途 |
|---|
| React / React DOM | 18.2.0 | UI 框架 |
| React Router DOM | 6.9.0 | 客户端路由 |
| Vite | 8.x | 开发服务器与生产构建 |
| @vitejs/plugin-react | 6.x | Vite 的 React 插件 |
| i18next | 26.x | 国际化 |
| react-i18next | 17.x | React 绑定 |
Node 版本要求：20.19+ 或 22.12+（Vite 8）。推荐 Node 22 LTS。
样式方案
| 技术 | 用途 |
|---|
| Tailwind CSS 3.4.17 | 主要样式，工具类 |
| PostCSS + Autoprefixer | CSS 处理 |
| 内联 Tailwind plugin | text-shadow-* 工具类（写在 tailwind.config.js，不是独立 npm 包） |
| 自定义 keyframes | fadeInUp、fadeInLeft、fadeIn |
主题与扩展
定义在 tailwind.config.js 的 theme.extend：
| Token | 值 | 用途 |
|---|
bured | #B24D4D | 主色 |
bured-deep | #772525 | 加深红 |
bu-stone / bu-ink / bu-muted / bu-gold | 中性色与点缀 | 正文与品牌 |
bu-overlay | rgba(88, 81, 78, 0.67) | CompactPageHeader 遮罩 |
textShadow.md | 灰色文字阴影 | text-shadow-md |
字体通过 index.html 加载 Google Fonts（Source Sans 3、Noto Sans/Serif SC、Source Serif 4）。
UI 与动画
| 库 | 用途 |
|---|
| Framer Motion 12.19 | 动画、下拉菜单、过渡 |
| React Icons 5.5 | 图标 |
| @radix-ui/react-slot | 组件组合 |
| class-variance-authority | 变体样式 |
| clsx + tailwind-merge | 类名合并（cn） |
构建与工具
| 工具 | 说明 |
|---|
| Vite 8 | npm run dev / npm run build / npm run preview |
| 输出目录 | dist/ |
| 开发端口 | 默认 5173 |
| 环境变量 | 当前代码不读取 .env / import.meta.env |
| 自动化测试 | 仓库内无测试脚本与测试框架 |
上游与参考
浏览器支持
package.json 的 browserslist：
- production:
>0.2%, not dead, not op_mini all
- development: 最新 Chrome / Firefox / Safari