用途:该技能为使用 Better i18n 构建国际化功能提供指导,覆盖翻译键管理、本地化工作流、AI 翻译、GitHub 同步与 CDN 分发等场景。
架构:Better i18n 是 GitHub 优先的本地化平台,流程为仓库经 AST 解析与键发现、GitHub 同步,进入平台进行 AI 翻译与人工审批,再经全球 CDN 边缘缓存交付给 React/Next.js、Vite/TanStack 或任意框架。CDN 地址结构为 https://cdn.better-i18n.com/{org}/{project}/{resource},资源包括 manifest.json、{locale}.json、{locale}/{namespace}.json 和 flags/{code}.svg。
主要能力与用法:新项目先创建项目并配置 i18n.config.ts,再用 CLI 扫描代码库中的硬编码字符串;已有代码库可运行 better-i18n scan,借助 AST 解析区分界面文本与开发者符号。需要快速翻译时使用 AI 翻译,建议先建立术语表以保证术语一致。Next.js 可用 @better-i18n/next(集成 next-intl,支持 ISR、带认证回调的中间件和自动 CDN 获取);Vite/TanStack Start 可用 @better-i18n/use-intl 或 TanStack Start 的完整 SSR。使用 Claude、Cursor 等 AI 助手时可通过 MCP 集成安装 MCP 服务器,在 IDE 内创建、更新、删除键和添加语言。CI/CD 中可用 better-i18n check:missing 在翻译不完整时使构建失败。
URL 与缓存:默认语言不带前缀(如 /about),其他语言带前缀(如 /tr/about、/de/about),并配合 hreflang。manifest 浏览器与 CDN 缓存均为 5 分钟,messages 为 1 小时,flags 为 1 年且不可变,发布时失效。
限制:资料未提供具体收费、价格、平台支持范围及效果数据,暂未提供。