项目简介
本页介绍刻晴生日会网站的项目背景、功能清单、技术栈与配置驱动的设计理念，帮助二次开发者快速了解项目全貌。
刻晴生日会（keqing-birthday-2026）是原神角色「刻晴」同人生日庆祝活动的官方网站前端，由刻晴生贺组「玉衡一心定天衡」制作。
玉衡星刻晴的生日即将到来，我们正在筹备一场庆典。无论你是创作者还是粉丝，都欢迎加入我们。
网站功能
| 功能 | 说明 |
|---|---|
| 首页招募与倒计时 | Hero 大标题 + 生日倒计时，到点自动跳转下一年 |
| 历年生日贺图轮播 | 基于 Swiper 的自动播放轮播 |
| 核心贡献者展示 | 首页卡片展示，可跳转 B 站个人空间 |
| 全部贡献者页面 | /contributors 独立页面，懒加载 |
| 招募信息 | 图标卡片式招募板块，图标可配置 |
| 音乐播放器 | 全局悬浮播放器，列表 / 单曲 / 随机三种模式 |
| 暗色 / 亮色主题 | 浅色、深色、跟随系统三档切换 |
| 粒子背景动画 | 星空、花瓣 / 粒子、雾气闪电、页脚粒子 |
技术栈
- React 19 — UI 框架
- Vite 8 — 构建工具
- Tailwind CSS 3 — 原子化 CSS
- React Router 7 — 路由
- Swiper 12 — 轮播图
- Lucide React — 图标
- LXGW Neo ZhiSong / LXGW WenKai — 中文字体
- Playwright — 构建后预渲染（SEO）
设计理念：配置驱动
本项目最重要的设计决策是：全站内容的唯一来源是三个配置文件。
- 修改站名、群号、生日日期、备案号：编辑
site.config.js - 修改文案、图片、贡献者、歌单、页脚：编辑
content.config.js - 修改配色、字体、特效、卡片风格：编辑
theme.config.js
这些字段由组件自动消费，无需修改任何 JSX 代码。详见 配置手册。
开源与版权
- 网站代码基于 MIT 许可证 开源，欢迎其它生贺组 fork 改造。
- 本项目为玩家同人作品，非官方内容。所涉及的游戏角色、图像、音乐等素材版权归 miHoYo / HoYoverse 所有。