feat: 发布 v0.2.0，完成 Interactor 验证逻辑与代码质量提升

- 完成 Interactor 完整验证逻辑，实现真实的交互测试
- 添加 compiler.py 单元测试（14 个测试用例）
- 创建平台工具模块 platform.py，消除 exe_ext 判断的代码重复
- 拆分 StressTestRunTool.execute 函数，提高代码可读性
- 测试代码覆盖从约 50-60% 提升至 80%+
- 消除 10 处 exe_ext 重复代码
- 通过工具函数封装提高可维护性
- 将平台相关逻辑集中到 platform.py 模块
- 重构过长函数，拆分为更小的辅助方法
- 更新类型注解和导入声明
- 添加 TROUBLESHOOTING.md 故障排除指南

Author: SummerOneTwo

CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2026-03-31
+
+### Features
+
+- 完成 Interactor 完整验证逻辑，实现真实的交互测试
+- 添加 compiler.py 单元测试（14 个测试用例）
+- 创建平台工具模块 `platform.py`，消除 `exe_ext` 判断的代码重复
+- 拆分 `StressTestRunTool.execute` 函数，提高代码可读性
+
+### Improvements
+
+- 测试代码覆盖从约 50-60% 提升至 80%+
+- 消除 10 处 `exe_ext` 重复代码
+- 通过工具函数封装提高可维护性
+
+### Code Quality
+
+- 将平台相关逻辑集中到 `platform.py` 模块
+- 重构过长函数，拆分为更小的辅助方法
+- 更新类型注解和导入声明
+
+### Breaking Changes
+
+- 无
+
 ## [0.1.0] - 2025-03-30
 
 ### Features
@@ -31,6 +56,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Notes & Caveats
 
-- Interactor 工具的交互测试逻辑尚未完全实现（有 TODO 标记）
 - Windows 平台不支持内存限制（ulimit）
-- 需要 g++ 编译器支持 C++2C 标准
+- 需要 g++ 编译器支持 C++2c 标准

TROUBLESHOOTING.md

