SuperAPI AI 工具集

objectstack-i18n

通用与其它

查看项目

更新于 10-16 02:35

技能介绍

用途:为 ObjectStack 应用编写与配置国际化翻译包,覆盖对象与字段标签、视图文本、应用导航字符串、自动化消息等界面文案,并配置默认语言、支持语言与回退语言。

主要能力:在 objectstack.config.ts 中通过 i18n 配置 defaultLocale、supportedLocales、fallbackLocale;用 defineTranslationBundle 按 locale 组装 TranslationData 并注册到 stack。可翻译对象级 label/pluralLabel/description、fields 的 label/help/placeholder/options、_views、_actions、_sections、_tabs、_validations,以及顶层 apps、messages、globalActions、dashboards、datasets、pages、flows 等分组。

使用方式:推荐按 locale 分文件(如 src/translations/{en,zh-CN}.ts + index.ts)再用 defineTranslationBundle 汇总。命令示例:os i18n extract --locales=zh-CN --out=./src/translations 生成骨架;os i18n check --locales=zh-CN 校验覆盖;os i18n extract <config> --check 校验生成文件是否过期;os lint --i18n-strict 合并覆盖检查。消息仅支持双花括号 {{variable}} 插值,需在应用代码中处理复数。

限制:对象名与字段键必须为 snake_case 且与 schema 一致,选项键须用存储值而非显示标签;无 ICU MessageFormat;os i18n extract 默认仅生成 objects/globalActions 子树,其他分组需加 --no-objects-only 或手写;getCoverage/suggestTranslations 等可选契约方法无内置实现。