useAiWork开发者文档
出海开发

面向海外市场的国际化与 SEO

同步语言路由、消息、内容、搜索 metadata 与索引。

当前基础

语言配置在 src/config/index.ts,next-intl routing 在 src/i18n/routing.ts。默认语言中文使用无前缀路径,其他语言按配置使用前缀。不要只根据 README 判断语言范围,检查运行时配置与实际路由。

消息通过 src/i18n/catalogs.ts 显式导入,页面按模块加载。新增语言要同步配置、消息目录、catalog 注册、页面作用域与日期金额格式。

产品语言与文档语言

开发者文档只提供中文。产品面向海外用户时可扩展对应语言界面,但不需要为本次技术文档生成英文副本。

AI 指令独立于 UI 翻译,当前存在中文与英文实现。扩展新语言必须同步系统提示词、任务输出标签、邮件和错误信息,并验证事实引用逻辑。

搜索元信息

检查 src/lib/metadata.ts、公开页的 generateMetadata、src/app/sitemap.ts 和 src/app/robots.ts。

当前通用 metadata 的 Open Graph locale 固定为 en_US,语言 alternates 也不是完整的 hreflang 映射。出海发布前应按真实页面语言补齐;不能声称切换消息后 SEO 已自动完成。

项目验证方式
canonical
每页指向唯一正式域名与规范语言路径
hreflang
只引用真实可访问的语言版本,双向对应
sitemap
不收录不存在的语言页、私有页面或重复路径
OG 与分享卡片
标题、描述、图片与页面语言一致
robots
与需公开收录的页面范围一致
语言跳转
保留当前路径,默认语言不重复加前缀

内容策略

围绕目标用户的具体任务组织博客与落地页,而不是批量翻译同一段营销文案。技术文档中引用的源码路径和代码标识保持原样,中文解释说明用途。

修改语言加载后运行 src/test/i18n 的相关测试,并直接访问默认和非默认语言页确认渲染。

本页目录