Harness 踩坑笔记01：外部搜索工具返回结果的解码问题

作者总结了 Agent 调用 rg 等外部搜索工具时，因 Python 默认解码导致 UTF-8 字节被 GBK 误解码的踩坑经验，并提出四层防护方案。第一层将 text 设为 False，由程序检测原始字节编码后再解码；第二层按 rg 返回码区分搜索成功有内容、成功无匹配与执行失败；第三层在外部工具失效时切换自研搜索逻辑；第四层将错误信息封装成文本反馈给 LLM 作为兜底。