Pixeval i18n

维护 Pixeval 的用户可见文本时，遵循资源、引用、生成和验证的完整流程。

Rules

• 将所有需要翻译的用户可见文本放入 src/Pixeval/i18n，只有不需要翻译的专有名词等可以保留为字面量。
• 按语义选择资源文件，避免在页面资源中重复定义跨页面使用的文案。
• 优先复用已有资源键。移动文案时删除旧键，不保留页面资源中的重复键或兼容别名。
• 以 zh-Hans 作为默认语言和资源键来源。新增或迁移字符串时只在 zh-Hans 添加中文值。
• 不要为 en-US、fr-FR、ru-RU 或其他非默认语言新增字符串、补翻译或创建缺失的资源文件。新增、修改、迁移或删除资源时，非默认语言只删除对应的资源条目；若父对象因此为空则一并删除空对象，保留无关的既有内容。
• 不要手动编辑生成的 src/Pixeval/i18n/Language.cs。

References

在 C# 中通过生成的资源类获取文本：

I18NManager.GetResource(BlockedContentResources.BlockTag)

在 XAML 中通过 I18N 标记扩展引用资源：

{I18N {x:Static pixeval:BlockedContentResources.BlockTag}}

不要把资源路径写成字符串，也不要使用未生成的裸资源名。

Workflow

1. 使用 rg 搜索待修改的旧资源键、硬编码文本和所有语言文件中的对应条目。

2. 将通用文案放入默认语言下合适的共享资源文件，只在 zh-Hans 新增或修改中文值，并在所有存在对应条目的非默认语言文件中删除该条目；若父对象因此为空则一并删除空对象。

3. 更新 XAML 和 C# 引用，使用生成的 *Resources 常量。

4. 运行 T4 重新生成语言资源类：

   t4 src/Pixeval/i18n/Language.tt
   

5. 校验所有修改过的 JSON 可以解析，并确认旧资源键和不应保留的硬编码文本不再被引用。运行最小相关验证：

   dotnet build src/Pixeval/Pixeval.csproj --no-restore -v:minimal
   dotnet test src/Pixeval.Tests/Pixeval.Tests.csproj --no-restore -v:minimal
   

6. 检查 git diff --check，只保留本次 i18n 变更和必要的生成文件变更。