语言环境切换详细步骤
这是 OpenClacky Windows 安装指南 的子文档
⚠️ 执行约束(必须遵守)
- 语言包安装是异步操作,命令返回 ≠ 安装完成
- 每个子步骤完成后必须等待用户确认,禁止连续自动执行
- 严禁在未获用户明确同意的情况下变更系统版本
前置说明:征得用户同意
在执行任何步骤之前,必须先向用户说明并征得同意:
"由于 Minimax Agent 的 MCP 工具在中文 Windows 环境下会出现乱码,导致无法正常读取命令输出,因此安装过程中需要临时将系统语言切换为英文。安装完成后会自动恢复您的原有语言设置。是否同意继续?"
必须收到用户明确同意后,才能执行步骤 0 及后续操作!
步骤 0:检查系统版本
(Get-WmiObject -Class Win32_OperatingSystem).Caption
结果处理
如果输出包含 "Single Language":
⛔ 禁止直接执行升级命令! 必须先询问用户:
"检测到您的 Windows 是「家庭版单语言」版本,无法直接安装额外语言包。需要将系统升级为「家庭版」(多语言)才能继续。升级过程会使用通用产品密钥,不会影响您的激活状态和数据,但属于系统级变更。是否同意升级?"
仅在用户明确同意后,才执行:
Start-Process powershell -Verb RunAs -ArgumentList "slmgr /ipk TX9XD-98N7V-6WMQ6-BX7FG-H8Q99; slmgr /ato; Restart-Computer"
等待用户确认重启完成后,重新执行步骤 0 验证版本,再继续步骤 1。
如果不包含 "Single Language":直接继续步骤 1。
步骤 1:备份当前语言设置
$backup = @{
UserLanguage = (Get-WinUserLanguageList)[0].LanguageTag
SystemLocale = (Get-WinSystemLocale).Name
Culture = (Get-Culture).Name
} | ConvertTo-Json
$backup | Out-File "$env:USERPROFILE\openclacky_backup.json" -Encoding UTF8
执行后确认文件存在:
Get-Content "$env:USERPROFILE\openclacky_backup.json"
步骤 2:安装英文语言包
Install-Language en-US
如果权限不足:
Start-Process powershell -Verb RunAs -ArgumentList "Install-Language en-US"
⚠️ 执行命令后立即告知用户(禁止继续执行后续命令):
"请确认授权管理员权限下载语言包,根据网络环境的不同,可能需要 15-30 分钟。请不要关闭终端,等待下载结束后终端会自行关闭,告诉我「已完成」,我再继续下一步。"
必须收到用户「已完成」后才能继续步骤 3!
步骤 3:应用英文语言设置
收到用户确认后,依次以管理员权限执行(每条单独执行,确认无报错再执行下一条):
Start-Process powershell -Verb RunAs -ArgumentList "Set-WinUILanguageOverride -Language en-US"
Start-Process powershell -Verb RunAs -ArgumentList "Set-WinUserLanguageList en-US -Force"
Start-Process powershell -Verb RunAs -ArgumentList "Set-WinSystemLocale en-US"
Start-Process powershell -Verb RunAs -ArgumentList "Set-Culture en-US"
步骤 4:重启
Restart-Computer
告知用户:
"系统需要重启才能生效。请重启后告诉我「已重启」,我将继续验证。"
必须等待用户「已重启」后才能继续!
步骤 5:验证语言环境
重启后,执行验证:
$result1 = (Get-WinUserLanguageList)[0].LanguageTag
$result2 = (Get-WinSystemLocale).Name
$result3 = (Get-Culture).Name
Write-Host "Display Language: $result1"
Write-Host "System Locale: $result2"
Write-Host "User Culture: $result3"
三项必须全部返回 en-US!
验证 WSL 输出语言(关键):
wsl --help
必须全英文输出! 如出现中文,说明语言切换未生效,必须重新执行步骤 2-4。
| 验证项 | 期望值 |
|---|---|
| Display Language | en-US |
| System Locale | en-US |
| User Culture | en-US |
| wsl --help | 全英文 |
全部通过后,继续 WSL 安装。
恢复语言设置(安装完成后执行)
$backup = Get-Content "$env:USERPROFILE\openclacky_backup.json" | ConvertFrom-Json
Set-WinUILanguageOverride -Language $backup.UserLanguage
Set-WinUserLanguageList $backup.UserLanguage -Force
Set-WinSystemLocale $backup.SystemLocale
Set-Culture $backup.Culture
执行完成后告知用户:
"语言设置已恢复,请重启电脑使其生效。如果重启后发现仍有部分语言设置未还原(如显示语言、区域格式等),可前往「Windows 设置 → 时间和语言」手动调整后再重启即可。"
恢复完成后重启系统。