WorkBuddy模型切换后出现中文乱码，主因是字符编码与Stream流配置不匹配。需四步解决：一、强制响应流编码为UTF-8；二、禁用模型侧自动编码检测；三、校准前端EventSource解码器；四、启用双编码回退验证通道。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在WorkBuddy中切换模型后出现中文乱码、符号错位或空字符泛滥等现象，则很可能是新模型的默认字符编码与当前Stream流配置不匹配所致。以下是针对性解决此问题的操作步骤：
一、强制统一响应流编码为UTF-8
WorkBuddy在模型切换时可能继承旧模型的编码协商逻辑，导致HTTP/EventSource流未声明charset，引发客户端解码歧义。需显式锁定输出编码。
1、打开WorkBuddy安装目录下的config/stream.yaml文件。
2、定位到response_headers区块，添加或修改字段：Content-Type: text/event-stream; charset=utf-8。
3、若存在encoding_fallback配置项，将其值设为utf-8而非auto或system。
4、保存文件后执行命令：sudo systemctl restart workbuddy-stream-engine。
二、禁用模型侧自动编码检测
部分大语言模型（如Qwen2.5、GLM-4）在生成响应前会尝试探测输入文本编码并反向适配输出，该机制在WorkBuddy代理链路中易造成二次转码冲突。应关闭该行为。
1、进入WorkBuddy管理后台，导航至「模型配置」→「高级参数」。
2、找到当前激活模型的配置卡片，点击「编辑」。
3、在「推理参数」区域新增键值对：disable_encoding_autodetect: true。
启用该技能，可以在WorkBuddy对话页的右边栏添加一个日历，提供月历视图、日程增删改查、分类标签（开庭/会议/截止日期/个人/研究/其他），支持从对话中提取事件并自动同步到日历。当用户提到"日历""日程""打开日历""添加日程""我的日程""calendar""安排"或询问已记录的日程信息时使用。
4、提交更改，并在弹出确认框中勾选“强制重载模型上下文缓存”。
三、校准前端EventSource解码器
浏览器原生EventSource API默认按UTF-8解析，但若服务端未发送BOM且响应体含GB18030字节序列，部分旧版Chromium内核会误判为ISO-8859-1。需在客户端注入显式解码逻辑。
1、在WorkBuddy Web界面开发者工具中，打开Console面板。
2、执行以下脚本注入自定义解码器：window.EventSource = class extends EventSource { constructor(url, opts) { super(url, {...opts, withCredentials: true}); this.addEventListener('message', e => { const decoder = new TextDecoder('utf-8'); try { e.data = decoder.decode(new Uint8Array(e.data.split('').map(c => c.charCodeAt(0)))); } catch {} }); } };
3、刷新页面，重新发起模型调用观察输出是否恢复正常。
四、启用双编码回退验证通道
当无法立即定位乱码根源时，可临时启用并行输出通道，分别以UTF-8和GB18030解码同一原始字节流，人工比对结果以快速判定真实编码类型。
1、在WorkBuddy设置中开启「调试模式」：右上角齿轮图标 →「高级」→ 勾选「启用双编码响应日志」。
2、触发一次典型乱码请求（如生成中文报告）。
3、打开日志面板，查找标记为[ENCODING-UTF8]与[ENCODING-GB18030]的两组原始响应体Hex Dump。
4、将两组Hex数据分别粘贴至在线解码工具（如https://www.rapidtables.com/convert/number/hex-to-ascii.html），选择对应编码查看哪组呈现可读中文——该编码即为实际有效编码。
