useAiWork开发者文档
技术架构

路由、国际化与文档内容

理解公开页面、登录页面、语言消息和 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 的用户指南,只配置中文文档树。

新增文档步骤:

  1. 在主题目录创建 .zh.mdx,填写 title 与 description。
  2. 在对应 meta.zh.json 添加文件名,不含 .zh.mdx 后缀。
  3. 使用 /project/... 的文档链接。
  4. 检查导航、正文、页内目录及搜索。

开发者文档没有英文正文,也不提供切换到英文目录的控件。

实现入口

  • 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:开发者文档阅读页。

本页目录