@@ -0,0 +1,206 @@
+# 故障排查指南
+
+本文档提供 AutoCode MCP Server 的常见问题和解决方案。
+
+## 编译问题
+
+### C++ 编译器未找到
+
+**错误信息：**
+```
+Compiler not found: g++
+Compilation failed with error
+```
+
+**解决方案：**
+
+1. Windows 平台：
+   - 安装 [MinGW-w64](https://www.mingw-w64.org/)
+   - 或安装 [MSYS2](https://www.msys2.org/)
+   - 确保 `g++` 在 PATH 中
+
+2. Linux/macOS：
+   - 安装 `g++`：`sudo apt install g++` 或 `brew install gcc`
+
+3. 验证安装：
+   ```bash
+   g++ --version
+   ```
+
+### C++2c 标准不支持
+
+**错误信息：**
+```
+error: 'c++2c' is not a valid standard
+```
+
+**解决方案：**
+
+1. 升级到 GCC 14+：
+   ```bash
+   gcc --version  # 需要 14.0 或更高
+   ```
+
+2. 或降级到 C++20：
+   - 修改 `compiler.py` 中的 `std` 参数默认值
+
+### 编译超时
+
+**错误信息：**
+```
+Compilation timeout after 30s
+```
+
+**解决方案：**
+
+1. 检查代码复杂度，可能有模板递归展开
+2. 增加 `compile_cpp()` 的 `timeout` 参数
+3. 检查是否有头文件循环依赖
+
+## 执行问题
+
+### 二进制文件未找到
+
+**错误信息：**
+```
+Binary not found: /path/to/binary
+```
+
+**解决方案：**
+
+1. 确保已运行 `*_build` 工具
+2. 检查文件扩展名：
+   - Windows：需要 `.exe`
+   - Linux/macOS：无扩展名
+3. 验证编译是否成功（检查 `compile_result.success`）
+
+### 执行超时 (TLE)
+
+**错误信息：**
+```
+Execution timeout after 30s
+```
+
+**解决方案：**
+
+1. 增加超时时间
+2. 优化算法复杂度
+3. 检查是否有死循环或低效代码
+
+### 内存限制错误（仅 Linux）
+
+**错误信息：**
+```
+Binary not found or prlimit unavailable
+```
+
+**解决方案：**
+
+1. 安装 `prlimit`：
+   ```bash
+   sudo apt install util-linux
+   ```
+2. Windows 平台内存限制不支持，仅依赖超时控制
+
+## 测试问题
+
+### stress_test 失败
+
+**可能原因：**
+
+1. **Generator 失败**：检查 `gen.cpp` 生成逻辑
+2. **sol 失败**：检查 `sol.cpp` 代码正确性
+3. **brute 失败**：检查 `brute.cpp` 代码正确性
+4. **Validator 失败**：检查 `val.cpp` 验证逻辑
+
+**调试步骤：**
+
+1. 运行单轮测试（设置 `trials=1`）
+2. 检查失败的输入数据
+3. 比较 `sol` 和 `brute` 的输出差异
+
+### Validator 验证不一致
+
+**症状：**
+- 预期 `expected_valid=True`，但实际返回非零退出码
+- 或相反情况
+
+**解决方案：**
+
+1. 检查 Validator 使用 `quitf(_ok, ...)` 或 `quitf(_wa, ...)`
+2. 确保退出码正确：
+   - `_ok` → exit 0
+   - `_wa` 或其他 → exit 非 0
+
+## 平台特定问题
+
+### Windows 路径问题
+
+**症状：**
+```
+OSError: [WinError 32] The process cannot access the file
+```
+
+**解决方案：**
+
+1. 确保路径使用正斜杠 `/` 或双反斜杠 `\\`
+2. 避免使用保留名称（如 `con`, `prn`, `aux`）
+3. 检查文件是否被其他进程占用
+
+### Windows 文件权限问题
+
+**错误信息：**
+```
+PermissionError: [Errno 13] Permission denied
+```
+
+**解决方案：**
+
+1. 关闭可能占用文件的程序
+2. 以管理员身份运行
+3. 检查文件是否设置为只读
+
+## 性能优化
+
+### 测试生成缓慢
+
+**优化建议：**
+
+1. 使用 `test_count` 参数限制测试数量
+2. 调整 `max_attempts` 系数（默认 `test_count * 10`）
+3. 优化 `gen.cpp` 生成算法复杂度
+
+### 对拍测试缓慢
+
+**优化建议：**
+
+1. 减小 `n_max` 参数（默认 100）
+2. 减少 `trials` 轮数
+3. 优化 `brute.cpp` 暴力解法复杂度
+
+## MCP Server 问题
+
+### 无法连接 Server
+
+**检查清单：**
+
+1. 确认 `autocode-mcp` 命令可执行
+2. 检查 MCP 客户端配置
+3. 验证 Python 虚拟环境已激活
+
+### 工具调用失败
+
+**调试步骤：**
+
+1. 查看 Server 日志的完整错误信息
+2. 验证 `input_schema` 参数是否正确
+3. 检查 `problem_dir` 路径是否存在且有写权限
+
+## 获取帮助
+
+如果遇到未在本文档中列出的问题：
+
+1. 查看测试用例：`tests/` 目录
+2. 检查工具文档：`src/autocode_mcp/tools/` 源代码注释
+3. 运行测试验证环境：`pytest tests/ -v`
+4. 提交 Issue：[GitHub Issues](https://github.com/your-repo/issues)

src/autocode_mcp/tools/checker.py

@@ -4,9 +4,9 @@
 基于论文 Algorithm 3: BUILDCHECKER 实现。
 """
 import os
-import sys
 
 from ..utils.compiler import compile_cpp, run_binary_with_args
+from ..utils.platform import get_exe_extension
 from .base import Tool, ToolResult
 
 
@@ -89,8 +89,7 @@ async def execute(
             return ToolResult.fail(f"Failed to save code: {str(e)}")
 
         # 编译
-        exe_ext = ".exe" if sys.platform == "win32" else ""
-        binary_path = os.path.join(problem_dir, f"checker{exe_ext}")
+        binary_path = os.path.join(problem_dir, f"checker{get_exe_extension()}")
 
         compile_result = await compile_cpp(source_path, binary_path, compiler=compiler)
 

src/autocode_mcp/tools/generator.py

@@ -5,9 +5,9 @@
 """
 import hashlib
 import os
-import sys
 
 from ..utils.compiler import compile_cpp, run_binary, run_binary_with_args
+from ..utils.platform import get_exe_extension
 from .base import Tool, ToolResult
 
 
@@ -65,7 +65,7 @@ async def execute(
         except Exception as e:
             return ToolResult.fail(f"Failed to save code: {str(e)}")
 
-        exe_ext = ".exe" if sys.platform == "win32" else ""
+        exe_ext = get_exe_extension()
         binary_path = os.path.join(problem_dir, f"gen{exe_ext}")
 
         compile_result = await compile_cpp(source_path, binary_path, compiler=compiler)
@@ -154,7 +154,7 @@ async def execute(
         t_max: int = 1,
     ) -> ToolResult:
         """执行数据生成。"""
-        exe_ext = ".exe" if sys.platform == "win32" else ""
+        exe_ext = get_exe_extension()
 
         # 检查 generator
         gen_exe = os.path.join(problem_dir, f"gen{exe_ext}")