Files
gemini-nexus/openspec/changes/localize-app-chinese-default/specs/localization/spec.md
T
2025-12-23 01:38:53 +08:00

1.6 KiB

规格:本地化

ADDED Requirements

Requirement: 自动语言检测

应用在首次启动时 MUST 自动检测用户的系统语言并设置相应的界面语言。

Scenario: 系统语言为中文

Given 用户首次打开应用 And 用户的系统语言设置为中文 (zh-CN) And 本地存储中没有保存语言偏好 When 应用加载时 Then 界面应该显示为简体中文 (zh-CN)

Scenario: 系统语言为其他(非中文)

Given 用户首次打开应用 And 用户的系统语言设置为法语 (fr) And 本地存储中没有保存语言偏好 When 应用加载时 Then 界面应该回退显示为英语 (en)

Requirement: 语言切换

用户 MUST 能够在支持的语言之间切换,且手动选择 MUST 覆盖自动检测。

Scenario: 切换语言

Given 用户在设置页面 When 用户从语言下拉菜单中选择 "English" Then 界面应该立即切换为英语 And 偏好应该保存到本地存储

Requirement: 持久化

用户的手动语言偏好 MUST 在会话之间持久化,并优先于系统语言。

Scenario: 持久化语言偏好

Given 用户已手动选择 "English" 作为首选语言 And 用户的系统语言设置为中文 When 用户重启应用 Then 界面应该显示为英语(尊重用户选择)

MODIFIED Requirements

Requirement: i18n 配置更新

i18n 配置 MUST 更新以支持语言检测插件。

Scenario: i18n 配置

src/localization/i18n.ts 文件必须更新为:

  1. 集成 i18next-browser-languagedetector。
  2. 配置检测顺序:['localStorage', 'navigator']。
  3. 包含 zh-CN 资源对象。