品牌与上线定制

先用完整 Mock 确认功能，再替换品牌与生产配置。Mock 数据只用于本地体验，正式站必须使用你自己的域名、备案信息、内容和第三方服务凭据。

1. 修改站点身份

编辑 config/community-template.json：

{
  "identity": {
    "name": "你的社区名称",
    "shortName": "社区简称",
    "locale": "zh-CN",
    "filing": {
      "number": "你的备案号",
      "url": "https://beian.miit.gov.cn/"
    }
  }
}

没有备案展示需求时将 filing 设置为 null，页脚不会渲染备案链接。配置校验会拒绝空备案号和非法 URL。

主站 Logo 位于 apps/space/public/logo-square.png，模板说明站 Logo 位于 apps/template-docs/public/logo-square.webp。替换时保持文件名和尺寸比例；VitePress 的设计图、截图和新增内容图片统一使用 WebP。

2. 选择功能与供应商

• 在 modules 中启用或关闭业务模块，先阅读功能配置中的依赖关系。
• 在 providers 中选择当前已实现的存储、支付、邮件、视频和 AI 供应商。
• 修改后运行 pnpm --filter @zaowu/template-core validate:config -- config/community-template.json，不要通过删除页面或注释 API 绕过模块门禁。

3. 配置域名

复制 .env.example 为生产环境变量文件，分别填写主站、认证、API 和对象存储域名。域名必须与 OAuth 回调、支付回调、CORS、Cookie Domain 和 Nginx 配置保持一致。

推荐先使用临时域名完成安装检查，再切换正式 DNS。模板说明站可以部署在独立子域名，例如 template.example.com；生产社区不需要暴露本地 Mock 的 3999 端口或 /__mock/* 路径。

4. 替换内容与法律文本

• 删除示例账号、文章、动态、商品、订单和运营数据；生产环境通过正式迁移与后台创建内容。
• 检查 apps/space/src/app 中的关于页、社区规范、隐私政策和用户协议，使其符合实际经营主体与服务范围。
• 配置自己的支付商户、邮件发件人、对象存储和视频服务；不同环境使用相互隔离的凭据。
• 检查页脚、SEO 标题、分享卡片、客服方式和退款规则。

5. 上线前验收

运行预检、类型检查、测试和生产构建，并按AI 部署完成健康检查。至少用普通访客、付费用户和管理员三个角色验证浏览、购买、下载与后台路径。

当前站点色彩、首页文案和部分法律内容仍属于源码级定制，不是全部都能从 JSON 配置。请把这些改动提交到自己的 Git 仓库，升级新模板版本时再按差异合并。