Persistent Terminal MCP Server

# 修复文档索引 本目录包含所有重要修复的详细文档。 ## 文档列表 ### 1. [FIX_SUMMARY.md](FIX_SUMMARY.md) **完整修复总结** 包含所有修复的概述： - Cursor 兼容性修复 - 终端交互问题修复 - 新增功能说明 - 测试结果汇总 - 部署步骤 **推荐阅读顺序：** 第一个阅读，了解全局 --- ### 2. [STDIO_FIX.md](STDIO_FIX.md) **Stdio 通道纯净性修复** 详细说明 Cursor 兼容性问题的修复： - 问题描述和根本原因 - MCP 协议要求 - 修复方案和代码示例 - 测试验证方法 - 技术细节 **适合：** 需要了解 MCP stdio 协议的开发者 --- ### 3. [CURSOR_FIX_SUMMARY.md](CURSOR_FIX_SUMMARY.md) **Cursor 兼容性问题修复总结（中文）** 中文版的 Cursor 修复说明： - 问题现象 - 根本原因 - 修复方案 - 使用说明 - 技术细节 **适合：** 中文用户快速了解 Cursor 修复 --- ### 4. [QUICK_FIX_GUIDE.md](QUICK_FIX_GUIDE.md) **快速修复指南** 3 步快速修复指南： 1. 重新编译项目 2. 更新 Cursor 配置 3. 重启 Cursor **适合：** 遇到问题需要快速解决的用户 --- ### 5. [TERMINAL_FIXES.md](TERMINAL_FIXES.md) **终端交互问题修复报告** 详细的终端修复技术文档： - 问题 1: 命令执行修复 - 问题 2: 交互式输入处理修复 - 问题 3: 输出读取实时性修复 - 新增功能说明 - 最佳实践 - 测试验证 **适合：** 需要深入了解终端实现的开发者 --- ## 快速导航 ### 按问题类型 **Cursor 卡住/报错？** → [QUICK_FIX_GUIDE.md](QUICK_FIX_GUIDE.md) → [CURSOR_FIX_SUMMARY.md](CURSOR_FIX_SUMMARY.md) **命令执行有问题？** → [TERMINAL_FIXES.md](TERMINAL_FIXES.md) - 问题 1 **交互式应用不工作？** → [TERMINAL_FIXES.md](TERMINAL_FIXES.md) - 问题 2 **输出读取不准确？** → [TERMINAL_FIXES.md](TERMINAL_FIXES.md) - 问题 3 **想了解全部修复？** → [FIX_SUMMARY.md](FIX_SUMMARY.md) ### 按角色 **用户（遇到问题）** 1. [QUICK_FIX_GUIDE.md](QUICK_FIX_GUIDE.md) - 快速解决 2. [CURSOR_FIX_SUMMARY.md](CURSOR_FIX_SUMMARY.md) - 了解详情 **开发者（需要技术细节）** 1. [FIX_SUMMARY.md](FIX_SUMMARY.md) - 全局了解 2. [STDIO_FIX.md](STDIO_FIX.md) - Stdio 协议 3. [TERMINAL_FIXES.md](TERMINAL_FIXES.md) - 终端实现 **维护者（需要完整信息）** - 阅读所有文档 - 参考 [../../CHANGELOG.md](../../CHANGELOG.md) --- ## 相关资源 ### 测试脚本 位于 `tests/integration/`： - `test-mcp-stdio.mjs` - Stdio 纯净性测试 - `test-cursor-scenario.mjs` - Cursor 场景测试 - `test-terminal-fixes.mjs` - 终端修复测试 ### 其他文档 - [../../CHANGELOG.md](../../CHANGELOG.md) - 完整更新日志 - [../../README.md](../../README.md) - 项目说明 - [../bug-fixes.md](../bug-fixes.md) - 历史 Bug 修复记录 --- ## 修复时间线 ``` 2025-10-06 ├── Stdio 通道纯净性修复 │ ├── 修复 console.log 污染问题 │ ├── 添加 MCP_DEBUG 环境变量 │ └── 完全兼容 Cursor │ └── 终端交互问题修复 ├── 命令执行修复（PTY 配置） ├── 交互式输入修复（环境变量） ├── 输出读取修复（事件处理） └── 新增 wait_for_output 工具 ``` --- ## 测试覆盖 所有修复都经过完整测试： ``` ✅ 单元测试: 33/33 通过 ✅ Stdio 测试: 通过 ✅ Cursor 场景: 7/7 通过 ✅ 终端修复: 6/6 通过 ``` --- ## 贡献 如果你发现新的问题或有改进建议，请： 1. 查看 [../../CONTRIBUTING.md](../../CONTRIBUTING.md) 2. 提交 Issue 或 Pull Request 3. 参考现有修复文档的格式 --- **最后更新：** 2025-10-06