first commit

2025-06-07 15:35:13 +08:00
parent 4e14f40dbf
commit 669705dc9a
115 changed files with 19831 additions and 0 deletions
--- a/RELEASE_NOTES/CHANGELOG.en.md
+++ b/RELEASE_NOTES/CHANGELOG.en.md
@@ -0,0 +1,190 @@
+# Changelog (English)
+
+This document records all version updates for **MCP Feedback Enhanced**.
+
+## [v2.2.5] - WSL Environment Support & Cross-Platform Enhancement
+# Release v2.2.5 - WSL Environment Support & Cross-Platform Enhancement
+
+## 🌟 Highlights
+This version introduces comprehensive support for WSL (Windows Subsystem for Linux) environments, enabling WSL users to seamlessly use this tool with automatic Windows browser launching, significantly improving cross-platform development experience.
+
+## ✨ 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
+
+## 📦 Installation & Update
+```bash
+# Quick test latest version
+uvx mcp-feedback-enhanced@latest test --gui
+
+# Update to specific version
+uvx mcp-feedback-enhanced@v2.2.5 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)
+
+---
+
+### ✨ 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 |
+
+---
+
+**Full Project Info:** [GitHub - mcp-feedback-enhanced](https://github.com/Minidoracat/mcp-feedback-enhanced) 
--- a/RELEASE_NOTES/CHANGELOG.zh-CN.md
+++ b/RELEASE_NOTES/CHANGELOG.zh-CN.md
@@ -0,0 +1,213 @@
+# 更新日志 (简体中文)
+
+本文件记录了 **MCP Feedback Enhanced** 的所有版本更新内容。
+
+## [v2.2.5] - WSL 环境支持与跨平台增强
+# Release v2.2.5 - WSL 环境支持与跨平台增强
+
+## 🌟 亮点
+本版本新增了 WSL (Windows Subsystem for Linux) 环境的完整支持，让 WSL 用户能够无缝使用本工具并自动启动 Windows 浏览器，大幅提升跨平台开发体验。
+
+## ✨ 新功能
+- 🐧 **WSL 环境检测**: 自动识别 WSL 环境，提供专门的支持逻辑
+- 🌐 **智能浏览器启动**: WSL 环境下自动调用 Windows 浏览器，支持多种启动方式
+- 🔧 **跨平台测试增强**: 测试功能整合 WSL 检测，提升测试覆盖率
+
+## 🚀 改进功能
+- 🎯 **环境检测优化**: 改进远程环境检测逻辑，WSL 不再被误判为远程环境
+- 📊 **系统信息增强**: 系统信息工具新增 WSL 环境状态显示
+- 🧪 **测试体验提升**: 测试模式下自动尝试启动浏览器，提供更好的测试体验
+
+## 📦 安装与更新
+```bash
+# 快速测试最新版本
+uvx mcp-feedback-enhanced@latest test --gui
+
+# 更新到特定版本
+uvx mcp-feedback-enhanced@v2.2.5 test
+```
+
+## 🔗 相关链接
+- 完整文档: [README.zh-CN.md](../../README.zh-CN.md)
+- 问题报告: [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues)
+- 项目首页: [GitHub Repository](https://github.com/Minidoracat/mcp-feedback-enhanced)
+
+---
+
+### ✨ 新功能
+- 🐧 **WSL 环境检测**: 自动识别 WSL 环境，提供专门的支持逻辑
+- 🌐 **智能浏览器启动**: WSL 环境下自动调用 Windows 浏览器，支持多种启动方式
+- 🔧 **跨平台测试增强**: 测试功能整合 WSL 检测，提升测试覆盖率
+
+### 🚀 改进功能
+- 🎯 **环境检测优化**: 改进远程环境检测逻辑，WSL 不再被误判为远程环境
+- 📊 **系统信息增强**: 系统信息工具新增 WSL 环境状态显示
+- 🧪 **测试体验提升**: 测试模式下自动尝试启动浏览器，提供更好的测试体验
+
+---
+
+## [v2.2.4] - GUI 体验优化与问题修复
+
+### 🐛 问题修复
+- 🖼️ **图片重复粘贴修复**: 解决 GUI 界面中使用 Ctrl+V 复制粘贴图片时出现重复粘贴的问题
+- 🌐 **语系切换修复**: 修复图片设定区域在语言切换时文字没有正确翻译的问题
+- 📝 **字体可读性改善**: 调整图片设定区域的字体大小，提升文字可读性
+
+---
+
+## [v2.2.5] - WSL 环境支持与跨平台增强
+
+### ✨ 新功能
+- 🐧 **WSL 环境检测**: 自动识别 WSL 环境，提供专门的支持逻辑
+- 🌐 **智能浏览器启动**: WSL 环境下自动调用 Windows 浏览器，支持多种启动方式
+- 🔧 **跨平台测试增强**: 测试功能整合 WSL 检测，提升测试覆盖率
+
+### 🚀 改进功能
+- 🎯 **环境检测优化**: 改进远程环境检测逻辑，WSL 不再被误判为远程环境
+- 📊 **系统信息增强**: 系统信息工具新增 WSL 环境状态显示
+- 🧪 **测试体验提升**: 测试模式下自动尝试启动浏览器，提供更好的测试体验
+
+---
+
+## [v2.2.4] - GUI 体验优化与问题修复
+
+### 🐛 问题修复
+- 🖼️ **图片重复粘贴修复**: 解决 GUI 界面中使用 Ctrl+V 复制粘贴图片时出现重复粘贴的问题
+- 🌐 **语系切换修复**: 修复图片设定区域在语言切换时文字没有正确翻译的问题
+- 📝 **字体可读性改善**: 调整图片设定区域的字体大小，提升文字可读性
+
+---
+
+## [v2.2.3] - 超时控制与图片设置增强
+
+### ✨ 新功能
+- ⏰ **用户超时控制**: 新增可自定义的超时设置功能，支持 30 秒至 2 小时的弹性设置
+- ⏱️ **倒数计时器**: 界面顶部显示实时倒数计时器，提供可视化的时间提醒
+- 🖼️ **图片大小限制**: 新增图片上传大小限制设置（无限制/1MB/3MB/5MB）
+- 🔧 **Base64 兼容模式**: 新增 Base64 详细模式，提升部分 AI 模型的图片识别兼容性
+- 🧹 **UV Cache 管理工具**: 新增 `cleanup_cache.py` 脚本，协助管理和清理 UV cache 空间
+
+### 🚀 改进功能
+- 📚 **文档结构优化**: 重新整理文档目录结构，将图片移至 `docs/{语言}/images/` 路径
+- 📖 **Cache 管理指南**: 新增详细的 UV Cache 管理指南，包含自动化清理方案
+- 🎯 **智能兼容性提示**: 当图片上传失败时自动显示 Base64 兼容模式建议
+
+### 🐛 问题修复
+- 🛡️ **超时处理优化**: 改进用户自定义超时与 MCP 系统超时的协调机制
+- 🖥️ **界面自动关闭**: 修复超时后界面自动关闭和资源清理逻辑
+- 📱 **响应式布局**: 优化超时控制组件在小屏幕设备上的显示效果
+
+---
+
+## [v2.2.2] - 超时自动清理修复
+
+### 🐛 问题修复
+- 🔄 **超时自动清理**: 修复 GUI/Web UI 在 MCP session timeout (默认 600 秒) 后没有自动关闭的问题
+- 🛡️ **资源管理优化**: 改进超时处理机制，确保在超时时正确清理和关闭所有 UI 资源
+- ⚡ **超时检测增强**: 加强超时检测逻辑，确保在各种情况下都能正确处理超时事件
+
+---
+
+## [v2.2.1] - 窗口优化与统一设置接口
+
+### 🚀 改进功能
+- 🖥️ **窗口大小限制解除**: 解除 GUI 主窗口最小大小限制，从 1000×800 降至 400×300
+- 💾 **窗口状态实时保存**: 实现窗口大小与位置的即时保存机制，支持防抖延迟
+- ⚙️ **统一设置接口优化**: 改进 GUI 设置版面的配置保存逻辑，避免设置冲突
+
+### 🐛 问题修复
+- 🔧 **窗口大小限制**: 解决 GUI 窗口无法调整至小尺寸的问题
+- 🛡️ **设置冲突**: 修复设置保存时可能出现的配置冲突问题
+
+---
+
+## [v2.2.0] - 布局与设置界面优化
+
+### ✨ 新功能
+- 🎨 **水平布局模式**: GUI 与 Web UI 的合并模式新增摘要与反馈的左右布局选项
+
+### 🚀 改进功能
+- 🎨 **设置界面改进**: 优化了 GUI 与 Web UI 的设置页面，提升布局清晰度
+- ⌨️ **快捷键完善**: 提交反馈快捷键现已完整支持数字键盘的 Enter 键
+
+### 🐛 问题修复
+- 🔧 **图片重复粘贴**: 解决了在 Web UI 文字输入区使用 Ctrl+V 粘贴图片时的重复问题
+
+---
+
+## [v2.1.1] - 窗口定位优化
+
+### ✨ 新功能
+- 🖥️ **智能窗口定位**: 新增「总是在主屏幕中心显示窗口」设置选项
+- 🌐 **多屏幕支持**: 完美解决 T 字型屏幕排列等复杂多屏幕环境的窗口定位问题
+- 💾 **位置记忆**: 自动保存和恢复窗口位置，智能检测窗口可见性
+
+---
+
+## [v2.1.0] - 全面重构版
+
+### 🎨 重大重构
+- 🏗️ **全面重构**: GUI 和 Web UI 采用模块化架构
+- 📁 **集中管理**: 重新组织文件夹结构，提升维护性
+- 🖥️ **界面优化**: 现代化设计和改进的用户体验
+
+### ✨ 新功能
+- 🍎 **macOS 界面优化**: 针对 macOS 用户体验进行专项改进
+- ⚙️ **功能增强**: 新增设置选项和自动关闭页面功能
+- ℹ️ **关于页面**: 新增关于页面，包含版本信息、项目链接和致谢内容
+
+---
+
+## [v2.0.14] - 快捷键与图片功能增强
+
+### 🚀 改进功能
+- ⌨️ **增强快捷键**: Ctrl+Enter 支持数字键盘
+- 🖼️ **智能图片粘贴**: Ctrl+V 直接粘贴剪贴板图片
+
+---
+
+## [v2.0.9] - 多语言架构重构
+
+### 🔄 重构
+- 🌏 **多语言架构重构**: 支持动态载入
+- 📁 **语言文件模块化**: 模块化组织语言文件
+
+---
+
+## [v2.0.3] - 编码问题修复
+
+### 🐛 重要修复
+- 🛡️ **完全修复中文字符编码问题**: 解决所有中文显示相关问题
+- 🔧 **解决 JSON 解析错误**: 修复数据解析错误
+
+---
+
+## [v2.0.0] - Web UI 支持
+
+### 🌟 重大功能
+- ✅ **新增 Web UI 支持**: 支持远程环境使用
+- ✅ **自动环境检测**: 自动选择合适的界面
+- ✅ **WebSocket 即时通讯**: 实现即时双向通讯
+
+---
+
+## 图例说明
+
+| 图标 | 意义 |
+|------|------|
+| 🌟 | 版本亮点 |
+| ✨ | 新功能 |
+| 🚀 | 改进功能 |
+| 🐛 | 问题修复 |
+| 🔄 | 重构变更 |
+| 🎨 | 界面优化 |
+| ⚙️ | 设置相关 |
+| 🖥️ | 窗口相关 |
+| 🌐 | 多语言/网络相关 |
+| 📁 | 文件结构 |
+| ⌨️ | 快捷键 |
+| 🖼️ | 图片功能 |
+
+---
+
+**完整项目信息：** [GitHub - mcp-feedback-enhanced](https://github.com/Minidoracat/mcp-feedback-enhanced) 
--- a/RELEASE_NOTES/CHANGELOG.zh-TW.md
+++ b/RELEASE_NOTES/CHANGELOG.zh-TW.md
@@ -0,0 +1,190 @@
+# 更新日誌 (繁體中文)
+
+本文件記錄了 **MCP Feedback Enhanced** 的所有版本更新內容。
+
+## [v2.2.5] - WSL 環境支援與跨平台增強
+# Release v2.2.5 - WSL 環境支援與跨平台增強
+
+## 🌟 亮點
+本版本新增了 WSL (Windows Subsystem for Linux) 環境的完整支援，讓 WSL 用戶能夠無縫使用本工具並自動啟動 Windows 瀏覽器，大幅提升跨平台開發體驗。
+
+## ✨ 新功能
+- 🐧 **WSL 環境檢測**: 自動識別 WSL 環境，提供專門的支援邏輯
+- 🌐 **智能瀏覽器啟動**: WSL 環境下自動調用 Windows 瀏覽器，支援多種啟動方式
+- 🔧 **跨平台測試增強**: 測試功能整合 WSL 檢測，提升測試覆蓋率
+
+## 🚀 改進功能
+- 🎯 **環境檢測優化**: 改進遠端環境檢測邏輯，WSL 不再被誤判為遠端環境
+- 📊 **系統資訊增強**: 系統資訊工具新增 WSL 環境狀態顯示
+- 🧪 **測試體驗提升**: 測試模式下自動嘗試啟動瀏覽器，提供更好的測試體驗
+
+## 📦 安裝與更新
+```bash
+# 快速測試最新版本
+uvx mcp-feedback-enhanced@latest test --gui
+
+# 更新到特定版本
+uvx mcp-feedback-enhanced@v2.2.5 test
+```
+
+## 🔗 相關連結
+- 完整文檔: [README.zh-TW.md](../../README.zh-TW.md)
+- 問題回報: [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues)
+- 專案首頁: [GitHub Repository](https://github.com/Minidoracat/mcp-feedback-enhanced)
+
+---
+
+### ✨ 新功能
+- 🐧 **WSL 環境檢測**: 自動識別 WSL 環境，提供專門的支援邏輯
+- 🌐 **智能瀏覽器啟動**: WSL 環境下自動調用 Windows 瀏覽器，支援多種啟動方式
+- 🔧 **跨平台測試增強**: 測試功能整合 WSL 檢測，提升測試覆蓋率
+
+### 🚀 改進功能
+- 🎯 **環境檢測優化**: 改進遠端環境檢測邏輯，WSL 不再被誤判為遠端環境
+- 📊 **系統資訊增強**: 系統資訊工具新增 WSL 環境狀態顯示
+- 🧪 **測試體驗提升**: 測試模式下自動嘗試啟動瀏覽器，提供更好的測試體驗
+
+---
+
+## [v2.2.4] - GUI 體驗優化與問題修復
+
+### 🐛 問題修復
+- 🖼️ **圖片重複貼上修復**: 解決 GUI 介面中使用 Ctrl+V 複製貼上圖片時出現重複貼上的問題
+- 🌐 **語系切換修復**: 修復圖片設定區域在語言切換時文字沒有正確翻譯的問題
+- 📝 **字體可讀性改善**: 調整圖片設定區域的字體大小，提升文字可讀性
+
+---
+
+## [v2.2.3] - 超時控制與圖片設定增強
+
+### ✨ 新功能
+- ⏰ **用戶超時控制**: 新增可自訂的超時設定功能，支援 30 秒至 2 小時的彈性設定
+- ⏱️ **倒數計時器**: 介面頂部顯示即時倒數計時器，提供視覺化的時間提醒
+- 🖼️ **圖片大小限制**: 新增圖片上傳大小限制設定（無限制/1MB/3MB/5MB）
+- 🔧 **Base64 相容模式**: 新增 Base64 詳細模式，提升部分 AI 模型的圖片識別相容性
+- 🧹 **UV Cache 管理工具**: 新增 `cleanup_cache.py` 腳本，協助管理和清理 UV cache 空間
+
+### 🚀 改進功能
+- 📚 **文檔結構優化**: 重新整理文檔目錄結構，將圖片移至 `docs/{語言}/images/` 路徑
+- 📖 **Cache 管理指南**: 新增詳細的 UV Cache 管理指南，包含自動化清理方案
+- 🎯 **智能相容性提示**: 當圖片上傳失敗時自動顯示 Base64 相容模式建議
+
+### 🐛 問題修復
+- 🛡️ **超時處理優化**: 改進用戶自訂超時與 MCP 系統超時的協調機制
+- 🖥️ **介面自動關閉**: 修復超時後介面自動關閉和資源清理邏輯
+- 📱 **響應式佈局**: 優化超時控制元件在小螢幕設備上的顯示效果
+
+---
+
+## [v2.2.2] - 超時自動清理修復
+
+### 🐛 問題修復
+- 🔄 **超時自動清理**: 修復 GUI/Web UI 在 MCP session timeout (預設 600 秒) 後沒有自動關閉的問題
+- 🛡️ **資源管理優化**: 改進超時處理機制，確保在超時時正確清理和關閉所有 UI 資源
+- ⚡ **超時檢測增強**: 加強超時檢測邏輯，確保在各種情況下都能正確處理超時事件
+
+---
+
+## [v2.2.1] - 視窗優化與統一設定接口
+
+### 🚀 改進功能
+- 🖥️ **視窗大小限制解除**: 解除 GUI 主視窗最小大小限制，從 1000×800 降至 400×300
+- 💾 **視窗狀態實時保存**: 實現視窗大小與位置的即時保存機制，支援防抖延遲
+- ⚙️ **統一設定接口優化**: 改進 GUI 設定版面的配置保存邏輯，避免設定衝突
+
+### 🐛 問題修復
+- 🔧 **視窗大小限制**: 解決 GUI 視窗無法調整至小尺寸的問題
+- 🛡️ **設定衝突**: 修復設定保存時可能出現的配置衝突問題
+
+---
+
+## [v2.2.0] - 佈局與設定界面優化
+
+### ✨ 新功能
+- 🎨 **水平佈局模式**: GUI 與 Web UI 的合併模式新增摘要與回饋的左右佈局選項
+
+### 🚀 改進功能
+- 🎨 **設定界面改進**: 優化了 GUI 與 Web UI 的設定頁面，提升佈局清晰度
+- ⌨️ **快捷鍵完善**: 提交回饋快捷鍵現已完整支援數字鍵盤的 Enter 鍵
+
+### 🐛 問題修復
+- 🔧 **圖片重複貼上**: 解決了在 Web UI 文字輸入區使用 Ctrl+V 貼上圖片時的重複問題
+
+---
+
+## [v2.1.1] - 視窗定位優化
+
+### ✨ 新功能
+- 🖥️ **智能視窗定位**: 新增「總是在主螢幕中心顯示視窗」設定選項
+- 🌐 **多螢幕支援**: 完美解決 T 字型螢幕排列等複雜多螢幕環境的視窗定位問題
+- 💾 **位置記憶**: 自動保存和恢復視窗位置，智能檢測視窗可見性
+
+---
+
+## [v2.1.0] - 全面重構版
+
+### 🎨 重大重構
+- 🏗️ **全面重構**: GUI 和 Web UI 採用模組化架構
+- 📁 **集中管理**: 重新組織資料夾結構，提升維護性
+- 🖥️ **界面優化**: 現代化設計和改進的用戶體驗
+
+### ✨ 新功能
+- 🍎 **macOS 界面優化**: 針對 macOS 用戶體驗進行專項改進
+- ⚙️ **功能增強**: 新增設定選項和自動關閉頁面功能
+- ℹ️ **關於頁面**: 新增關於頁面，包含版本資訊、專案連結和致謝內容
+
+---
+
+## [v2.0.14] - 快捷鍵與圖片功能增強
+
+### 🚀 改進功能
+- ⌨️ **增強快捷鍵**: Ctrl+Enter 支援數字鍵盤
+- 🖼️ **智能圖片貼上**: Ctrl+V 直接貼上剪貼簿圖片
+
+---
+
+## [v2.0.9] - 多語言架構重構
+
+### 🔄 重構
+- 🌏 **多語言架構重構**: 支援動態載入
+- 📁 **語言檔案模組化**: 模組化組織語言檔案
+
+---
+
+## [v2.0.3] - 編碼問題修復
+
+### 🐛 重要修復
+- 🛡️ **完全修復中文字符編碼問題**: 解決所有中文顯示相關問題
+- 🔧 **解決 JSON 解析錯誤**: 修復資料解析錯誤
+
+---
+
+## [v2.0.0] - Web UI 支援
+
+### 🌟 重大功能
+- ✅ **新增 Web UI 支援**: 支援遠端環境使用
+- ✅ **自動環境檢測**: 自動選擇合適的界面
+- ✅ **WebSocket 即時通訊**: 實現即時雙向通訊
+
+---
+
+## 圖例說明
+
+| 圖示 | 意義 |
+|------|------|
+| 🌟 | 版本亮點 |
+| ✨ | 新功能 |
+| 🚀 | 改進功能 |
+| 🐛 | 問題修復 |
+| 🔄 | 重構變更 |
+| 🎨 | 界面優化 |
+| ⚙️ | 設定相關 |
+| 🖥️ | 視窗相關 |
+| 🌐 | 多語言/網路相關 |
+| 📁 | 檔案結構 |
+| ⌨️ | 快捷鍵 |
+| 🖼️ | 圖片功能 |
+
+---
+
+**完整專案資訊：** [GitHub - mcp-feedback-enhanced](https://github.com/Minidoracat/mcp-feedback-enhanced) 
--- a/RELEASE_NOTES/README.md
+++ b/RELEASE_NOTES/README.md
@@ -0,0 +1,66 @@
+# 發佈說明管理系統
+
+此目錄包含了所有版本的結構化發佈說明，支援多語言，採用**雙重架構**來兼顧統一的更新日誌檢視和自動化發佈功能。
+
+## 📁 資料夾結構
+
+```
+RELEASE_NOTES/
+├── README.md                  # 此說明文檔
+├── template.md               # 發佈說明模板
+├── CHANGELOG.en.md           # 完整更新歷史（英文）
+├── CHANGELOG.zh-TW.md        # 完整更新歷史（繁體中文）
+├── CHANGELOG.zh-CN.md        # 完整更新歷史（簡體中文）
+├── v2.2.1/                   # 版本特定資料夾（供 GitHub Actions 使用）
+│   ├── en.md                 # 英文發佈說明
+│   ├── zh-TW.md              # 繁體中文發佈說明
+│   └── zh-CN.md              # 簡體中文發佈說明
+├── v2.2.0/
+│   ├── en.md
+│   ├── zh-TW.md
+│   └── zh-CN.md
+└── ...                       # 其他版本
+```
+
+## 🔄 雙重架構優勢
+
+### 📖 CHANGELOG 檔案
+- **完整歷史檢視**: 用戶可在單一檔案查看所有版本更新
+- **便於搜尋**: 快速找到特定功能的引入版本
+- **GitHub 顯示友好**: 更新歷史在專案主頁直接可見
+
+### 📁 版本資料夾  
+- **自動化友好**: GitHub Actions 可精確提取特定版本內容
+- **維護簡便**: 新版本只需建立新資料夾，無需修改大檔案
+- **工具整合**: 各種自動化工具容易解析單一版本檔案
+
+## 🤖 GitHub Actions 整合
+
+GitHub Actions 工作流程會自動執行：
+1. **版本檢測**: 從 git 標籤檢測要發佈的版本
+2. **發佈說明提取**: 從 `RELEASE_NOTES/vX.Y.Z/` 提取對應的發佈說明
+3. **多語言組合**: 將所有語言版本組合成結構化的發佈內容
+4. **GitHub Release 發佈**: 將格式化的發佈說明發佈到 GitHub Releases
+5. **CHANGELOG 同步**: 自動將新版本內容更新到統一的 CHANGELOG 檔案
+
+## 📝 撰寫發佈說明
+
+### 新版本發佈：
+1. **建立版本資料夾**: 為每個版本建立新資料夾（例如 `v2.2.1/`）
+2. **添加語言檔案**: 為每種語言添加發佈說明（`en.md`、`zh-TW.md`、`zh-CN.md`）
+3. **遵循模板**: 依照 `template.md` 中的模板結構
+4. **更新 CHANGELOG**: 將新版本內容添加到各個 CHANGELOG 檔案的頂部
+5. **一致格式**: 在各語言中使用一致的表情符號和格式
+
+### 維護作業：
+- **版本資料夾**: 供 GitHub Actions 自動化發佈使用
+- **CHANGELOG 檔案**: 為用戶和文檔提供統一檢視
+- **模板**: 參考 `template.md` 確保結構一致
+
+## 🔧 格式指南
+
+- **表情符號一致性**: 為不同類型的變更使用一致的表情符號前綴
+- **簡潔描述**: 保持項目符號簡潔但具描述性  
+- **問題引用**: 在適當的地方包含問題引用（例如 `fixes #10`）
+- **平行結構**: 在所有語言中保持平行結構
+- **時間順序**: 在 CHANGELOG 檔案中將最新版本放在頂部 
--- a/RELEASE_NOTES/template.md
+++ b/RELEASE_NOTES/template.md
@@ -0,0 +1,24 @@
+# Release vX.Y.Z - [發佈標題]
+
+## 🌟 亮點
+本次發佈主要變更的簡要摘要。
+
+## ✨ 新功能
+- 🆕 **功能名稱**: 新功能的描述
+- 🎨 **界面增強**: 介面改進的描述
+
+## 🐛 錯誤修復
+- 🔧 **問題修復**: 修復內容的描述 (fixes #issue_number)
+- 🛡️ **安全修復**: 安全相關的改進
+
+## 🚀 改進功能
+- ⚡ **效能優化**: 效能最佳化
+- 📱 **用戶體驗增強**: 用戶體驗改進
+
+## 🔄 變更
+- 🔀 **重大變更**: 任何重大變更（僅限主要版本）
+- 📝 **文檔更新**: 文檔更新
+
+---
+**說明**: 此模板應該適應每種語言（CHANGELOG.en.md, CHANGELOG.zh-TW.md, CHANGELOG.zh-CN.md）
+**注意**: 版本發佈文件不包含安裝與相關連結部分，這些內容已移至各語言的完整 CHANGELOG 文件中
--- a/RELEASE_NOTES/v2.2.1/en.md
+++ b/RELEASE_NOTES/v2.2.1/en.md
@@ -0,0 +1,28 @@
+# Release v2.2.1 - Window Optimization & Unified Settings Interface
+
+## 🌟 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
+
+## 📦 Installation & Update
+```bash
+# Quick test latest version
+uvx mcp-feedback-enhanced@latest test --gui
+
+# Update to specific version
+uvx mcp-feedback-enhanced@v2.2.1 test
+```
+
+## 🔗 Related Links
+- Full Documentation: [README.md](../../README.md)
+- Issue Reporting: [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues)
+- Issues Addressed: #10 (partially completed) 
--- a/RELEASE_NOTES/v2.2.1/zh-CN.md
+++ b/RELEASE_NOTES/v2.2.1/zh-CN.md
@@ -0,0 +1,28 @@
+# Release v2.2.1 - 窗口优化与统一设置接口
+
+## 🌟 亮点
+本版本主要解决了 GUI 窗口大小限制问题，实现了窗口状态的智能保存机制，并优化了设置接口的统一性。
+
+## 🚀 改进功能
+- 🖥️ **窗口大小限制解除**: 解除 GUI 主窗口最小大小限制，从 1000×800 降至 400×300，让用户可以自由调整窗口大小以符合不同使用场景
+- 💾 **窗口状态实时保存**: 实现窗口大小与位置的即时保存机制，支持防抖延迟避免过度频繁的 I/O 操作
+- ⚙️ **统一设置接口优化**: 改进 GUI 设置版面的配置保存逻辑，避免设置冲突，确保窗口定位与大小设置的正确性
+- 🎯 **智能窗口大小保存**: 「总是在主屏幕中心显示」模式下正确保存窗口大小（但不保存位置），「智能定位」模式下保存完整的窗口状态
+
+## 🐛 问题修复
+- 🔧 **窗口大小限制**: 解决 GUI 窗口无法调整至小尺寸的问题 (fixes #10 第一部分)
+- 🛡️ **设置冲突**: 修复设置保存时可能出现的配置冲突问题
+
+## 📦 安装与更新
+```bash
+# 快速测试最新版本
+uvx mcp-feedback-enhanced@latest test --gui
+
+# 更新到特定版本
+uvx mcp-feedback-enhanced@v2.2.1 test
+```
+
+## 🔗 相关链接
+- 完整文档: [README.zh-CN.md](../../README.zh-CN.md)
+- 问题报告: [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues)
+- 解决问题: #10 (部分完成) 
--- a/RELEASE_NOTES/v2.2.1/zh-TW.md
+++ b/RELEASE_NOTES/v2.2.1/zh-TW.md
@@ -0,0 +1,28 @@
+# Release v2.2.1 - 視窗優化與統一設定接口
+
+## 🌟 亮點
+本版本主要解決了 GUI 視窗大小限制問題，實現了視窗狀態的智能保存機制，並優化了設定接口的統一性。
+
+## 🚀 改進功能
+- 🖥️ **視窗大小限制解除**: 解除 GUI 主視窗最小大小限制，從 1000×800 降至 400×300，讓用戶可以自由調整視窗大小以符合不同使用場景
+- 💾 **視窗狀態實時保存**: 實現視窗大小與位置的即時保存機制，支援防抖延遲避免過度頻繁的 I/O 操作
+- ⚙️ **統一設定接口優化**: 改進 GUI 設定版面的配置保存邏輯，避免設定衝突，確保視窗定位與大小設定的正確性
+- 🎯 **智能視窗大小保存**: 「總是在主螢幕中心顯示」模式下正確保存視窗大小（但不保存位置），「智能定位」模式下保存完整的視窗狀態
+
+## 🐛 問題修復
+- 🔧 **視窗大小限制**: 解決 GUI 視窗無法調整至小尺寸的問題 (fixes #10 第一部分)
+- 🛡️ **設定衝突**: 修復設定保存時可能出現的配置衝突問題
+
+## 📦 安裝與更新
+```bash
+# 快速測試最新版本
+uvx mcp-feedback-enhanced@latest test --gui
+
+# 更新到特定版本
+uvx mcp-feedback-enhanced@v2.2.1 test
+```
+
+## 🔗 相關連結
+- 完整文檔: [README.zh-TW.md](../../README.zh-TW.md)
+- 問題回報: [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues)
+- 解決問題: #10 (部分完成) 
--- a/RELEASE_NOTES/v2.2.2/en.md
+++ 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) 
--- a/RELEASE_NOTES/v2.2.2/zh-CN.md
+++ 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) 
--- a/RELEASE_NOTES/v2.2.2/zh-TW.md
+++ 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) 
--- a/RELEASE_NOTES/v2.2.3/en.md
+++ b/RELEASE_NOTES/v2.2.3/en.md
@@ -0,0 +1,42 @@
+# Release v2.2.3 - Timeout Control & Image Settings Enhancement
+
+## 🌟 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)
--- a/RELEASE_NOTES/v2.2.3/zh-CN.md
+++ b/RELEASE_NOTES/v2.2.3/zh-CN.md
@@ -0,0 +1,42 @@
+# Release v2.2.3 - 超时控制与图片设置增强
+
+## 🌟 亮点
+本版本新增了用户可控制的超时设置功能，以及灵活的图片上传设置选项，同时完善了 UV Cache 管理工具，提升整体使用体验。
+
+## ✨ 新功能
+- ⏰ **用户超时控制**: 新增可自定义的超时设置功能，支持 30 秒至 2 小时的弹性设置
+- ⏱️ **倒数计时器**: 界面顶部显示实时倒数计时器，提供可视化的时间提醒
+- 🖼️ **图片大小限制**: 新增图片上传大小限制设置（无限制/1MB/3MB/5MB）
+- 🔧 **Base64 兼容模式**: 新增 Base64 详细模式，提升部分 AI 模型的图片识别兼容性
+- 🧹 **UV Cache 管理工具**: 新增 `cleanup_cache.py` 脚本，协助管理和清理 UV cache 空间
+
+## 🚀 改进功能
+- 📚 **文档结构优化**: 重新整理文档目录结构，将图片移至 `docs/{语言}/images/` 路径
+- 📖 **Cache 管理指南**: 新增详细的 UV Cache 管理指南，包含自动化清理方案
+- 🎯 **智能兼容性提示**: 当图片上传失败时自动显示 Base64 兼容模式建议
+- 🔄 **设置同步机制**: 改进图片设置在不同界面模式间的同步机制
+
+## 🐛 问题修复
+- 🛡️ **超时处理优化**: 改进用户自定义超时与 MCP 系统超时的协调机制
+- 🖥️ **界面自动关闭**: 修复超时后界面自动关闭和资源清理逻辑
+- 📱 **响应式布局**: 优化超时控制组件在小屏幕设备上的显示效果
+
+## 🔧 技术改进
+- 🎛️ **超时控制架构**: 实现前端倒数计时器与后端超时处理的分离设计
+- 📊 **图片处理优化**: 改进图片上传的大小检查和格式验证机制
+- 🗂️ **设置持久化**: 增强设置保存机制，确保用户偏好的正确保存和载入
+- 🧰 **工具脚本增强**: 新增跨平台的 cache 清理工具，支持强制清理和预览模式
+
+## 📦 安装与更新
+```bash
+# 快速测试最新版本
+uvx mcp-feedback-enhanced@latest test --gui
+
+# 更新到特定版本
+uvx mcp-feedback-enhanced@v2.2.3 test
+```
+
+## 🔗 相关链接
+- 完整文档: [README.zh-CN.md](../../README.zh-CN.md)
+- 问题报告: [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues)
+- 相关 PR: #22 (超时控制功能), #19 (图片设置功能)
--- a/RELEASE_NOTES/v2.2.3/zh-TW.md
+++ b/RELEASE_NOTES/v2.2.3/zh-TW.md
@@ -0,0 +1,42 @@
+# Release v2.2.3 - 超時控制與圖片設定增強
+
+## 🌟 亮點
+本版本新增了用戶可控制的超時設定功能，以及靈活的圖片上傳設定選項，同時完善了 UV Cache 管理工具，提升整體使用體驗。
+
+## ✨ 新功能
+- ⏰ **用戶超時控制**: 新增可自訂的超時設定功能，支援 30 秒至 2 小時的彈性設定
+- ⏱️ **倒數計時器**: 介面頂部顯示即時倒數計時器，提供視覺化的時間提醒
+- 🖼️ **圖片大小限制**: 新增圖片上傳大小限制設定（無限制/1MB/3MB/5MB）
+- 🔧 **Base64 相容模式**: 新增 Base64 詳細模式，提升部分 AI 模型的圖片識別相容性
+- 🧹 **UV Cache 管理工具**: 新增 `cleanup_cache.py` 腳本，協助管理和清理 UV cache 空間
+
+## 🚀 改進功能
+- 📚 **文檔結構優化**: 重新整理文檔目錄結構，將圖片移至 `docs/{語言}/images/` 路徑
+- 📖 **Cache 管理指南**: 新增詳細的 UV Cache 管理指南，包含自動化清理方案
+- 🎯 **智能相容性提示**: 當圖片上傳失敗時自動顯示 Base64 相容模式建議
+- 🔄 **設定同步機制**: 改進圖片設定在不同介面模式間的同步機制
+
+## 🐛 問題修復
+- 🛡️ **超時處理優化**: 改進用戶自訂超時與 MCP 系統超時的協調機制
+- 🖥️ **介面自動關閉**: 修復超時後介面自動關閉和資源清理邏輯
+- 📱 **響應式佈局**: 優化超時控制元件在小螢幕設備上的顯示效果
+
+## 🔧 技術改進
+- 🎛️ **超時控制架構**: 實現前端倒數計時器與後端超時處理的分離設計
+- 📊 **圖片處理優化**: 改進圖片上傳的大小檢查和格式驗證機制
+- 🗂️ **設定持久化**: 增強設定保存機制，確保用戶偏好的正確保存和載入
+- 🧰 **工具腳本增強**: 新增跨平台的 cache 清理工具，支援強制清理和預覽模式
+
+## 📦 安裝與更新
+```bash
+# 快速測試最新版本
+uvx mcp-feedback-enhanced@latest test --gui
+
+# 更新到特定版本
+uvx mcp-feedback-enhanced@v2.2.3 test
+```
+
+## 🔗 相關連結
+- 完整文檔: [README.zh-TW.md](../../README.zh-TW.md)
+- 問題回報: [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues)
+- 相關 PR: #22 (超時控制功能), #19 (圖片設定功能)
--- a/RELEASE_NOTES/v2.2.4/en.md
+++ b/RELEASE_NOTES/v2.2.4/en.md
@@ -0,0 +1,23 @@
+# 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) 
--- a/RELEASE_NOTES/v2.2.4/zh-CN.md
+++ b/RELEASE_NOTES/v2.2.4/zh-CN.md
@@ -0,0 +1,23 @@
+# Release v2.2.4 - GUI 体验优化与问题修复
+
+## 🌟 亮点
+本版本专注于 GUI 使用体验的优化，修复了图片复制粘贴的重复问题，重新组织了语系文件结构，并改善了界面文字的可读性。
+
+## 🐛 问题修复
+- 🖼️ **图片重复粘贴修复**: 解决 GUI 界面中使用 Ctrl+V 复制粘贴图片时出现重复粘贴的问题
+- 🌐 **语系切换修复**: 修复图片设定区域在语言切换时文字没有正确翻译的问题
+- 📝 **字体可读性改善**: 调整图片设定区域的字体大小，提升文字可读性
+
+## 📦 安装与更新
+```bash
+# 快速测试最新版本
+uvx mcp-feedback-enhanced@latest test --gui
+
+# 更新到特定版本
+uvx mcp-feedback-enhanced@v2.2.4 test
+```
+
+## 🔗 相关链接
+- 完整文档: [README.zh-CN.md](../../README.zh-CN.md)
+- 问题报告: [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues)
+- 项目首页: [GitHub Repository](https://github.com/Minidoracat/mcp-feedback-enhanced) 
--- a/RELEASE_NOTES/v2.2.4/zh-TW.md
+++ b/RELEASE_NOTES/v2.2.4/zh-TW.md
@@ -0,0 +1,23 @@
+# Release v2.2.4 - GUI 體驗優化與問題修復
+
+## 🌟 亮點
+本版本專注於 GUI 使用體驗的優化，修復了圖片複製貼上的重複問題，重新組織了語系檔案結構，並改善了介面文字的可讀性。
+
+## 🐛 問題修復
+- 🖼️ **圖片重複貼上修復**: 解決 GUI 介面中使用 Ctrl+V 複製貼上圖片時出現重複貼上的問題
+- 🌐 **語系切換修復**: 修復圖片設定區域在語言切換時文字沒有正確翻譯的問題
+- 📝 **字體可讀性改善**: 調整圖片設定區域的字體大小，提升文字可讀性
+
+## 📦 安裝與更新
+```bash
+# 快速測試最新版本
+uvx mcp-feedback-enhanced@latest test --gui
+
+# 更新到特定版本
+uvx mcp-feedback-enhanced@v2.2.4 test
+```
+
+## 🔗 相關連結
+- 完整文檔: [README.zh-TW.md](../../README.zh-TW.md)
+- 問題回報: [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues)
+- 專案首頁: [GitHub Repository](https://github.com/Minidoracat/mcp-feedback-enhanced) 
--- a/RELEASE_NOTES/v2.2.5/en.md
+++ b/RELEASE_NOTES/v2.2.5/en.md
@@ -0,0 +1,28 @@
+# Release v2.2.5 - WSL Environment Support & Cross-Platform Enhancement
+
+## 🌟 Highlights
+This version introduces comprehensive support for WSL (Windows Subsystem for Linux) environments, enabling WSL users to seamlessly use this tool with automatic Windows browser launching, significantly improving cross-platform development experience.
+
+## ✨ 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
+
+## 📦 Installation & Update
+```bash
+# Quick test latest version
+uvx mcp-feedback-enhanced@latest test --gui
+
+# Update to specific version
+uvx mcp-feedback-enhanced@v2.2.5 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)
--- a/RELEASE_NOTES/v2.2.5/zh-CN.md
+++ b/RELEASE_NOTES/v2.2.5/zh-CN.md
@@ -0,0 +1,28 @@
+# Release v2.2.5 - WSL 环境支持与跨平台增强
+
+## 🌟 亮点
+本版本新增了 WSL (Windows Subsystem for Linux) 环境的完整支持，让 WSL 用户能够无缝使用本工具并自动启动 Windows 浏览器，大幅提升跨平台开发体验。
+
+## ✨ 新功能
+- 🐧 **WSL 环境检测**: 自动识别 WSL 环境，提供专门的支持逻辑
+- 🌐 **智能浏览器启动**: WSL 环境下自动调用 Windows 浏览器，支持多种启动方式
+- 🔧 **跨平台测试增强**: 测试功能整合 WSL 检测，提升测试覆盖率
+
+## 🚀 改进功能
+- 🎯 **环境检测优化**: 改进远程环境检测逻辑，WSL 不再被误判为远程环境
+- 📊 **系统信息增强**: 系统信息工具新增 WSL 环境状态显示
+- 🧪 **测试体验提升**: 测试模式下自动尝试启动浏览器，提供更好的测试体验
+
+## 📦 安装与更新
+```bash
+# 快速测试最新版本
+uvx mcp-feedback-enhanced@latest test --gui
+
+# 更新到特定版本
+uvx mcp-feedback-enhanced@v2.2.5 test
+```
+
+## 🔗 相关链接
+- 完整文档: [README.zh-CN.md](../../README.zh-CN.md)
+- 问题报告: [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues)
+- 项目首页: [GitHub Repository](https://github.com/Minidoracat/mcp-feedback-enhanced)
--- a/RELEASE_NOTES/v2.2.5/zh-TW.md
+++ b/RELEASE_NOTES/v2.2.5/zh-TW.md
@@ -0,0 +1,28 @@
+# Release v2.2.5 - WSL 環境支援與跨平台增強
+
+## 🌟 亮點
+本版本新增了 WSL (Windows Subsystem for Linux) 環境的完整支援，讓 WSL 用戶能夠無縫使用本工具並自動啟動 Windows 瀏覽器，大幅提升跨平台開發體驗。
+
+## ✨ 新功能
+- 🐧 **WSL 環境檢測**: 自動識別 WSL 環境，提供專門的支援邏輯
+- 🌐 **智能瀏覽器啟動**: WSL 環境下自動調用 Windows 瀏覽器，支援多種啟動方式
+- 🔧 **跨平台測試增強**: 測試功能整合 WSL 檢測，提升測試覆蓋率
+
+## 🚀 改進功能
+- 🎯 **環境檢測優化**: 改進遠端環境檢測邏輯，WSL 不再被誤判為遠端環境
+- 📊 **系統資訊增強**: 系統資訊工具新增 WSL 環境狀態顯示
+- 🧪 **測試體驗提升**: 測試模式下自動嘗試啟動瀏覽器，提供更好的測試體驗
+
+## 📦 安裝與更新
+```bash
+# 快速測試最新版本
+uvx mcp-feedback-enhanced@latest test --gui
+
+# 更新到特定版本
+uvx mcp-feedback-enhanced@v2.2.5 test
+```
+
+## 🔗 相關連結
+- 完整文檔: [README.zh-TW.md](../../README.zh-TW.md)
+- 問題回報: [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues)
+- 專案首頁: [GitHub Repository](https://github.com/Minidoracat/mcp-feedback-enhanced)