# 设计：多语言支持

## 架构

应用使用 `react-i18next` 进行国际化，并配合 `i18next-browser-languagedetector` 进行语言检测。配置集中在 `src/localization/i18n.ts` 中。

### 语言资源

翻译资源将作为 JSON 对象构建在 `i18n.ts` 中（如果太大则分文件）。
我们将在 `resources` 对象中添加 `zh-CN` 键。

### 默认语言策略

我们将引入 `LanguageDetector` 插件。
`i18n.use(LanguageDetector).init({...})` 将被配置为首先检查 `localStorage`，然后检查 `navigator`（浏览器/系统语言）。
`fallbackLng` 将保持为 `'en'`，作为最后的兜底。

### 键映射

我们将把现有的英文字符串映射到语义键（例如 `home.title`, `settings.theme`）。

## 数据流

1. 应用启动。
2. `i18next` 初始化，通过 `LanguageDetector` 确定语言：
   * 检查 `localStorage` 是否有保存的偏好。
   * 如果无，检查 `navigator.language`。
   * 如果检测到的语言受支持（`en` 或 `zh-CN`），则使用该语言。
   * 否则，使用 `fallbackLng` (`en`)。
3. 组件使用 `useTranslation` hook 根据当前语言获取字符串。