mcp-feedback-enhanced/RELEASE_NOTES/CHANGELOG.zh-TW.md

更新日誌 (繁體中文)

本文件記錄了 MCP Feedback Enhanced 的所有版本更新內容。

[v2.5.6] - 2025-06-21 - 設定保存機制優化與介面美化

🌟 版本亮點

重構設定保存機制，解決語系切換保存問題，並為設定介面增加視覺化圖標，提升使用者體驗。

🚀 改進功能

• 🔨 設定保存機制重構: 完全移除 localStorage 依賴，改用統一的 FastAPI 後端保存機制
  • 解決語系切換時設定無法正確保存的問題
  • 移除防抖機制，確保設定即時保存
  • 提升設定保存的可靠性和一致性
• ✨ 設定介面美化: 為設定頁籤內的各功能區塊新增對應圖標
  • 提升介面視覺效果和使用者體驗
  • 更直觀的功能識別

🛠️ 技術改進

• 📊 統一存儲架構: 所有設定統一使用 JSON 檔案存儲，確保跨環境一致性
• 🔧 程式碼簡化: 移除複雜的 localStorage 相關程式碼，降低維護成本

---

[v2.5.5] - 2025-06-21 - SSH 遠端開發支援與穩定性增強

🌟 版本亮點

新增 SSH 遠端開發環境支援，解決遠端開發時無法存取 Web UI 的問題。同時改進 macOS 編譯支援和桌面應用穩定性，提升開發者體驗。

✨ 新功能

• 🌐 SSH 遠端開發支援: 新增 MCP_WEB_HOST 環境變數，支援設定 Web 伺服器主機綁定
  • 預設為 127.0.0.1 確保安全性
  • 可設定為 0.0.0.0 允許遠端存取
  • 解決 Cursor SSH Remote 等遠端開發環境的存取問題
• 🍎 macOS 編譯支援增強: 新增 .cargo/config.toml 配置檔案
  • 支援 Intel (x86_64) 和 Apple Silicon (aarch64) 架構
  • 解決 macOS 上 PyO3 undefined dynamic_lookup 編譯問題
  • 遵循 PyO3 官方推薦的最佳實踐

🚀 改進功能

• 📝 工具文檔優化: 將 LLM 指令移至工具 docstring，提升 token 效率
• 🎨 使用者配置簡化: 移除複雜的 Cursor 規則配置
• 📊 AI 工作摘要 Markdown 增強: 改進 Markdown 渲染效果和相容性
• 🔄 會話歷史流程優化: 改進會話保存和管理機制

🐛 問題修復

• 🖥️ 桌面應用 MCP 協議修復: 修正桌面模式下 MCP 協議通訊污染問題
• 📦 打包流程修復: 修正多平台桌面應用打包和發布問題
• 🔧 發布流程優化: 改進自動化發布工作流程的穩定性
• 🔥 移除 ESC 快捷鍵: 移除可能造成意外關閉的 ESC 快捷鍵功能

🛠️ 技術改進

• 🏗️ 構建系統增強: 改進跨平台編譯配置和相依性管理
• 📚 文檔自動化: 改進工具自我文檔化，遵循 FastMCP 最佳實踐
• 🔍 調試功能增強: 新增更詳細的調試訊息和錯誤處理

📋 使用說明

• SSH 遠端開發: 在 MCP 配置中設定 "MCP_WEB_HOST": "0.0.0.0" 允許遠端存取
• 本地開發: 保持預設 "MCP_WEB_HOST": "127.0.0.1" 確保安全性
• macOS 開發: 新的編譯配置將自動生效，無需額外設定

---

[v2.5.0] - 2025-06-15 - 桌面應用程式與效能優化

🌟 版本亮點

全新推出跨平台桌面應用程式，支援 Windows、macOS、Linux 三大平台。同時大幅提升系統效能與穩定性，引入防抖/節流機制優化用戶體驗。

✨ 新功能

• 🖥️ 桌面應用程式: 基於 Tauri 框架的原生桌面應用，支援 Windows x64、macOS (Intel/Apple Silicon)、Linux x64
• 📊 會話歷史本地檔案存儲: 會話記錄從 localStorage 改為伺服器端本地檔案保存，支援跨環境數據一致性
• 🔧 多平台構建支援: 完整的 CI/CD 流程，支援自動化多平台桌面應用構建
• 📝 桌面模式配置: 新增 MCP_DESKTOP_MODE 環境變數，支援桌面/Web 模式切換
• 📋 AI 工作摘要 Markdown 顯示: 支援 Markdown 語法渲染，包含標題、粗體、程式碼區塊、列表、連結等格式

