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

# 更新日誌 (繁體中文)

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

## [v2.6.0] - 2025-06-28 - 智能會話管理與自動化功能強化

### 🌟 版本亮點
大幅強化會話管理功能，新增自動執行命令、匯出功能和通知系統，提供更智能的開發體驗。

### ✨ 新功能
- 🚀 **自動執行命令**: 新建會話和提交後可自動執行預設命令
- 📊 **會話匯出功能**: 支援將會話記錄匯出為多種格式
- ⏸️ **自動提交控制**: 新增暫停和開始按鈕，讓使用者更好控制自動提交時機
- 🔔 **系統通知**: 新增系統級通知功能，重要事件即時提醒

### 🚀 改進功能
- ⏱️ **會話超時機制優化**: 重新設計會話管理，提供更彈性的設定選項
- 🌏 **多語系強化**: 重構多語系架構，通知系統也完整支援多語言
- 🎨 **介面簡化**: 大幅簡化使用者介面，提升使用體驗

### 🐛 問題修復
- 修復命令執行功能的相關問題
- 修正 WebSocket 狀態檢測的導入錯誤
- 完善會話歷史的多語言支援

---

## [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](https://github.com/Minidoracat/mcp-feedback-enhanced)