site.config.js —— 站点信息配置

本页列出 src/config/site.config.js 中的全部配置项，说明每个配置项的类型、默认值与显示位置。

src/config/site.config.js 保存全站最基础的信息：站名、组名、QQ 群号、生日日期、备案号。

这些字段遵循「唯一来源」原则：在配置中只书写一次，页脚、联系方式板块、倒计时等引用位置自动读取，无需重复填写。将本站改造成其他角色的生日会站点时，首先修改本文件。

完整配置一览

完整的 site.config.js 如下：

export const siteConfig = {
  siteName: '刻晴生日会',
  groupName: '玉衡一心定天衡',
  qqGroup: '231786295',
  birthday: {
    month: 11,
    day: 20,
    eventName: '刻晴生日',
  },
  icp: {
    text: '萌ICP备20261127号',
    href: 'https://icp.gov.moe/?keyword=20261127',
  },
};

---

siteName —— 站点名称

siteName 的元信息如下表所示。

项目	说明
类型	字符串
默认值	'刻晴生日会'
显示在哪	页脚品牌区的大字标题

提示

顶部导航栏的站名是写死在 src/components/Navbar.jsx 里的文字与 /favicon.png logo 图片。修改 siteName 后导航栏不会变化，属于正常现象；如需修改导航栏，请直接修改 Navbar 组件（见 改造成你的网站）。

groupName —— 生贺组名称

groupName 的元信息如下表所示。

项目	说明
类型	字符串
默认值	'玉衡一心定天衡'
显示在哪	① 页脚 credits「由 {groupName} 制作」；② 联系方式板块

修改一处，两处引用位置同时生效。

qqGroup —— QQ 群号

qqGroup 的元信息如下表所示。

项目	说明
类型	字符串或纯数字均可
默认值	'231786295'
显示在哪	① 联系方式板块的群号卡片与「复制群号」按钮；② 页脚 credits「QQ群：{qqGroup}」

点击「复制群号」按钮后，该值会被写入剪贴板，并弹出 Toast 提示「复制成功」（正文显示已复制的群号）。

提示

建议写成字符串（带引号），避免数字过大时产生意外问题。

birthday —— 生日倒计时目标

birthday 各字段的含义如下表所示。

字段	类型	默认值	用途
month	数字	11	生日的自然月。11 月就写 11，1 月写 1
day	数字	20	生日的日
eventName	字符串	'刻晴生日'	倒计时文案中的事件名称

倒计时文案格式为：

距离 {目标年份} 年{month}月{day}日{eventName}还有

渲染效果：「距离 2026 年11月20日刻晴生日还有」。

警告

JavaScript 的月份从 0 开始计数（0 = 1 月），但这里的 month 用自然月：写 11 表示 11 月，写 0 会被当成 1 月。配置内部的 Hook 会自动做 -1 转换，只需填写真实月份。

提示

当年生日过后，倒计时会自动把目标切换到下一年同一天，无需每年手动修改。原理见 倒计时。

icp —— 备案信息

icp 各字段的含义如下表所示。

字段	类型	说明
text	字符串	备案号文本，如 '萌ICP备20261127号'。留空字符串 '' 时页脚自动隐藏备案链接
href	字符串	点击备案号时跳转的链接（如萌备案的查询页）

无备案的网站将 text 设为 '' 即可隐藏备案链接，无需删除任何代码。

修改示例：换成另一个角色的生日会

将站点改为另一个角色的生日会时，site.config.js 可以这样写：

export const siteConfig = {
  siteName: '甘雨生日会',
  groupName: '循循守月',
  qqGroup: '123456789',
  birthday: { month: 12, day: 2, eventName: '甘雨生日' },
  icp: { text: '', href: '' }, // 无备案：页脚不显示
};

修改后，页脚、联系方式与倒计时会自动更新。