技术架构
路由、国际化与文档内容
理解公开页面、登录页面、语言消息和 MDX 内容的组织方式。
页面分区
公开营销与文档页面使用 src/app/[locale] 下的语言路由。登录后的应用和认证页面在 src/app/(app) 中,(app) 是路由组,不出现在 URL 里。
默认语言由 src/config/index.ts 配置。next-intl 使用 as-needed 语言前缀:中文默认路径为 /project,/zh/project 经中间件规范化。其他语言行为以实际 routing 配置为准。
消息模块
翻译消息按功能放在 messages/zh/ 等目录,通过 src/i18n/catalogs.ts 显式导入。页面按作用域加载,避免把全部消息打进每个客户端页面。
界面文案与模型提示词分别维护。修改翻译不会自动修改 AI 系统指令,相关内容见提示词。
开发者文档
中文正文位于 src/content/project/**/*.zh.mdx,目录顺序由各级 meta.zh.json 的 pages 指定。开发者文档集合独立于 src/content/docs 的用户指南,只配置中文文档树。
新增文档步骤:
- 在主题目录创建
.zh.mdx,填写title与description。 - 在对应
meta.zh.json添加文件名,不含.zh.mdx后缀。 - 使用
/project/...的文档链接。 - 检查导航、正文、页内目录及搜索。
开发者文档没有英文正文,也不提供切换到英文目录的控件。
实现入口
src/middleware.ts、src/i18n/routing.ts:语言与访问路由。src/i18n/message-modules.ts:消息加载范围。source.config.ts、src/integrations/fumadocs/source.ts:MDX 集合与文档树。src/app/[locale]/project:开发者文档阅读页。