v1.4 工具集扩展 + Windows 编码攻坚

- 新增 BashTool（bash 命令执行，30s 超时 + 自愈 + 截断）
- 新增 WriteFileTool（文件写入）
- Windows GBK 编码自动转 UTF-8（golang.org/x/text）
- OpenAIProvider 新增 API 交互日志
- dumpMessages 移除截断，完整展示上下文
- cmd/claw 三段式任务演示

README.md

@@ -65,6 +65,32 @@ func main() {
 
 ## 版本历史
 
+### v1.4 — 工具集扩展与 Windows 编码攻坚
+
+#### 变更
+
+- **新增 BashTool** — 执行本地 bash 命令，支持 30s 超时、错误原样回传（模型自愈）、8KB 输出截断
+- **新增 WriteFileTool** — 写文件到工作区，覆盖/新建均支持
+- **Windows GBK 编码修复** — 命令输出从 GBK 自动转 UTF-8（`golang.org/x/text/encoding/simplifiedchinese`），不依赖 `chcp`
+- **API 交互日志** — `OpenAIProvider.Generate` 新增请求/响应日志（阶段标记、消息数、工具数、ToolCall 明细）
+- **调试输出优化** — `dumpMessages` 移除 80 字符截断，完整展示上下文内容
+- **三段式任务演示** — `cmd/claw` 任务改为：查 Go 版本 → 写 helloworld.go → 编译运行
+
+#### 踩坑记录
+
+| 问题 | 原因 | 解决 |
+|---|---|---|
+| bash 输出中文乱码 | Windows 命令输出为 GBK 编码，Go 按 UTF-8 解析 | 引入 `golang.org/x/text`，检测编码后自动转换 |
+| `chcp 65001` 导致终端刷屏 | `chcp` 在子进程中修改代码页可能影响终端渲染 | 放弃 `chcp` 方案，改用 Go 原生编码转换 |
+| `utf8.Valid` 检查后仍乱码 | GBK 字节序列碰巧也合法于 UTF-8，跳过转换 | 去掉 `utf8.Valid` 判断，Windows 下一律转换 |
+| `helloworld.go` 导致编译失败 | 模型生成的测试文件含 `main` 函数，与项目 main.go 冲突 | 运行后清理 `helloworld.*` 测试产物 |
+
+#### 经验教训
+
+1. **编码问题不要依赖外部命令** — `chcp` 属于"改环境让输出配合你"，不可靠。Go 原生转码属于"你主动适应输出"，稳定可控
+2. **`utf8.Valid` 不能当编码检测器** — 它的语义是"是否合法 UTF-8"，不是"是否是 GBK"。GBK 和 UTF-8 有交集，用合法性判断编码方向是伪命题
+3. **Agent 的工具越多，越需要关注副作用** — 模型会写文件、执行命令，产生的文件（helloworld.go）可能反过来破坏项目结构。工具内部要做好隔离
+
 ### v1.3 — Registry 实现重构与第一把真实工具
 
 #### 变更