Story流程+本地化

Assets/Scripts/Settings/SettingsSaveData.cs

@@ -119,6 +119,20 @@ namespace Ichni
         public int beatmapOffset = 0;
 
         // Localization
+        /// <summary>
+        /// 玩家选择的稳定 Locale Code，例如 <c>zh-CN</c>、<c>ja</c>。
+        /// <para>这是设置存档的唯一语言契约：语言列表的显示顺序可以调整，已保存的语言不会因此指向其它 Locale。</para>
+        /// <para>旧存档没有该字段时，SettingsManager 会只使用一次 <see cref="languageIndex"/> 映射为 Code，并在下次保存时写入本字段。</para>
+        /// </summary>
+        // 不设置字段默认值：ES3 反序列化旧存档时，缺失字段必须保持 null，
+        // SettingsManager 才能辨认它是旧版数据并按 languageIndex 正确迁移。
+        public string languageCode;
+
+        /// <summary>
+        /// 旧版设置存档的语言下拉索引，仅用于迁移既有 ES3 数据。
+        /// <para>禁止新增运行时代码依赖该字段；请通过 SettingsManager 的语言 API 读写 <see cref="languageCode"/>。</para>
+        /// </summary>
+        [FormerlySerializedAs("language")]
         public int languageIndex = 0;
 
         // Developer settings. 这些字段会在后续分类重构时迁出正式 Release 设置。