Windows用户hermes chat卡死、Ollama连接报Connection refused及配置不生效，系v0.15.0底层缺陷所致，v0.15.1已修复；需确认Git Bash路径、补全subprocess编码参数、设置PYTHONIOENCODING、放行防火墙端口11434、改用WSL2可解析的Windows主机IP，并执行pkill、清除cache、hermes doctor --reload-config及config validate强制重载验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Windows用户执行hermes chat后终端卡死、WSL2中Ollama连接持续报Connection refused、配置文件修改后重启不生效——这些不是你的环境问题，而是v0.15.0遗留的底层调度与序列化缺陷，在v0.15.1热修复版中已被强制拦截并重写核心路径。
Windows Git Bash空输出问题彻底修复
第一步：确认当前shell为Git Bash，执行which bash，输出必须是C:\Program Files\Git\usr\bin\bash.exe而非pwsh.exe或cmd.exe。
第二步：打开hermes/tools/environments/local.py，定位到LocalEnvironment.execute()方法中subprocess.Popen调用行。
第三步：将原参数stdout=subprocess.PIPE替换为stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True, encoding='utf-8'。Windows下缺省encoding会导致字节流解码失败，输出始终为空。
第四步：在Popen调用前插入两行关键补丁：env = os.environ.copy()→env['PYTHONIOENCODING'] = 'utf-8'，并将env传入Popen。否则Git Bash内部Python子进程仍按ANSI编码输出，与父进程UTF-8解码器错位。
WSL2 Ollama连接拒绝错误根治
方法一：启用Windows主机防火墙放行规则（管理员PowerShell）：Set-NetFirewallRule -DisplayName "Ollama" -Enabled True；若无该规则则先执行New-NetFirewallRule -DisplayName "Ollama" -Direction Inbound -Protocol TCP -LocalPort 11434 -Action Allow。
方法二：绕过DNS直连主机IP（WSL2终端）：cat /etc/resolv.conf | grep nameserver，记下nameserver后IP（如172.28.0.1），然后编辑~/.hermes/config.yaml，将ollama_base_url从http://localhost:11434改为http://172.28.0.1:11434。
【注意】改完必须执行hermes doctor --fix触发配置校验，否则新地址不会被加载进运行时上下文。
config.yaml修改后不生效的强制重载机制
第一步：停止所有Hermes进程：pkill -f "hermes chat"→pkill -f "hermes gateway"→pkill -f "hermes webui"。
第二步：清除运行时缓存：rm -rf ~/.hermes/cache/runtime/。v0.15.0会将旧配置哈希值固化在此目录，不删则重载无效。
第三步：执行hermes doctor --reload-config。该命令会强制重建config.yaml解析树，并验证所有字段合法性——若存在YAML缩进错误或废弃字段（如OPENAI_BASE_URL），会直接报错退出，不再静默忽略。
第四步：启动服务前验证配置完整性：hermes config validate。只有返回✅ Config is valid才可继续执行hermes chat。
