@harmonyos-arkts/d2h 0.0.0-stage → 0.1.1

package/skills/arkts-i18n/SKILL.md

@@ -0,0 +1,496 @@
+---
+name: arkts-i18n
+description: >
+  ArkTS/HarmonyOS 国际化（i18n）技能（V2 优先，API 12+）。当用户需要添加多语言支持、实现动态语言切换、配置资源文件、处理国际化资源目录结构、扫描硬编码字符串，或任何与"国际化"、"多语言"、"切换语言"相关的问题时，务必触发此 skill。
+  即使用户只是说"怎么添加英文"或"怎么做中英文切换"，也应触发。
+type: domain
+domain: engineering
+tags: [i18n, localization, multi-language, resource-manager]
+---
+
+# ArkTS I18N — 国际化指南（V2 优先）
+
+## 输入与统一结果
+
+根据用户请求和当前工作区确定范围，始终执行同一套资源迁移、代码替换和完整性审计流程，不识别或修改外部编排状态。
+
+输入：
+
+- HarmonyOS 工程根路径；
+- Android→HarmonyOS 迁移时提供 Android 工程根路径；纯 HarmonyOS i18n 工作不要求 Android 工程；
+- 请求范围内实际读取到的 `values*/strings.xml`、代码引用和 HarmonyOS 资源文件；
+- 目标 locales。未显式给出时，从 Android 语言限定符和现有 HarmonyOS 目录确定，不凭空新增语言。
+
+返回结果：
+
+```json
+{
+  "status": "completed | partial | failed",
+  "changedFiles": [],
+  "sourceFiles": [],
+  "evidence": [],
+  "domainChecks": [{"name": "", "status": "passed | failed", "evidence": []}],
+  "unresolved": [{"kind": "", "blocking": true, "location": "", "reason": ""}],
+  "verificationRequests": [{"type": "build | test | device | review", "scope": [], "reason": ""}],
+  "suggestedRemediation": [],
+  "details": {"locales": [], "translatedCount": 0}
+}
+```
+
+`status` 只表示本 Skill 的领域工作状态，不表示工程已构建或功能已验证。不得把翻译摘要当作 Android 源码依据，也不得在仍有阻断性未解决翻译时返回 `completed`。需要构建、语言切换测试或设备核对时写入 `verificationRequests`。
+
+## API 版本与项目策略
+
+本 skill 的代码示例基于 **API 12+（HarmonyOS 5.0.0+）和 ArkTS V2 装饰器体系**。
+
+> **项目锁 V2**：所有新生成的"语言切换 / locale 状态 / refreshKey"代码使用 V2 装饰器（`@ComponentV2 / @Local / @Param / @Once / @ObservedV2 / @Trace / AppStorageV2.connect / PersistenceV2.globalConnect`）。i18n 相关 API（`resourceManager` / `intl` / `$r('app.string.xxx')` / `setPreferredLanguage` / `getPreferredLanguage` / `onLanguageConfigurationUpdate`）在 V1/V2 之间**完全不变**。
+>
+> 仅当需要查阅老项目 V1 写法（`@Component / @State / @StorageLink('currentLanguage')` 等）时，参阅 [`references/v1-compat.md`](./references/v1-compat.md) 与现有 legacy 文档（已加历史标识）。
+
+V1 → V2 关键差异（仅与本 skill 相关的 state 部分）：
+
+| V1 | V2 |
+|---|---|
+| `@Component` | `@ComponentV2` |
+| `@State refreshKey: number = 0` | `@Local refreshKey: number = 0` |
+| `@StorageLink('currentLanguage') lang: string = 'zh'` | `@Local locale: LocaleModel = AppStorageV2.connect(LocaleModel, 'locale', () => new LocaleModel())!`（需先定义 `@ObservedV2 LocaleModel`） |
+| `@Prop currentColumns: number = 3` | `@Param @Once currentColumns: number = 3`（只读） |
+| `@Watch('lang') onLangChange()` | `@Monitor('lang') onLangChange(m: IMonitor)` |
+| `AppStorage.setOrCreate('refreshKey', n)` | `localeModel.refreshKey = n`（直接改 @Trace 字段，自动同步） |
+| `PersistentStorage.persistProp('currentLanguage', 'zh')` | `PersistenceV2.globalConnect({ type: LocaleModel, key: 'locale', defaultCreator: () => new LocaleModel() })` |
+
+> **重要**：i18n 业务 API（`resourceManager.setPreferredLanguage()` / `$r()` / `onLanguageConfigurationUpdate()` 等）**与装饰器版本无关**。本次升级仅替换状态装饰器，API 调用方式不变。
+
+---
+
+## 资源迁移与补齐模式
+
+当前请求或调用范围需要迁移、补齐文案时执行：
+
+1. **读取真实来源**：读取请求范围内的 Android `values*/strings.xml`、Gradle `resValue`、引用这些资源的 Kotlin/Java/XML/Compose 文件，以及当前 HarmonyOS `resources/`。摘要只用于定位。
+2. **确定 locales**：按 Android 语言限定符和现有 HarmonyOS 资源目录分组；非语言限定符不作为 locale。
+3. **建立 key 映射**：保持同一业务文案在各 locale 的稳定 key；记录 Android 源文件和 HarmonyOS 目标文件。
+4. **写入资源**：更新 `string.json`、`plural.json`、`strarray.json` 或语言图片，替换 `.ets` 中的用户可见硬编码文案。
+5. **处理翻译缺口**：能够可靠翻译时写入目标 locale；无法可靠翻译或术语依据不足时保留明确占位并写入 `unresolved`，不得伪造已完成翻译。
+6. **完整性审计**：运行 `scripts/audit_i18n_completeness.sh`，并扫描资源值和 ArkTS 文件中的 `[TODO: translate]`、裸 TODO 和未迁移用户可见文案。
+7. **返回结果**：把修改文件、Android 源文件、locales、审计输出、未解决 key 和后续验证请求写入统一领域结果。
+
+`audit_i18n_completeness.sh` 退出码 1、仍有缺失 key 或未解决翻译时返回 `partial`/`failed`。
+
+---
+
+## 核心概念
+
+HarmonyOS 国际化基于「**资源文件目录分级**」和「**系统语言检测**」：
+
+```
+resources/
+├── base/           // Fallback 资源（无匹配时使用）
+├── zh_CN/          // 简体中文
+├── en_US/          // 美国英文
+└── ja/             // 日文
+```
+
+- **静态引用**：`$r('app.string.xxx')` 由系统根据当前语言自动加载
+- **动态切换**：通过 `resourceManager.setPreferredLanguage()` 手动指定语言
+
+### ⚠️ base/ 目录的作用
+
+**base/ 不是"中文目录"，而是 Fallback 目录！**
+
+```
+资源匹配规则：
+1. 系统根据当前语言查找匹配目录（zh-CN → zh_CN、zh-Hans、zh）
+2. 找到匹配目录？→ ✅ 使用该目录的资源
+3. 未找到？→ 使用 base/ 目录的资源（Fallback）
+```
+
+---
+
+## 资源文件结构
+
+### 标准目录结构
+
+```
+src/main/resources/
+├── base/                      # Fallback 资源
+│   ├── element/
+│   │   └── string.json        # 字符串资源
+│   └── media/                  # 图片资源
+├── zh_CN/                     # 简体中文
+│   └── element/
+│       └── string.json
+├── en_US/                     # 美国英文
+│   ├── element/
+│   │   └── string.json
+│   └── media/
+│       └── logo.png           # 英文版 logo（可选）
+└── ja/                        # 日文
+    └── element/
+        └── string.json
+```
+
+### 目录命名规范
+
+| 类型 | 格式 | 示例 |
+|------|------|------|
+| 语言 | ISO 639-1 | `en`, `ja`, `ko`, `zh` |
+| 语言+区域 | ISO 639-1 + ISO 3166-1 | `zh_CN`, `en_US`, `zh_TW` |
+
+> ⚠️ 目录名必须完全匹配，否则系统无法识别
+
+---
+
+## 字符串资源文件
+
+### JSON 格式
+
+**base/element/string.json**：
+```json
+{
+  "string": [
+    { "name": "app_name", "value": "App Name" },
+    { "name": "confirm", "value": "Confirm" }
+  ]
+}
+```
+
+**zh_CN/element/string.json**：
+```json
+{
+  "string": [
+    { "name": "app_name", "value": "应用名称" },
+    { "name": "confirm", "value": "确认" }
+  ]
+}
+```
+
+### 引用方式
+
+```typescript
+// 静态引用
+Text($r('app.string.app_name'))
+Button($r('app.string.confirm'))
+Image($r('app.media.logo'))
+```
+
+### 插值参数（占位符）
+
+```json
+// string.json
+{ "name": "file_count", "value": "共 %d 个文件" }
+```
+
+```typescript
+// 代码中替换
+const str = resourceManager.getStringByNameSync('file_count')
+const message = str.replace('%d', count.toString())
+```
+
+---
+
+## module.json5 配置
+
+### 声明支持的语言
+
+```json5
+{
+  "module": {
+    "name": "entry",
+    "type": "entry",
+    "supportedLanguages": [
+      "zh-Hans",  // 简体中文
+      "en",       // 英文
+      "ja"        // 日文
+    ]
+  }
+}
+```
+
+> ⚠️ `supportedLanguages` 声明后，`setPreferredLanguage()` 才能正确工作
+> 当前代码仓未配置此字段，如需动态语言切换，建议添加
+
+---
+
+## 动态语言切换（V2）
+
+### 基本实现
+
+V2 项目用 `@Local` 持有 refreshKey；i18n API 不变：
+
+```typescript
+import { resourceManager } from '@kit.LocalizationKit'
+import { common } from '@kit.AbilityKit'
+
+@Entry
+@ComponentV2
+struct LanguageSettings {
+  private context = getContext(this) as common.UIAbilityContext
+  @Local private refreshKey: number = 0
+
+  async switchLanguage(lang: string): Promise<void> {
+    const resMgr = this.context.resourceManager
+    await resMgr.setPreferredLanguage([lang])
+    this.refreshKey++  // 触发 UI 重建
+  }
+
+  build() {
+    Column() {
+      Text($r('app.string.welcome'))
+        .fontSize(20)
+    }
+    .id('lang_' + this.refreshKey)
+  }
+}
+```
+
+### 全局共享 locale 状态（V2 推荐）
+
+把 `currentLanguage` / `refreshKey` 封装到一个 `@ObservedV2 LocaleModel`，用 `AppStorageV2.connect` 在所有页面共享单例：
+
+```typescript
+// common/LocaleModel.ets
+@ObservedV2
+export class LocaleModel {
+  @Trace currentLanguage: string = 'zh'
+  @Trace refreshKey: number = 0
+}
+
+// 任意 V2 组件
+@ComponentV2
+struct AnyPage {
+  @Local locale: LocaleModel = AppStorageV2.connect(
+    LocaleModel,
+    'locale',
+    () => new LocaleModel()
+  )!
+
+  build() {
+    Column() {
+      Text($r('app.string.hello'))
+        .id('page_' + this.locale.refreshKey)  // refreshKey 改 → 自动重建
+    }
+  }
+}
+```
+
+> 修改 `this.locale.refreshKey++` 即可同步刷新所有 `connect` 同一 key 的组件，无需 V1 `@StorageLink` 散字段。
+
+### 获取当前系统语言
+
+```typescript
+async getCurrentLanguage(): Promise<string> {
+  const resMgr = this.context.resourceManager
+  const languages = await resMgr.getPreferredLanguage()
+  return languages[0] || 'zh'
+}
+```
+
+### 监听语言变化
+
+```typescript
+// 在 EntryAbility 中
+onLanguageConfigurationUpdate(): void {
+  hilog.info(0x0000, 'I18N', 'Language changed')
+}
+```
+
+---
+
+## 图片国际化
+
+```
+resources/
+├── base/media/logo.png         # 默认 logo
+├── en/media/logo.png           # 英文版 logo（同名）
+└── zh_CN/media/logo.png        # 中文版 logo（同名）
+```
+
+```typescript
+// 同一引用路径，不同语言加载不同文件
+Image($r('app.media.logo'))
+```
+
+> ⚠️ 不同语言目录下的图片**文件名必须一致**
+
+---
+
+## 常见错误
+
+### 错误 1：硬编码字符串
+
+```typescript
+// ❌ 错误
+Text('确认')
+Button('登录')
+
+// ✅ 正确
+Text($r('app.string.confirm'))
+Button($r('app.string.login'))
+```
+
+### 错误 2：目录命名错误
+
+```typescript
+// ❌ 错误
+resources/chinese/element/string.json
+
+// ✅ 正确
+resources/zh_CN/element/string.json
+```
+
+### 错误 3：未声明 supportedLanguages
+
+导致 `setPreferredLanguage()` 不生效。
+
+### 错误 4：动态切换后 UI 不更新
+
+```typescript
+// ❌ 错误 — 直接返回
+await resMgr.setPreferredLanguage([lang])
+
+// ✅ 正确 — 触发重建
+await resMgr.setPreferredLanguage([lang])
+this.refreshKey++
+```
+
+### 错误 5：string.json 格式错误
+
+```json
+// ❌ 错误 — value 被双引号包裹
+{ "name": "app_name", "value": "\"图库\"" }
+
+// ✅ 正确
+{ "name": "app_name", "value": "图库" }
+```
+
+---
+
+## 硬编码字符串扫描与迁移
+
+当用户需要**扫描项目中的硬编码字符串并迁移到 resources**时，执行以下流程：
+
+### 步骤 1：扫描硬编码
+
+```bash
+rg "Text\(['\"]" --type ets -n
+rg "Button\(['\"]" --type ets -n
+rg "showToast\(['\"]" --type ets -n
+```
+
+### 步骤 2：识别需要迁移的字符串
+
+**排除**：已使用 `$r()` 引用、URL、代码变量、正则、单字符
+
+**需要迁移**：
+```typescript
+Text('确认')
+Button('取消')
+.title('设置页面')
+promptAction.showToast('操作成功')
+```
+
+### 步骤 3：生成资源 key
+
+| 场景 | key 格式 | 示例 |
+|------|---------|------|
+| 按钮 | `btn_xxx` | `btn_confirm`, `btn_cancel` |
+| 标题 | `title_xxx` | `title_settings` |
+| 消息 | `msg_xxx` | `msg_delete_confirm` |
+| Toast | `toast_xxx` | `toast_save_success` |
+
+### 步骤 4：添加到 string.json
+
+**base/element/string.json**：
+```json
+{ "name": "confirm", "value": "确认" }
+```
+
+**en_US/element/string.json**：
+```json
+{ "name": "confirm", "value": "Confirm" }
+```
+
+### 步骤 5：替换代码
+
+```typescript
+// 替换前
+Text('确认')
+
+// 替换后
+Text($r('app.string.confirm'))
+```
+
+### 步骤 6：验证
+
+**1) 跨 locale key 一致性（自动）** — 跑本 skill 自带的完整性脚本：
+
+```bash
+bash <skill-root>/arkts-i18n/scripts/audit_i18n_completeness.sh \
+    --project-root <abs> \
+    --output-json docs/i18n-audit.json
+```
+
+职责：扫 `string.json` / `plural.json` / `strarray.json`，base 的全部 key 必须在每个 language locale（zh_CN / en_US / ...）出现；mode locale（dark / horizontal / vertical 等）按差异覆盖即可，豁免。
+
+退出码：`0` 全 PASS / `1` 有 key_missing FAIL / `2` 脚本参数错误。
+
+`audit_i18n_completeness.sh` 负责 locale 间 key 集合一致性，不负责识别占位文本。当前调用范围收尾时还必须使用文本搜索扫描 HarmonyOS 资源值和 `.ets` 文件中的 `[TODO: translate]`、裸 TODO，以及仍然硬编码的用户可见文案；发现项写入 `unresolved`。不得依赖其他 Skill 代为扫描。
+
+**2) 手工 / 编译检查**：
+
+- [ ] 所有用户可见字符串都已替换为 `$r()` 引用
+- [ ] 替换后能正常编译
+
+---
+
+## 生成检查清单
+
+- [ ] 资源目录使用标准语言代码
+- [ ] string.json 格式正确
+- [ ] 所有用户可见字符串使用 `$r()` 引用
+- [ ] module.json5 中声明 `supportedLanguages`（如需动态切换）
+- [ ] 不同语言目录下的图片文件名一致
+- [ ] 已扫描硬编码字符串并迁移到 resources
+
+---
+
+## API 验证状态
+
+| API | 状态 |
+|-----|------|
+| `resourceManager.getStringByNameSync()` | ✅ 已验证 |
+| `resourceManager.getStringByName()` | ⚠️ 需查证 |
+| `setPreferredLanguage()` | ⚠️ 需查证 |
+| `getPreferredLanguage()` | ⚠️ 需查证 |
+| `$r('app.string.xxx')` | ✅ 已验证 |
+
+---
+
+## References
+
+详细文档和完整代码示例请参阅（**全部代码示例已升级 V2**）：
+
+| 文件 | 内容 |
+|------|------|
+| `references/resource-file-structure.md` | 完整资源目录结构模板（与装饰器版本无关） |
+| `references/dynamic-language-switch.md` | 动态语言切换完整代码（V2，含 LocaleModel） |
+| `references/common-pitfalls.md` | 避坑指南与错误对照表（V2） |
+| `references/hardcoded-string-scanner.md` | 硬编码扫描脚本和工具（与装饰器版本无关） |
+| `references/language-codes.md` | 语言代码对照表（ISO 标准） |
+| `references/code-examples.md` | ColumnsDialog 等代码示例（V2） |
+| `references/static-vs-dynamic.md` | 纯静态 vs 动态切换方案对比 |
+| `references/v1-compat.md` | **V1 兼容写法**（@Component / @State / @StorageLink），仅老项目查阅 |
+
+---
+
+## 可选领域协作
+
+下列能力存在时可以协作，但不改变本 Skill 的输入、流程或统一结果：
+
+| 需要什么 | 读取哪里 |
+|---------|---------|
+| V2 状态管理、页面和跨页 locale 状态 | `arkts-mvvm-architecture` |
+| 图片资源与语言图片迁移 | `android2hmos_resources_convert` |
+
+本 Skill 不更新迁移报告、不创建 checkpoint、不调用 `complete`，也不选择仓库级构建或设备测试命令；这些动作通过 `verificationRequests` 交给调用方。

