aionclaw中文乱码主因是编码识别失败或渲染链路中断，须从输入源、传输通道、显示层三端同步排查：先确认文件编码为utf-8并覆盖保存；再重置客户端渲染引擎（macos用defaults命令，windows改注册表defaultencoding为65001）；最后通过剪贴板中转或中间文本框过滤富文本污染；若日志报unicodedecodeerror，则需用vs code定位非法字节人工修复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
用AionClaw处理本地文档、网页抓取或跨平台粘贴内容时，中文显示为方块、问号、拉丁字母混排或符号错位，说明字符编码识别失败或渲染链路中断，必须从输入源、传输通道、显示层三端同步排查。
检查输入文件本身的编码格式
右键打开出问题的文本文件（如.txt、.csv、.md），用系统自带的文本编辑器（macOS预览/备忘录、Windows记事本）重新打开→点击「文件」→「另存为」→在弹出窗口底部找到「编码」下拉菜单→确认当前显示的是【UTF-8】而非ANSI、GBK或ISO-8859-1；若显示非UTF-8，立即更改为UTF-8并勾选「始终使用此编码保存」后覆盖保存。
这一步不可跳过：AionClaw默认只识别UTF-8编码，其他编码格式会直接触发底层解析器报错，导致后续所有环节全链路乱码，且不提示具体错误类型。
强制重置AionClaw客户端文本渲染引擎
关闭AionClaw主程序（不是最小化，是彻底退出进程）→在终端执行以下命令：
macOS用户输入：defaults write com.aionclaw.AionClaw NSGlobalDomain -string "UTF-8" → 回车 → 再输入：killall cfprefsd
Windows用户需手动进入注册表路径：HKEY_CURRENT_USER\Software\AionClaw\Rendering → 找到键值DefaultEncoding → 双击修改数值数据为【65001】（即UTF-8的Windows代码页编号）→ 重启客户端。
注意：注册表修改前请先导出该分支备份，误改其他键值可能导致界面元素消失。
拦截并修正第三方粘贴内容的编码污染
方法一：用系统剪贴板历史工具中转
开启macOS「剪贴板历史」（设置→键盘→快捷键→剪贴板→启用）或Windows「剪贴板历史」（Win+V）→复制乱码原文→在剪贴板历史面板中长按该条目→选择「纯文本粘贴」→再将净化后的文本拖入AionClaw对话框。
方法二：通过中间文本框过滤
新建一个空白TextEdit（macOS）或记事本（Windows）→粘贴原始内容→全选→复制→再粘贴进AionClaw；这个操作会强制剥离富文本格式与隐藏控制字符，仅保留可打印Unicode字符。
这两步能解决90%由微信、钉钉、网页复制带来的“隐形乱码”，因为这些应用常在剪贴板中混入私有格式标记，AionClaw无法识别却仍尝试解析，最终呈现为乱码。
验证大模型返回内容是否被二次编码
第一步：在AionClaw中输入指令「输出测试字符串：你好，世界」→观察返回是否正常；
第二步：若第一步正常，但调用「读取D:\report.csv」后返回乱码→说明问题出在文件读取模块而非模型本身；
第三步：立即前往「个人中心→安全保护→日志管理」→筛选最近30分钟内含关键词「encoding」「codec」「decode」的日志条目→定位报错行末尾的文件路径与行号。
如果日志中出现UnicodeDecodeError: 'utf-8' codec can't decode byte 0xd6 in position 123这类报错，说明该文件第123字节存在非法UTF-8序列，需用专业工具（如VS Code + Encoding插件）定位并人工修复损坏字节，不能依赖自动转换。
