内容

模板内容与官网文档不同

Flare 自身的公开内容放在 apps/web/src/content。它是应用内 MDX 内容，不是 musemvp-com 的 Fumadocs 开发者文档，也不读取官网 content/docs。你购买源码后可以独立部署，不需要把官网当成运行依赖。

内容入口在 apps/web/src/modules/public，页面路由在 apps/web/src/routes/$.tsx，SEO 在 apps/web/src/lib/seo.ts，robots 与 sitemap 在 apps/web/src/server.ts。

编辑一篇已有内容

1. 找到对应英文与中文 MDX，例如 docs、blog、changelog 或法律页的文件。
2. 同时维护两种语言的标题、段落、链接与实际产品能力。
3. 用标准 Markdown 标题、列表、链接和代码块；不要粘贴未经审查的脚本或包含密钥的配置。
4. 运行 pnpm dev，访问英文和 /zh 对应页面，检查真实结果。

文件按 <slug>.en.mdx 与 <slug>.zh.mdx 成对存放。当前加载采用 content 目录下的静态 glob，任意新建多层文件夹不会自动变成文章集合。法律页的 legal 前缀在加载时会规范化，改文件名之前先核对现有映射。

新增一个公开页面

仅新增 MDX 不会注册新路由。需要同步：

• routes/$.tsx 的允许路径以及页面分发逻辑。
• modules/public 的页面标题、内容 slug 与导航入口。
• lib/seo.ts 的标题、描述、canonical 和 hreflang。
• server.ts 的公开 sitemap / robots 规则。
• 两种语言的消息、内容和浏览器测试。

未知 URL 应继续返回 404，不能为方便内容加载而把所有路径都变成 200。API 路径与受保护页面也不能加入公开 sitemap。

法律与联系内容

将隐私政策、服务条款、支持邮箱、数据使用、第三方服务与退款描述改为自己的业务情况。不要保留示例公司的承诺或没有实现的能力。联系页的呈现不等于新增了任意表单提交后端；添加提交功能时明确接收方、服务端校验和失败反馈。

内容与发布流程

建议把产品介绍、文档、更新日志和法律变更放进同一 PR，让审查者能对应实际功能。图片放在 public 并使用可访问替代文本；避免依赖登录后才能访问的临时图片 URL。

长代码块在移动端横向滚动，不让整页溢出。中文和英文的链接都应保持正确语言路径，外部链接使用明确目标。

验证与排障

• 页面有标题但正文为空：检查 slug、成对文件名与静态 glob 位置。
• 新文章 404：检查路由允许列表，而非只看磁盘文件是否存在。
• SEO 仍是旧产品：检查 config、消息和 seo.ts，不只改 MDX 标题。
• 运行 pnpm build，检查公开页、404、两种语言以及 sitemap 中只有真实公开地址。

继续阅读 国际化 与 主题组件。