多语言调整

Document/预设文件维护说明.md

@@ -0,0 +1,93 @@
+# 预设文件维护说明
+
+## 文件位置
+
+预设配置放在：
+
+```text
+public/Preset/
+```
+
+预设索引：
+
+```text
+public/Preset/index.json
+```
+
+## 新增预设
+
+1. 把新的预设配置放入 `public/Preset/`。
+2. 重新启动开发服务或执行构建，索引会自动更新。
+3. 部署时一起上传 `index.json`、预设文件和 `dist/`。
+
+自动生成示例：
+
+```json
+{
+  "file": "8.烟花爆炸.json",
+  "name": {
+    "zh-CN": "8.烟花爆炸",
+    "zh-TW": "8.烟花爆炸",
+    "en": "8.烟花爆炸",
+    "ja": "8.烟花爆炸",
+    "ko": "8.烟花爆炸",
+    "fr": "8.烟花爆炸",
+    "de": "8.烟花爆炸",
+    "pt-BR": "8.烟花爆炸",
+    "es": "8.烟花爆炸"
+  }
+}
+```
+
+## 规则
+
+- `file` 是实际预设配置文件名，必须与磁盘文件完全一致。
+- `name` 是下拉框显示名称，不参与文件加载。
+- `name` 可以省略；省略时直接显示去掉 `.json` 后缀的文件名。
+- `name` 也兼容旧版字符串格式和多语言对象格式。
+- 文件名建议使用稳定、简洁的名称，可使用 ASCII。
+- 当前生成器会把所有语言字段都填成文件名本身。
+- 自动生成工具可以只输出文件记录：
+
+```json
+{
+  "file": "8.fireworks.json"
+}
+```
+
+界面会显示为：
+
+```text
+8.fireworks
+```
+
+- 旧版字符串格式仍然兼容：
+
+```json
+{
+  "file": "8.fireworks.json",
+  "name": "8.烟花爆炸"
+}
+```
+
+字符串格式会在所有语言中显示同一个名称。
+
+## 回退顺序
+
+当某种语言的名称缺失时，界面依次使用：
+
+```text
+当前语言 → English → 简体中文 → 文件名
+```
+
+验证命令：
+
+```bash
+npm run test:i18n
+```
+
+该命令会检查：
+
+- 每个预设文件是否存在；
+- 多语言名称字段格式是否有效；
+- 语言包键和插值占位符是否一致。