品牌定制

在可能的情况下，通过配置定制 ZShip 站点品牌，无需改代码。

配置文件（后端 vars 无需重建）

功能	配置文件	字段
品牌名与 Logo	apps/web/src/config/site.ts	siteName, brand.name, brand.logo, brand.accentColor
SEO 元数据	apps/web/src/config/site.ts	tagline, description, seo.*
社交链接	apps/web/src/config/site.ts	links.github, links.twitter, links.discord
Dashboard 品牌	packages/dashboard/config/brand.ts	BRAND_NAME, STORAGE_PREFIX
分析	apps/web/src/config/site.ts	analytics.googleAnalytics.measurementId、analytics.plausible.*

分析（Google Analytics 4 与 Plausible）

使用公共 Base 布局的页面会通过 apps/web/src/components/AnalyticsHead.astro 注入统计脚本。只有在 apps/web/src/config/site.ts 的 analytics 中填写有效值时才会加载；留空则不注入。

Google Analytics 4

• 将 analytics.googleAnalytics.measurementId 设为 GA4 测量 ID（格式：G- + 字母数字）。
• 留空或去掉 googleAnalytics 即不加载 gtag.js。

Plausible

• 将 analytics.plausible.domain 设为与 Plausible 后台站点域名一致（如 yoursite.com）。
• 默认脚本地址为 https://plausible.io/js/script.js。
• 自托管： 设置 scriptSrc 为你实例上的脚本 URL（如 https://plausible.example.com/js/script.js）。
• 反向代理： 设置 apiEndpoint 为代理后的 event 接口，对应脚本标签上的 data-api。

可同时启用 GA4、Plausible、两者或都不启用。修改 site.ts 后需重新构建 web 应用。

如何换品牌

1. 编辑 apps/web/src/config/site.ts — 修改 siteName、brand.name、brand.logo
2. 编辑 packages/dashboard/config/brand.ts — 修改 BRAND_NAME（Dashboard 侧边栏）
3. 替换 /public/logo.svg 和 /public/favicon.ico 为你的资源
4. 若使用 Nuxt 应用，同时更新 apps/web-nuxt/app/config/site.ts 和 nuxt.config.ts 的 title

组件覆盖

将文件放在 apps/web/src/overrides/ 可覆盖共享组件，无需修改 packages。zship-resolver 插件会自动解析覆盖。

详见 apps/web/src/overrides/README.md。