空白响应或乱码通常源于编码错位或工具调用异常，需依次检查终端utf-8支持、禁用streaming、重置tool_calls缓冲区、替换为surrogateescape容错解析器。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您向 Hermes Agent 发出指令，AI 却返回空白响应或乱码字符（如、□、等不可读符号），这通常不是网络中断所致，而是模型输出解析阶段发生编码错位或工具调用链异常终止。以下是解决此问题的步骤：
一、检查模型响应编码与终端渲染设置
Hermes Agent 在接收大模型原始响应后，需经 UTF-8 解码并过滤控制字符；若模型返回含 BOM 头或混合编码（如 GBK 片段混入 UTF-8 流），终端将无法正确渲染，表现为全空或大量方块乱码。该问题在使用本地 Ollama 模型（如 llama3:8b）且未显式指定 encoding 参数时尤为常见。
1、确认终端支持 UTF-8 编码：在 Linux/macOS 中执行 locale | grep UTF，输出应包含 UTF-8；Windows WSL2 用户需在 PowerShell 中运行 chcp 65001 切换至 UTF-8 代码页。
2、强制 Hermes Agent 使用严格 UTF-8 解析：编辑 ~/.hermes/config.yaml，在 llm 节点下添加字段：encoding: "utf-8"。
3、重启 Hermes Agent 进程，避免缓存残留影响验证结果。
二、禁用非必要响应流式解析（streaming）
当启用 streaming 模式时，Hermes Agent 会逐 chunk 接收并拼接模型响应；若某次 chunk 包含不完整 Unicode 码点（如仅收到 UTF-8 多字节字符的前两个字节），后续解码即失败，导致整段输出被丢弃或替换为 。关闭流式传输可规避该类截断风险，适用于 OpenRouter 或本地 Ollama 接口。
1、打开 ~/.hermes/config.yaml 文件。
2、定位到 llm 配置块，在其子项中查找 stream 字段。
3、将该字段值设为 false；若不存在，则手动添加：stream: false。
4、保存文件并重新启动 Hermes Agent。
三、重置工具调用上下文缓冲区
Hermes Agent 内部维护一个 tool_calls 响应缓冲区，用于暂存浏览器快照、文件写入等操作的原始返回内容。若某次 browser_snapshot 返回超长 HTML（含大量未转义 Unicode 实体），而缓冲区未做预清理，后续 decode 步骤可能因内存越界触发静默截断，最终导致主响应为空。该现象在处理多语言网页（如含日文、阿拉伯文）时高频复现。
1、进入 Hermes Agent 安装目录，执行：rm -f ~/.hermes/cache/tool_buffer_*.bin。
2、清空当前会话轨迹缓存：rm -f ~/.hermes/trajectories/*.jsonl。
3、在启动命令中加入环境变量强制刷新上下文：HERMES_RESET_TOOL_BUFFER=1 python main.py。
四、替换默认响应解析器为容错版本
原生解析器对非法字节序列采用 strict 模式，一旦遇到无法解码字节即抛出异常并中断响应构造；改用 surrogateescape 错误处理器可在保留原始字节语义的前提下完成解码，使乱码部分以可识别的 \udcXX 形式呈现，便于人工定位污染源。
1、在 ~/.hermes/hermes-agent/ 目录下新建文件 response_decoder_patch.py。
2、写入以下内容：import codecs; codecs.register_error("hermes_replace", lambda e: (u"\uFFFD", e.start + 1))。
3、在 Hermes Agent 启动脚本 main.py 开头插入：import response_decoder_patch。
4、确保所有响应字符串解码调用均显式指定 errors="hermes_replace"，例如：text.decode("utf-8", errors="hermes_replace")。
