# Changelog (English) This document records all version updates for **MCP Feedback Enhanced**. ## [v2.5.5] - 2025-06-21 - SSH Remote Development Support & Stability Enhancement ### ๐ŸŒŸ Version Highlights Added SSH remote development environment support, resolving Web UI access issues in remote development scenarios. Enhanced macOS compilation support and desktop application stability for improved developer experience. ### โœจ New Features - ๐ŸŒ **SSH Remote Development Support**: Added `MCP_WEB_HOST` environment variable for configuring web server host binding - Defaults to `127.0.0.1` for security - Can be set to `0.0.0.0` to allow remote access - Resolves access issues in remote development environments like Cursor SSH Remote - ๐ŸŽ **Enhanced macOS Compilation Support**: Added `.cargo/config.toml` configuration file - Supports Intel (x86_64) and Apple Silicon (aarch64) architectures - Resolves macOS PyO3 undefined dynamic_lookup compilation issues - Follows PyO3 official recommended best practices ### ๐Ÿš€ Improvements - ๐Ÿ“ **Tool Documentation Optimization**: Moved LLM instructions to tool docstring for improved token efficiency - ๐ŸŽจ **Simplified User Configuration**: Removed complex Cursor rules configuration - ๐Ÿ“Š **Enhanced AI Work Summary Markdown**: Improved Markdown rendering effects and compatibility - ๐Ÿ”„ **Session History Process Optimization**: Enhanced session saving and management mechanisms ### ๐Ÿ› Bug Fixes - ๐Ÿ–ฅ๏ธ **Desktop Application MCP Protocol Fix**: Fixed MCP protocol communication pollution issues in desktop mode - ๐Ÿ“ฆ **Packaging Process Fix**: Fixed multi-platform desktop application packaging and publishing issues - ๐Ÿ”ง **Release Process Optimization**: Improved stability of automated release workflows - ๐Ÿ”ฅ **Removed ESC Shortcut**: Removed ESC shortcut functionality that could cause accidental closure ### ๐Ÿ› ๏ธ Technical Improvements - ๐Ÿ—๏ธ **Enhanced Build System**: Improved cross-platform compilation configuration and dependency management - ๐Ÿ“š **Documentation Automation**: Enhanced tool self-documentation following FastMCP best practices - ๐Ÿ” **Enhanced Debugging Features**: Added more detailed debugging information and error handling ### ๐Ÿ“‹ Usage Instructions - **SSH Remote Development**: Set `"MCP_WEB_HOST": "0.0.0.0"` in MCP configuration to allow remote access - **Local Development**: Keep default `"MCP_WEB_HOST": "127.0.0.1"` for security - **macOS Development**: New compilation configuration will take effect automatically without additional setup --- ## [v2.5.0] - 2025-06-15 - Desktop Application & Performance Optimization ### ๐ŸŒŸ Version Highlights Introducing cross-platform desktop application supporting Windows, macOS, and Linux. Significant performance improvements with debounce/throttle mechanisms and enhanced system stability. ### โœจ New Features - ๐Ÿ–ฅ๏ธ **Desktop Application**: Native cross-platform desktop app based on Tauri framework, supporting Windows x64, macOS (Intel/Apple Silicon), Linux x64 - ๐Ÿ“Š **Server-side Session History Storage**: Session records migrated from localStorage to server-side local file storage for improved data consistency and reliability - ๐Ÿ”ง **Multi-platform Build Support**: Complete CI/CD pipeline supporting automated multi-platform desktop application builds - ๐Ÿ“ **Desktop Mode Configuration**: Added `MCP_DESKTOP_MODE` environment variable for desktop/web mode switching - ๐Ÿ“‹ **AI Work Summary Markdown Display**: Support for Markdown syntax rendering including headers, bold text, code blocks, lists, links and other formats ### ๐Ÿš€ Improvements - โšก **Significant Performance Enhancement**: Introduced debounce/throttle mechanisms to reduce unnecessary rendering and network requests - ๐ŸŒ **Network Connection Stability**: Improved WebSocket reconnection mechanism with network status detection and intelligent reconnection - ๐ŸŽจ **UI Rendering Optimization**: Optimized rendering performance for session management, statistics, and status indicators - ๐Ÿ“ฑ **Responsive Improvements**: Adjusted heartbeat frequency and timeout thresholds to reduce system load - ๐Ÿ”„ **Enhanced Modularity**: Optimized JavaScript module structure with better logging management ### ๐Ÿ› Bug Fixes - ๐ŸŒ **Network Reconnection Improvements**: Optimized reconnection algorithm with exponential backoff strategy and random jitter - ๐Ÿ–ฅ๏ธ **Desktop Mode Adaptation**: Fixed browser auto-launch issues in desktop mode - ๐Ÿ“Š **Rendering Performance Fixes**: Resolved duplicate rendering and unnecessary state update issues ### ๐Ÿ› ๏ธ Technical Improvements - ๐Ÿ—๏ธ **Build Process Optimization**: Added Makefile desktop application build commands supporting debug/release modes - ๐Ÿ“ฆ **Dependency Management**: Integrated Rust toolchain supporting cross-platform compilation and packaging - ๐Ÿ” **Enhanced Development Tools**: Added environment checks, build validation, and cleanup tools - ๐Ÿ“š **Documentation Enhancement**: Added desktop application build guide and workflow documentation - ๐Ÿ”’ **Security Enhancement**: Introduced DOMPurify for XSS protection ensuring content security ### ๐Ÿ“‹ Usage Instructions - **Desktop Mode**: Set `"MCP_DESKTOP_MODE": "true"` in MCP configuration (refer to `examples/mcp-config-desktop.json`) - **Web Mode**: Set `"MCP_DESKTOP_MODE": "false"` in MCP configuration (default, refer to `examples/mcp-config-web.json`) - **Test Desktop Mode**: `uvx mcp-feedback-enhanced@latest test --desktop` - **Build Desktop Application**: `make build-desktop-release` --- ## [v2.4.3] - 2025-06-14 - Session Management Refactoring & Audio Notifications ### ๐ŸŒŸ Version Highlights Migrated session management from sidebar to dedicated tab, resolving browser compatibility issues. Added audio notification system with custom audio support. ### โœจ New Features - ๐Ÿ”Š **Audio Notification System**: Play audio alerts for session updates, supports built-in and custom audio uploads - ๐Ÿ“š **Session History Management**: Local session record storage with export and cleanup functionality - ๐Ÿ’พ **Input Height Memory**: Automatically save and restore textarea input height settings - ๐Ÿ“‹ **One-Click Copy**: Project path and session ID support click-to-copy ### ๐Ÿš€ Improvements - ๐Ÿ“‹ **Session Management Refactoring**: Migrated from sidebar to "Session Management" tab, fixing button click issues in small windows - ๐ŸŽจ **Interface Layout Optimization**: AI summary auto-expansion, submit button repositioning, removed redundant descriptions - ๐ŸŒ **Multilingual Enhancement**: Added tooltip and button multilingual support ### ๐Ÿ› Bug Fixes - Fixed current session details button unresponsive issue - Fixed session details modal close delay issue - Fixed audio notification language initialization issue - Corrected auto-submit processing logic --- ## [v2.4.2] - Web-Only Architecture Refactoring & Smart Feature Enhancement ### ๐ŸŒŸ Version Highlights This version underwent major architectural refactoring, **completely removing PyQt6 GUI dependencies** and transitioning to a pure Web UI architecture, dramatically simplifying deployment and maintenance. Additionally, multiple smart features were added, including prompt management, auto-submit, session management, and more, comprehensively enhancing user experience and work efficiency. ### ๐Ÿ”„ Major Architectural Changes - ๐Ÿ—๏ธ **Complete PyQt6 GUI Removal**: Thoroughly removed desktop application dependencies, simplifying installation and deployment processes - ๐ŸŒ **Pure Web UI Architecture**: Unified use of Web interface, supporting all platforms and environments - ๐Ÿ“ฆ **Dramatically Simplified Dependencies**: Removed PyQt6, related GUI libraries and other heavy dependencies, significantly reducing installation package size - ๐Ÿš€ **Simpler Deployment**: No need to consider GUI environment configuration, suitable for all development environments ### โœจ Brand New Features - ๐Ÿ“ **Smart Prompt Management System**: - CRUD operations for common prompts (Create, Edit, Delete, Use) - Usage frequency statistics and intelligent sorting - Quick selection and one-click application functionality - Support for auto-submit marking and priority display - โฐ **Auto-Timed Submit Feature**: - Configurable countdown timer from 1-86400 seconds - Visual countdown display and status indicators - Deep integration with prompt management system - Support for pause, resume, and cancel operations - ๐Ÿ“Š **Session Management & Tracking**: - Real-time current session status display - Session history records and statistical analysis - Today's session count and average duration statistics - Session detail viewing and management functions - ๐Ÿ”— **Connection Monitoring System**: - Real-time WebSocket connection status monitoring - Latency measurement and connection quality indicators - Auto-reconnection mechanism and error handling - Detailed connection statistical information - โŒจ๏ธ **Enhanced Shortcuts**: Added Ctrl+I quick focus input box feature (Thanks @penn201500) ### ๐Ÿš€ Feature Improvements - ๐ŸŽจ **Comprehensive UI/UX Optimization**: - Added left session management panel with collapse/expand support - Top connection status bar with real-time system status display - Responsive design adapting to different screen sizes - Unified design language and visual style - ๐ŸŒ **Enhanced Multi-language System**: - Optimized language switching mechanism with instant switching support - Added extensive translation text, improving localization coverage - Improved language selector UI with dropdown design - Fixed display issues during language switching - ๐Ÿ–ผ๏ธ **Image Settings Integration**: - Moved image settings from workspace to settings tab - Unified settings management interface - Improved organization and layout of setting items - ๐Ÿ“ฑ **Interface Layout Optimization**: - Adjusted layout to accommodate multi-language display requirements - Optimized button styles and spacing - Improved visual design of form elements - Enhanced accessibility and usability ### ๐Ÿ› Bug Fixes - ๐Ÿ”ง **Session Management Fixes**: - Fixed session statistics information not updating correctly - Fixed session count calculation errors - Improved session state tracking mechanism - ๐ŸŽฏ **Prompt Feature Fixes**: - Fixed common prompt management unable to correctly set auto-submit - Improved prompt selection and application logic - ๐ŸŒ **Localization Switch Fixes**: - Fixed partial text not updating during language switching - Improved multi-language text loading mechanism - ๐Ÿ—๏ธ **Architecture Stability Fixes**: - Fixed session management initialization issues - Improved error handling and resource cleanup - Optimized module loading order and dependencies ### ๐Ÿ› ๏ธ Technical Improvements - ๐Ÿ“ฆ **Modular Architecture**: - Complete JavaScript code modular refactoring - Adopted ES6+ syntax and modern development patterns - Clear module separation and responsibility division - ๐Ÿ“Š **Performance Enhancement**: - Optimized WebSocket communication efficiency - Improved frontend resource loading speed - Reduced memory usage and CPU load ### ๐Ÿ“š Documentation Updates - ๐Ÿ“– **Architecture Documentation Update**: Updated system architecture description to reflect Web-Only design - ๐Ÿ”ง **Installation Guide Simplification**: Removed GUI-related installation steps and dependency descriptions - ๐Ÿ–ผ๏ธ **Screenshot Updates**: Updated all interface screenshots to showcase new Web UI design - ๐Ÿ“‹ **Enhanced API Documentation**: Added API descriptions for new features like prompt management and auto-submit --- ## [v2.3.0] - System Stability & Resource Management Enhancement ### ๐ŸŒŸ Highlights This version focuses on improving system stability and user experience, particularly solving the browser launch issue in Cursor SSH Remote environments. ### โœจ New Features - ๐ŸŒ **SSH Remote Environment Support**: Solved Cursor SSH Remote browser launch issues with clear usage guidance - ๐Ÿ›ก๏ธ **Error Message Improvements**: Provides more user-friendly error messages and solution suggestions when errors occur - ๐Ÿงน **Auto-cleanup Features**: Automatically cleans temporary files and expired sessions to keep the system tidy - ๐Ÿ“Š **Memory Monitoring**: Monitors memory usage to prevent system resource shortage ### ๐Ÿš€ Improvements - ๐Ÿ’พ **Resource Management Optimization**: Better system resource management for improved performance - ๐Ÿ”ง **Enhanced Error Handling**: Provides clearer explanations and solutions when problems occur - ๐ŸŒ **Connection Stability**: Improved Web UI connection stability - ๐Ÿ–ผ๏ธ **Image Upload Optimization**: Enhanced stability of image upload functionality - ๐ŸŽฏ **Auto-focus Input Box**: Automatically focus on feedback input box when window opens, improving user experience (Thanks @penn201500) ### ๐Ÿ› Bug Fixes - ๐ŸŒ **Connection Issues**: Fixed WebSocket connection related problems - ๐Ÿ”„ **Session Management**: Fixed session state tracking issues - ๐Ÿ–ผ๏ธ **Image Processing**: Fixed event handling issues during image upload --- ## [v2.2.5] - WSL Environment Support & Cross-Platform Enhancement ### โœจ New Features - ๐Ÿง **WSL Environment Detection**: Automatically identifies WSL environments and provides specialized support logic - ๐ŸŒ **Smart Browser Launching**: Automatically invokes Windows browser in WSL environments with multiple launch methods - ๐Ÿ”ง **Cross-Platform Testing Enhancement**: Test functionality integrates WSL detection for improved test coverage ### ๐Ÿš€ Improvements - ๐ŸŽฏ **Environment Detection Optimization**: Improved remote environment detection logic, WSL no longer misidentified as remote environment - ๐Ÿ“Š **System Information Enhancement**: System information tool now displays WSL environment status - ๐Ÿงช **Testing Experience Improvement**: Test mode automatically attempts browser launching for better testing experience --- ## [v2.2.4] - GUI Experience Optimization & Bug Fixes ### ๐Ÿ› 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 --- ## [v2.2.3] - Timeout Control & Image Settings Enhancement ### โœจ 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 ### ๐Ÿ› 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 --- ## [v2.2.2] - Timeout Auto-cleanup Fix ### ๐Ÿ› 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 --- ## [v2.2.1] - Window Optimization & Unified Settings Interface ### ๐Ÿš€ Improvements - ๐Ÿ–ฅ๏ธ **Window Size Constraint Removal**: Removed GUI main window minimum size limit from 1000ร—800 to 400ร—300 - ๐Ÿ’พ **Real-time Window State Saving**: Implemented real-time saving mechanism for window size and position changes - โš™๏ธ **Unified Settings Interface Optimization**: Improved GUI settings page configuration saving logic to avoid setting conflicts ### ๐Ÿ› Bug Fixes - ๐Ÿ”ง **Window Size Constraint**: Fixed GUI window unable to resize to small dimensions issue - ๐Ÿ›ก๏ธ **Setting Conflicts**: Fixed potential configuration conflicts during settings save operations --- ## [v2.2.0] - Layout & Settings UI Enhancements ### โœจ New Features - ๐ŸŽจ **Horizontal Layout Mode**: GUI & Web UI combined mode adds left-right layout option for summary and feedback ### ๐Ÿš€ Improvements - ๐ŸŽจ **Improved Settings Interface**: Optimized the settings page for both GUI and Web UI - โŒจ๏ธ **GUI Shortcut Enhancement**: Submit feedback shortcut now fully supports numeric keypad Enter key ### ๐Ÿ› Bug Fixes - ๐Ÿ”ง **Image Duplication Fix**: Resolved Web UI image pasting duplication issue --- ## [v2.1.1] - Window Positioning Optimization ### โœจ 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 --- ## [v2.1.0] - Complete Refactored Version ### ๐ŸŽจ 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 --- ## [v2.0.14] - Shortcut & Image Feature Enhancement ### ๐Ÿš€ Improvements - โŒจ๏ธ **Enhanced Shortcuts**: Ctrl+Enter supports numeric keypad - ๐Ÿ–ผ๏ธ **Smart Image Pasting**: Ctrl+V directly pastes clipboard images --- ## [v2.0.9] - Multi-language Architecture Refactor ### ๐Ÿ”„ Refactoring - ๐ŸŒ **Multi-language Architecture Refactor**: Support for dynamic loading - ๐Ÿ“ **Modularized Language Files**: Modular organization of language files --- ## [v2.0.3] - Encoding Issues Fix ### ๐Ÿ› 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 ### ๐ŸŒŸ 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 | | ๐Ÿ“ | Prompt Management | | โฐ | Auto-Submit | | ๐Ÿ“Š | Session Management | | ๐Ÿ”— | Connection Monitoring | | ๐Ÿ—๏ธ | Architecture Changes | | ๐Ÿ› ๏ธ | Technical Improvements | | ๐Ÿ“š | Documentation Updates | --- **Full Project Info:** [GitHub - mcp-feedback-enhanced](https://github.com/Minidoracat/mcp-feedback-enhanced)