界面设置模块（uiSettings.ts）

模块路径：web_rviz/src/uiSettings.ts

用途

管理界面语言与主题的持久化偏好，并负责应用静态文案翻译。

公开接口

`Language`

en
zh

`ThemeMode`

dark
light

`TranslationKey`

由内置英文翻译表推导出的合法翻译键联合类型。

`loadLanguage(): Language` / `saveLanguage(language): void`

从 localStorage 读取或保存当前界面语言。

`loadTheme(): ThemeMode` / `saveTheme(theme): void`

从 localStorage 读取或保存当前界面主题。

`t(language, key, vars = {})`

返回 key 对应的翻译文本，并使用 vars 对 {name} 形式的占位符做替换。

`applyStaticTranslations(language): void`

更新 document.documentElement.lang、document.title，以及所有带有 data-i18n 的元素文本。

`applyTheme(theme): void`

把当前主题写入 document.documentElement.dataset.theme，供 CSS 主题选择器使用。

行为说明

未保存历史偏好时，默认语言为 zh。
未保存历史偏好时，默认主题为 light。
t() 会优先回退到英文翻译，其次回退到原始 key。
applyStaticTranslations() 只负责静态标签；运行时动态文本仍应在渲染时显式调用 t()。