认识 Horizon UI · 16/17：八种语言的本地化
译自英文原文：Meet Horizon UI · 16/17: Localization in Eight Languages。
这是 Meet Horizon UI 系列的第十六篇，仍然属于第五幕 make it yours & adopt。上一篇讲到，整个控制台都由 template 驱动。本地化也建立在这个基础上：Horizon 支持八种语言，每种翻译都是覆盖在同一套 template 上的一层 overlay。它不是 fork 出一份 dashboard，也不是每次渲染图表时重新翻译。
翻译是 overlay，在服务端合并一次
每个非英语 locale 都是一份 overlay catalog，覆盖在英语 source template 上。BFF 返回 template 时，会根据请求头里的语言选择，把 overlay 合并到 source 上一次，再返回本地化后的 template。翻译只在服务端解析一次，不会在每个图表加载时再处理。合并逻辑也比较宽容：overlay 会 deep-merge 到 source 上；没有翻译到的 leaf 会回退到英语，所以一份只翻了一半的 catalog 也是有效的。新增或修正语言，本质上就是编辑 overlay，不需要改 source dashboard。
这里有一条刻意划清的边界：哪些内容会翻译，哪些不会。会翻译的是界面 chrome，例如 widget title、tip、label、menu alias。但 OAP 提供的数据不会翻译：service、instance、endpoint 名称，tags，log line，alarm rule name，span operation，都会按后端返回的原样展示。SkyWalking、Kubernetes、Envoy 这类产品或协议名，MQE 表达式，以及 RPM / P95 / SLA 这样的代码和缩写，也保持原样。
点一下就能翻译
本地化不需要手写 JSON。Admin → Translations 会给出目标语言的 live preview：选择 template 和 language，点击任意 widget，右侧面板会列出可以翻译的字段：上方是英语 source，下方是你的翻译。每种语言都有进度计数，模板那篇提到的草稿模型也同样适用：Stage local 把改动保存在浏览器里，Check diff & push 把 overlay 发布到 OAP，Export / Import 可以把某种语言的翻译作为 JSON 文件迁移。
图 1：Translations 管理页：选择语言（这里是 Français），在 live preview 中点击任意 widget，就可以输入翻译。title 和 tip 会翻译；RPM / P95 / SLA 这类代码保持原样，OAP 提供的所有值也保持原样。
八种语言，按设备选择
Horizon 正式支持八种 locale：English 是 source，另外还有 Deutsch、Español、Français、日本語、한국어、Português、中文（简体）。你可以从顶栏的 language chip 切换语言；所有页面都支持，包括登录前的 login 页面。选择会按当前设备持久化。
图 2：顶栏 language chip：八种正式支持的语言，English 加 Deutsch、Español、Français、日本語、한국어、Português、中文。每个设备可以独立选择，登录页也能切换。
切换语言后，整个控制台都会跟着变。下面是中文里的 General Service dashboard：sidebar、tabs 和 widget title 都已经本地化，而 API path、service name 和 metric value 仍然按 OAP 返回值展示。你也会看到少数 widget title 还是英语：那几个 leaf 还没有翻译，所以自然回退到 source。这正是 overlay 模型想要的降级方式。
图 3：同一个 General Service dashboard 的中文版本：sidebar、tabs 和 widget title 会本地化；service name、API path 和 metric value 仍然按 OAP 返回值展示。未翻译的 leaf 会回退到英语。
它在哪里运行
Locale 解析发生在 BFF 侧，所以它兼容任意 OAP。发布翻译时，会通过 OAP 11 的 admin host，把 sibling overlay 写入 OAP 的 template store；权限由 overview:write 控制。八种 UI chrome message catalog 是随包内置的，切换时同步生效，不需要额外网络请求。CI 里的 i18n:validate 会检查每个 source template 都有对应 locale 的 overlay，避免 source 和翻译脱节。字段参考，包括哪些字段可翻译、如何新增语言，可以看 i18n 文档。
下一篇，也就是这个系列的收官篇：安装与迁移：安装 Horizon，并把它替换到现有 UI 的位置。