如何使用 Skill 制作多语言预设文件

chxdon

已经做好的预设，键面却只有中文？可以用

1. ulanzi-profile-localizer

复制代码

Skill 提取需要翻译的文字，填好八种语言，再生成一份新预设。下面拿一份包含 10 条文字和 10 条快捷键的预设做例子。

准备：一份能正常导入的原预设
从 Ulanzi Studio 导出预设，保留原件。先确认它在自己的电脑上可以正常导入、按键动作正常。这里用

1. mac-默认预设.ulanziDeckProfile

复制代码

演示，输出另存为

1. 默认预设-八语.ulanziDeckProfile

复制代码

，不会覆盖原文件。

下载 ulanzi-profile-localizer Skill 后解压到本机。链接是内网地址，需要能访问对应网络。Skill 目录中应能看到

1. SKILL.md

复制代码

、

1. scripts/profile[i]localizer.py

复制代码

和

1. references/

复制代码

。

如果已经把 Skill 安装到 Codex，可以把原预设交给它，并这样说：

> 请用 ulanzi-profile-localizer 处理这个

1. .ulanziDeckProfile

复制代码

。先提取可见文字和快捷键，生成翻译模板。我填好八种语言后，请保留原有动作，生成新预设并运行 validate，告诉我校验结果。

记得附上原预设的文件路径。喜欢自己操作的话，也可以照着下面的命令一步步来。

第一步：提取真正需要翻译的内容
在终端进入 Skill 目录，运行：

1. python3 scripts/profile_localizer.py extract \
2.   "/你的路径/原预设.ulanziDeckProfile" \
3.   "/你的路径/翻译工作目录"

复制代码

运行后提取出 10 条文字、10 条快捷键，工作目录里生成

1. translator.template.json

复制代码

。打开它：

1. tr

复制代码

是名称、键面等可见文字，

1. hotkey

复制代码

是快捷键显示值。每条文字下面都有

1. zh[/i]CN

复制代码

、

1. zh[i]HK

复制代码

、

1. en[/i]US

复制代码

、

1. de[i]DE

复制代码

、

1. ja[/i]JP

复制代码

、

1. pt[i]PT

复制代码

、

1. es[/i]ES

复制代码

、

1. ko[i]KR

复制代码

八个位置。

第二步：填写翻译，不改变功能
复制模板为

1. translations.json

复制代码

。保留每个键名和

1. source

复制代码

，逐项填满八种语言；

1. zh[/i]CN

复制代码

保持与原文完全相同。例如模板里的“撤销”可写成：

在 VS Code 中填写八种语言的翻译文件

图中是填好的

1. translations.json

复制代码

。一个原文对应八种译文，填完一组就检查一下语言代码和键名，免得后面构建时报错。

1. "撤销": {
2.   "zh_CN": "撤销",
3.   "zh_HK": "復原",
4.   "en_US": "Undo",
5.   "de_DE": "Rückgängig",
6.   "ja_JP": "元に戻す",
7.   "pt_PT": "Desfazer",
8.   "es_ES": "Deshacer",
9.   "ko_KR": "실행 취소"
10. }

复制代码

1. ⌘ Z

复制代码

、

1. ⌘ C

复制代码

等快捷键保持原值。翻译的是用户看到的词，不是按键发送的组合。插件 ID、路径、数字、UUID 和图片同样保持原样。若某个专有名词没有合适译法，保留原文也比留空好。

第三步：构建新的预设包

1. python3 scripts/profile_localizer.py build \
2.   "/你的路径/原预设.ulanziDeckProfile" \
3.   "/你的路径/翻译工作目录/translations.json" \
4.   "/你的路径/原预设-八语.ulanziDeckProfile"

复制代码

构建输出显示：文本 10 条、快捷键 10 条、语言 8 种；“预设包校验通过”且“非翻译内容与 ZIP 元数据校验通过”。再独立运行一次：

1. python3 scripts/profile_localizer.py validate \
2.   "/你的路径/原预设-八语.ulanziDeckProfile"

复制代码

看到“预设包校验通过”才进入下一步。原包不是普通 ZIP，直接用 Finder 压缩或

1. zip -r

复制代码

重打包可能无法导入；使用 Skill 的

1. build

复制代码

命令即可保留包格式并检查非翻译内容。

第四步：导入 Studio 检查实际显示
在 Ulanzi Studio 导入新生成的预设，切换简体中文、英语和目标用户常用的另一种语言，检查名称、按键文字和提示是否显示完整。再按一次关键按键，确认动作仍与原预设相同。检查通过后再到 UGC 上传新文件。

预设包里的键面支持八种语言；UGC 上传页的作品介绍则提供七种语言。这两处要分别填写，上传预设不会自动生成作品介绍。