第二部分：项目配置

2.1 环境变量文件

复制示例配置文件：

# Windows
copy .env.example .env.local

# macOS/Linux
cp .env.example .env.local

2.2 基础配置（必需）

# 网站 URL（部署后修改为实际域名
NEXT_PUBLIC_SITE_URL=https://yourdomain.com

# 网站名称
NEXT_PUBLIC_SITE_NAME=FunRadiusP

# 网站描述
NEXT_PUBLIC_SITE_DESCRIPTION=个人博客

# 作者名称
NEXT_PUBLIC_AUTHOR_NAME=Your Name

注意：所有 NEXT_PUBLIC_ 前缀的变量可在客户端代码中访问，请勿存储敏感信息。

2.3 Giscus 评论系统（可选）

前置条件

  1. GitHub 仓库已启用 Discussions
  2. 安装 Giscus App 到仓库

配置步骤

  1. 访问 giscus.app
  2. 按页面提示获取配置信息
  3. 填入环境变量：
NEXT_PUBLIC_GISCUS_REPO=username/repo
NEXT_PUBLIC_GISCUS_REPO_ID=your-repo-id
NEXT_PUBLIC_GISCUS_CATEGORY=Announcements
NEXT_PUBLIC_GISCUS_CATEGORY_ID=your-category-id

禁用方式：留空上述变量即可禁用评论系统。

2.4 Live2D 看板娘（可选）

# 模型路径数组，设为 [] 禁用
NEXT_PUBLIC_LIVE2D_MODELS=["/live2d/model/model.json"]

# 停靠位置：left 或 right
NEXT_PUBLIC_LIVE2D_DOCKED_POSITION=right

# 模型位置 [x, y]
NEXT_PUBLIC_LIVE2D_POSITION=[0, 60]

# 缩放比例
NEXT_PUBLIC_LIVE2D_SCALE=0.08

# 舞台高度
NEXT_PUBLIC_LIVE2D_STAGE_HEIGHT=450

禁用方式：设置 NEXT_PUBLIC_LIVE2D_MODELS=[]

2.5 粒子特效（可选）

# 是否启用
NEXT_PUBLIC_PARTICLES_ENABLED=true

# 类型：petal, leaf, rain, snow, auto
NEXT_PUBLIC_PARTICLES_TYPE=petal

# 粒子数量
NEXT_PUBLIC_PARTICLES_COUNT=50

# z-index 层级
NEXT_PUBLIC_PARTICLES_ZINDEX=0

禁用方式：设置 NEXT_PUBLIC_PARTICLES_ENABLED=false

2.6 其他配置

# 默认主题色
NEXT_PUBLIC_DEFAULT_PRIMARY_COLOR=#ff69b4

# 导航栏自动隐藏
NEXT_PUBLIC_HEADER_AUTO_HIDE_ENABLED=true

2.7 内容页面配置

编辑以下 Markdown 文件自定义内容页面：

  • content/spec/about/index.md - 关于页面
  • content/spec/journey/index.md - 历程页面
  • content/spec/projects/index.md - 项目页面
  • content/spec/information/index.md - 信息页面