diff --git a/README.md b/README.md index 28a62b8..090e0be 100644 --- a/README.md +++ b/README.md @@ -168,51 +168,14 @@ uvx --with-editable . mcp-feedback-enhanced test --web # Test Web UI (auto co - **Qt GUI Test**: Quick launch and test of local graphical interface - **Web UI Test**: Start Web server and keep running for complete Web functionality testing -## 🆕 Version Highlights +## 🆕 Version History -### v2.2.1 (Window Optimization & Unified Settings Interface) -- 🖥️ **Window Size Constraint Removal**: Removed GUI main window minimum size limit from 1000×800 to 400×300, allowing users to freely adjust window size for different use cases (fixes [Issue #10](https://github.com/Minidoracat/mcp-feedback-enhanced/issues/10) part one). -- 💾 **Real-time Window State Saving**: Implemented real-time saving mechanism for window size and position changes, with debounce delay to avoid excessive I/O operations. -- ⚙️ **Unified Settings Interface Optimization**: Improved GUI settings page configuration saving logic to avoid setting conflicts, ensuring correct window positioning and size settings. -- 🎯 **Smart Window Size Saving**: In "Always center display" mode, correctly saves window size (but not position); in "Smart positioning" mode, saves complete window state. +📋 **Complete Version History:** [RELEASE_NOTES/CHANGELOG.en.md](RELEASE_NOTES/CHANGELOG.en.md) -### v2.2.0 (Layout & Settings UI Enhancements) -- ✨ **Enhanced Interface Layout**: Added a left-right layout (horizontal split) option for summary and feedback in the combined mode for both GUI and Web UI, offering more flexible viewing (fulfills [Issue #1](https://github.com/Minidoracat/mcp-feedback-enhanced/issues/1)). -- 🎨 **Improved Settings Interface**: Optimized the settings page for both GUI and Web UI, enhancing layout clarity and user experience. -- ⌨️ **GUI Shortcut Enhancement**: The submit feedback shortcut (Ctrl+Enter / Cmd+Enter) now fully supports the Enter key on the numeric keypad (numpad). -- 🐞 **Web UI Bug Fix**: Resolved an issue where pasting images using Ctrl+V in the text input area could lead to duplicate image pasting. - -### v2.1.1 (Window Positioning Optimization) -- 🖥️ **Smart Window Positioning**: Added "Always show window at primary screen center" setting option -- 🌐 **Multi-Monitor Support**: Perfect solution for complex multi-monitor setups like T-shaped screen arrangements -- 💾 **Position Memory**: Auto-save and restore window position with intelligent visibility detection -- ⚙️ **User Choice**: Provides smart positioning (default) and forced center display modes - -### v2.1.0 (Latest Refactored Version) -- 🎨 **Complete Refactoring**: GUI and Web UI adopt modular architecture -- 📁 **Centralized Management**: Reorganized folder structure, improved maintainability -- 🖥️ **Interface Optimization**: Modern design and improved user experience -- 🍎 **macOS Interface Optimization**: Specialized improvements for macOS user experience -- ⚙️ **Feature Enhancement**: New settings options and auto-close page functionality -- 🌐 **Language Switching**: Fixed Web UI content update issues when switching languages -- ℹ️ **About Page**: Added about page with version info, project links, and acknowledgments - -### v2.0.14 -- ⌨️ Enhanced Shortcuts: Ctrl+Enter supports numpad -- 🖼️ Smart Image Pasting: Ctrl+V directly pastes clipboard images - -### v2.0.9 -- 🌏 Multi-language architecture refactor with dynamic loading -- 📁 Modularized language file organization - -### v2.0.3 -- 🛡️ Complete fix for Chinese character encoding issues -- 🔧 Resolved JSON parsing errors - -### v2.0.0 -- ✅ Added Web UI support for remote environments -- ✅ Auto environment detection and interface selection -- ✅ WebSocket real-time communication +### 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 ## 🐛 Common Issues diff --git a/README.zh-CN.md b/README.zh-CN.md index 271a9d2..087c3a8 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -168,51 +168,14 @@ uvx --with-editable . mcp-feedback-enhanced test --web # 测试 Web UI (自 - **Qt GUI 测试**:快速启动并测试本地图形界面 - **Web UI 测试**:启动 Web 服务器并保持运行,便于完整测试 Web 功能 -## 🆕 版本亮点 +## 🆕 版本更新记录 -### v2.2.1 (窗口优化与统一设置接口) -- 🖥️ **窗口大小限制解除**:解除 GUI 主窗口最小大小限制,从 1000×800 降至 400×300,让用户可以自由调整窗口大小以符合不同使用场景 (解决 [Issue #10](https://github.com/Minidoracat/mcp-feedback-enhanced/issues/10) 第一部分)。 -- 💾 **窗口状态实时保存**:实现窗口大小与位置的即时保存机制,支持防抖延迟避免过度频繁的 I/O 操作。 -- ⚙️ **统一设置接口优化**:改进 GUI 设置版面的配置保存逻辑,避免设置冲突,确保窗口定位与大小设置的正确性。 -- 🎯 **智能窗口大小保存**:「总是在主屏幕中心显示」模式下正确保存窗口大小(但不保存位置),「智能定位」模式下保存完整的窗口状态。 +📋 **完整版本更新记录:** [RELEASE_NOTES/CHANGELOG.zh-CN.md](RELEASE_NOTES/CHANGELOG.zh-CN.md) -### v2.2.0 (布局与设置界面优化) -- ✨ **界面布局增强**:GUI 与 Web UI 的合并模式新增摘要与反馈的左右布局(水平分割)选项,提供更灵活的查看方式 (实现 [Issue #1](https://github.com/Minidoracat/mcp-feedback-enhanced/issues/1))。 -- 🎨 **设置界面改进**:优化了 GUI 与 Web UI 的设置页面,提升布局清晰度与用户操作体验。 -- ⌨️ **快捷键完善 (GUI)**:提交反馈快捷键 (Ctrl+Enter / Cmd+Enter) 现已完整支持数字键盘(九宫格)的 Enter 键。 -- 🐞 **问题修复 (Web UI)**:解决了在文本输入区使用 Ctrl+V 粘贴图片时,可能导致图片重复粘贴的问题。 - -### v2.1.1(窗口定位优化) -- 🖥️ **智能窗口定位**:新增「总是在主屏幕中心显示窗口」设置选项 -- 🌐 **多屏幕支持**:完美解决 T 字型屏幕排列等复杂多屏幕环境的窗口定位问题 -- 💾 **位置记忆**:自动保存和恢复窗口位置,智能检测窗口可见性 -- ⚙️ **用户选择**:提供智能定位(默认)和强制中心显示两种模式 - -### v2.1.0(最新重构版) -- 🎨 **全面重构**:GUI 和 Web UI 采用模块化架构 -- 📁 **集中管理**:重新组织文件夹结构,提升维护性 -- 🖥️ **界面优化**:现代化设计和改进的用户体验 -- 🍎 **macOS 界面优化**:针对 macOS 用户体验进行专项改进 -- ⚙️ **功能增强**:新增设置选项和自动关闭页面功能 -- 🌐 **语言切换**:修复 Web UI 语言切换时内容更新问题 -- ℹ️ **关于页面**:新增关于页面,包含版本信息、项目链接和致谢内容 - -### v2.0.14 -- ⌨️ 增强快捷键:Ctrl+Enter 支持数字键盘 -- 🖼️ 智能图片粘贴:Ctrl+V 直接粘贴剪贴板图片 - -### v2.0.9 -- 🌏 多语言架构重构,支持动态载入 -- 📁 语言文件模块化组织 - -### v2.0.3 -- 🛡️ 完全修复中文字符编码问题 -- 🔧 解决 JSON 解析错误 - -### v2.0.0 -- ✅ 新增 Web UI 支持远程环境 -- ✅ 自动环境检测与界面选择 -- ✅ WebSocket 即时通讯 +### 最新版本亮点(v2.2.2) +- 🔄 **超时自动清理**: 修复 GUI/Web UI 在 MCP session timeout 后没有自动关闭的问题 +- 🛡️ **资源管理优化**: 改进超时处理机制,确保正确清理所有 UI 资源 +- 🎯 **QTimer 整合**: 在 GUI 中引入精确的 QTimer 超时控制机制 ## 🐛 常见问题 diff --git a/README.zh-TW.md b/README.zh-TW.md index b03005f..cf4a1b5 100644 --- a/README.zh-TW.md +++ b/README.zh-TW.md @@ -168,51 +168,14 @@ uvx --with-editable . mcp-feedback-enhanced test --web # 測試 Web UI (自 - **Qt GUI 測試**:快速啟動並測試本地圖形界面 - **Web UI 測試**:啟動 Web 服務器並保持運行,便於完整測試 Web 功能 -## 🆕 版本亮點 +## 🆕 版本更新記錄 -### v2.2.1 (視窗優化與統一設定接口) -- 🖥️ **視窗大小限制解除**:解除 GUI 主視窗最小大小限制,從 1000×800 降至 400×300,讓用戶可以自由調整視窗大小以符合不同使用場景 (解決 [Issue #10](https://github.com/Minidoracat/mcp-feedback-enhanced/issues/10) 第一部分)。 -- 💾 **視窗狀態實時保存**:實現視窗大小與位置的即時保存機制,支援防抖延遲避免過度頻繁的 I/O 操作。 -- ⚙️ **統一設定接口優化**:改進 GUI 設定版面的配置保存邏輯,避免設定衝突,確保視窗定位與大小設定的正確性。 -- 🎯 **智能視窗大小保存**:「總是在主螢幕中心顯示」模式下正確保存視窗大小(但不保存位置),「智能定位」模式下保存完整的視窗狀態。 +📋 **完整版本更新記錄:** [RELEASE_NOTES/CHANGELOG.zh-TW.md](RELEASE_NOTES/CHANGELOG.zh-TW.md) -### v2.2.0 (佈局與設定界面優化) -- ✨ **界面佈局增強**:GUI 與 Web UI 的合併模式新增摘要與回饋的左右佈局(水平分割)選項,提供更靈活的檢視方式 (實現 [Issue #1](https://github.com/Minidoracat/mcp-feedback-enhanced/issues/1))。 -- 🎨 **設定界面改進**:優化了 GUI 與 Web UI 的設定頁面,提升佈局清晰度與用戶操作體驗。 -- ⌨️ **快捷鍵完善 (GUI)**:提交回饋快捷鍵 (Ctrl+Enter / Cmd+Enter) 現已完整支援數字鍵盤(九宮格)的 Enter 鍵。 -- 🐞 **問題修復 (Web UI)**:解決了在文字輸入區使用 Ctrl+V 貼上圖片時,可能導致圖片重複貼上的問題。 - -### v2.1.1(視窗定位優化) -- 🖥️ **智能視窗定位**:新增「總是在主螢幕中心顯示視窗」設定選項 -- 🌐 **多螢幕支援**:完美解決 T 字型螢幕排列等複雜多螢幕環境的視窗定位問題 -- 💾 **位置記憶**:自動保存和恢復視窗位置,智能檢測視窗可見性 -- ⚙️ **用戶選擇**:提供智能定位(預設)和強制中心顯示兩種模式 - -### v2.1.0(最新重構版) -- 🎨 **全面重構**:GUI 和 Web UI 採用模組化架構 -- 📁 **集中管理**:重新組織資料夾結構,提升維護性 -- 🖥️ **界面優化**:現代化設計和改進的用戶體驗 -- 🍎 **macOS 介面優化**:針對 macOS 用戶體驗進行專項改進 -- ⚙️ **功能增強**:新增設定選項和自動關閉頁面功能 -- 🌐 **語言切換**:修復 Web UI 語言切換時內容更新問題 -- ℹ️ **About 頁面**:新增關於頁面,包含版本資訊、專案連結和致謝內容 - -### v2.0.14 -- ⌨️ 增強快捷鍵:Ctrl+Enter 支援數字鍵盤 -- 🖼️ 智能圖片貼上:Ctrl+V 直接貼上剪貼板圖片 - -### v2.0.9 -- 🌏 多語言架構重構,支援動態載入 -- 📁 語言檔案模組化組織 - -### v2.0.3 -- 🛡️ 完全修復中文字符編碼問題 -- 🔧 解決 JSON 解析錯誤 - -### v2.0.0 -- ✅ 新增 Web UI 支援遠端環境 -- ✅ 自動環境檢測與介面選擇 -- ✅ WebSocket 即時通訊 +### 最新版本亮點(v2.2.2) +- 🔄 **超時自動清理**: 修復 GUI/Web UI 在 MCP session timeout 後沒有自動關閉的問題 +- 🛡️ **資源管理優化**: 改進超時處理機制,確保正確清理所有 UI 資源 +- 🎯 **QTimer 整合**: 在 GUI 中引入精確的 QTimer 超時控制機制 ## 🐛 常見問題 diff --git a/RELEASE_NOTES/CHANGELOG.en.md b/RELEASE_NOTES/CHANGELOG.en.md index 83e2c38..ac59d3d 100644 --- a/RELEASE_NOTES/CHANGELOG.en.md +++ b/RELEASE_NOTES/CHANGELOG.en.md @@ -4,6 +4,25 @@ This document records all version updates for **MCP Feedback Enhanced**. --- +## [v2.2.2] - Timeout Auto-cleanup Fix (2024-12-XX) + +### 🌟 Highlights +This version fixes a critical resource management issue where GUI/Web UI interfaces were not properly closed when MCP sessions ended due to timeout, causing the interfaces to remain open and unresponsive. + +### 🐛 Bug Fixes +- 🔄 **Timeout Auto-cleanup**: Fixed GUI/Web UI not automatically closing after MCP session timeout (default 600 seconds) (fixes #5) +- 🛡️ **Resource Management Optimization**: Improved timeout handling mechanism to ensure proper cleanup and closure of all UI resources on timeout +- ⚡ **Enhanced Timeout Detection**: Strengthened timeout detection logic to correctly handle timeout events in various scenarios +- 🔧 **Interface Response Improvement**: Enhanced Web UI frontend handling of session timeout events + +### 🚀 Technical Improvements +- 📦 **Web Session Management**: Refactored WebFeedbackSession timeout handling logic +- 🎯 **QTimer Integration**: Introduced precise QTimer timeout control mechanism in GUI +- 🌐 **Frontend Communication Optimization**: Improved timeout message communication between Web UI frontend and backend +- 🧹 **Resource Cleanup Mechanism**: Added _cleanup_resources_on_timeout method to ensure thorough cleanup + +--- + ## [v2.2.1] - Window Optimization & Unified Settings Interface (2024-12-XX) ### 🌟 Highlights diff --git a/RELEASE_NOTES/CHANGELOG.zh-CN.md b/RELEASE_NOTES/CHANGELOG.zh-CN.md index f2ecaf4..80ecba0 100644 --- a/RELEASE_NOTES/CHANGELOG.zh-CN.md +++ b/RELEASE_NOTES/CHANGELOG.zh-CN.md @@ -4,6 +4,25 @@ --- +## [v2.2.2] - 超时自动清理修复 (2024-12-XX) + +### 🌟 亮点 +本版本修复了一个重要的资源管理问题:当 MCP session 因超时结束时,GUI/Web UI 界面没有正确关闭,导致界面持续显示而无法正常关闭。 + +### 🐛 问题修复 +- 🔄 **超时自动清理**: 修复 GUI/Web UI 在 MCP session timeout (默认 600 秒) 后没有自动关闭的问题 (fixes #5) +- 🛡️ **资源管理优化**: 改进超时处理机制,确保在超时时正确清理和关闭所有 UI 资源 +- ⚡ **超时检测增强**: 加强超时检测逻辑,确保在各种情况下都能正确处理超时事件 +- 🔧 **界面响应改进**: 改善 Web UI 前端对 session timeout 事件的处理响应 + +### 🚀 技术改进 +- 📦 **Web Session 管理**: 重构 WebFeedbackSession 的超时处理逻辑 +- 🎯 **QTimer 整合**: 在 GUI 中引入精确的 QTimer 超时控制机制 +- 🌐 **前端通信优化**: 改进 Web UI 前端与后端的超时消息传递 +- 🧹 **资源清理机制**: 新增 _cleanup_resources_on_timeout 方法确保彻底清理 + +--- + ## [v2.2.1] - 窗口优化与统一设置接口 (2024-12-XX) ### 🌟 亮点 diff --git a/RELEASE_NOTES/CHANGELOG.zh-TW.md b/RELEASE_NOTES/CHANGELOG.zh-TW.md index 067e768..8ad92ef 100644 --- a/RELEASE_NOTES/CHANGELOG.zh-TW.md +++ b/RELEASE_NOTES/CHANGELOG.zh-TW.md @@ -4,6 +4,25 @@ --- +## [v2.2.2] - 超時自動清理修復 (2024-12-XX) + +### 🌟 亮點 +本版本修復了一個重要的資源管理問題:當 MCP session 因超時結束時,GUI/Web UI 介面沒有正確關閉,導致介面持續顯示而無法正常關閉。 + +### 🐛 問題修復 +- 🔄 **超時自動清理**: 修復 GUI/Web UI 在 MCP session timeout (預設 600 秒) 後沒有自動關閉的問題 (fixes #5) +- 🛡️ **資源管理優化**: 改進超時處理機制,確保在超時時正確清理和關閉所有 UI 資源 +- ⚡ **超時檢測增強**: 加強超時檢測邏輯,確保在各種情況下都能正確處理超時事件 +- 🔧 **介面回應改進**: 改善 Web UI 前端對 session timeout 事件的處理回應 + +### 🚀 技術改進 +- 📦 **Web Session 管理**: 重構 WebFeedbackSession 的超時處理邏輯 +- 🎯 **QTimer 整合**: 在 GUI 中引入精確的 QTimer 超時控制機制 +- 🌐 **前端通訊優化**: 改進 Web UI 前端與後端的超時訊息傳遞 +- 🧹 **資源清理機制**: 新增 _cleanup_resources_on_timeout 方法確保徹底清理 + +--- + ## [v2.2.1] - 視窗優化與統一設定接口 (2024-12-XX) ### 🌟 亮點 diff --git a/RELEASE_NOTES/v2.2.2/en.md b/RELEASE_NOTES/v2.2.2/en.md new file mode 100644 index 0000000..69a134d --- /dev/null +++ b/RELEASE_NOTES/v2.2.2/en.md @@ -0,0 +1,30 @@ +# Release v2.2.2 - Timeout Auto-cleanup Fix + +## 🌟 Highlights +This version fixes a critical resource management issue where GUI/Web UI interfaces were not properly closed when MCP sessions ended due to timeout, causing the interfaces to remain open and unresponsive. + +## 🐛 Bug Fixes +- 🔄 **Timeout Auto-cleanup**: Fixed GUI/Web UI not automatically closing after MCP session timeout (default 600 seconds) +- 🛡️ **Resource Management Optimization**: Improved timeout handling mechanism to ensure proper cleanup and closure of all UI resources on timeout +- ⚡ **Enhanced Timeout Detection**: Strengthened timeout detection logic to correctly handle timeout events in various scenarios +- 🔧 **Interface Response Improvement**: Enhanced Web UI frontend handling of session timeout events + +## 🚀 Technical Improvements +- 📦 **Web Session Management**: Refactored WebFeedbackSession timeout handling logic +- 🎯 **QTimer Integration**: Introduced precise QTimer timeout control mechanism in GUI +- 🌐 **Frontend Communication Optimization**: Improved timeout message communication between Web UI frontend and backend +- 🧹 **Resource Cleanup Mechanism**: Added _cleanup_resources_on_timeout method to ensure thorough cleanup + +## 📦 Installation & Update +```bash +# Quick test latest version +uvx mcp-feedback-enhanced@latest test --gui + +# Update to specific version +uvx mcp-feedback-enhanced@v2.2.2 test +``` + +## 🔗 Related Links +- Full Documentation: [README.md](../../README.md) +- Issue Reporting: [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues) +- Fixed Issue: #5 (GUI/Web UI timeout cleanup) \ No newline at end of file diff --git a/RELEASE_NOTES/v2.2.2/zh-CN.md b/RELEASE_NOTES/v2.2.2/zh-CN.md new file mode 100644 index 0000000..7e8437f --- /dev/null +++ b/RELEASE_NOTES/v2.2.2/zh-CN.md @@ -0,0 +1,30 @@ +# Release v2.2.2 - 超时自动清理修复 + +## 🌟 亮点 +本版本修复了一个重要的资源管理问题:当 MCP session 因超时结束时,GUI/Web UI 界面没有正确关闭,导致界面持续显示而无法正常关闭。 + +## 🐛 问题修复 +- 🔄 **超时自动清理**: 修复 GUI/Web UI 在 MCP session timeout (默认 600 秒) 后没有自动关闭的问题 +- 🛡️ **资源管理优化**: 改进超时处理机制,确保在超时时正确清理和关闭所有 UI 资源 +- ⚡ **超时检测增强**: 加强超时检测逻辑,确保在各种情况下都能正确处理超时事件 +- 🔧 **界面响应改进**: 改善 Web UI 前端对 session timeout 事件的处理响应 + +## 🚀 技术改进 +- 📦 **Web Session 管理**: 重构 WebFeedbackSession 的超时处理逻辑 +- 🎯 **QTimer 整合**: 在 GUI 中引入精确的 QTimer 超时控制机制 +- 🌐 **前端通信优化**: 改进 Web UI 前端与后端的超时消息传递 +- 🧹 **资源清理机制**: 新增 _cleanup_resources_on_timeout 方法确保彻底清理 + +## 📦 安装与更新 +```bash +# 快速测试最新版本 +uvx mcp-feedback-enhanced@latest test --gui + +# 更新到特定版本 +uvx mcp-feedback-enhanced@v2.2.2 test +``` + +## 🔗 相关链接 +- 完整文档: [README.zh-CN.md](../../README.zh-CN.md) +- 问题报告: [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues) +- 解决问题: #5 (GUI/Web UI timeout cleanup) \ No newline at end of file diff --git a/RELEASE_NOTES/v2.2.2/zh-TW.md b/RELEASE_NOTES/v2.2.2/zh-TW.md new file mode 100644 index 0000000..c83280b --- /dev/null +++ b/RELEASE_NOTES/v2.2.2/zh-TW.md @@ -0,0 +1,30 @@ +# Release v2.2.2 - 超時自動清理修復 + +## 🌟 亮點 +本版本修復了一個重要的資源管理問題:當 MCP session 因超時結束時,GUI/Web UI 介面沒有正確關閉,導致介面持續顯示而無法正常關閉。 + +## 🐛 問題修復 +- 🔄 **超時自動清理**: 修復 GUI/Web UI 在 MCP session timeout (預設 600 秒) 後沒有自動關閉的問題 +- 🛡️ **資源管理優化**: 改進超時處理機制,確保在超時時正確清理和關閉所有 UI 資源 +- ⚡ **超時檢測增強**: 加強超時檢測邏輯,確保在各種情況下都能正確處理超時事件 +- 🔧 **介面回應改進**: 改善 Web UI 前端對 session timeout 事件的處理回應 + +## 🚀 技術改進 +- 📦 **Web Session 管理**: 重構 WebFeedbackSession 的超時處理邏輯 +- 🎯 **QTimer 整合**: 在 GUI 中引入精確的 QTimer 超時控制機制 +- 🌐 **前端通訊優化**: 改進 Web UI 前端與後端的超時訊息傳遞 +- 🧹 **資源清理機制**: 新增 _cleanup_resources_on_timeout 方法確保徹底清理 + +## 📦 安裝與更新 +```bash +# 快速測試最新版本 +uvx mcp-feedback-enhanced@latest test --gui + +# 更新到特定版本 +uvx mcp-feedback-enhanced@v2.2.2 test +``` + +## 🔗 相關連結 +- 完整文檔: [README.zh-TW.md](../../README.zh-TW.md) +- 問題回報: [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues) +- 解決問題: #5 (GUI/Web UI timeout cleanup) \ No newline at end of file