📝 更新 v2.2.2 相關文檔

This commit is contained in:
Minidoracat 2025-06-03 22:34:29 +08:00
parent 5d09c3309a
commit 0ffe024bee
9 changed files with 165 additions and 129 deletions

View File

@ -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

View File

@ -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 超时控制机制
## 🐛 常见问题

View File

@ -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 超時控制機制
## 🐛 常見問題

View File

@ -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

View File

@ -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)
### 🌟 亮点

View File

@ -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)
### 🌟 亮點

View File

@ -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)

View File

@ -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)

View File

@ -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)