📝 更新 2.2.4 相關文檔

This commit is contained in:
Minidoracat 2025-06-05 06:15:21 +08:00
parent f87405c112
commit b503d1f361
6 changed files with 223 additions and 173 deletions

125
RELEASE_NOTES/CHANGELOG.md Normal file
View File

@ -0,0 +1,125 @@
# Changelog (English)
This file documents all version updates for **MCP Feedback Enhanced**.
---
## [v2.2.4] - GUI Experience Optimization & Bug Fixes (2025-01-XX)
### 🐛 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 (2025-01-XX)
### ✨ New Features
- ⏰ **User Timeout Control**: Added customizable timeout settings with flexible range from 30 seconds to 2 hours
- ⏱️ **Countdown Timer**: Real-time countdown timer displayed at the top of the interface for visual time reminders
- 🖼️ **Image Size Limit**: Added image upload size limit settings (Unlimited/1MB/3MB/5MB)
- 🔧 **Base64 Compatibility Mode**: Added Base64 verbose mode to improve image recognition compatibility with some AI models
- 🧹 **UV Cache Management Tool**: Added `cleanup_cache.py` script for managing and cleaning UV cache space
### 🚀 Improvements
- 📚 **Documentation Structure Optimization**: Reorganized documentation directory structure, moved images to `docs/{language}/images/` path
- 📖 **Cache Management Guide**: Added detailed UV Cache management guide with automated cleanup solutions
- 🎯 **Smart Compatibility Hints**: Automatically show 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 timeout-triggered interface auto-close and resource cleanup logic
- 📱 **Responsive Layout**: Optimized timeout control components display on small screen devices
---
## [v2.2.2] - Timeout Auto-cleanup Fix (2024-12-XX)
### 🐛 Bug Fixes
- 🔄 **Timeout Auto-cleanup**: Fixed GUI/Web UI not auto-closing after MCP session timeout (default 600 seconds)
- 🛡️ **Resource Management Optimization**: Improved timeout handling to ensure proper cleanup and closure of all UI resources
- ⚡ **Timeout Detection Enhancement**: Strengthened timeout detection logic to handle timeout events correctly in all scenarios
---
## [v2.2.1] - Window Optimization & Unified Settings Interface (2024-12-XX)
### 🚀 Improvements
- 🖥️ **Window Size Limit Removal**: Removed GUI main window minimum size limit, reduced from 1000×800 to 400×300
- 💾 **Real-time Window State Saving**: Implemented instant window size and position saving with debounce delay
- ⚙️ **Unified Settings Interface Optimization**: Improved GUI settings panel configuration saving logic to avoid conflicts
### 🐛 Bug Fixes
- 🔧 **Window Size Limitation**: Fixed GUI window unable to resize to small dimensions issue
- 🛡️ **Settings Conflict**: Fixed configuration conflicts that could occur during settings save
---
## [v2.2.0] - Layout & Settings Interface Optimization (2024-12-XX)
### ✨ New Features
- 🎨 **Horizontal Layout Mode**: Added summary and feedback left-right layout option for GUI and Web UI merged mode
### 🚀 Improvements
- 🎨 **Settings Interface Improvement**: Optimized GUI and Web UI settings pages for better layout clarity
- ⌨️ **Hotkey Enhancement**: Submit feedback hotkey now fully supports numpad Enter key
### 🐛 Bug Fixes
- 🔧 **Image Duplicate Paste**: Fixed duplicate image pasting issue when using Ctrl+V in Web UI text input area
---
## [v2.1.1] - Window Positioning Optimization (2024-11-XX)
### ✨ New Features
- 🖥️ **Smart Window Positioning**: Added "Always center window on main screen" setting option
- 🌐 **Multi-screen Support**: Perfect solution for complex multi-screen environments like T-shaped screen arrangements
- 💾 **Position Memory**: Automatic window position saving and restoration with intelligent visibility detection
---
## [v2.1.0] - Complete Refactoring Version (2024-11-XX)
### 🎨 Major Refactoring
- 🏗️ **Complete Refactoring**: GUI and Web UI adopted modular architecture
- 📁 **Centralized Management**: Reorganized folder structure for improved maintainability
- 🖥️ **Interface Optimization**: Modern design and improved user experience
### ✨ New Features
- 🍎 **macOS Interface Optimization**: Specialized improvements for macOS user experience
- ⚙️ **Feature Enhancement**: Added setting options and auto-close page functionality
- **About Page**: Added about page with version info, project links, and acknowledgments
---
## [v2.0.14] - Hotkey & Image Feature Enhancement (2024-10-XX)
### 🚀 Improvements
- ⌨️ **Enhanced Hotkeys**: Ctrl+Enter supports numpad
- 🖼️ **Smart Image Paste**: Ctrl+V directly pastes clipboard images
---
## [v2.0.9] - Multi-language Architecture Refactoring (2024-10-XX)
### 🔄 Refactoring
- 🌏 **Multi-language Architecture Refactoring**: Support for dynamic loading
- 📁 **Language File Modularization**: 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 environment usage
- ✅ **Automatic Environment Detection**: Automatically choose appropriate interface
- ✅ **WebSocket Real-time Communication**: Implemented real-time bidirectional communication

