QoderWake中文界面设置指南：语言包安装与配置详解

QoderWake安装后界面仍为英文，通常由语言包缺失或系统区域设置未正确同步导致。以下四种方法可针对性解决本地化问题，根据你的使用场景选择对应方案。

一、通过命令面板快速切换语言

这是最高效的界面语言切换方案，适用于桌面版v0.0.9及以上版本。无需修改配置文件，操作即时生效。

1. 启动QoderWake客户端。

2. 激活主界面顶部搜索框，或直接使用快捷键：Ctrl + Shift + P（Windows/Linux） 或 Cmd + Shift + P（macOS），调出命令面板。

3. 在命令面板输入框中键入 >configure locale 并回车。

4. 从弹出的选项列表中选择 Configure Display Language。

5. 在语言选择下拉菜单中，定位并点击 简体中文（zh-CN）。

6. 根据提示重启QoderWake客户端，界面将完整切换为中文环境。

二、手动安装语言包并配置路径

针对便携版、离线环境或命令面板无语言选项的特殊情况，手动部署Qt翻译文件（.qm）是可靠解决方案。此方法直接替换UI文本资源，确保所有菜单、按钮及提示信息完全中文化。

1. 获取对应版本的语言包。访问Qoder官方GitHub Releases页面，下载与你当前QoderWake版本（如v0.0.9）匹配的 translations-zh_CN.zip 文件。

2. 解压压缩包，提取核心翻译文件 zh_CN.qm。

3. 定位至QoderWake安装目录，进入 resources/translations/ 子目录。若目录不存在，请手动创建。

4. 将 zh_CN.qm 文件复制至该目录。如遇同名文件，选择 替换。

5. 配置软件识别路径。再次打开QoderWake，通过命令面板输入 >open settings json，编辑配置文件。

6. 在文件末尾（确保JSON格式正确，与前一项用逗号分隔）添加以下配置：
"locale": "zh-CN",
"qtTranslationsDir": "./resources/translations/"

7. 保存配置文件，彻底退出QoderWake（包括系统托盘后台进程）。重新启动软件，中文界面将正常加载。

三、启动参数强制指定语言环境

此方法通过启动参数直接指令Qt运行时加载指定翻译资源，绕过软件自动检测逻辑。适用于Linux终端启动、Docker容器部署或系统locale非中文的环境。

1. 确保完全关闭当前QoderWake进程。

2. 打开终端（Windows可使用PowerShell或CMD），切换至QoderWake可执行文件目录，执行以下启动命令：
QT_QPA_PLATFORMTHEME=qt5ct QT_TRANSLATIONS_DIR=./resources/translations LANG=zh_CN.UTF-8 ./QoderWake

3. 若启动后出现“Cannot load translation file”类错误，请检查 ./resources/translations/zh_CN.qm 文件路径是否存在且当前用户具备读取权限。

4. 若系统未安装中文语言环境（常见于Linux），可运行以下命令生成并更新locale：
sudo locale-gen zh_CN.UTF-8 && sudo update-locale

5. 完成系统配置后，重新执行第2步的带参启动命令即可。

四、覆盖系统区域设置启用中文UI

当操作系统为多语言混合环境，或受IT策略限制导致QoderWake继承非预期系统语言时，可通过配置强制软件使用内置中文资源，忽略系统区域设置。

1. 启动QoderWake，通过命令面板输入 >open settings json 编辑配置文件。

2. 在settings.json中，找到或新增配置项：
"overrideSystemLocale": true

3. 在同一层级添加另一配置项：
"userInterfaceLanguage": "zh-CN"

4. 确保已按方法二正确将 zh_CN.qm 文件置于 resources/translations/ 目录。

5. 保存settings.json文件，彻底退出QoderWake所有进程。

6. 重新启动软件。若设置生效，状态栏右下角通常会显示 简体中文 标识。