用途:为使用 react-intl-universal 的仓库提供一套组合式国际化实践,覆盖文案编写、默认消息抽取、翻译任务生成、增量审校、合并与审计,目标是让本地化软件在各语言下自然、清晰、可信,并让本地化改动可预测、可评审、可演进。未使用该库的仓库也可参考其通用原则:保持语言质量、避免消息碎片化、保留变量与标签契约。
主要能力:以 intl.get(key, values).d(defaultMessage) 作为文案唯一来源;用 ICU 占位符(如 {username})承载可翻译动态值;用富标签(如 <link>documentation</link>)承载 React 元素;一个用户可见句子对应一个消息键;同一含义使用稳定字面量键;仅依据默认语言差异为已有非默认语言生成翻译任务;提供静态 UI 适配审查,关注紧凑控件换行与视觉完整性;提供 UI 巡检模式,可基于用户提供的页面 URL 做本地化 QA。
使用方式:先查看现有 i18n 配置与抽取命令;修改源码中的 .d(defaultMessage);运行项目抽取命令(如 npm run intl:extract),无则用 npx react-intl-universal-extract --cmd extract --source-path ./src --output-path ./src/locales/en-US.json;推断默认语言;用 create-translation-tasks.mjs --base-ref <ref> 生成任务;用 review-translation-deltas.mjs 审校;用 apply-translation-deltas.mjs 合并;用 audit-changed-locale-keys.mjs 审计变更键;最后用 create-i18n-handoff.mjs 交接。脚本流程还包括 discover-project-i18n.mjs、verify-locale-export.mjs、infer-default-locale.mjs 等。
适用场景:新增或修改业务文案键、同步项目已支持的语言文件、从页面 URL 巡检本地化 UI、发布前质量门禁。
限制:富 React 组件插值需 react-intl-universal@2.14.0 或更高;不要向非默认语言文件运行抽取;不要盲目机器翻译全部语言文件;静态 UI 适配警告只是评审提示,不等于布局已损坏;日常开发流程默认不启动 Browser Use,除非用户要求 UI 巡检或发布质量门禁;动态键与冲突默认值需人工审查。具体收费、价格与平台信息暂未提供。