用途:维护 OneKey 应用的多语言翻译,覆盖翻译键的搜索、新增、更新、从 Lokalise 拉取及在代码中使用。
主要能力:通过 yarn i18n:search 本地搜索,通过 yarn i18n:add 新增键,通过 yarn i18n:pull(或 :keychain、:oenv 变体)同步本地生成文件。支持 Lokalise MCP 或 Web 处理已有翻译。
必要用法:禁止修改自动生成文件 translations.ts 与 json/*.json,禁止硬编码文本;始终使用 ETranslations 成员配合 intl.formatMessage。新增键命名用 semantic_key__type 格式。远程变更前须验证 Lokalise 项目名称与 ID,并获取该项目的 lang_iso 列表。yarn i18n:add 只创建 en_US 与可选 zh_CN,需补齐全部仓库语言(当前 19 个 locale JSON)。拉取后检查生成 diff 并在代码中接入枚举成员,校验占位符一致。任何远程 Lokalise 变更或 i18n:pull 前先阅读 i18n.md。
适用场景:涉及新增或更新翻译键、拉取生成文件的 OneKey 前端任务。
限制:不通过校验不得静默跳过仓库语言;若目标项目确实缺少所需语言,应停止上传并报告不匹配。凭据解析不得打印 token,代码变更与生成的语言文件变更应分开审查。