多语言

Sora 将翻译文本作为独立的 locale catalog 处理，而不是普通业务表。

业务配置只保存 text 类型的文案 key。localization source 表提供这些 key 的各语言翻译。运行时先加载普通配置包，再单独挂载一个或多个语言包。

业务表 -> config bundle
localization sources -> LocaleCatalog -> i18n locale packs

Text Key

需要本地化的字段使用 text：

[[tables.fields]]
name = "title_key"
type = "text"

[[tables.fields]]
name = "body_keys"
type = "list<text>"

text 保存的是 key，不是实际翻译文本。源数据里应填写 quest.1001.title、ui.confirm 这类值。目标语言支持独立生成运行时类型时，生成代码会暴露为 TextKey。

catalog 校验会扫描业务数据里的所有 text 值。key 不存在或翻译为空都会直接构建失败。

Catalog Sources

在 project schema root 声明 localization：

[localization]
locales = ["zh_cn", "en_us"]
default_locale = "zh_cn"
fallback_locale = "en_us"

[[localization.sources]]
name = "ui"
file = "Core.xlsx"
sheet = "UILocalization"

[[localization.sources]]
name = "quest"
file = "Quest.xlsx"
sheet = "QuestLocalization"

每个 source 是宽表。默认 key 列名是 key：

locales 里声明的语言列会进入语言包。其它列，例如 note，只作为编辑和诊断元数据，不进入运行时包。

规则：

如果 key 列不叫 key，可以在 source 上指定：

[[localization.sources]]
name = "ui"
file = "Core.xlsx"
sheet = "UILocalization"
key = "id"

导出语言包

普通导出格式（binary、json、cbor、sora-protobuf、proto）只包含业务数据和 text key，不包含实际翻译文本。

在 build manifest 里添加 i18n 导出：

[[build.exports]]
format = "binary"
out = "generated/config.sora"

[[build.exports]]
format = "i18n-binary"
out = "generated/i18n/zh_cn.sora-i18n"
locale = "zh_cn"

[[build.exports]]
format = "i18n-json"
out = "generated/i18n/en_us.json"
locale = "en_us"

i18n-binary 面向生产语言包。i18n-json 面向检查、外包翻译交付和测试。

运行时挂载

生成运行时会分开加载配置包和语言包。Rust 示例：

#![allow(unused)]
fn main() {
let config = SoraConfig::from_bytes(config_bytes)?;
let pack = generated::runtime::LocalePack::from_bytes(locale_bytes)?;

let mut i18n = generated::SoraI18n::new();
i18n.mount(&config, pack)?;
i18n.set_locale("zh_cn")?;

let mail = config.mail_template().get(&1001).unwrap();
let title = i18n.text(&mail.title_key);
let body = i18n.format(&mail.body_key, [("count", 100)])?;
}

挂载时会校验：

业务代码不感知 key 来自哪张 source 表，只用已挂载的 i18n runtime 查询 TextKey。