🚀 改進功能

• ⚡ 效能大幅提升: 引入防抖/節流機制，減少不必要的渲染和網路請求
• 🌐 網路連接穩定性: 改進 WebSocket 重連機制，支援網路狀態檢測和智能重連
• 📊 會話歷史存儲改進: 從 localStorage 改為伺服器端本地檔案存儲，提升跨環境一致性
• 🎨 UI 渲染優化: 優化會話管理、統計資訊、狀態指示器的渲染效能
• 📱 響應式改進: 調整心跳頻率和超時閾值，減少系統負載
• 🔄 模組化增強: JavaScript 模組結構優化，支援更好的日誌管理

🐛 問題修復

• 🌐 網路重連改進: 優化重連算法，採用指數退避策略和隨機抖動
• 🖥️ 桌面模式適配: 修復桌面模式下瀏覽器自動開啟的問題
• 📊 渲染效能修復: 解決重複渲染和不必要的狀態更新問題

🛠️ 技術改進

• 🏗️ 構建流程優化: 新增 Makefile 桌面應用構建命令，支援 debug/release 模式
• 📦 依賴管理: 整合 Rust 工具鏈，支援跨平台編譯和打包
• 🔍 開發工具增強: 新增環境檢查、構建驗證、清理工具
• 📚 文檔完善: 新增桌面應用構建指南和工作流程說明
• 🔒 安全性增強: 引入 DOMPurify 進行 XSS 防護，確保內容安全

📋 使用說明

• 桌面模式: 在 MCP 配置中設定 "MCP_DESKTOP_MODE": "true" (參考 examples/mcp-config-desktop.json)
• Web 模式: 在 MCP 配置中設定 "MCP_DESKTOP_MODE": "false" (預設，參考 examples/mcp-config-web.json)
• 測試桌面模式: uvx mcp-feedback-enhanced@latest test --desktop
• 構建桌面應用: make build-desktop-release

---

[v2.4.3] - 2025-06-14 - 會話管理重構與音效通知

🌟 版本亮點

將會話管理從左側邊欄遷移到獨立頁籤，解決瀏覽器相容性問題。新增音效通知系統，支援自訂音效。

✨ 新功能

• 🔊 音效通知系統: 會話更新時播放音效提醒，支援內建音效和自訂音效上傳
• 📚 會話歷史管理: 本地保存會話記錄，支援匯出和清理功能
• 💾 輸入框高度記憶: 自動保存和恢復文字輸入框的高度設定
• 📋 一鍵複製: 專案路徑和會話ID支援點擊複製

🚀 改進功能

• 📋 會話管理重構: 從左側邊欄遷移到「會話管理」頁籤，解決小視窗下按鈕無法點擊的問題
• 🎨 介面佈局優化: AI摘要區域自動擴展，提交按鈕位置調整，移除多餘描述文字
• 🌐 多語言增強: 新增tooltip和按鈕的多語言支援

🐛 問題修復

• 修復當前會話詳細資訊按鈕無反應問題
• 修復會話詳情彈窗關閉延遲問題
• 修復音效通知語系初始化問題
• 修正自動提交處理邏輯

---

[v2.4.2] - Web-Only 架構重構與智能功能增強

🌟 版本亮點

本版本進行了重大架構重構，完全移除 PyQt6 GUI 依賴，轉為純 Web UI 架構，大幅簡化部署和維護。同時新增多項智能功能，包括提示詞管理、自動提交、會話管理等，全面提升用戶體驗和工作效率。

🔄 重大架構變更

• 🏗️ 完全移除 PyQt6 GUI: 徹底移除桌面應用程式依賴，簡化安裝和部署流程
• 🌐 純 Web UI 架構: 統一使用 Web 介面，支援所有平台和環境
• 📦 依賴大幅簡化: 移除 PyQt6、相關 GUI 庫等重型依賴，安裝包體積顯著減小
• 🚀 部署更簡單: 無需考慮 GUI 環境配置，適用於所有開發環境

✨ 全新功能

• 📝 智能提示詞管理系統:
  • 常用提示詞的 CRUD 操作（新增、編輯、刪除、使用）
  • 使用頻率統計和智能排序
  • 快速選擇和一鍵應用功能
  • 支援自動提交標記和優先顯示
