From 0ebf60aa34f7527578a8089aaeb82a153d50c427 Mon Sep 17 00:00:00 2001 From: Minidoracat Date: Thu, 5 Jun 2025 09:47:59 +0800 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20=E6=9B=B4=E6=96=B0=202.2.5=20?= =?UTF-8?q?=E7=9B=B8=E9=97=9C=E6=96=87=E6=AA=94?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 33 ++++++++++++++++++------ README.zh-CN.md | 33 ++++++++++++++++++------ README.zh-TW.md | 23 +++++++++++------ RELEASE_NOTES/{2.2.5 => v2.2.5}/en.md | 0 RELEASE_NOTES/{2.2.5 => v2.2.5}/zh-CN.md | 0 RELEASE_NOTES/{2.2.5 => v2.2.5}/zh-TW.md | 0 6 files changed, 65 insertions(+), 24 deletions(-) rename RELEASE_NOTES/{2.2.5 => v2.2.5}/en.md (100%) rename RELEASE_NOTES/{2.2.5 => v2.2.5}/zh-CN.md (100%) rename RELEASE_NOTES/{2.2.5 => v2.2.5}/zh-TW.md (100%) diff --git a/README.md b/README.md index 96b2dc2..0903d17 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ ## 🎯 Core Concept -This is an [MCP server](https://modelcontextprotocol.io/) that establishes **feedback-oriented development workflows**, perfectly adapting to both local and **SSH remote development environments**. By guiding AI to confirm with users rather than making speculative operations, it can consolidate multiple tool calls into a single feedback-oriented request, dramatically reducing platform costs and improving development efficiency. +This is an [MCP server](https://modelcontextprotocol.io/) that establishes **feedback-oriented development workflows**, perfectly adapting to local, **SSH remote development environments**, and **WSL (Windows Subsystem for Linux) environments**. By guiding AI to confirm with users rather than making speculative operations, it can consolidate multiple tool calls into a single feedback-oriented request, dramatically reducing platform costs and improving development efficiency. **Supported Platforms:** [Cursor](https://www.cursor.com) | [Cline](https://cline.bot) | [Windsurf](https://windsurf.com) | [Augment](https://www.augmentcode.com) | [Trae](https://www.trae.ai) @@ -23,8 +23,8 @@ This is an [MCP server](https://modelcontextprotocol.io/) that establishes **fee ### 🖥️ Dual Interface System - **Qt GUI**: Native experience for local environments, modular refactored design -- **Web UI**: Modern interface for remote SSH environments, brand new architecture -- **Smart Switching**: Auto-detect environment and choose optimal interface +- **Web UI**: Modern interface for remote SSH and WSL environments, brand new architecture +- **Smart Switching**: Auto-detect environment (local/remote/WSL) and choose optimal interface ### 🎨 Brand New Interface Design (v2.1.0) - **Modular Architecture**: Both GUI and Web UI adopt modular design @@ -42,6 +42,12 @@ This is an [MCP server](https://modelcontextprotocol.io/) that establishes **fee - **Smart Detection**: Auto-select based on system language - **Live Switching**: Change language directly within interface +### ✨ WSL Environment Support (v2.2.5 New Feature) +- **Auto Detection**: Intelligently identifies WSL (Windows Subsystem for Linux) environments +- **Browser Integration**: Automatically launches Windows browser in WSL environments +- **Multiple Launch Methods**: Supports `cmd.exe`, `powershell.exe`, `wslview` and other browser launch methods +- **Seamless Experience**: WSL users can directly use Web UI without additional configuration + ## 🖥️ Interface Preview ### Qt GUI Interface (Refactored Version) @@ -172,10 +178,11 @@ uvx --with-editable . mcp-feedback-enhanced test --web # Test Web UI (auto co 📋 **Complete Version History:** [RELEASE_NOTES/CHANGELOG.en.md](RELEASE_NOTES/CHANGELOG.en.md) -### Latest Version Highlights (v2.2.2) -- 🔄 **Timeout Auto-cleanup**: Fixed GUI/Web UI not automatically closing after MCP session timeout -- 🛡️ **Resource Management Optimization**: Improved timeout handling mechanism to ensure proper cleanup of all UI resources -- 🎯 **QTimer Integration**: Introduced precise QTimer timeout control mechanism in GUI +### Latest Version Highlights (v2.2.5) +- ✨ **WSL Environment Support**: Added comprehensive support for WSL (Windows Subsystem for Linux) environments +- 🌐 **Smart Browser Launching**: Automatically invokes Windows browser in WSL environments with multiple launch methods +- 🎯 **Environment Detection Optimization**: Improved remote environment detection logic, WSL no longer misidentified as remote environment +- 🧪 **Testing Experience Improvement**: Test mode automatically attempts browser launching for better testing experience ## 🐛 Common Issues @@ -214,9 +221,19 @@ For detailed instructions, see: [Cache Management Guide](docs/en/cache-managemen **Q: Gemini Pro 2.5 cannot parse images** A: Known issue. Gemini Pro 2.5 may not correctly parse uploaded image content. Testing shows Claude-4-Sonnet can properly analyze images. Recommend using Claude models for better image understanding capabilities. -**Q: Multi-screen window positioning issues** +**Q: Multi-screen window positioning issues** A: Fixed in v2.1.1. Go to "⚙️ Settings" tab, check "Always show window at primary screen center" to resolve window positioning issues. Especially useful for T-shaped screen arrangements and other complex multi-monitor configurations. +**Q: Cannot launch browser in WSL environment** +A: v2.2.5 has added WSL environment support. If issues persist: +1. Confirm WSL version (WSL 2 recommended) +2. Check if Windows browser is properly installed +3. Try manual test: run `cmd.exe /c start https://www.google.com` in WSL +4. If `wslu` package is installed, you can also try the `wslview` command + +**Q: WSL environment misidentified as remote environment** +A: v2.2.5 has fixed this issue. WSL environments are now correctly identified and use Web UI with Windows browser launching, instead of being misidentified as remote environments. + ## 🙏 Acknowledgments ### 🌟 Support Original Author diff --git a/README.zh-CN.md b/README.zh-CN.md index cce1479..ffb426a 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -8,7 +8,7 @@ ## 🎯 核心概念 -这是一个 [MCP 服务器](https://modelcontextprotocol.io/)，建立**反馈导向的开发工作流程**，完美适配本地与 **SSH 远程开发环境**。通过引导 AI 与用户确认而非进行推测性操作，可将多次工具调用合并为单次反馈导向请求，大幅节省平台成本并提升开发效率。 +这是一个 [MCP 服务器](https://modelcontextprotocol.io/)，建立**反馈导向的开发工作流程**，完美适配本地、**SSH 远程开发环境**与 **WSL (Windows Subsystem for Linux) 环境**。通过引导 AI 与用户确认而非进行推测性操作，可将多次工具调用合并为单次反馈导向请求，大幅节省平台成本并提升开发效率。 **支持平台：** [Cursor](https://www.cursor.com) | [Cline](https://cline.bot) | [Windsurf](https://windsurf.com) | [Augment](https://www.augmentcode.com) | [Trae](https://www.trae.ai) @@ -23,8 +23,8 @@ ### 🖥️ 双界面系统 - **Qt GUI**：本地环境原生体验，模块化重构设计 -- **Web UI**：远程 SSH 环境现代化界面，全新架构 -- **智能切换**：自动检测环境并选择最适界面 +- **Web UI**：远程 SSH 环境与 WSL 环境现代化界面，全新架构 +- **智能切换**：自动检测环境（本地/远程/WSL）并选择最适界面 ### 🎨 全新界面设计（v2.1.0） - **模块化架构**：GUI 和 Web UI 均采用模块化设计 @@ -42,6 +42,12 @@ - **智能检测**：根据系统语言自动选择 - **即时切换**：界面内可直接切换语言 +### ✨ WSL 环境支持（v2.2.5 新功能） +- **自动检测**：智能识别 WSL (Windows Subsystem for Linux) 环境 +- **浏览器整合**：WSL 环境下自动启动 Windows 浏览器 +- **多种启动方式**：支持 `cmd.exe`、`powershell.exe`、`wslview` 等多种浏览器启动方法 +- **无缝体验**：WSL 用户可直接使用 Web UI，无需额外配置 + ## 🖥️ 界面预览 ### Qt GUI 界面（重构版） @@ -172,10 +178,11 @@ uvx --with-editable . mcp-feedback-enhanced test --web # 测试 Web UI (自 📋 **完整版本更新记录：** [RELEASE_NOTES/CHANGELOG.zh-CN.md](RELEASE_NOTES/CHANGELOG.zh-CN.md) -### 最新版本亮点（v2.2.2） -- 🔄 **超时自动清理**: 修复 GUI/Web UI 在 MCP session timeout 后没有自动关闭的问题 -- 🛡️ **资源管理优化**: 改进超时处理机制，确保正确清理所有 UI 资源 -- 🎯 **QTimer 整合**: 在 GUI 中引入精确的 QTimer 超时控制机制 +### 最新版本亮点（v2.2.5） +- ✨ **WSL 环境支持**: 新增 WSL (Windows Subsystem for Linux) 环境的完整支持 +- 🌐 **智能浏览器启动**: WSL 环境下自动调用 Windows 浏览器，支持多种启动方式 +- 🎯 **环境检测优化**: 改进远程环境检测逻辑，WSL 不再被误判为远程环境 +- 🧪 **测试体验提升**: 测试模式下自动尝试启动浏览器，提供更好的测试体验 ## 🐛 常见问题 @@ -214,9 +221,19 @@ uv cache clean **Q: Gemini Pro 2.5 无法解析图片** A: 已知问题，Gemini Pro 2.5 可能无法正确解析上传的图片内容。实测 Claude-4-Sonnet 可以正常解析图片。建议使用 Claude 模型获得更好的图片理解能力。 -**Q: 多屏幕视窗定位问题** +**Q: 多屏幕视窗定位问题** A: 已在 v2.1.1 修复。进入「⚙️ 设置」标签页，勾选「总是在主屏幕中心显示窗口」即可解决窗口定位问题。特别适用于 T 字型屏幕排列等复杂多屏幕配置。 +**Q: WSL 环境下无法启动浏览器** +A: v2.2.5 已新增 WSL 环境支持。如果仍有问题： +1. 确认 WSL 版本（建议使用 WSL 2） +2. 检查 Windows 浏览器是否正常安装 +3. 尝试手动测试：在 WSL 中执行 `cmd.exe /c start https://www.google.com` +4. 如果安装了 `wslu` 套件，也可尝试 `wslview` 命令 + +**Q: WSL 环境被误判为远程环境** +A: v2.2.5 已修复此问题。WSL 环境现在会被正确识别并使用 Web UI 配合 Windows 浏览器启动，而不会被误判为远程环境。 + ## 🙏 致谢 ### 🌟 支持原作者 diff --git a/README.zh-TW.md b/README.zh-TW.md index d52874e..796bc99 100644 --- a/README.zh-TW.md +++ b/README.zh-TW.md @@ -8,7 +8,7 @@ ## 🎯 核心概念 -這是一個 [MCP 伺服器](https://modelcontextprotocol.io/)，建立**回饋導向的開發工作流程**，完美適配本地與 **SSH 遠端開發環境**。透過引導 AI 與用戶確認而非進行推測性操作，可將多次工具調用合併為單次回饋導向請求，大幅節省平台成本並提升開發效率。 +這是一個 [MCP 伺服器](https://modelcontextprotocol.io/)，建立**回饋導向的開發工作流程**，完美適配本地、**SSH 遠端開發環境**與 **WSL (Windows Subsystem for Linux) 環境**。透過引導 AI 與用戶確認而非進行推測性操作，可將多次工具調用合併為單次回饋導向請求，大幅節省平台成本並提升開發效率。 **支援平台：** [Cursor](https://www.cursor.com) | [Cline](https://cline.bot) | [Windsurf](https://windsurf.com) | [Augment](https://www.augmentcode.com) | [Trae](https://www.trae.ai) @@ -23,8 +23,8 @@ ### 🖥️ 雙介面系統 - **Qt GUI**：本地環境原生體驗，模組化重構設計 -- **Web UI**：遠端 SSH 環境現代化界面，全新架構 -- **智能切換**：自動檢測環境並選擇最適介面 +- **Web UI**：遠端 SSH 環境與 WSL 環境現代化界面，全新架構 +- **智能切換**：自動檢測環境（本地/遠端/WSL）並選擇最適介面 ### 🎨 全新界面設計（v2.1.0） - **模組化架構**：GUI 和 Web UI 均採用模組化設計 @@ -42,6 +42,12 @@ - **智能偵測**：根據系統語言自動選擇 - **即時切換**：介面內可直接切換語言 +### ✨ WSL 環境支援（v2.2.5 新功能） +- **自動檢測**：智能識別 WSL (Windows Subsystem for Linux) 環境 +- **瀏覽器整合**：WSL 環境下自動啟動 Windows 瀏覽器 +- **多種啟動方式**：支援 `cmd.exe`、`powershell.exe`、`wslview` 等多種瀏覽器啟動方法 +- **無縫體驗**：WSL 用戶可直接使用 Web UI，無需額外配置 + ## 🖥️ 介面預覽 ### Qt GUI 介面（重構版） @@ -172,10 +178,11 @@ uvx --with-editable . mcp-feedback-enhanced test --web # 測試 Web UI (自 📋 **完整版本更新記錄：** [RELEASE_NOTES/CHANGELOG.zh-TW.md](RELEASE_NOTES/CHANGELOG.zh-TW.md) -### 最新版本亮點（v2.2.2） -- 🔄 **超時自動清理**: 修復 GUI/Web UI 在 MCP session timeout 後沒有自動關閉的問題 -- 🛡️ **資源管理優化**: 改進超時處理機制，確保正確清理所有 UI 資源 -- 🎯 **QTimer 整合**: 在 GUI 中引入精確的 QTimer 超時控制機制 +### 最新版本亮點（v2.2.5） +- ✨ **WSL 環境支援**: 新增 WSL (Windows Subsystem for Linux) 環境的完整支援 +- 🌐 **智能瀏覽器啟動**: WSL 環境下自動調用 Windows 瀏覽器，支援多種啟動方式 +- 🎯 **環境檢測優化**: 改進遠端環境檢測邏輯，WSL 不再被誤判為遠端環境 +- 🧪 **測試體驗提升**: 測試模式下自動嘗試啟動瀏覽器，提供更好的測試體驗 ## 🐛 常見問題 @@ -214,7 +221,7 @@ uv cache clean ``` 詳細說明請參考：[Cache 管理指南](docs/zh-TW/cache-management.md) -**Q: AI 模型無法解析圖片** +**Q: AI 模型無法解析圖片** A: 各種 AI 模型（包括 Gemini Pro 2.5、Claude 等）在圖片解析上可能存在不穩定性，表現為有時能正確識別、有時無法解析上傳的圖片內容。這是 AI 視覺理解技術的已知限制。建議： 1. 確保圖片品質良好（高對比度、清晰文字） 2. 多嘗試幾次上傳，通常重試可以成功 diff --git a/RELEASE_NOTES/2.2.5/en.md b/RELEASE_NOTES/v2.2.5/en.md similarity index 100% rename from RELEASE_NOTES/2.2.5/en.md rename to RELEASE_NOTES/v2.2.5/en.md diff --git a/RELEASE_NOTES/2.2.5/zh-CN.md b/RELEASE_NOTES/v2.2.5/zh-CN.md similarity index 100% rename from RELEASE_NOTES/2.2.5/zh-CN.md rename to RELEASE_NOTES/v2.2.5/zh-CN.md diff --git a/RELEASE_NOTES/2.2.5/zh-TW.md b/RELEASE_NOTES/v2.2.5/zh-TW.md similarity index 100% rename from RELEASE_NOTES/2.2.5/zh-TW.md rename to RELEASE_NOTES/v2.2.5/zh-TW.md