# 预设文件维护说明

## 文件位置

预设配置放在：

```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
```

该命令会检查：

- 每个预设文件是否存在；
- 多语言名称字段格式是否有效；
- 语言包键和插值占位符是否一致。