supervisor-simulator/scripts/Core/LocalizationService.cs

using Godot;
using Models;

namespace Core;

/// <summary>
/// i18n 服务抽象
/// 设计说明：
/// 1) Model 只持有 LocalizedText(Key/Fallback)，具体翻译交给服务层。
/// 2) 便于后续替换为自定义多语言系统或 Mod 词库。
/// 注意事项：
/// - TranslationServer 的翻译表应通过 Godot Editor 管理。
/// 未来扩展：
/// - 可加入“参数化翻译”和“运行时语言切换事件”。
/// </summary>
public interface ILocalizationService
{
	string Translate(LocalizedText text);
	string Translate(string key, string fallback = null);
}

public sealed class GodotLocalizationService : ILocalizationService
{
	public string Translate(LocalizedText text)
	{
		if (text == null) return string.Empty;
		return Translate(text.Key, text.Fallback);
	}

	public string Translate(string key, string fallback = null)
	{
		if (string.IsNullOrWhiteSpace(key))
		{
			return fallback ?? string.Empty;
		}

		var translated = TranslationServer.Translate(key);
		if (translated == key && !string.IsNullOrWhiteSpace(fallback))
		{
			return fallback;
		}

		return translated;
	}
}