企业官网建设流程全解析

XPipe 多语言切换完整指南：三步把界面换成中文

【免费下载链接】xpipeAccess your entire server infrastructure from your local desktop项目地址: https://gitcode.com/GitHub_Trending/xp/xpipe

刚装好的 XPipe 打开后，菜单、按钮、提示清一色英文，想找个"保存"还得靠猜 Save、Store、Apply 这些词。对一个要管理一堆远程服务器的工具来说，读不懂的界面是第一道门槛。读完后，你能在 1 分钟内完成 XPipe 多语言切换，还会弄明白翻译为什么有时"改回去"，以及背后是谁在干活。

三步切换界面为中文

第一步：找到语言入口。打开设置面板，进入"应用程序"页签，找到"语言（language）"这一项。设置面板本身也在翻译覆盖范围内，切换后它会用目标语言显示，不用担心看不懂当前选项。

第二步：选目标语言。在下拉框里选简体中文，无需重启，整屏菜单与提示文案立刻变化。

第三步：抽查高频区域。依次看三处：连接中心的标题（显示为"连接中心"）、设置面板里的"设置"条目本身、帮助菜单下的"报告问题"入口。三处都变了，说明切换生效。

上面这些中文文案出自 lang/strings/translations_zh-Hans.properties，当前稳定版本号为 24.1，标注在 version 文件中。

语言切换背后跑的是什么

整条流水线可以理解为一个三段的"字幕工厂"：

1. 英语底稿是原声轨。所有界面文案先以英文写成（存放在fixed_en.properties），在 lang/README.md 的状态表里，英语是唯一标记为"Reference"的语言，其他语言全部以它为基准。
2. 机器翻译是 AI 粗剪。DeepL 把英文词条批量翻成十几种语言，一语言一文件，lang/strings/ 里存的就是这批 .properties 文件，键名相同、按语言各存一份值。
3. 人工校对是逐句修音。社区贡献者挑出不顺的译文做修正，改过的字符串靠#custom标记保护，下一轮重新生成时不会被冲掉。

此外还有一条"文字频道"：lang/texts/ 存放 Termius、Xshell 等连接指南一类的长文 markdown，每种语言单独一份 .md。这类文件不参与自动重生成，所以修正后直接生效，无需额外标记。

进阶玩法与生态参与

术语表、隐藏命令与导出工具

想保留某条个性化译文，在字符串上方加一行标记即可：

#custom welcomeMessage=欢迎使用 XPipe 服务器管理工具

之后无论翻译如何批量更新，这一行都不会被动。标记的完整规则见 lang/README.md 的 "Correcting strings" 一节。

临时换界面语言不必动设置面板，两条命令就够了：

xpipe config set language=en xpipe config reset language

第一条把界面切成英文，第二条恢复系统默认。企业里若有一套统一术语表，启动时加参数指向自定义文件即可：

xpipe --translation-override=custom_zh.properties

开发者模式下还能一条命令导出所有缺失的中文条目，方便批量补齐：

./gradlew lang:exportUntranslated -Dlang=zh

如何参与翻译贡献

1. 克隆仓库到本地：

   git clone https://gitcode.com/GitHub_Trending/xp/xpipe

2. 在本地克隆里校对lang/strings/translations_zh-Hans.properties，给改过的条目补上#custom；
3. 提交 PR，流程规范参考 CONTRIBUTING.md 与 lang/README.md 里的约定；
4. 按贡献指南跑一次开发者构建，当场看到文案的实际效果。

如果你的语言还没出现在翻译文件列表里，先在仓库里开一个 issue，由维护者用 DeepL 跑初始翻译——这一步需要 API 订阅，无法自行完成。lang/README.md 的状态表里，语言标注"Verified @ 版本号"表示该版本处由真人逐句校对过；之后新加入的字符串则仍需再校对。

容易踩的坑与规避办法

切完语言，部分界面还是英文。现象：新功能的某些按钮停留在英文。原因：该字符串是新版才加的，中文译文尚未补全。处理：先在中文翻译文件里搜索对应键名确认缺失，再走 PR 补上译文并加#custom标记。

改过的译文被下次更新冲回。现象：你修正过的措辞又变回机翻版本。原因：漏加了#custom，字符串被判定为机翻内容，重生成时直接覆盖。处理：所有手工修正过的字符串，上方都要补一行#custom。

机翻在多个语言里同时出错。现象：某条英文原文不只中文翻错，其他语言也跟着错。原因：DeepL 对原句的上下文理解有偏差。处理：在英文原文字符串上追加#context: 说明注释补充语境，让该字符串重新生成译文（参考 lang/README.md 的 "Improving automatic translations" 一节）。

下一步

XPipe 多语言体系的价值在于三层分工：英语底稿保证一致性，机翻首过保证覆盖，#custom保护标记保证人工成果不丢失。切换后若遇到文案问题，先用帮助菜单里的"报告问题"入口反馈，或直接按 lang/README.md 的流程提交修正。

【免费下载链接】xpipeAccess your entire server infrastructure from your local desktop项目地址: https://gitcode.com/GitHub_Trending/xp/xpipe