| name | localization-dev |
| description | Tyou 多语言文案/本地化/i18n 工作流 skill。涉及新增或修改多语言文本、`TableLocalizationText`、`#TableLocalizationText.xlsx`、`tyou.i18n.get`、`LocalizeLabel`、切语言显示、文案 key、中文/英文字段、导表后使用多语言时必须使用。会路由到 `luban-dev` 完成源 Excel 修改和导表，不用于手写字典或直接改生成代码。 |
Tyou 多语言工作流
本 skill 只负责 Tyou 多语言文案流程。配表读写、字段变更和导表细节必须使用 luban-dev。
核心路径
- 读取
.agents/skills/luban-dev/SKILL.md 和 .agents/skills/tyou-dev/references/luban-config.md。
- 只改源表：
Design/config/#TableLocalizationText.xlsx。
- 当前字段：
id、key、zh_cn、en_us。
- 写表前先查重：
key 必须稳定且唯一，id 不重复。
- 写表前先做文案复用判断，避免重复行。
- 写表必须通过
luban-dev 的安全流程；能用 luban_helper.py 就优先用它，写操作必须带 --write。
- 导表只使用
Design/tools/genBin.bat。
- 运行时只通过
tyou.i18n.get(key, ...args) 或 LocalizeLabel 使用。
复用判断
- 新增文案前先查询
TableLocalizationText 现有行，优先用 luban_helper.py table get TableLocalizationText 或更窄的 row query。
- 如果已有行的
zh_cn 和 en_us 与目标文案完全一致，直接复用该行 id/key，不新建一模一样的行。
- 如果已有行语义接近但文本不完全一致，并且候选范围很小、上下文已在手边或 token 成本低，则列出候选
id/key、现有文案和差异点，让开发者确认复用旧行还是新建精确文案。
- 如果表很大、需要大范围语义比较或会明显消耗上下文，只做完全一致判断，并在回复中说明未做语义近似扫描。
- 语义接近的行未经开发者确认不得擅自复用；完全一致的行可以直接复用。
禁止
- 不手写多语言字典作为主路径。
- 不直接修改
Client/assets/scripts/proto/config/bin/schema.ts。
- 不手改
Client/assets/asset-raw/config/game/*.bin。
- 不直接解析
.bin 判断文案内容。
- 不绕过 Luban 源 Excel 补运行时兜底文本。
常用操作
只读确认：
python .agents/skills/luban-dev/scripts/luban_helper.py table get TableLocalizationText
python .agents/skills/luban-dev/scripts/luban_helper.py field list TableLocalizationText
python .agents/skills/luban-dev/scripts/luban_helper.py row query TableLocalizationText --conditions key=common_ok
导表：
Design/tools/genBin.bat
运行时：
const text = tyou.i18n.get("common_ok");
const textWithArg = tyou.i18n.get("item_count", count);
UI Label：
labelNode.getComponent(LocalizeLabel)?.setKey("common_ok");
验证
- 源表存在目标
key，且 zh_cn / en_us 有值。
- 导表成功，生成的
schema.ts 与 game/*.bin 只作为导表产物变化。
TableModule.onCreate() 后 tyou.i18n 可通过 TbTableLocalizationText 读取文本。- 缺 key 时运行时返回
#key#，不要用业务代码吞掉这个信号。
