mirror of
https://github.com/Minidoracat/mcp-feedback-enhanced.git
synced 2025-07-27 10:42:25 +08:00
📝 更新 2.2.5 相關文檔
This commit is contained in:
Minidoracat
parent
dc1789ccff
commit
0ebf60aa34
31
README.md
31
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
|
||||
|
||||
@ -217,6 +224,16 @@ A: Known issue. Gemini Pro 2.5 may not correctly parse uploaded image content. T
|
||||
**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
|
||||
|
||||
@ -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 不再被误判为远程环境
|
||||
- 🧪 **测试体验提升**: 测试模式下自动尝试启动浏览器，提供更好的测试体验
|
||||
|
||||
## 🐛 常见问题
|
||||
|
||||
@ -217,6 +224,16 @@ A: 已知问题，Gemini Pro 2.5 可能无法正确解析上传的图片内容
|
||||
**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 浏览器启动，而不会被误判为远程环境。
|
||||
|
||||
## 🙏 致谢
|
||||
|
||||
### 🌟 支持原作者
|
||||
|
||||
@ -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 不再被誤判為遠端環境
|
||||
- 🧪 **測試體驗提升**: 測試模式下自動嘗試啟動瀏覽器，提供更好的測試體驗
|
||||
|
||||
## 🐛 常見問題
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user