View File

@ -3,56 +3,18 @@
本文件记录了 **MCP Feedback Enhanced** 的所有版本更新内容。 本文件记录了 **MCP Feedback Enhanced** 的所有版本更新内容。
--- ---
# Release v2.2.3 - 超时控制与图片设置增强
## 🌟 亮点 ## [v2.2.4] - GUI 体验优化与问题修复 (2025-01-XX)
本版本新增了用户可控制的超时设置功能,以及灵活的图片上传设置选项,同时完善了 UV Cache 管理工具,提升整体使用体验。
## ✨ 新功能 ### 🐛 问题修复
- ⏰ **用户超时控制**: 新增可自定义的超时设置功能,支持 30 秒至 2 小时的弹性设置 - 🖼️ **图片重复粘贴修复**: 解决 GUI 界面中使用 Ctrl+V 复制粘贴图片时出现重复粘贴的问题
- ⏱️ **倒数计时器**: 界面顶部显示实时倒数计时器,提供可视化的时间提醒 - 🌐 **语系切换修复**: 修复图片设定区域在语言切换时文字没有正确翻译的问题
- 🖼️ **图片大小限制**: 新增图片上传大小限制设置(无限制/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 (图片设置功能)
--- ---
## [v2.2.3] - 超时控制与图片设置增强 (2025-01-XX) ## [v2.2.3] - 超时控制与图片设置增强 (2025-01-XX)
### 🌟 亮点
本版本新增了用户可控制的超时设置功能,以及灵活的图片上传设置选项,同时完善了 UV Cache 管理工具,提升整体使用体验。
### ✨ 新功能 ### ✨ 新功能
- ⏰ **用户超时控制**: 新增可自定义的超时设置功能,支持 30 秒至 2 小时的弹性设置 - ⏰ **用户超时控制**: 新增可自定义的超时设置功能,支持 30 秒至 2 小时的弹性设置
- ⏱️ **倒数计时器**: 界面顶部显示实时倒数计时器,提供可视化的时间提醒 - ⏱️ **倒数计时器**: 界面顶部显示实时倒数计时器,提供可视化的时间提醒
@ -64,92 +26,61 @@ uvx mcp-feedback-enhanced@v2.2.3 test
- 📚 **文档结构优化**: 重新整理文档目录结构,将图片移至 `docs/{语言}/images/` 路径 - 📚 **文档结构优化**: 重新整理文档目录结构,将图片移至 `docs/{语言}/images/` 路径
- 📖 **Cache 管理指南**: 新增详细的 UV Cache 管理指南,包含自动化清理方案 - 📖 **Cache 管理指南**: 新增详细的 UV Cache 管理指南,包含自动化清理方案
- 🎯 **智能兼容性提示**: 当图片上传失败时自动显示 Base64 兼容模式建议 - 🎯 **智能兼容性提示**: 当图片上传失败时自动显示 Base64 兼容模式建议
- 🔄 **设置同步机制**: 改进图片设置在不同界面模式间的同步机制
### 🐛 问题修复 ### 🐛 问题修复
- 🛡️ **超时处理优化**: 改进用户自定义超时与 MCP 系统超时的协调机制 - 🛡️ **超时处理优化**: 改进用户自定义超时与 MCP 系统超时的协调机制
- 🖥️ **界面自动关闭**: 修复超时后界面自动关闭和资源清理逻辑 - 🖥️ **界面自动关闭**: 修复超时后界面自动关闭和资源清理逻辑
- 📱 **响应式布局**: 优化超时控制组件在小屏幕设备上的显示效果 - 📱 **响应式布局**: 优化超时控制组件在小屏幕设备上的显示效果
### 🔧 技术改进
- 🎛️ **超时控制架构**: 实现前端倒数计时器与后端超时处理的分离设计
- 📊 **图片处理优化**: 改进图片上传的大小检查和格式验证机制
- 🗂️ **设置持久化**: 增强设置保存机制,确保用户偏好的正确保存和载入
- 🧰 **工具脚本增强**: 新增跨平台的 cache 清理工具,支持强制清理和预览模式
--- ---
## [v2.2.2] - 超时自动清理修复 (2024-12-XX) ## [v2.2.2] - 超时自动清理修复 (2024-12-XX)
### 🌟 亮点
本版本修复了一个重要的资源管理问题:当 MCP session 因超时结束时GUI/Web UI 界面没有正确关闭,导致界面持续显示而无法正常关闭。
### 🐛 问题修复 ### 🐛 问题修复
- 🔄 **超时自动清理**: 修复 GUI/Web UI 在 MCP session timeout (默认 600 秒) 后没有自动关闭的问题 (fixes #5) - 🔄 **超时自动清理**: 修复 GUI/Web UI 在 MCP session timeout (默认 600 秒) 后没有自动关闭的问题
- 🛡️ **资源管理优化**: 改进超时处理机制,确保在超时时正确清理和关闭所有 UI 资源 - 🛡️ **资源管理优化**: 改进超时处理机制,确保在超时时正确清理和关闭所有 UI 资源
- ⚡ **超时检测增强**: 加强超时检测逻辑,确保在各种情况下都能正确处理超时事件 - ⚡ **超时检测增强**: 加强超时检测逻辑,确保在各种情况下都能正确处理超时事件
- 🔧 **界面响应改进**: 改善 Web UI 前端对 session timeout 事件的处理响应
### 🚀 技术改进
- 📦 **Web Session 管理**: 重构 WebFeedbackSession 的超时处理逻辑
- 🎯 **QTimer 整合**: 在 GUI 中引入精确的 QTimer 超时控制机制
- 🌐 **前端通信优化**: 改进 Web UI 前端与后端的超时消息传递
- 🧹 **资源清理机制**: 新增 _cleanup_resources_on_timeout 方法确保彻底清理
--- ---
## [v2.2.1] - 窗口优化与统一设置接口 (2024-12-XX) ## [v2.2.1] - 窗口优化与统一设置接口 (2024-12-XX)
### 🌟 亮点
本版本主要解决了 GUI 窗口大小限制问题,实现了窗口状态的智能保存机制,并优化了设置接口的统一性。
### 🚀 改进功能 ### 🚀 改进功能
- 🖥️ **窗口大小限制解除**: 解除 GUI 主窗口最小大小限制,从 1000×800 降至 400×300让用户可以自由调整窗口大小以符合不同使用场景 - 🖥️ **窗口大小限制解除**: 解除 GUI 主窗口最小大小限制,从 1000×800 降至 400×300
- 💾 **窗口状态实时保存**: 实现窗口大小与位置的即时保存机制,支持防抖延迟避免过度频繁的 I/O 操作 - 💾 **窗口状态实时保存**: 实现窗口大小与位置的即时保存机制,支持防抖延迟
- ⚙️ **统一设置接口优化**: 改进 GUI 设置版面的配置保存逻辑,避免设置冲突,确保窗口定位与大小设置的正确性 - ⚙️ **统一设置接口优化**: 改进 GUI 设置版面的配置保存逻辑,避免设置冲突
- 🎯 **智能窗口大小保存**: 「总是在主屏幕中心显示」模式下正确保存窗口大小(但不保存位置),「智能定位」模式下保存完整的窗口状态
### 🐛 问题修复 ### 🐛 问题修复
- 🔧 **窗口大小限制**: 解决 GUI 窗口无法调整至小尺寸的问题 (fixes #10 第一部分) - 🔧 **窗口大小限制**: 解决 GUI 窗口无法调整至小尺寸的问题
- 🛡️ **设置冲突**: 修复设置保存时可能出现的配置冲突问题 - 🛡️ **设置冲突**: 修复设置保存时可能出现的配置冲突问题
--- ---
## [v2.2.0] - 布局与设置界面优化 (2024-12-XX) ## [v2.2.0] - 布局与设置界面优化 (2024-12-XX)
### 🌟 亮点
本版本新增了水平布局选项,优化了设置界面,并修复了快捷键和图片粘贴问题。
### ✨ 新功能 ### ✨ 新功能
- 🎨 **水平布局模式**: GUI 与 Web UI 的合并模式新增摘要与反馈的左右布局(水平分割)选项,提供更灵活的查看方式 (实现 [Issue #1](https://github.com/Minidoracat/mcp-feedback-enhanced/issues/1)) - 🎨 **水平布局模式**: GUI 与 Web UI 的合并模式新增摘要与反馈的左右布局选项
### 🚀 改进功能 ### 🚀 改进功能
- 🎨 **设置界面改进**: 优化了 GUI 与 Web UI 的设置页面,提升布局清晰度与用户操作体验 - 🎨 **设置界面改进**: 优化了 GUI 与 Web UI 的设置页面,提升布局清晰度
- ⌨️ **快捷键完善 (GUI)**: 提交反馈快捷键 (Ctrl+Enter / Cmd+Enter) 现已完整支持数字键盘(九宫格)的 Enter 键 - ⌨️ **快捷键完善**: 提交反馈快捷键现已完整支持数字键盘的 Enter 键
### 🐛 问题修复 ### 🐛 问题修复
- 🔧 **图片重复粘贴 (Web UI)**: 解决了在文本输入区使用 Ctrl+V 粘贴图片时,可能导致图片重复粘贴的问题 - 🔧 **图片重复粘贴**: 解决了在 Web UI 文字输入区使用 Ctrl+V 粘贴图片时的重复问题
--- ---
## [v2.1.1] - 窗口定位优化 (2024-11-XX) ## [v2.1.1] - 窗口定位优化 (2024-11-XX)
### 🌟 亮点
完美解决多屏幕环境下的窗口定位问题,特别是 T 字型屏幕排列等复杂配置。
### ✨ 新功能 ### ✨ 新功能
- 🖥️ **智能窗口定位**: 新增「总是在主屏幕中心显示窗口」设置选项 - 🖥️ **智能窗口定位**: 新增「总是在主屏幕中心显示窗口」设置选项
- 🌐 **多屏幕支持**: 完美解决 T 字型屏幕排列等复杂多屏幕环境的窗口定位问题 - 🌐 **多屏幕支持**: 完美解决 T 字型屏幕排列等复杂多屏幕环境的窗口定位问题
- 💾 **位置记忆**: 自动保存和恢复窗口位置,智能检测窗口可见性 - 💾 **位置记忆**: 自动保存和恢复窗口位置,智能检测窗口可见性
- ⚙️ **用户选择**: 提供智能定位(默认)和强制中心显示两种模式
--- ---
## [v2.1.0] - 全面重构版 (2024-11-XX) ## [v2.1.0] - 全面重构版 (2024-11-XX)
### 🌟 亮点
这是一个重大重构版本GUI 和 Web UI 均采用了全新的模块化架构。
### 🎨 重大重构 ### 🎨 重大重构
- 🏗️ **全面重构**: GUI 和 Web UI 采用模块化架构 - 🏗️ **全面重构**: GUI 和 Web UI 采用模块化架构
- 📁 **集中管理**: 重新组织文件夹结构,提升维护性 - 📁 **集中管理**: 重新组织文件夹结构,提升维护性
@ -160,9 +91,6 @@ uvx mcp-feedback-enhanced@v2.2.3 test
- ⚙️ **功能增强**: 新增设置选项和自动关闭页面功能 - ⚙️ **功能增强**: 新增设置选项和自动关闭页面功能
- **关于页面**: 新增关于页面,包含版本信息、项目链接和致谢内容 - **关于页面**: 新增关于页面,包含版本信息、项目链接和致谢内容
### 🐛 问题修复
- 🌐 **语言切换**: 修复 Web UI 语言切换时内容更新问题
--- ---
## [v2.0.14] - 快捷键与图片功能增强 (2024-10-XX) ## [v2.0.14] - 快捷键与图片功能增强 (2024-10-XX)

View File

@ -3,56 +3,18 @@
本文件記錄了 **MCP Feedback Enhanced** 的所有版本更新內容。 本文件記錄了 **MCP Feedback Enhanced** 的所有版本更新內容。
--- ---
# Release v2.2.3 - 超時控制與圖片設定增強
## 🌟 亮點 ## [v2.2.4] - GUI 體驗優化與問題修復 (2025-01-XX)
本版本新增了用戶可控制的超時設定功能,以及靈活的圖片上傳設定選項,同時完善了 UV Cache 管理工具,提升整體使用體驗。
## ✨ 新功能 ### 🐛 問題修復
- ⏰ **用戶超時控制**: 新增可自訂的超時設定功能,支援 30 秒至 2 小時的彈性設定 - 🖼️ **圖片重複貼上修復**: 解決 GUI 介面中使用 Ctrl+V 複製貼上圖片時出現重複貼上的問題
- ⏱️ **倒數計時器**: 介面頂部顯示即時倒數計時器,提供視覺化的時間提醒 - 🌐 **語系切換修復**: 修復圖片設定區域在語言切換時文字沒有正確翻譯的問題
- 🖼️ **圖片大小限制**: 新增圖片上傳大小限制設定(無限制/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 (圖片設定功能)
--- ---
## [v2.2.3] - 超時控制與圖片設定增強 (2025-01-XX) ## [v2.2.3] - 超時控制與圖片設定增強 (2025-01-XX)
### 🌟 亮點
本版本新增了用戶可控制的超時設定功能,以及靈活的圖片上傳設定選項,同時完善了 UV Cache 管理工具,提升整體使用體驗。
### ✨ 新功能 ### ✨ 新功能
- ⏰ **用戶超時控制**: 新增可自訂的超時設定功能,支援 30 秒至 2 小時的彈性設定 - ⏰ **用戶超時控制**: 新增可自訂的超時設定功能,支援 30 秒至 2 小時的彈性設定
- ⏱️ **倒數計時器**: 介面頂部顯示即時倒數計時器,提供視覺化的時間提醒 - ⏱️ **倒數計時器**: 介面頂部顯示即時倒數計時器,提供視覺化的時間提醒
@ -64,92 +26,61 @@ uvx mcp-feedback-enhanced@v2.2.3 test
- 📚 **文檔結構優化**: 重新整理文檔目錄結構,將圖片移至 `docs/{語言}/images/` 路徑 - 📚 **文檔結構優化**: 重新整理文檔目錄結構,將圖片移至 `docs/{語言}/images/` 路徑
- 📖 **Cache 管理指南**: 新增詳細的 UV Cache 管理指南,包含自動化清理方案 - 📖 **Cache 管理指南**: 新增詳細的 UV Cache 管理指南,包含自動化清理方案
- 🎯 **智能相容性提示**: 當圖片上傳失敗時自動顯示 Base64 相容模式建議 - 🎯 **智能相容性提示**: 當圖片上傳失敗時自動顯示 Base64 相容模式建議
- 🔄 **設定同步機制**: 改進圖片設定在不同介面模式間的同步機制
### 🐛 問題修復 ### 🐛 問題修復
- 🛡️ **超時處理優化**: 改進用戶自訂超時與 MCP 系統超時的協調機制 - 🛡️ **超時處理優化**: 改進用戶自訂超時與 MCP 系統超時的協調機制
- 🖥️ **介面自動關閉**: 修復超時後介面自動關閉和資源清理邏輯 - 🖥️ **介面自動關閉**: 修復超時後介面自動關閉和資源清理邏輯
- 📱 **響應式佈局**: 優化超時控制元件在小螢幕設備上的顯示效果 - 📱 **響應式佈局**: 優化超時控制元件在小螢幕設備上的顯示效果
### 🔧 技術改進
- 🎛️ **超時控制架構**: 實現前端倒數計時器與後端超時處理的分離設計
- 📊 **圖片處理優化**: 改進圖片上傳的大小檢查和格式驗證機制
- 🗂️ **設定持久化**: 增強設定保存機制,確保用戶偏好的正確保存和載入
- 🧰 **工具腳本增強**: 新增跨平台的 cache 清理工具,支援強制清理和預覽模式
--- ---
## [v2.2.2] - 超時自動清理修復 (2024-12-XX) ## [v2.2.2] - 超時自動清理修復 (2024-12-XX)
### 🌟 亮點
本版本修復了一個重要的資源管理問題:當 MCP session 因超時結束時GUI/Web UI 介面沒有正確關閉,導致介面持續顯示而無法正常關閉。
### 🐛 問題修復 ### 🐛 問題修復
- 🔄 **超時自動清理**: 修復 GUI/Web UI 在 MCP session timeout (預設 600 秒) 後沒有自動關閉的問題 (fixes #5) - 🔄 **超時自動清理**: 修復 GUI/Web UI 在 MCP session timeout (預設 600 秒) 後沒有自動關閉的問題
- 🛡️ **資源管理優化**: 改進超時處理機制,確保在超時時正確清理和關閉所有 UI 資源 - 🛡️ **資源管理優化**: 改進超時處理機制,確保在超時時正確清理和關閉所有 UI 資源
- ⚡ **超時檢測增強**: 加強超時檢測邏輯,確保在各種情況下都能正確處理超時事件 - ⚡ **超時檢測增強**: 加強超時檢測邏輯,確保在各種情況下都能正確處理超時事件
- 🔧 **介面回應改進**: 改善 Web UI 前端對 session timeout 事件的處理回應
### 🚀 技術改進
- 📦 **Web Session 管理**: 重構 WebFeedbackSession 的超時處理邏輯
- 🎯 **QTimer 整合**: 在 GUI 中引入精確的 QTimer 超時控制機制
- 🌐 **前端通訊優化**: 改進 Web UI 前端與後端的超時訊息傳遞
- 🧹 **資源清理機制**: 新增 _cleanup_resources_on_timeout 方法確保徹底清理
--- ---
## [v2.2.1] - 視窗優化與統一設定接口 (2024-12-XX) ## [v2.2.1] - 視窗優化與統一設定接口 (2024-12-XX)
### 🌟 亮點
本版本主要解決了 GUI 視窗大小限制問題,實現了視窗狀態的智能保存機制,並優化了設定接口的統一性。
### 🚀 改進功能 ### 🚀 改進功能
- 🖥️ **視窗大小限制解除**: 解除 GUI 主視窗最小大小限制,從 1000×800 降至 400×300讓用戶可以自由調整視窗大小以符合不同使用場景 - 🖥️ **視窗大小限制解除**: 解除 GUI 主視窗最小大小限制,從 1000×800 降至 400×300
- 💾 **視窗狀態實時保存**: 實現視窗大小與位置的即時保存機制,支援防抖延遲避免過度頻繁的 I/O 操作 - 💾 **視窗狀態實時保存**: 實現視窗大小與位置的即時保存機制,支援防抖延遲
- ⚙️ **統一設定接口優化**: 改進 GUI 設定版面的配置保存邏輯,避免設定衝突,確保視窗定位與大小設定的正確性 - ⚙️ **統一設定接口優化**: 改進 GUI 設定版面的配置保存邏輯,避免設定衝突
- 🎯 **智能視窗大小保存**: 「總是在主螢幕中心顯示」模式下正確保存視窗大小(但不保存位置),「智能定位」模式下保存完整的視窗狀態
### 🐛 問題修復 ### 🐛 問題修復
- 🔧 **視窗大小限制**: 解決 GUI 視窗無法調整至小尺寸的問題 (fixes #10 第一部分) - 🔧 **視窗大小限制**: 解決 GUI 視窗無法調整至小尺寸的問題
- 🛡️ **設定衝突**: 修復設定保存時可能出現的配置衝突問題 - 🛡️ **設定衝突**: 修復設定保存時可能出現的配置衝突問題
--- ---
## [v2.2.0] - 佈局與設定界面優化 (2024-12-XX) ## [v2.2.0] - 佈局與設定界面優化 (2024-12-XX)
### 🌟 亮點
本版本新增了水平佈局選項,優化了設定界面,並修復了快捷鍵和圖片貼上問題。
### ✨ 新功能 ### ✨ 新功能
- 🎨 **水平佈局模式**: GUI 與 Web UI 的合併模式新增摘要與回饋的左右佈局(水平分割)選項,提供更靈活的檢視方式 (實現 [Issue #1](https://github.com/Minidoracat/mcp-feedback-enhanced/issues/1)) - 🎨 **水平佈局模式**: GUI 與 Web UI 的合併模式新增摘要與回饋的左右佈局選項
### 🚀 改進功能 ### 🚀 改進功能
- 🎨 **設定界面改進**: 優化了 GUI 與 Web UI 的設定頁面,提升佈局清晰度與用戶操作體驗 - 🎨 **設定界面改進**: 優化了 GUI 與 Web UI 的設定頁面,提升佈局清晰度
- ⌨️ **快捷鍵完善 (GUI)**: 提交回饋快捷鍵 (Ctrl+Enter / Cmd+Enter) 現已完整支援數字鍵盤(九宮格)的 Enter 鍵 - ⌨️ **快捷鍵完善**: 提交回饋快捷鍵現已完整支援數字鍵盤的 Enter 鍵
### 🐛 問題修復 ### 🐛 問題修復
- 🔧 **圖片重複貼上 (Web UI)**: 解決了在文字輸入區使用 Ctrl+V 貼上圖片時,可能導致圖片重複貼上的問題 - 🔧 **圖片重複貼上**: 解決了在 Web UI 文字輸入區使用 Ctrl+V 貼上圖片時的重複問題
--- ---
## [v2.1.1] - 視窗定位優化 (2024-11-XX) ## [v2.1.1] - 視窗定位優化 (2024-11-XX)
### 🌟 亮點
完美解決多螢幕環境下的視窗定位問題,特別是 T 字型螢幕排列等複雜配置。
### ✨ 新功能 ### ✨ 新功能
- 🖥️ **智能視窗定位**: 新增「總是在主螢幕中心顯示視窗」設定選項 - 🖥️ **智能視窗定位**: 新增「總是在主螢幕中心顯示視窗」設定選項
- 🌐 **多螢幕支援**: 完美解決 T 字型螢幕排列等複雜多螢幕環境的視窗定位問題 - 🌐 **多螢幕支援**: 完美解決 T 字型螢幕排列等複雜多螢幕環境的視窗定位問題
- 💾 **位置記憶**: 自動保存和恢復視窗位置,智能檢測視窗可見性 - 💾 **位置記憶**: 自動保存和恢復視窗位置,智能檢測視窗可見性
- ⚙️ **用戶選擇**: 提供智能定位(預設)和強制中心顯示兩種模式
--- ---
## [v2.1.0] - 全面重構版 (2024-11-XX) ## [v2.1.0] - 全面重構版 (2024-11-XX)
### 🌟 亮點
這是一個重大重構版本GUI 和 Web UI 均採用了全新的模組化架構。
### 🎨 重大重構 ### 🎨 重大重構
- 🏗️ **全面重構**: GUI 和 Web UI 採用模組化架構 - 🏗️ **全面重構**: GUI 和 Web UI 採用模組化架構
- 📁 **集中管理**: 重新組織資料夾結構,提升維護性 - 📁 **集中管理**: 重新組織資料夾結構,提升維護性
@ -160,16 +91,13 @@ uvx mcp-feedback-enhanced@v2.2.3 test
- ⚙️ **功能增強**: 新增設定選項和自動關閉頁面功能 - ⚙️ **功能增強**: 新增設定選項和自動關閉頁面功能
- **關於頁面**: 新增關於頁面,包含版本資訊、專案連結和致謝內容 - **關於頁面**: 新增關於頁面,包含版本資訊、專案連結和致謝內容
### 🐛 問題修復
- 🌐 **語言切換**: 修復 Web UI 語言切換時內容更新問題
--- ---
## [v2.0.14] - 快捷鍵與圖片功能增強 (2024-10-XX) ## [v2.0.14] - 快捷鍵與圖片功能增強 (2024-10-XX)
### 🚀 改進功能 ### 🚀 改進功能
- ⌨️ **增強快捷鍵**: Ctrl+Enter 支援數字鍵盤 - ⌨️ **增強快捷鍵**: Ctrl+Enter 支援數字鍵盤
- 🖼️ **智能圖片貼上**: Ctrl+V 直接貼上剪貼圖片 - 🖼️ **智能圖片貼上**: Ctrl+V 直接貼上剪貼簿圖片
--- ---

View File

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

View File

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

View File

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