package/skills/arkts-i18n/evals/evals.json

@@ -0,0 +1,84 @@
+{
+  "skill_name": "arkts-i18n",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "为我的应用添加日语支持，需要创建哪些文件和目录？",
+      "expected_output": "说明资源目录结构（resources/ja/element/string.json）、string.json 格式、module.json5 的 supportedLanguages 配置。提供两种命名方案：1) 仅语言代码（ja），2) 语言+区域代码（ja_JP）。强调使用 ISO 639-1 标准，目录名必须完全匹配。",
+      "files": []
+    },
+    {
+      "id": 2,
+      "prompt": "用户可以手动切换应用语言，从中文切换到英文后 UI 也要跟着变，怎么实现？",
+      "expected_output": "说明两种方案：1) ⚠️ 未验证：setPreferredLanguage() + V2 @Local refreshKey（或 @ObservedV2 LocaleModel + AppStorageV2.connect）触发 UI 刷新（需查证官方文档），2) ✅ 已验证：应用内维护语言状态 + router.replaceUrl() 重载页面。提供 V2 完整代码示例（@ComponentV2 + @Local），强调需要 module.json5 中声明 supportedLanguages。",
+      "files": []
+    },
+    {
+      "id": 3,
+      "prompt": "检查我的 string.json 文件有没有国际化问题：base/element/string.json 和 en_US/element/string.json",
+      "expected_output": "基于代码仓实际结构（base/ 和 en_US/），检查：1) key 是否完全一致（996 行对应），2) value 是否为字符串类型，3) JSON 格式是否正确（无尾随逗号），4) 是否有硬编码。提供代码仓验证结果：✅ base 和 en_US 的 key 完全对应。",
+      "files": [
+        "entry/src/main/resources/base/element/string.json",
+        "entry/src/main/resources/en_US/element/string.json"
+      ]
+    },
+    {
+      "id": 4,
+      "prompt": "我的应用只支持中英文，应该用什么语言目录名？en 还是 en_US？",
+      "expected_output": "说明两种方案的优缺点：1) 简单方案（推荐）：en/ + zh/，优点是简单适配所有区域，缺点是无法区分 zh_CN 和 zh_TW；2) 精确方案：en_US/ + zh_CN/，优点是精确区域划分，缺点是维护成本高。代码仓使用 en_US/（方案2）。提供选择建议和语言代码对照表。",
+      "files": []
+    },
+    {
+      "id": 5,
+      "prompt": "代码中怎么获取字符串资源？有没有同步和异步两种方法？",
+      "expected_output": "提供代码仓验证的实现：✅ 同步方法：resourceManager.getStringByNameSync('key')（基于 ColumnsDialog.ets:11）。⚠️ 异步方法：resourceManager.getStringByName('key')（未验证）。提供完整代码示例，包括错误处理（try-catch）。",
+      "files": [
+        "entry/src/main/ets/components/dialogs/ColumnsDialog.ets"
+      ]
+    },
+    {
+      "id": 6,
+      "prompt": "怎么判断当前应用加载的是中文还是英文资源？",
+      "expected_output": "提供代码仓验证的方法（基于 ColumnsDialog.ets:7-16）：1) 使用 resourceManager.getStringByNameSync('dialog_column') 获取字符串，2) 用正则表达式 /[\\u4e00-\\u9fa5]/.test(str) 检测中文字符（Unicode 范围 0x4e00-0x9fa5），3) 返回布尔值表示是否中文环境。提供完整代码示例，包括 try-catch 错误处理和默认返回值。说明适用场景（需要根据语言执行不同逻辑）。",
+      "files": [
+        "entry/src/main/ets/components/dialogs/ColumnsDialog.ets"
+      ]
+    },
+    {
+      "id": 7,
+      "prompt": "英文环境下，'1 column' 和 '2 columns' 这种复数怎么处理？",
+      "expected_output": "提供代码仓验证的完整实现（基于 ColumnsDialog.ets:18-31）：1) 判断语言环境（isChineseLocale），2) 使用 resourceManager.getStringByNameSync('dialog_column') 获取字符串（含占位符 %d），3) 替换占位符 str.replace('%d', num.toString())，4) 判断是否需要添加 's'（条件：num > 1 && !isChineseLocale && !str.endsWith('s')），5) 提供 try-catch 兜底逻辑（return num === 1 ? '1 column' : `${num} columns`）。说明仅支持规则复数（+s），不规则复数需特殊处理。",
+      "files": [
+        "entry/src/main/ets/components/dialogs/ColumnsDialog.ets",
+        "entry/src/main/resources/base/element/string.json",
+        "entry/src/main/resources/en_US/element/string.json"
+      ]
+    },
+    {
+      "id": 8,
+      "prompt": "我的应用只需要中英文，不需要应用内切换语言，应该怎么实现？",
+      "expected_output": "说明纯静态方案（基于代码仓实际实现）：1) 组织资源文件（base/ + en_US/，确保 key 完全对应），2) 95%+ 使用 $r('app.string.xxx') 静态引用（270+ 处），3) 少数场景用 resourceManager.getStringByNameSync() 动态获取（如占位符替换、复数处理），4) 依赖系统语言自动匹配。对比动态方案：优点（简单、性能优、自动跟随系统、维护成本低），缺点（无法应用内切换、需重启应用）。说明代码仓选择原因和适用场景（大多数应用）。",
+      "files": [
+        "entry/src/main/resources/base/element/string.json",
+        "entry/src/main/resources/en_US/element/string.json"
+      ]
+    },
+    {
+      "id": 9,
+      "prompt": "占位符 %d 或 %s 怎么替换成实际的值？",
+      "expected_output": "提供两种方法：1) ✅ 手动替换（已验证）：str.replace('%d', value.toString()) 或 str.replace('%s', value)，基于 ColumnsDialog.ets:23。2) ⚠️ API 替换（未验证）：resourceManager.getStringByName('key', param)。推荐方法1（更可靠）。提供完整代码示例，包括多个占位符的处理（链式 replace）。说明支持的占位符类型（%d 整数、%s 字符串、%f 浮点数）。",
+      "files": [
+        "entry/src/main/ets/components/dialogs/ColumnsDialog.ets"
+      ]
+    },
+    {
+      "id": 10,
+      "prompt": "代码仓为什么要用 en_US 而不是 en 作为英文资源目录？",
+      "expected_output": "说明选择 en_US 的三大原因：1) 精确区域划分：明确标识为美国英语，与 en_GB（英国）、en_AU（澳大利亚）区分，符合 ISO 3166-1 标准。2) 扩展性好：未来可添加 en_GB、en_CA 等其他英文区域。3) 代码仓实际情况：base/ 和 en_US/ 的 key 完全对应（996 行），所有翻译已完成。对比 en/ 方案（简单但无法精确划分）。说明当前代码仓只需支持中英文，但使用 en_US/ 为未来扩展留出空间。",
+      "files": [
+        "entry/src/main/resources/base/element/string.json",
+        "entry/src/main/resources/en_US/element/string.json"
+      ]
+    }
+  ]
+}