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

预设文件维护说明

文件位置

预设配置放在：

public/Preset/

预设索引：

public/Preset/index.json

新增预设

1. 把新的预设配置放入 public/Preset/。
2. 重新启动开发服务或执行构建，索引会自动更新。
3. 部署时一起上传 index.json、预设文件和 dist/。

自动生成示例：

{
  "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。
• 当前生成器会把所有语言字段都填成文件名本身。
• 自动生成工具可以只输出文件记录：

{
  "file": "8.fireworks.json"
}

界面会显示为：

8.fireworks

• 旧版字符串格式仍然兼容：

{
  "file": "8.fireworks.json",
  "name": "8.烟花爆炸"
}

字符串格式会在所有语言中显示同一个名称。

回退顺序

当某种语言的名称缺失时，界面依次使用：

当前语言 → English → 简体中文 → 文件名

验证命令：

npm run test:i18n

该命令会检查：

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