# Changelog (English) This document records all version updates for **MCP Feedback Enhanced**. --- # Release v2.2.4 - GUI Experience Optimization & Bug Fixes ## ๐ŸŒŸ Highlights This version focuses on GUI user experience optimization, fixing image copy-paste duplication issues, reorganizing localization file structure, and improving interface text readability. ## ๐Ÿ› Bug Fixes - ๐Ÿ–ผ๏ธ **Image Duplicate Paste Fix**: Fixed the issue where Ctrl+V image pasting in GUI would create duplicate images - ๐ŸŒ **Localization Switch Fix**: Fixed image settings area text not translating correctly when switching languages - ๐Ÿ“ **Font Readability Improvement**: Adjusted font sizes in image settings area for better readability ## ๐Ÿ“ฆ Installation & Update ```bash # Quick test latest version uvx mcp-feedback-enhanced@latest test --gui # Update to specific version uvx mcp-feedback-enhanced@v2.2.4 test ``` ## ๐Ÿ”— Related Links - Full Documentation: [README.md](../../README.md) - Issue Reports: [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues) - Project Homepage: [GitHub Repository](https://github.com/Minidoracat/mcp-feedback-enhanced) --- ## ๐ŸŒŸ Highlights This version introduces user-controllable timeout settings and flexible image upload configuration options, while improving UV Cache management tools to enhance the overall user experience. ## โœจ New Features - โฐ **User Timeout Control**: Added customizable timeout settings with flexible range from 30 seconds to 2 hours - โฑ๏ธ **Countdown Timer**: Real-time countdown timer display at the top of the interface for visual time reminders - ๐Ÿ–ผ๏ธ **Image Size Limits**: Added image upload size limit settings (unlimited/1MB/3MB/5MB) - ๐Ÿ”ง **Base64 Compatibility Mode**: Added Base64 detail mode to improve image recognition compatibility with AI models - ๐Ÿงน **UV Cache Management Tool**: Added `cleanup_cache.py` script to help manage and clean UV cache space ## ๐Ÿš€ Improvements - ๐Ÿ“š **Documentation Structure Optimization**: Reorganized documentation directory structure, moved images to `docs/{language}/images/` paths - ๐Ÿ“– **Cache Management Guide**: Added detailed UV Cache management guide with automated cleanup solutions - ๐ŸŽฏ **Smart Compatibility Hints**: Automatically display Base64 compatibility mode suggestions when image upload fails - ๐Ÿ”„ **Settings Sync Mechanism**: Improved image settings synchronization between different interface modes ## ๐Ÿ› Bug Fixes - ๐Ÿ›ก๏ธ **Timeout Handling Optimization**: Improved coordination between user-defined timeout and MCP system timeout - ๐Ÿ–ฅ๏ธ **Interface Auto-close**: Fixed interface auto-close and resource cleanup logic after timeout - ๐Ÿ“ฑ **Responsive Layout**: Optimized timeout control component display on small screen devices ## ๐Ÿ”ง Technical Improvements - ๐ŸŽ›๏ธ **Timeout Control Architecture**: Implemented separated design for frontend countdown timer and backend timeout handling - ๐Ÿ“Š **Image Processing Optimization**: Improved image upload size checking and format validation mechanisms - ๐Ÿ—‚๏ธ **Settings Persistence**: Enhanced settings saving mechanism to ensure correct saving and loading of user preferences - ๐Ÿงฐ **Tool Script Enhancement**: Added cross-platform cache cleanup tool with support for force cleanup and preview modes ## ๐Ÿ“ฆ Installation & Update ```bash # Quick test latest version uvx mcp-feedback-enhanced@latest test --gui # Update to specific version uvx mcp-feedback-enhanced@v2.2.3 test ``` ## ๐Ÿ”— Related Links - Full Documentation: [README.md](../../README.md) - Issue Reporting: [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues) - Related PRs: #22 (Timeout Control Feature), #19 (Image Settings Feature) --- ## [v2.2.3] - Timeout Control & Image Settings Enhancement (2025-01-XX) ### ๐ŸŒŸ Highlights This version introduces user-controllable timeout settings and flexible image upload configuration options, while improving UV Cache management tools to enhance the overall user experience. ### โœจ New Features - โฐ **User Timeout Control**: Added customizable timeout settings with flexible range from 30 seconds to 2 hours - โฑ๏ธ **Countdown Timer**: Real-time countdown timer display at the top of the interface for visual time reminders - ๐Ÿ–ผ๏ธ **Image Size Limits**: Added image upload size limit settings (unlimited/1MB/3MB/5MB) - ๐Ÿ”ง **Base64 Compatibility Mode**: Added Base64 detail mode to improve image recognition compatibility with AI models - ๐Ÿงน **UV Cache Management Tool**: Added `cleanup_cache.py` script to help manage and clean UV cache space ### ๐Ÿš€ Improvements - ๐Ÿ“š **Documentation Structure Optimization**: Reorganized documentation directory structure, moved images to `docs/{language}/images/` paths - ๐Ÿ“– **Cache Management Guide**: Added detailed UV Cache management guide with automated cleanup solutions - ๐ŸŽฏ **Smart Compatibility Hints**: Automatically display Base64 compatibility mode suggestions when image upload fails - ๐Ÿ”„ **Settings Sync Mechanism**: Improved image settings synchronization between different interface modes ### ๐Ÿ› Bug Fixes - ๐Ÿ›ก๏ธ **Timeout Handling Optimization**: Improved coordination between user-defined timeout and MCP system timeout - ๐Ÿ–ฅ๏ธ **Interface Auto-close**: Fixed interface auto-close and resource cleanup logic after timeout - ๐Ÿ“ฑ **Responsive Layout**: Optimized timeout control component display on small screen devices ### ๐Ÿ”ง Technical Improvements - ๐ŸŽ›๏ธ **Timeout Control Architecture**: Implemented separated design for frontend countdown timer and backend timeout handling - ๐Ÿ“Š **Image Processing Optimization**: Improved image upload size checking and format validation mechanisms - ๐Ÿ—‚๏ธ **Settings Persistence**: Enhanced settings saving mechanism to ensure correct saving and loading of user preferences - ๐Ÿงฐ **Tool Script Enhancement**: Added cross-platform cache cleanup tool with support for force cleanup and preview modes --- ## [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 This release primarily addresses GUI window size constraints, implements smart window state saving mechanisms, and optimizes the unified settings interface. ### ๐Ÿš€ Improvements - ๐Ÿ–ฅ๏ธ **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 - ๐Ÿ’พ **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 ### ๐Ÿ› Bug Fixes - ๐Ÿ”ง **Window Size Constraint**: Fixed GUI window unable to resize to small dimensions issue (fixes #10 part one) - ๐Ÿ›ก๏ธ **Setting Conflicts**: Fixed potential configuration conflicts during settings save operations --- ## [v2.2.0] - Layout & Settings UI Enhancements (2024-12-XX) ### ๐ŸŒŸ Highlights This version adds horizontal layout options, optimizes the settings interface, and fixes shortcut keys and image pasting issues. ### โœจ New Features - ๐ŸŽจ **Horizontal Layout Mode**: 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)) ### ๐Ÿš€ Improvements - ๐ŸŽจ **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) ### ๐Ÿ› Bug Fixes - ๐Ÿ”ง **Image Duplication Fix (Web UI)**: 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 (2024-11-XX) ### ๐ŸŒŸ Highlights Perfect solution for window positioning issues in multi-monitor environments, especially T-shaped screen arrangements and other complex configurations. ### โœจ New Features - ๐Ÿ–ฅ๏ธ **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] - Complete Refactored Version (2024-11-XX) ### ๐ŸŒŸ Highlights This is a major refactoring version where both GUI and Web UI adopt brand new modular architecture. ### ๐ŸŽจ Major Refactoring - ๐Ÿ—๏ธ **Complete Refactoring**: GUI and Web UI adopt modular architecture - ๐Ÿ“ **Centralized Management**: Reorganized folder structure, improved maintainability - ๐Ÿ–ฅ๏ธ **Interface Optimization**: Modern design and improved user experience ### โœจ New Features - ๐ŸŽ **macOS Interface Optimization**: Specialized improvements for macOS user experience - โš™๏ธ **Feature Enhancement**: New settings options and auto-close page functionality - โ„น๏ธ **About Page**: Added about page with version info, project links, and acknowledgments ### ๐Ÿ› Bug Fixes - ๐ŸŒ **Language Switching**: Fixed Web UI content update issues when switching languages --- ## [v2.0.14] - Shortcut & Image Feature Enhancement (2024-10-XX) ### ๐Ÿš€ Improvements - โŒจ๏ธ **Enhanced Shortcuts**: Ctrl+Enter supports numpad - ๐Ÿ–ผ๏ธ **Smart Image Pasting**: Ctrl+V directly pastes clipboard images --- ## [v2.0.9] - Multi-language Architecture Refactor (2024-10-XX) ### ๐Ÿ”„ Refactoring - ๐ŸŒ **Multi-language Architecture Refactor**: Support for dynamic loading - ๐Ÿ“ **Modularized Language Files**: Modular organization of language files --- ## [v2.0.3] - Encoding Issues Fix (2024-10-XX) ### ๐Ÿ› Critical Fixes - ๐Ÿ›ก๏ธ **Complete Chinese Character Encoding Fix**: Resolved all Chinese display related issues - ๐Ÿ”ง **JSON Parsing Error Fix**: Fixed data parsing errors --- ## [v2.0.0] - Web UI Support (2024-09-XX) ### ๐ŸŒŸ Major Features - โœ… **Added Web UI Support**: Support for remote environments - โœ… **Auto Environment Detection**: Automatically choose appropriate interface - โœ… **WebSocket Real-time Communication**: Real-time bidirectional communication --- ## Legend | Icon | Meaning | |------|---------| | ๐ŸŒŸ | Version Highlights | | โœจ | New Features | | ๐Ÿš€ | Improvements | | ๐Ÿ› | Bug Fixes | | ๐Ÿ”„ | Refactoring Changes | | ๐ŸŽจ | UI Optimization | | โš™๏ธ | Settings Related | | ๐Ÿ–ฅ๏ธ | Window Related | | ๐ŸŒ | Multi-language/Network Related | | ๐Ÿ“ | File Structure | | โŒจ๏ธ | Shortcuts | | ๐Ÿ–ผ๏ธ | Image Features | --- **Full Project Info:** [GitHub - mcp-feedback-enhanced](https://github.com/Minidoracat/mcp-feedback-enhanced)