Configuration Overview

Configuration-Overview

几乎所有开关在 src/config/*.ts，经 @/config 导出；类型在 src/types/。
改站优先改配置，不改布局内核。

• 仓内目录说明：src/config/README.md
• 出厂键表：本地 docs/official/（见 Official-Docs-Map）
• 官方默认 ≠ 本站 — 先看下方差异速查

怎么引用

import { siteConfig, profileConfig } from "@/config";

fork 差异速查

项	本站	别按官方默认抄
评论	commentConfig.type = "waline"	不是 "none"
音乐	musicPlayerConfig.mode = "local"	不是 "meting"
亮暗	themeColor.defaultMode = "time"	不是只认 system
壁纸	有 atmosphere	官方壁纸篇无此节
看板	spritePetConfig.enable	pio Live2D/Spine 默认关
公告	loveLetter 礼盒	官方只有静态公告字段

配置地图

文件	管什么	官方镜像（出厂键表）
siteConfig.ts	站名、site_url、主题色、分页、pages.*、站庆	02-基础配置/站点配置.md
profileConfig.ts	头像、简介、社交；本站可有 avatarFrame	个人资料.md
navBarConfig.ts	导航 / LinkPresets	导航栏.md
sidebarConfig.ts	左右栏 widget（type 须映射一致）	侧边栏.md + 侧边栏小组件.md
backgroundWallpaper.ts	mode、横幅、carousel、atmosphere	背景壁纸.md（无 atmosphere）
displaySettingsConfig.ts	访客设置面板	设置面板.md
commentConfig.ts	评论（本站 waline）	评论系统.md
musicConfig.ts	音乐（本站 local）	音乐播放器.md
petConfig.ts / pioConfig.ts	桌宠 / Live2D·Spine（互斥）	Live2D 篇；桌宠无官方专章
announcementConfig.ts	公告 + loveLetter	公告.md（无礼盒）
collectionsConfig.ts	人工合集	（官方无）
dynamicConfig.ts	动态	动态.md
galleryConfig.ts	相册	相册.md
effectsConfig.ts	樱花等	特效设置.md
analyticsConfig.ts	统计	（见站点配置/分析相关）
fontConfig.ts / expressiveCodeConfig.ts	字体、代码块	字体.md / 代码块.md
mermaidConfig.ts / plantumlConfig.ts	图表	对应功能篇

完整列表以 src/config/ 为准。

页面开关

siteConfig.pages.* = false → 路由 404，导航一般会藏。改完建议自测导航。

主题色（本站习惯）

• defaultMode：time / light / dark / system
• 现行常见：time（站点时区；默认日间亮、夜间暗）
• 壳层中性灰，紫系仅点缀 — 见主仓 CONTEXT.md

下一步

• 功能细节：Wallpaper-and-Atmosphere · Music-Player · Comments-Waline · Sprite-Pets · Sidebar-Widgets
• 发文：Writing-Posts
• 部署：Deploy-Vercel