✨ 更新版本發布流程

2025-07-27 10:42:25 +08:00 · 2025-06-03 21:06:01 +08:00 · 2025-06-03 21:06:01 +08:00 · e7283b3610
commit e7283b3610
parent 88297599fe
9 changed files with 744 additions and 24 deletions
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@ -70,10 +70,167 @@ jobs:
        NEW_VERSION="${{ steps.bump_version.outputs.new }}"
        sed -i "s/__version__ = \".*\"/__version__ = \"$NEW_VERSION\"/" src/mcp_feedback_enhanced/__init__.py
    
-    - name: Commit version bump
+    - name: Check Release Notes
+      id: check_notes
+      run: |
+        NEW_VERSION="v${{ steps.bump_version.outputs.new }}"
+        RELEASE_DIR="RELEASE_NOTES/${NEW_VERSION}"
+        
+        if [ ! -d "$RELEASE_DIR" ]; then
+          echo "❌ Error: Release notes directory not found at $RELEASE_DIR"
+          echo "Please create release notes before publishing!"
+          echo "Required files:"
+          echo "  - $RELEASE_DIR/en.md"
+          echo "  - $RELEASE_DIR/zh-TW.md"
+          exit 1
+        fi
+        
+        if [ ! -f "$RELEASE_DIR/en.md" ]; then
+          echo "❌ Error: English release notes not found at $RELEASE_DIR/en.md"
+          exit 1
+        fi
+        
+        if [ ! -f "$RELEASE_DIR/zh-TW.md" ]; then
+          echo "❌ Error: Traditional Chinese release notes not found at $RELEASE_DIR/zh-TW.md"
+          exit 1
+        fi
+        
+        if [ ! -f "$RELEASE_DIR/zh-CN.md" ]; then
+          echo "❌ Error: Simplified Chinese release notes not found at $RELEASE_DIR/zh-CN.md"
+          exit 1
+        fi
+        
+        echo "✅ Release notes found for $NEW_VERSION"
+        echo "release_dir=$RELEASE_DIR" >> $GITHUB_OUTPUT
+    
+    - name: Generate Release Body
+      id: release_body
+      run: |
+        NEW_VERSION="v${{ steps.bump_version.outputs.new }}"
+        RELEASE_DIR="${{ steps.check_notes.outputs.release_dir }}"
+        
+        # Create multi-language release body
+        cat > release_body.md << 'EOF'
+        ## 🌐 Multi-Language Release Notes
+        
+        ### 🇺🇸 English
+        EOF
+        
+        # Add English content
+        cat "$RELEASE_DIR/en.md" >> release_body.md
+        
+        # Add separator
+        cat >> release_body.md << 'EOF'
+        
+        ---
+        
+        ### 🇹🇼 繁體中文
+        EOF
+        
+        # Add Traditional Chinese content
+        cat "$RELEASE_DIR/zh-TW.md" >> release_body.md
+        
+        # Add separator
+        cat >> release_body.md << 'EOF'
+        
+        ---
+        
+        ### 🇨🇳 简体中文
+        EOF
+        
+        # Add Simplified Chinese content
+        cat "$RELEASE_DIR/zh-CN.md" >> release_body.md
+        
+        # Add installation section
+        cat >> release_body.md << 'EOF'
+        
+        ---
+        
+        ## 📦 Installation & Update
+        
+        ```bash
+        # Quick test latest version
+        uvx mcp-feedback-enhanced@latest test
+        
+        # Update to this specific version
+        EOF
+        
+        echo "uvx mcp-feedback-enhanced@$NEW_VERSION test" >> release_body.md
+        
+        cat >> release_body.md << 'EOF'
+        ```
+        
+        ## 🔗 Links
+        - **Documentation**: [README.md](https://github.com/Minidoracat/mcp-feedback-enhanced/blob/main/README.md)
+        - **Full Changelog**: [CHANGELOG](https://github.com/Minidoracat/mcp-feedback-enhanced/blob/main/RELEASE_NOTES/)
+        - **Issues**: [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues)
+        
+        ---
+        **Release automatically generated from RELEASE_NOTES system** 🤖
+        EOF
+        
+        echo "Release body generated successfully"
+    
+    - name: Sync CHANGELOG Files
+      run: |
+        NEW_VERSION="v${{ steps.bump_version.outputs.new }}"
+        RELEASE_DIR="${{ steps.check_notes.outputs.release_dir }}"
+        
+        # Function to add version to changelog
+        add_to_changelog() {
+          local lang_file="$1"
+          local changelog_file="$2"
+          local temp_file="changelog_temp.md"
+          
+          # Get the header and separator
+          head -n 5 "$changelog_file" > "$temp_file"
+          
+          # Add the new version content
+          cat "$lang_file" >> "$temp_file"
+          
+          # Add separator
+          echo "" >> "$temp_file"
+          echo "---" >> "$temp_file"
+          echo "" >> "$temp_file"
+          
+          # Add the rest of the changelog (skip header)
+          tail -n +7 "$changelog_file" >> "$temp_file"
+          
+          # Replace the original file
+          mv "$temp_file" "$changelog_file"
+          
+          echo "✅ Updated $changelog_file"
+        }
+        
+        # Check if CHANGELOG files exist
+        if [ -f "RELEASE_NOTES/CHANGELOG.en.md" ]; then
+          add_to_changelog "$RELEASE_DIR/en.md" "RELEASE_NOTES/CHANGELOG.en.md"
+        else
+          echo "⚠️ CHANGELOG.en.md not found, skipping"
+        fi
+        
+        if [ -f "RELEASE_NOTES/CHANGELOG.zh-TW.md" ]; then
+          add_to_changelog "$RELEASE_DIR/zh-TW.md" "RELEASE_NOTES/CHANGELOG.zh-TW.md"
+        else
+          echo "⚠️ CHANGELOG.zh-TW.md not found, skipping"
+        fi
+        
+        if [ -f "RELEASE_NOTES/CHANGELOG.zh-CN.md" ]; then
+          add_to_changelog "$RELEASE_DIR/zh-CN.md" "RELEASE_NOTES/CHANGELOG.zh-CN.md"
+        else
+          echo "⚠️ CHANGELOG.zh-CN.md not found, skipping"
+        fi
+        
+        echo "📝 CHANGELOG files synchronized"
+    
+    - name: Commit version bump and changelog updates
      run: |
        git add .
-        git commit -m "🔖 Release v${{ steps.bump_version.outputs.new }}"
+        git commit -m "🔖 Release v${{ steps.bump_version.outputs.new }}
+
+        - Updated version to ${{ steps.bump_version.outputs.new }}
+        - Synchronized CHANGELOG files with release notes
+        - Auto-generated from RELEASE_NOTES system"
        git tag "v${{ steps.bump_version.outputs.new }}"
    
    - name: Build package
@ -94,28 +251,26 @@ jobs:
        git push origin "v${{ steps.bump_version.outputs.new }}"
    
    - name: Create GitHub Release
-      uses: actions/create-release@v1
-      env:
-        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      uses: softprops/action-gh-release@v2
      with:
        tag_name: "v${{ steps.bump_version.outputs.new }}"
-        release_name: "Release v${{ steps.bump_version.outputs.new }}"
-        body: |
-          ## Changes in v${{ steps.bump_version.outputs.new }}
-          
-          **Version Type:** ${{ github.event.inputs.version_type }}
-          **Previous Version:** v${{ steps.current_version.outputs.current }}
-          
-          This release was automatically generated.
-          
-          ### Installation
-          ```bash
-          uvx mcp-feedback-enhanced@latest
-          ```
-          
-          ### What's New
-          - Auto-generated release from GitHub Actions
-          - Updated package version from ${{ steps.current_version.outputs.current }} to ${{ steps.bump_version.outputs.new }}
-          
+        name: "Release v${{ steps.bump_version.outputs.new }}"
+        body_path: release_body.md
        draft: false
        prerelease: false
+        generate_release_notes: false
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    
+    - name: Summary
+      run: |
+        echo "🎉 Release v${{ steps.bump_version.outputs.new }} completed successfully!"
+        echo ""
+        echo "📦 Published to PyPI: https://pypi.org/project/mcp-feedback-enhanced/"
+        echo "🚀 GitHub Release: https://github.com/Minidoracat/mcp-feedback-enhanced/releases/tag/v${{ steps.bump_version.outputs.new }}"
+        echo "📝 CHANGELOG files have been automatically updated"
+        echo ""
+        echo "✅ Next steps:"
+        echo "  - Check the release on GitHub"
+        echo "  - Verify the package on PyPI"
+        echo "  - Test installation with: uvx mcp-feedback-enhanced@v${{ steps.bump_version.outputs.new }} test" 
--- a/RELEASE_NOTES/CHANGELOG.en.md
+++ b/RELEASE_NOTES/CHANGELOG.en.md
@ -0,0 +1,126 @@
+# Changelog (English)
+
+This document records all version updates for **MCP Feedback Enhanced**.
+
+---
+
+## [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) 
--- a/RELEASE_NOTES/CHANGELOG.zh-CN.md
+++ b/RELEASE_NOTES/CHANGELOG.zh-CN.md
@ -0,0 +1,126 @@
+# 更新日志 (简体中文)
+
+本文件记录了 **MCP Feedback Enhanced** 的所有版本更新内容。
+
+---
+
+## [v2.2.1] - 窗口优化与统一设置接口 (2024-12-XX)
+
+### 🌟 亮点
+本版本主要解决了 GUI 窗口大小限制问题，实现了窗口状态的智能保存机制，并优化了设置接口的统一性。
+
+### 🚀 改进功能
+- 🖥️ **窗口大小限制解除**: 解除 GUI 主窗口最小大小限制，从 1000×800 降至 400×300，让用户可以自由调整窗口大小以符合不同使用场景
+- 💾 **窗口状态实时保存**: 实现窗口大小与位置的即时保存机制，支持防抖延迟避免过度频繁的 I/O 操作
+- ⚙️ **统一设置接口优化**: 改进 GUI 设置版面的配置保存逻辑，避免设置冲突，确保窗口定位与大小设置的正确性
+- 🎯 **智能窗口大小保存**: 「总是在主屏幕中心显示」模式下正确保存窗口大小（但不保存位置），「智能定位」模式下保存完整的窗口状态
+
+### 🐛 问题修复
+- 🔧 **窗口大小限制**: 解决 GUI 窗口无法调整至小尺寸的问题 (fixes #10 第一部分)
+- 🛡️ **设置冲突**: 修复设置保存时可能出现的配置冲突问题
+
+---
+
+## [v2.2.0] - 布局与设置界面优化 (2024-12-XX)
+
+### 🌟 亮点
+本版本新增了水平布局选项，优化了设置界面，并修复了快捷键和图片粘贴问题。
+
+### ✨ 新功能
+- 🎨 **水平布局模式**: 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] - 窗口定位优化 (2024-11-XX)
+
+### 🌟 亮点
+完美解决多屏幕环境下的窗口定位问题，特别是 T 字型屏幕排列等复杂配置。
+
+### ✨ 新功能
+- 🖥️ **智能窗口定位**: 新增「总是在主屏幕中心显示窗口」设置选项
+- 🌐 **多屏幕支持**: 完美解决 T 字型屏幕排列等复杂多屏幕环境的窗口定位问题
+- 💾 **位置记忆**: 自动保存和恢复窗口位置，智能检测窗口可见性
+- ⚙️ **用户选择**: 提供智能定位（默认）和强制中心显示两种模式
+
+---
+
+## [v2.1.0] - 全面重构版 (2024-11-XX)
+
+### 🌟 亮点
+这是一个重大重构版本，GUI 和 Web UI 均采用了全新的模块化架构。
+
+### 🎨 重大重构
+- 🏗️ **全面重构**: GUI 和 Web UI 采用模块化架构
+- 📁 **集中管理**: 重新组织文件夹结构，提升维护性
+- 🖥️ **界面优化**: 现代化设计和改进的用户体验
+
+### ✨ 新功能
+- 🍎 **macOS 界面优化**: 针对 macOS 用户体验进行专项改进
+- ⚙️ **功能增强**: 新增设置选项和自动关闭页面功能
+- ℹ️ **关于页面**: 新增关于页面，包含版本信息、项目链接和致谢内容
+
+### 🐛 问题修复
+- 🌐 **语言切换**: 修复 Web UI 语言切换时内容更新问题
+
+---
+
+## [v2.0.14] - 快捷键与图片功能增强 (2024-10-XX)
+
+### 🚀 改进功能
+- ⌨️ **增强快捷键**: Ctrl+Enter 支持数字键盘
+- 🖼️ **智能图片粘贴**: Ctrl+V 直接粘贴剪贴板图片
+
+---
+
+## [v2.0.9] - 多语言架构重构 (2024-10-XX)
+
+### 🔄 重构
+- 🌏 **多语言架构重构**: 支持动态载入
+- 📁 **语言文件模块化**: 模块化组织语言文件
+
+---
+
+## [v2.0.3] - 编码问题修复 (2024-10-XX)
+
+### 🐛 重要修复
+- 🛡️ **完全修复中文字符编码问题**: 解决所有中文显示相关问题
+- 🔧 **解决 JSON 解析错误**: 修复数据解析错误
+
+---
+
+## [v2.0.0] - Web UI 支持 (2024-09-XX)
+
+### 🌟 重大功能
+- ✅ **新增 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,126 @@
+# 更新日誌 (繁體中文)
+
+本文件記錄了 **MCP Feedback Enhanced** 的所有版本更新內容。
+
+---
+
+## [v2.2.1] - 視窗優化與統一設定接口 (2024-12-XX)
+
+### 🌟 亮點
+本版本主要解決了 GUI 視窗大小限制問題，實現了視窗狀態的智能保存機制，並優化了設定接口的統一性。
+
+### 🚀 改進功能
+- 🖥️ **視窗大小限制解除**: 解除 GUI 主視窗最小大小限制，從 1000×800 降至 400×300，讓用戶可以自由調整視窗大小以符合不同使用場景
+- 💾 **視窗狀態實時保存**: 實現視窗大小與位置的即時保存機制，支援防抖延遲避免過度頻繁的 I/O 操作
+- ⚙️ **統一設定接口優化**: 改進 GUI 設定版面的配置保存邏輯，避免設定衝突，確保視窗定位與大小設定的正確性
+- 🎯 **智能視窗大小保存**: 「總是在主螢幕中心顯示」模式下正確保存視窗大小（但不保存位置），「智能定位」模式下保存完整的視窗狀態
+
+### 🐛 問題修復
+- 🔧 **視窗大小限制**: 解決 GUI 視窗無法調整至小尺寸的問題 (fixes #10 第一部分)
+- 🛡️ **設定衝突**: 修復設定保存時可能出現的配置衝突問題
+
+---
+
+## [v2.2.0] - 佈局與設定界面優化 (2024-12-XX)
+
+### 🌟 亮點
+本版本新增了水平佈局選項，優化了設定界面，並修復了快捷鍵和圖片貼上問題。
+
+### ✨ 新功能
+- 🎨 **水平佈局模式**: 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] - 視窗定位優化 (2024-11-XX)
+
+### 🌟 亮點
+完美解決多螢幕環境下的視窗定位問題，特別是 T 字型螢幕排列等複雜配置。
+
+### ✨ 新功能
+- 🖥️ **智能視窗定位**: 新增「總是在主螢幕中心顯示視窗」設定選項
+- 🌐 **多螢幕支援**: 完美解決 T 字型螢幕排列等複雜多螢幕環境的視窗定位問題
+- 💾 **位置記憶**: 自動保存和恢復視窗位置，智能檢測視窗可見性
+- ⚙️ **用戶選擇**: 提供智能定位（預設）和強制中心顯示兩種模式
+
+---
+
+## [v2.1.0] - 全面重構版 (2024-11-XX)
+
+### 🌟 亮點
+這是一個重大重構版本，GUI 和 Web UI 均採用了全新的模組化架構。
+
+### 🎨 重大重構
+- 🏗️ **全面重構**: GUI 和 Web UI 採用模組化架構
+- 📁 **集中管理**: 重新組織資料夾結構，提升維護性
+- 🖥️ **界面優化**: 現代化設計和改進的用戶體驗
+
+### ✨ 新功能
+- 🍎 **macOS 界面優化**: 針對 macOS 用戶體驗進行專項改進
+- ⚙️ **功能增強**: 新增設定選項和自動關閉頁面功能
+- ℹ️ **關於頁面**: 新增關於頁面，包含版本資訊、專案連結和致謝內容
+
+### 🐛 問題修復
+- 🌐 **語言切換**: 修復 Web UI 語言切換時內容更新問題
+
+---
+
+## [v2.0.14] - 快捷鍵與圖片功能增強 (2024-10-XX)
+
+### 🚀 改進功能
+- ⌨️ **增強快捷鍵**: Ctrl+Enter 支援數字鍵盤
+- 🖼️ **智能圖片貼上**: Ctrl+V 直接貼上剪貼板圖片
+
+---
+
+## [v2.0.9] - 多語言架構重構 (2024-10-XX)
+
+### 🔄 重構
+- 🌏 **多語言架構重構**: 支援動態載入
+- 📁 **語言檔案模組化**: 模組化組織語言檔案
+
+---
+
+## [v2.0.3] - 編碼問題修復 (2024-10-XX)
+
+### 🐛 重要修復
+- 🛡️ **完全修復中文字符編碼問題**: 解決所有中文顯示相關問題
+- 🔧 **解決 JSON 解析錯誤**: 修復資料解析錯誤
+
+---
+
+## [v2.0.0] - Web UI 支援 (2024-09-XX)
+
+### 🌟 重大功能
+- ✅ **新增 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,37 @@
+# Release vX.Y.Z - [發佈標題]
+
+## 🌟 亮點
+本次發佈主要變更的簡要摘要。
+
+## ✨ 新功能
+- 🆕 **功能名稱**: 新功能的描述
+- 🎨 **界面增強**: 介面改進的描述
+
+## 🐛 錯誤修復
+- 🔧 **問題修復**: 修復內容的描述 (fixes #issue_number)
+- 🛡️ **安全修復**: 安全相關的改進
+
+## 🚀 改進功能
+- ⚡ **效能優化**: 效能最佳化
+- 📱 **用戶體驗增強**: 用戶體驗改進
+
+## 🔄 變更
+- 🔀 **重大變更**: 任何重大變更（僅限主要版本）
+- 📝 **文檔更新**: 文檔更新
+
+## 📦 安裝與更新
+```bash
+# 快速測試最新版本
+uvx mcp-feedback-enhanced@latest test
+
+# 更新到特定版本  
+uvx mcp-feedback-enhanced@vX.Y.Z test
+```
+
+## 🔗 相關連結
+- 完整更新日誌: [CHANGELOG.md](../../CHANGELOG.md)
+- 專案文檔: [README.md](../../README.md)
+- 解決的問題: #issue1, #issue2
+
+---
+**說明**: 此模板應該適應每種語言（en.md, zh-TW.md, zh-CN.md） 
--- 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 (部分完成)