XPipe 界面语言切换完整指南:3 步搞定中文界面
【免费下载链接】xpipeAccess your entire server infrastructure from your local desktop项目地址: https://gitcode.com/GitHub_Trending/xp/xpipe
XPipe 是一款从本地桌面直接管理整台服务器集群的工具——连接中心、文件浏览器、脚本执行器都集成在这一个窗口里。它的界面默认是英文,但仓库内置了 17 种语言的翻译包,简体中文只需 3 步就能切到位,且切换即时生效、不用重启。
3 步切换 XPipe 中文界面
先说结果:改完下拉框的一瞬间,所有菜单、按钮、提示语会跟着变,连接中心会显示"已保存的连接","添加连接"这类条目全部变中文。
具体操作:
- 打开 XPipe,进入设置面板,找到"个性化"分类(语言项就在这一组里,源码位于 PersonalizationCategory.java)。
- 找到"语言"配置项,在下拉菜单中选择"简体中文"。
- 确认保存,界面即刻完成切换。
对应的翻译文本写在 lang/strings/translations_zh-Hans.properties 里,你可以打开文件看到它长什么样:
language=语言 languageDescription=设置界面语言。 connectionAdd=添加连接右侧简体中文(zh-Hans)和繁体中文(zh-Hant)是两套独立的翻译文件,选"繁体中文"走 translations_zh-Hant.properties。
界面上的文字从哪里来
想弄清楚切换是怎么生效的,可以看 AppI18n.java 这套机制:
- 界面里每个文本在代码中都是一个 key(如
connectionAdd),AppI18n 负责把 key 换成当前语言文件里的译文。 - 语言偏好存在 AppPrefs.java 的
language字段中,默认值是英语。你在设置里一改,订阅者立刻重新加载对应语言的翻译包并刷新全局 Locale——这就是"不重启就换语言"的原因。 - 兜底规则:某条文本当前语言没翻译时,自动回落到英语;英语也没有,才显示 key 本身。所以偶尔看到零星的英文,多半是新版新增的字符串还没被人工校对,属于正常现象。
翻译内容分两层存放:
- lang/strings/:短字符串。每种语言一个
.properties文件,外加英语基准文件 fixed_en.properties。17 种语言全覆盖:德语、日语、韩语、法语、俄语、越南语等等。 - lang/texts/:长文档。
termiusSetup和xshellSetup两篇说明文每种语言各一份,专门翻译这类带步骤的富文本。
生产流程是"英语为基准 + 机器初翻 + 人工校对":新字符串先由 DeepL 从英语自动翻译出全部语言版本,再由母语者提交修正。机器翻译的准确率已经很高,所以大多数情况下人工只需要做零星纠错,而不是从头写。
让自定义译文不被覆盖
翻译包会被周期性重新生成——功能在扩张,字符串会新增、也会微调,重新跑一遍自动翻译是常规操作。如果你的改动是"修正某条机器译文",不加保护的话下次重新生成时会被冲掉。
解决办法是#custom标记。把想保留的译文改成下面这样:
#custom sortAlphabetical=按名称字母顺序排序带#custom注释的条目会被自动化工具识别为"人工定制",后续重新翻译时跳过它。translations_zh-Hans.properties 中大量条目已经带了这个标记,比如"连接中心"(storeIntroHeader)、"排查问题"(troubleshoot),可以直接当格式参考。
#custom还有个进阶用法:如果某条英语原文的语境容易被机器翻译搞错(比如省略了"服务器"这种隐含主语),维护者可以在英语基准文件里给该条目追加#context: ...注释,补充上下文后重新生成,所有语言的自动翻译质量会一起提升。这套规则完整写在 lang/README.md 的 "Correcting strings" 一节。
参与翻译与反馈问题
校对译文或提交功能问题,入口都是同一个仓库。克隆下来可以直接跑开发版构建验证你的修改效果:
git clone https://gitcode.com/GitHub_Trending/xp/xpipe然后按 CONTRIBUTING.md 的说明运行开发构建,改好的翻译会直接生效,所见即所得。
参与方式分三种情况:
- 语言已有翻译文件(17 种语言目前都在):发现错译直接提交 PR,修正处记得加
#custom。 - 长文档纠错:
lang/texts/下的 markdown 不会被自动覆盖,改完直接提交即可,不需要任何标记。 - 想新增一种语言:先在仓库提 issue 说明语种,维护者会用 DeepL API 生成初始翻译包,之后社区再逐条校对。
各语言的校对进度记录在 lang/README.md 的状态表里——"Verified" 表示该语言在对应版本号上已被真人逐条校对过,后续版本新增的字符串可能尚未复查,所以表里会标注版本号供你参考。
【免费下载链接】xpipeAccess your entire server infrastructure from your local desktop项目地址: https://gitcode.com/GitHub_Trending/xp/xpipe
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考