← 核心概念

Langsys 的工作原理

Langsys 会把您界面中已有的句子变成翻译系统。无需维护密钥文件,也没有构建时的提取步骤——代码中的短语既是查找用的密钥,也是基础语言的默认文本。

短语即是键

在传统的 i18n 中，您需要为每个字符串自创一个标识符，把真实文本存放在语言区域文件中，并永远保持两者同步。Langsys 省去了这层间接关系：您直接写出实际的句子，这个句子本身就是键。

// Traditional i18n — indirection + a keys file to maintain
t('greetings.hello');            // what does this say? open en.json to find out

// en.json
{ "greetings": { "hello": "Hello, {name}!" } }

// Langsys — the phrase IS the key and the base-language default
t('Hello, {name}!', 'Greetings', { name });

由于源文本就是键，同一短语无论出现在应用的哪个位置，都只对应一个可翻译条目——自动去重——而尚未翻译的语言会直接回退到源文本。因此不存在“缺失键”占位符这种情况。

实时与持续

你无需运行任何提取命令。应用渲染时,SDK 会自动发现其使用的短语。新短语会在后台被机器翻译为项目的目标语言环境,应用随后获取完成的翻译目录。今天上线一个新句子,稍后它就会被翻译好,无需重新部署语言包。

生命周期

1. 你的 UI 通过 t()、<Translate> 等方式渲染短语。
2. 在开发环境中,写入密钥可让 SDK 发现并注册任何新短语。
3. Langsys 会将它们机器翻译为你项目的每个目标语言区域。
4. 在生产环境中,只读密钥会获取适用于用户语言区域的完整目录。
5. 切换语言区域,整个界面会立即重新渲染为对应译文,无需重新加载。