SuperAPI AI 工具集

i18n

前端与建站

查看项目

更新于 10-15 22:38

技能介绍

用途:为 aionui 项目提供国际化(i18n)标准与工作流,确保所有用户可见文本都走翻译机制,避免硬编码中英文。

主要能力与规范:以 src/common/config/i18n-config.json 为唯一事实来源,读取当前支持语言与模块列表,不假设固定数量。键使用命名空间点号写法,如 t('module.key') 或 t('module.nested.key');键名用 camelCase,通用文案放 common.json,功能文案放对应模块。常见后缀包括 title、placeholder、label、success/error、confirm、empty、tooltip。

使用方式:新增文案时先读配置,再搜索已有键复用;选择合适模块;把新键加入 supportedLanguages 中每个语言目录;组件中用 useTranslation 的 t() 调用;最后依次运行 bun run i18n:types 与 node scripts/check-i18n.js,两者都通过再提交。新增模块需先更新配置的 modules 数组,再在各语言目录创建 JSON 并在 index.ts 中导入导出。

限制与注意:禁止在 JSX 中硬编码中英文(注释、调试输出、内部常量除外);i18n-keys.d.ts 为自动生成,不可手改;缺任一语言键会导致 CI 校验失败;zh-TW 部分术语需人工复核(如视频/影片、软件/軟體、信息/訊息、默认/預設)。插值用 {{count}} 等,复杂标记用 Trans 组件。

适用场景:为 aionui 添加新界面文案、创建新组件、新增翻译模块或维护多语言一致性时使用。