站点配置

本 CMS 的配置分为三层：数据库 informations 表内存储的 value、site.config.ts 内定义的字面量和 .env 内存放的环境变量。

数据库内存储的设置项我会在【后台管理（目前还没撰写）】章节中介绍，这里介绍后两项，详细的配置项说明请参见【配置说明（目前还没撰写）】。

site.config.ts

site.config.ts 位于项目根目录，放的是构建期就要确定的值：PWA manifest、CSP 策略、CDN 资源前缀、功能开关、社交链接、SEO 默认文案。改完必须重新构建，开发环境 Nuxt 会自动重启服务器。

它同时兼任兜底：站名、域名、描述、首页文案这些运行时设置实际存在 informations 表里、由后台管理，这里的同名值只在数据库没有值时生效，所以改站名等相关配置要去后台。

因为这里不存放敏感值，不常更新，配置项为云服务，跨机器也能用，因此我选择让 Git 跟随它。

在开发环境，它会被 app、server 和 nuxt.config.ts 读取。构建时，某些可选项（如小程序 API 是否进生产包）也依赖 nuxt.config.ts，像 .env 一样被固化进生产包，修改后只能重新构建。

site.config.ts 的配置项说明请参见【配置说明（目前还没撰写）】。

修改 .env

.env 存放环境变量和密钥，跟部署环境走、不进版本库，模板是 .env.example。数据库连接 DB_* 五项必填，其余留空也能启动。

模板每一节都标了生效时机：【运行时】的改完重启进程即可，【构建期】的必须重新构建，【部署脚本】的只被 scripts/ 下的脚本读取。开发环境改完重启 bun run dev。

.env 的环境变量说明请参见【环境变量说明（目前还没撰写）】。