• ⏰ 自動定時提交功能:
  • 可設定 1-86400 秒的倒數計時器
  • 視覺化倒數顯示和狀態指示
  • 與提示詞管理系統深度整合
  • 支援暫停、恢復、取消操作
• 📊 會話管理與追蹤:
  • 當前會話狀態即時顯示
  • 會話歷史記錄和統計分析
  • 今日會話數量和平均時長統計
  • 會話詳情查看和管理功能
• 🔗 連線監控系統:
  • WebSocket 連線狀態即時監控
  • 延遲測量和連線品質指示
  • 自動重連機制和錯誤處理
  • 詳細的連線統計資訊
• ⌨️ 快捷鍵增強: 新增 Ctrl+I 快速聚焦輸入框功能 (感謝 @penn201500)

🚀 功能改進

• 🎨 UI/UX 全面優化:
  • 新增左側會話管理面板，支援收合/展開
  • 頂部連線狀態列，即時顯示系統狀態
  • 響應式設計，適配不同螢幕尺寸
  • 統一的設計語言和視覺風格
• 🌐 多語言系統增強:
  • 優化語言切換機制，支援即時切換
  • 新增大量翻譯文本，提升本地化覆蓋率
  • 改進語言選擇器 UI，使用下拉選單設計
  • 修復語言切換時的顯示問題
• 🖼️ 圖片設定整合:
  • 將圖片設定從工作區移至設定頁籤
  • 統一的設定管理介面
  • 改進設定項目的組織和佈局
• 📱 介面佈局優化:
  • 調整版面配置，符合多語言顯示需求
  • 優化按鈕樣式和間距
  • 改進表單元素的視覺設計
  • 增強可訪問性和易用性

🐛 問題修復

• 🔧 會話管理修復:
  • 修復會話統計資訊無法正確更新的問題
  • 修復會話數量計算錯誤
  • 改進會話狀態追蹤機制
• 🎯 提示詞功能修復:
  • 修復常用提示詞管理無法正確設定自動提交的問題
  • 改進提示詞選擇和應用邏輯
• 🌐 語系切換修復:
  • 修復語言切換時部分文字未更新的問題
  • 改進多語言文本的載入機制
• 🏗️ 架構穩定性修復:
  • 修復會話管理初始化問題
  • 改進錯誤處理和資源清理
  • 優化模組載入順序和依賴關係

🛠️ 技術改進

• 📦 模組化架構:
  • JavaScript 代碼完全模組化重構
  • 採用 ES6+ 語法和現代化開發模式
  • 清晰的模組分離和職責劃分
• 📊 效能提升:
  • 優化 WebSocket 通信效率
  • 改進前端資源載入速度
  • 減少記憶體使用和 CPU 負載

📚 文檔更新

• 📖 架構文檔更新: 更新系統架構說明，反映 Web-Only 設計
• 🔧 安裝指南簡化: 移除 GUI 相關安裝步驟和依賴說明
• 🖼️ 截圖更新: 更新所有介面截圖，展示新的 Web UI 設計
• 📋 API 文檔增強: 新增提示詞管理、自動提交等新功能的 API 說明

---

[v2.3.0] - 系統穩定性與資源管理增強

🌟 亮點

本版本專注於提升系統穩定性和使用體驗，特別解決了 Cursor SSH Remote 環境下無法啟動瀏覽器的問題。

✨ 新功能

• 🌐 SSH Remote 環境支援: 解決 Cursor SSH Remote 無法啟動瀏覽器的問題，提供清晰的使用指引
• 🛡️ 錯誤提示改善: 當發生錯誤時，提供更友善的錯誤訊息和解決建議
• 🧹 自動清理功能: 自動清理臨時文件和過期會話，保持系統整潔
• 📊 記憶體監控: 監控記憶體使用情況，防止系統資源不足

🚀 改進功能

• 💾 資源管理優化: 更好地管理系統資源，提升運行效率
• 🔧 錯誤處理增強: 遇到問題時提供更清楚的說明和解決方案
• 🌐 連線穩定性: 改善 Web UI 的連線穩定性
• 🖼️ 圖片上傳優化: 改善圖片上傳功能的穩定性
• 🎯 自動聚焦輸入框: 回饋視窗開啟時自動聚焦到輸入框，提升用戶體驗 (感謝 @penn201500)

🐛 問題修復

• 🌐 連線問題: 修復 WebSocket 連線的相關問題
• 🔄 會話管理: 修復會話狀態追蹤的問題
• 🖼️ 圖片處理: 修復圖片上傳時的事件處理問題

---

[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