WorkBuddy安装脚本中文乱码需统一终端UTF-8编码：Windows PowerShell临时执行[Console]::OutputEncoding = [System.Text.Encoding]::UTF8；CMD永久设chcp 65001及环境变量PYTHONIOENCODING=utf-8；macOS/Linux配置LANG=zh_CN.UTF-8；VS Code集成终端设默认编码为utf8；禁用Windows“Beta版UTF-8支持”并重启。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在运行WorkBuddy安装脚本时遇到中文显示为方块、问号或符号错乱，极大概率是终端当前字符编码未设为UTF-8，导致GBK/GB18030等中文编码无法被正确解码。以下是解决此问题的步骤：
一、Windows PowerShell临时切换为UTF-8编码
PowerShell默认使用系统区域设置的ANSI编码（如GBK），需手动启用UTF-8支持以确保脚本中中文路径、提示、日志正常显示。
1、以管理员身份启动PowerShell。
2、执行命令：[Console]::OutputEncoding = [System.Text.Encoding]::UTF8。
3、验证是否生效：输入Write-Host "测试中文"，若显示正常则配置成功。
4、运行WorkBuddy安装脚本（如install.ps1）前，务必先执行第2步，否则脚本内echo、Write-Host等输出仍将乱码。
二、Windows CMD永久启用UTF-8代码页
CMD默认使用CP936（GBK），需强制切换至UTF-8代码页65001，并避免重启后失效。
1、在CMD中执行：chcp 65001，立即切换当前会话编码。
2、为实现永久生效，右键“此电脑”→“属性”→“高级系统设置”→“环境变量”→在“系统变量”中新建变量：PYTHONIOENCODING=utf-8。
3、同时新建另一系统变量：JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF-8（兼容Java类安装组件）。
4、重启CMD，再次运行chcp确认当前代码页为65001，再执行WorkBuddy安装脚本。
三、macOS/Linux终端全局启用UTF-8 locale
Unix系终端依赖locale配置决定字符处理行为，若LANG或LC_ALL未指向UTF-8 locale，Python或Shell脚本中的中文将解析失败。
1、在终端中执行：locale -a | grep -i utf-8，确认系统已安装utf8 locale（如en_US.UTF-8、zh_CN.UTF-8）。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、编辑shell配置文件：nano ~/.zshrc（macOS Catalina+）或nano ~/.bashrc（Linux）。
3、在文件末尾添加两行：export LANG=zh_CN.UTF-8与export LC_ALL=zh_CN.UTF-8（若zh_CN.UTF-8不可用，改用en_US.UTF-8）。
4、执行：source ~/.zshrc（或source ~/.bashrc），然后运行locale验证输出中所有字段均为UTF-8。
四、VS Code集成终端同步编码设置
若通过VS Code的集成终端运行WorkBuddy安装脚本，其编码独立于系统终端，需单独配置，否则即使系统已设UTF-8仍会乱码。
1、打开VS Code，按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）调出命令面板。
2、输入并选择：Terminal: Select Default Profile，确保选中PowerShell或zsh/bash而非Git Bash（后者编码策略不同）。
3、进入设置（Ctrl+,），搜索terminal integrated default encoding，将其值设为utf8。
4、关闭所有终端窗口，重新打开集成终端，再运行WorkBuddy安装脚本。
五、禁用Windows区域设置中的“Beta版UTF-8支持”冲突项
Windows 10/11中若同时启用“系统区域设置→管理→更改系统区域设置→Beta版：使用Unicode UTF-8提供全球语言支持”，可能与PowerShell原有编码逻辑冲突，引发脚本解析异常。
1、打开“控制面板”→“时钟和区域”→“区域”→“管理”选项卡→点击“更改系统区域设置”。
2、**取消勾选**“Beta版：使用Unicode UTF-8提供全球语言支持”。
3、点击“确定”，系统提示需重启，**立即重启计算机**。
4、重启后，按第一、二方法重新配置PowerShell/CMD编码，再执行安装脚本。
